Commit a29461f3 authored by 朱智's avatar 朱智

Delete AGENTS.md

parent c977cac6
# 鸿星项目 KB(客户项目知识层)
> doc_type: project_kb_navigation
> 项目:鸿星文具 SAP S/4HANA Cloud Public Edition 实施项目(覆盖鸿星、凌可、杭州艾尼等公司)
> 版本:v0.3 **脱源版 + 二次审计** | 审计日期:2026-08-24 | 依据:KB_建设方法论_指导书 v1.0 / 客户项目KB_建设指引 v1.1 | 源件归档索引见文末
> 治理:Owner=项目经理(待认领,ISS-013)| 验收门禁:KB_QA_验收题库.md
> 读者:① AI Agent(与 KB_SA / KB_SC 叠加使用,本层优先级最高)② 项目顾问
---
## 一、本 KB 的定位与使用规则
```
客户提问 → ① 本项目KB(客户专属决策/规则/流程)→ 命中即引用并注明来源文档
→ ② 未命中 → KB_SC(怎么配/怎么跑的标准操作)
→ ③ 再未命中 → KB_SA(功能边界/选型)
冲突裁决:项目 KB > SC Base KB > SA KB(官方步骤正确性仍以 SAP BPD/Base 为锚)
```
铁律:
- **脱源原则**:本 KB 自足——作答所需事实全部在正文与 `KB_DATA_*.md` 查找表内,不依赖解压/重读原始 Office 文件;文末归档索引仅供审计追溯。
- Base KB 已覆盖的标准功能**只引用不重写**;本项目文件只记录"项目怎么定的、和标准有什么差异"。
- 所有条目可溯源(文末索引),引用格式:`来源:[文档名] [日期]`
- 标注 ⚠️ 的条目为存疑内容,不得作为确定性答案输出。
- 阶段标注:【通用】= 全项目适用;【鸿星阶段】= 一期鸿星/凌可相关;【艾尼阶段】= 艾尼系公司相关。
## 二、导航图
| 文件 | 内容 | 典型问题 |
|------|------|---------|
| KB_ORG_组织与主数据.md | 公司码/工厂/销售组织/库存地点要点/科目/成本利润中心(客户真实值) | "公司代码3000是什么""科目编码几位数" |
| KB_ORG_单据与移动类型.md | PR/PO/SO/生产订单单据类型号段、标准+两套新增移动类型 | "退货PO用什么类型""551是什么移动类型" |
| KB_MD_主数据规则.md | 物料/BP/客户/供应商维护规则、物料类型与物料组、品类货号命名 | "物料编码怎么给号""客户主数据谁建""新品货号怎么编" |
| KB_BP_采购到付款.md | PR→PO→审批→收货→质检→发票→付款 全链 + 8 个子场景 | "采购订单怎么审批""预付款怎么做""委外怎么收货" |
| KB_BP_库存与仓储.md | 领退料/调拨/物料转换/报废/盘点 + 不良品处理决策树 | "报废怎么走""两步调拨怎么操作""盘点冻结两种模式区别" |
| KB_BP_销售到收款.md | 销售发货/冲销/退货/借贷项/免费销售/客户预付款 + B2B/B2C OMS 流程 | "免费销售用什么订单类型""电商单怎么进SAP" |
| KB_BP_生产.md | MRP→生产订单→MES 报工/领料/入库→关闭 + 返工/退补料/不良处理 | "MES挂了怎么办""返工订单什么类型""反冲失败怎么处理" |
| KB_BP_财务.md | 应收应付确认与清账、资产、在建工程、月结年结 | "发票校验三单匹配""月结顺序""在建工程怎么转固" |
| KB_INT_外围系统接口.md | 聚水潭/领星/钉钉宜搭/MES鼎捷/每刻/北森 接口方向与范围 | "客户主数据从哪来""哪些单据走钉钉审批""领星没接口怎么办" |
| KB_OPS_操作手册盘点.md | 盘点 APP 操作步骤 + 手册类材料的存疑标注 | "盘点凭证怎么建""过账冻结和冻结账面库存的区别" |
| KB_TST_UAT与配置.md | UAT 场景矩阵、系统配置值与 CR 号、租户 URL | "质检使用决策代码有哪些""系统配置到哪一步了" |
| KB_DATA_物料组_鸿星版.md / _AN版.md | 物料组全量两套(513 条 / AN 版)⚠️ 编码含义不同勿混用 | "010101是什么物料组" |
| KB_DATA_库存地点.md | 鸿星 58 条 + 艾尼 22 条仓库全量 | "3000工厂有哪些仓库" |
| KB_DATA_工作中心.md | 工作中心 58 条(鸿星/凌可车间工序级) | "叠板工序的工作中心编码" |
| KB_ISS_未决与存疑.md | 未决问题清单(带状态)+ 已关闭存疑的处置口径 | "Z008到底能不能用""哪些事还没定" |
| KB_QA_验收题库.md | Release 门禁题库(陷阱/反向陷阱/序列/场景/边界) | KB 改动后的回归验证 |
## 三、版本裁决表(同一主题多版本时以谁为准)
| 主题 | 权威文档 | 说明 |
|------|---------|------|
| 鸿星阶段业务流程 | 业务场景规划文档 **V3.0**_260203(02-业务场景规划) | 51 个场景 SUB-001~047,签字版 |
| 艾尼阶段业务流程 | 业务场景规划文档 **V4.0**_260724(根目录) | ANWH 前缀场景,艾尼系公司 |
| 数据规则(艾尼系) | 数据规则文档全 **V4.1**_260813(根目录) | 最新;公司码 3000~7000、Z21~Z38、单据类型 |
| 数据规则(鸿星阶段) | 数据规则文档全 **V3.2**_260421(01-架构&数据结构) | 工作中心编码、仓库定义等 |
| 系统实际配置值 | 配置文档 V1.0_260119 xlsx(01-架构&数据结构) | 含 CR 号 F24K900003、租户 URL;⚠️ 日期早于上述新版,冲突处以新版数据规则为准 |
| 操作步骤 | 盘点流程操作手册 20260306(03-培训) | ⚠️ 内部有存疑点,见该文件 |
| 外围接口与实施范围 | 会议纪要 18(20260130) | 一期/二期边界 |
| 打印模板 | 采购订单打印 4.0(06-报表打印) | PO 表样与条款 |
## 四、已知矛盾与存疑速览(回答前必读;状态跟踪见 `KB_ISS_未决与存疑.md`)
1. ⚠️ **UAT 测试用例表为外部模板残留**`UAT测试时间安排` xlsx 中 `UAT测试用例` 工作表的用例编号为 ECARX-*、样例客户为吉利系公司,**不是本项目规则,禁止引用**。仅 `UAT测试概览` 工作表可用。
2. ⚠️ **财务分模块文档疑为其他项目模板**`分模块\鸿星SAP项目财务业务场景规划文档1.0.docx` 内容前缀 SAP-WHSX-*、日期 2022-09。其场景内容已由 V3.0 主蓝图 SUB-036~047 覆盖,以 V3.0 为准,WHSX 文件不作为权威源。
3. ⚠️ **新增移动类型有两套**:配置文档 V1.0(260119,鸿星阶段)为 Z01~Z12(业务招待/办公用品/在建工程/研发支出/车间消耗领料);数据规则 V4.1(260813,艾尼阶段)为 Z21~Z38(慈善捐赠/包材消耗/返工辅料/质检损耗/盘点调整/开箱损耗/云仓耗材/商品资料调整/无头单)。按阶段+公司区分适用,不可混用。
4. ⚠️ **物料组有两套编码**:配置文档 V1.0 的鸿星物料组(010101 白板-杨木白板…570101 赠品)与 AN_SAP_物料组清单(20260721,艾尼版重编,010101=马克笔…)编号含义不同。
5. ⚠️ **退货 PO 类型三个文档不一致**:V4.1 数据规则 = Z005 退货类;配置文档 V1.0 = Z005 退货;盘点手册操作示例 = "Z008 Return PO"。以 V4.1 为准,手册的 Z008 按存疑处理。
6. ⚠️ **盘点手册中 MIR7 公司代码写 "1040"、PO 审批写 "BPM"**:项目中不存在公司码 1040(各文档均为 1000~7000 体系),审批平台其他所有文档均写钉钉宜搭。视为模板残留,引用该手册时需加警告。
> 以上为常驻警告摘要;每条的编号、状态与处置口径以 `KB_ISS_未决与存疑.md` 为准(ISS-001~014)。
## 五、项目速查卡
- 系统:SAP S/4HANA Cloud Public Edition,生产租户 `my36246819.prod01.cbc.one.sapcloud.cn`(来源:配置文档 V1.0)
- 主要传输请求:F24K900003(配置类)
- 实施分期:一期=鸿星(+铅芯工厂1010)+艾利尔;二期=学泰工厂+HR北森(来源:纪要18 20260130)
- 外围系统:OMS=聚水潭/领星,审批=钉钉宜搭,报销=每刻,MES=鼎捷7.0,HR=北森(二期)
- 主数据收集模板序号:00-物料 → 10-供应商 → 20-采购信息记录 → 30-客户 → 40-BOM → 50-工艺路线 → 60-生产版本 → 70-检验计划
### 明确不在范围 / 未定事项(防止 AI 替客户推断)
- 学泰工厂、HR 北森 = 二期,一期问题不展开其方案。
- 领星接口一期未定(兜底=表格导出导入);钉钉宜搭接口细节待议(ISS-003/004)。
- 产品功能"2602 支不支持 X"、Scope Item 选型 → 转介 KB_SA;标准操作步骤 → 引用 KB_SC,不在本层重写。
## 六、Agent 操作铁律
**铁律〇 · 开场先分类**:每次对话先判断请求类型并声明——A 项目咨询 / B 客户决策查询 / C 问题诊断 / D 系统操作 / E 对外输出,按类走对应铁律。
**铁律〇A · 开答前确认场景**:C/E 类且语境不明时先问一句:问题是"客户提出的""要给客户方案的"还是"内部排查",再决定输出形态。
**铁律一 · 开答先输出来源**:项目层答案必须带 `来源:[文件名] [日期]`;⚠️ 条目不得作为确定性结论。
**铁律二 · 分层路由不跳层**:客户决策/真实值→本 KB;标准怎么配怎么跑→KB_SC;功能边界/选型→KB_SA。冲突时 项目KB > 蓝图 > SC > SA,但与官方步骤正确性矛盾时停下让顾问判断。
**铁律三 · 真实值替换占位值**:操作类回答用 `KB_ORG_*` / `KB_DATA_*` 的客户真实值,禁用 Base 样例值(1310/TG11 等)直接下单。
**铁律四 · 写操作二次确认**:对生产租户执行创建/过账/冲销/删除前,必须复述单据与影响并获用户确认;删除/批量操作一律二次确认。
**铁律五 · 诊断四步不跳步**:报错类问题按 ①本 KB 存疑清单(KB_ISS) ②与项目 KB 同级的独立 issues-ledger 已有记录 ③KB 操作特例 ④升级项目经理 的顺序排查,禁止直接猜原因。
**铁律六 · 集成只答触点**:聚水潭/领星/宜搭/MES/每刻问题只回答触发条件、SAP 侧替代步骤、异常兜底;禁止推断外部系统内部逻辑。
**铁律七 · 双输出**:内容将发给客户时,分「给客户」(可直发、无内部术语)与「给顾问」(内部分析)两区。
**铁律八 · 自查只对照 KB**:被追问复核时只用 KB 内容验证,不得引入训练记忆推翻已给出的 KB 结论。
**铁律九 · 禁说"我无法查询"**:KB 未覆盖时说"KB 未覆盖,建议向项目经理确认/查 KB_SC/KB_SA",给出下一步动作。
**铁律十 · Session 闭环回写**:诊断/新决策落定后,经确认将结论回写 `KB_ISS`(状态变更)或对应 KB 文件,保持周级新鲜度。
### Issue Ledger(同级独立台账)
- 位置:`issues-ledger\`(与项目 KB 同级,位于工作区根,独立于 `hongxing-project-kb/`;字段与状态门禁见其 `list-config.md`)。
- 回写规则:C 类诊断/新决策落定后,**经顾问确认**再回写该同级 ledger;不自动创建 issue、不绕过 checklist;项目 KB 内的未决清单/存疑表(KB_ISS)只作证据来源,不替代该同级台账。
---
## 源件归档索引(仅供审计追溯,不作答时无需读取)
> 本 KB 为脱源版:以下源件已不在本地保留解压件;如需核对原文,按路径在项目资料库中打开。
| 材料 | 源件路径(项目资料库内) |
|------|------|
| 业务场景规划 V3.0 | 03-项目资料\02-业务场景规划\鸿星公司-SAP项目_业务场景规划文档_V3.0_260203.docx |
| 业务场景规划 V4.0 | 鸿星公司-SAP项目_业务场景规划文档_V4.0_260724.docx(根目录) |
| 分模块蓝图 PP | 03-项目资料\02-业务场景规划\分模块\鸿星PP.docx |
| 数据规则 V4.1 | 鸿星文具-SAP项目_数据规则文档全_V4.1_260813.docx(根目录) |
| 数据规则 V3.2 | 03-项目资料\01-架构&数据结构\鸿星文具-SAP项目_数据规则文档全_V3.2_260421.docx |
| 配置文档 V1.0 | 03-项目资料\01-架构&数据结构\鸿星_SAP项目实施_配置文档V1.0_260119.xlsx |
| 移动类型 V1.0 | 03-项目资料\01-架构&数据结构\鸿星_SAP_移动类型_V1.0.xlsx |
| 配置清单 | 04-测试数据\鸿星文具_SAP项目_配置清单.xlsx |
| UAT 时间安排 | 03-项目资料\鸿星文具SAP项目_UAT测试时间安排_V1.0_202604120-MM.xlsx |
| 盘点操作手册 | 03-项目资料\03-培训\鸿星SAP项目_SAP盘点流程操作手册_20260306.docx |
| 采购订单打印 4.0 | 03-项目资料\06-报表打印\采购订单4.0.docx |
| 纪要18 接口与范围 | 02-会议纪要\18.…外围系统接口对接&实施范围确定_会议纪要_20260107.docx |
| AN 物料组清单 | AN_SAP_物料组清单_2026.07.21.xlsx(根目录) |
| TD 品类货号规则 | TD-品类货号品名编写规则.xlsx(根目录) |
| AN 销售办事处对应关系 | AN_SAP_销售范围、销售办事处对应关系.xlsx(根目录,⚠️ 未收录本 KB,店铺明细需查原件) |
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment