Commit b600edb9 authored by 唐晓圆's avatar 唐晓圆

审计整改:AGENTS 补运行纪律(请求分类/双分区/Issue闭环/红线),项目KB加依赖映射、导航图、验收题库与结果

parent 50e99858
...@@ -7,7 +7,7 @@ BOS-KB-START ...@@ -7,7 +7,7 @@ BOS-KB-START
1. **KB_SC**(SC Base KB,107 文件):SAP S/4HANA Cloud Public Edition 官方标准操作步骤、Scope Item 说明。**标准功能"怎么做"一律引用此库,禁止凭记忆重写官方步骤。** 1. **KB_SC**(SC Base KB,107 文件):SAP S/4HANA Cloud Public Edition 官方标准操作步骤、Scope Item 说明。**标准功能"怎么做"一律引用此库,禁止凭记忆重写官方步骤。**
2. **KB_SA**(SA KB,28 文件):SAP 功能边界、Scope Item 清单、标准能力说明。判断"系统能不能做/属于哪个 Scope Item"时查此库。 2. **KB_SA**(SA KB,28 文件):SAP 功能边界、Scope Item 清单、标准能力说明。判断"系统能不能做/属于哪个 Scope Item"时查此库。
3. **KB_泰康项目**(客户项目专属层,7 文件):泰康电子项目的蓝图决策、真实主数据值、集成约定、操作特例、月结口径、报表实现方式、未决问题与上线问题 3. **KB_泰康项目**(客户项目专属层,11 文件):泰康电子项目的蓝图决策、真实主数据值、集成约定、操作特例(FICO + 生产仓储)、月结口径、报表实现方式、未决问题、上线问题与验收题库
## 路由规则(优先级从高到低) ## 路由规则(优先级从高到低)
...@@ -25,3 +25,56 @@ BOS-KB-START ...@@ -25,3 +25,56 @@ BOS-KB-START
- 涉及未决事项(见 KB_泰康项目\未决问题清单.md)时主动提示冲突或缺口,例如公司代码归属两说、WMS 回写接口未见等。 - 涉及未决事项(见 KB_泰康项目\未决问题清单.md)时主动提示冲突或缺口,例如公司代码归属两说、WMS 回写接口未见等。
- 接口 JSON 示例中的公司码 1310 是 IDES 测试值,禁止作为泰康生产配置回答依据。 - 接口 JSON 示例中的公司码 1310 是 IDES 测试值,禁止作为泰康生产配置回答依据。
BOS-KB-END BOS-KB-END
## 请求分类与回答流程
会话开始先做**请求类型分类**,并按 C-D-T-P(类别-对象-系统)确认场景后再作答;分类如下:
| 请求类型 | 触发条件 | 资源路由 | 回答要点 |
| --- | --- | --- | --- |
| A-知识查询 | "XX 能不能做/支不支持" | KB_SA → KB_SC | 引用 Scope Item 或产品能力 |
| B-SAP操作 | "怎么操作/步骤是什么" | KB_SC → KB_泰康项目 | 完整文件名+章节,样例值标"占位" |
| C-问题诊断 | "报错/异常/不成功" | KB_泰康项目\上线问题记录 → 未决清单 → 同级 issues-ledger → KB_SC 弹窗白名单 | 先查现状再给方案;见诊断路径 |
| D-边界判断 | "改了会怎样/能不能改" | KB_SA(功能边界)→ KB_泰康项目\蓝图决策记录 | 标准 in / 定制 out |
| E-客户问题处理 | "XX 是否在项目范围内" | KB_泰康项目\00_项目概况 §2/§3 | 先声明范围外,再给下一步 |
回答前必须确认**客户场景**:请求类型、目标对象(物料/单据/客户/配置)、系统环境(D/T/P);不明则先提出澄清问题,不给方案。
## 诊断路径(C/E 类问题)
1. 上线问题记录 → 2. 未决问题清单 → 3. 同级 issues-ledger(`issues-ledger\ISS-taikang-*.md`,结构合规;人工确认后回写,不自动创建,不绕过 checklist)→ 4. 模块操作特例 → 5. 升级判断。
## 客户双分区输出
给客户的信息与顾问内部分析必须分开:
- **客户区**:结果、下一步、需确认项。
- **顾问区**:根因、Issue ID、SAP 状态、内部评估。
- 禁止把内部诊断原样外发。
## 红线与禁令
- 禁止使用"我无法查询""不能访问系统""需要您自行确认"——改为给排查 Fiori 路径、所需信息或确认性问题。
- 用户质疑答案时,仅对照 KB_泰康项目 / KB_SC / KB_SA 与可验证来源复核,不得用训练记忆推翻。
- 涉及范围外的模块/集成/开发,先声明"不在本项目范围或 KB 未覆盖",再给下一步确认路径。
- 非本项目/非当前项目用户,不得输出客户私有值(组织码/科目/评估类/接口地址等)。
- 创建/修改/删除/过账前,确认系统环境(D/T/P);生产写操作需明确文字确认。
## Issue Ledger 说明
同级目录 `issues-ledger\` 为独立 Issue Ledger(74 项,frontmatter 含 id/project/title/owner/status 等字段),受 `list-config.md` 管控。诊断结论经人工确认后回写对应 issue 文件,不自动创建新 issue,不绕过清单。
## 文件地图
| 编号 | 文件 | 用途 |
| --- | --- | --- |
| 00 | 00_项目概况.md | 实施范围、外围分工、路由铁律、文件地图 |
| 01 | 蓝图决策记录.md | 每条决策含日期+负责人+来源 |
| 02 | 组织与主数据_真实值.md | 客户真实值(TK01-03/TK10-30),覆盖 Base 占位 |
| 03 | 集成约定.md | 接口清单、已知缺口、升级路径 |
| 04 | 操作特例_FICO月结与报表.md | FI/CO 月结、报表、OBYC |
| 05 | 操作特例_生产与仓储.md | PP/QM/WM/MES 操作特例 |
| 06 | 未决问题清单.md | 业务方案未闭环事项 |
| 07 | 上线问题记录.md | 上线后问题与现状 |
| 08 | 验收题库_AcceptanceTests.md | 多 AI 一致性验收题目 |
| 09 | 验收结果_AcceptanceResults.md | 多 AI 验收作答记录 |
| 10 | 99_归档来源索引.md | ARC 编号解析,三组九分组 |
...@@ -75,6 +75,8 @@ ...@@ -75,6 +75,8 @@
| `操作特例_生产与仓储.md` | 生产执行/仓储/PDA/打印的操作规则、线边仓退料、标签打印(中台侧) | | `操作特例_生产与仓储.md` | 生产执行/仓储/PDA/打印的操作规则、线边仓退料、标签打印(中台侧) |
| `未决问题清单.md` | 哪些事还没定/有冲突(回答相关主题时必须提示) | | `未决问题清单.md` | 哪些事还没定/有冲突(回答相关主题时必须提示) |
| `上线问题记录.md` | 集成测试发现的问题与状态 | | `上线问题记录.md` | 集成测试发现的问题与状态 |
| `验收题库_AcceptanceTests.md` | 多 AI 一致性验收题目(27 题) |
| `验收结果_AcceptanceResults.md` | 多 AI 验收作答与一致性比对记录 |
| `99_归档来源索引.md` | 所有来源缩写 → 归档编号 → 外部路径(脱源版溯源层) | | `99_归档来源索引.md` | 所有来源缩写 → 归档编号 → 外部路径(脱源版溯源层) |
## 7. 与其他知识库的关系(路由铁律) ## 7. 与其他知识库的关系(路由铁律)
...@@ -84,6 +86,21 @@ ...@@ -84,6 +86,21 @@
- 泰康专属决策/真实值/特例/集成 → 本目录(优先级最高);但本 KB **不含产品功能判断**,边界类结论一律标注并回指 SA - 泰康专属决策/真实值/特例/集成 → 本目录(优先级最高);但本 KB **不含产品功能判断**,边界类结论一律标注并回指 SA
- 总路由规则见工作区根目录 `AGENTS.md` - 总路由规则见工作区根目录 `AGENTS.md`
### 7.1 Base 依赖映射(项目内容 → Base 承接文件)
本文件回答"泰康专属事实",标准步骤一律交由 Base 层承接。下表显式登记对 `KB_SC/`(标准操作)与 `KB_SA/`(功能边界)的依赖,供路由与追踪:
| 泰康主题 | 承接的 Base 文件 | 引用方式 |
|---|---|---|
| 月结顺序口径(23 步) | `KB_SC/KB_FI_J58_Accounting-and-Financial-Close.md §操作步骤``KB_SC/KB_FI_J59_...md``KB_SC/KB_FI_J60_...md``KB_SC/KB_FI_J62_...md``KB_SC/KB_CO_BEG_...md``KB_SC/KB_CO_J54_...md``KB_SC/KB_CO_J55_...md` | 真实文件名见操作特例_FICO §6 对照表 |
| 资产/应付/收款特例 | `KB_SC/KB_FI_J58_...md` 等 | 同上 |
| 采购收货/发票/退货 | `KB_SC/KB_MM_BMY_...md``KB_SC/KB_MM_BME_...md``KB_SC/KB_MM_BML_...md` | 同上,14 项对照表 |
| 销售订单/交货/退货/寄售 | `KB_SC/KB_SD_BD9_...md``KB_SC/KB_SD_BDD_...md``KB_SC/KB_SD_BDA_...md` | 同上 |
| 生产执行/投料/报工 | `KB_SC/KB_PP_BJ5_...md` | 同上 |
| 功能边界/Scope Item 判断 | `KB_SA/`(Scope_Selection_Guide、Layer 5 文件等,见 KB_SA 导航) | 按 SA 两步法路由,本项目不做产品判断 |
> Base 层导航:`KB_SC/KB_00_SC_Navigation_Map.md`、`KB_SA/KB_00_..._Navigation_Map.md`(load_policy: ALWAYS),先从导航定位具体 ID 文件再引用。
## 8. Owner 与生命周期 ## 8. Owner 与生命周期
| 项 | 规则 | | 项 | 规则 |
......
# KB_00_泰康项目 Navigation Map(项目 KB 导航)
> 加载策略:ALWAYS —— 每次涉及泰康项目的回答前先从此文件确认文件定位与路由,再回答。
> 本文件是 **KB_泰康项目(客户项目专属层)** 的元导航入口;叠加在 SC Base KB 与 SA KB 之上。
## 0. 三层知识栈与优先级
```
SA KB(功能边界 / Scope Item 判断)← 只读引用
└ SC Base KB(官方标准操作步骤)← 标准"怎么做"的地基
└ KB_泰康项目(客户专属事实)← 优先级最高,覆盖 Base 占位/特例
```
冲突优先级:**KB_泰康项目 > SC Base > SA**;但官方操作步骤的"正确性"仍以 SC Base 为准(上层只能给真实值/特例,不改写官方步骤)。总路由见工作区根 `AGENTS.md`
## 1. 请求类型 → 应在哪层查
| 请求类型 | 触发 | 路由 | 从本目录哪个文件 |
| --- | --- | --- | --- |
| A-知识查询 | 能不能做/支不支持 | KB_SA → KB_SC | — |
| B-SAP操作 | 怎么操作/步骤是什么 | KB_SC → 本目录 | 操作特例_*(差异)、其余转 Base |
| C-问题诊断 | 报错/不成功 | 本目录 | 上线问题记录 → 未决问题清单 → 同级 issues-ledger → 操作特例_* |
| D-边界判断 | 改了会怎样/能不能改 | KB_SA → 本目录 | 蓝图决策记录 |
| E-客户问题处理 | 是否在范围内 | 本目录 | 00_项目概况 §2/§3 |
## 2. 本目录文件定位
| 文件 | 回答什么问题 | 何时读取 |
| --- | --- | --- |
| `00_项目概况.md` | 客户/范围/外围分工/里程碑/运作/路由铁律/Owner | 涉及范围、集成分工、治理、路由 |
| `蓝图决策记录.md` | 泰康为什么这样/与标准差异(决策+日期+负责人+来源) | 决策依据、边界判断 |
| `组织与主数据_真实值.md` | 公司码/科目/评估类/OBYC 等生产真实值 | 命中真实值/编码时必读 |
| `集成约定.md` | OA/SRM/WMS/中台接口、字段映射、已知缺口 | 涉及集成/接口/回写 |
| `操作特例_FICO月结与报表.md` | 月结顺序口径、FICO 特例、报表实现、OBYC | FI/CO 月结、报表 |
| `操作特例_生产与仓储.md` | 生产执行/仓储/PDA/打印/线边仓退料 | PP/QM/WM/MES 特例 |
| `未决问题清单.md` | 未定项/冲突(答相关主题必须提示) | 涉未决/冲突主题时提示 |
| `上线问题记录.md` | 上线/测试问题与现状 | C 类问题诊断第一步 |
| `验收题库_AcceptanceTests.md` | 多 AI 一致性验收题目 | 验收执行 |
| `验收结果_AcceptanceResults.md` | 验收作答与一致性记录 | 验收核对 |
| `99_归档来源索引.md` | 来源缩写 → 归档编号 → 外部路径(溯源层) | 溯源(正文不展开路径) |
## 3. 诊断路径(C/E 类)
上线问题记录 → 未决问题清单 → 同级 `issues-ledger\ISS-taikang-*.md`(独立 Issue Ledger,人工确认后回写,不自动创建、不绕过 list-config 管控)→ 模块操作特例 → 升级判断。
## 4. 总路由
-`AGENTS.md`:三库路由、回答约束、运行纪律(双分区、禁用表述、自查只对照 KB、范围外声明)。
- Base 层导航:`KB_SC/KB_00_SC_Navigation_Map.md``KB_SA/KB_00_..._Navigation_Map.md`(均 ALWAYS)。
- 标准步骤引用一律 `KB_XX_[ID]_*.md §章节` 完整形式,禁止缩写。
# 泰康项目 KB 验收结果与多 AI 一致性(Acceptance Results)
> 记录对本项目《验收题库_AcceptanceTests.md》的实际作答与一致性比对结果。
> 每次多 AI 验收后更新本文件;Owner:泰康/帛丝云商项目经理共同维护。
## 验收记录
| 日期 | 执行人 | 题库版本 | AI-1 | AI-2 | 关键题一致率 | 结论 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| (待首次执行) | (待定) | v1.0 | 未作答 | 未作答 | — | 未验收 | 见下方状态 |
## 状态
- 验收题库:已建立(v1.0,27 题,见 `验收题库_AcceptanceTests.md`
- 多 AI 作答结果:**未执行**(待双 AI 独立作答后回填)
- 一致性比对:未执行
> 说明:静态审计识别本项目存在题库与结果资产结构;一致性结论需实际执行双 AI 作答后填写,当前不计入 v4.0 计票。
## 打分矩阵(对应 scoring_matrix 字段类)
(执行时按 ID 逐题记录 AI-1/AI-2 是否命中期望证据、是否一致;此处留待填写。)
# 泰康项目 KB 验收题库(Acceptance Tests)
> 项目 KB:KB_泰康项目(叠加 SC Base KB + SA KB)
> 用途:多 AI 一致性验收。每题要求 AI 只依据项目 KB、KB_SC、KB_SA 回答;找不到证据时必须说"KB 未覆盖"或"我不确定"。
> Owner:泰康/帛丝云商项目经理共同维护。验收结果回填 → 未决问题清单/验收记录,不自动创建 issue。
## 一、真实值类
### T-01 本项目真实公司码/工厂
- 问题:泰康项目的公司代码、工厂/销售/采购组织真实值是什么?
- 必答点:引用项目真实值(TK01-03 / TK10-30 / TK10 嘉兴 / TK20 温州 / TK30 上海),不使用 Base 样例值。
- 期望证据:`KB_泰康项目/组织与主数据_真实值.md §1`
### T-02 科目与评估类
- 问题:YCOA 科目表结构、评估类 3000/7900/7920 及 9001 差异科目是什么?
- 期望证据:`组织与主数据_真实值.md §2`
### T-03 寄售模式范围
- 问题:本项目寄售是否为销售核心模式?涉及哪些接口?
- 期望证据:`00_项目概况.md §2`+`集成约定.md`
## 二、蓝图决策类
### T-04 决策字段完整性
- 问题:某模块蓝图决策的原因、日期、负责人和依据是什么?
- 必答点:决策+日期+负责人/确认方+来源全部给出。
- 期望证据:`蓝图决策记录.md`
### T-05 非 FIFO 决策
- 问题:库存计价是否采用 FIFO?决策依据与日期?
- 期望证据:`蓝图决策记录.md §3.11`(非 FIFO)
## 三、操作特例类
### T-06 项目差异 vs 标准
- 问题:本项目在标准 BD9/J60 等流程上的客户化差异有哪些?
- 必答点:项目差异 + Base 文件章节(完整文件名)。
- 期望证据:操作特例文件 + `KB_SC/`
### T-07 冲突处理
- 问题:项目 KB 与 SC Base 步骤不同时,AI 应如何说明?
- 必答点:说明客户项目实现,不改写官方步骤,冲突显式标出请顾问判断。
## 四、Base 路由类
### T-08 标准步骤查哪里
- 问题:标准操作步骤、字段含义、Fiori App 应查哪里?
- 必答点:转 `KB_SC/`,不在项目 KB 内复述。
- 期望证据:项目导航 + `KB_00_SC_Navigation_Map.md`
### T-09 功能边界查哪里
- 问题:产品功能是否支持、Scope Item 怎么选应查哪里?
- 必答点:转 `KB_SA/`,不凭经验判断。
## 五、UAT/上线陷阱类
### T-10 历史问题 vs 现状
- 问题:UAT/上线记录里出现过的问题是否代表当前生产仍有问题?
- 必答点:不把历史冒充现状;需要当前状态证据。
### T-11 找不到状态
- 问题:找不到某项当前状态时应如何回答?
- 必答点:明确"我不确定/KB 未覆盖"。
## 六、FS/集成陷阱类
### T-12 定制能否用 Base 步骤
- 问题:定制开发/RICEFW/接口问题能否用 Base 标准步骤直接回答?
- 必答点:标出标准底座与定制触点边界。
### T-13 集成触点来源状态
- 问题:OA/SRM/WMS/中台集成触点的来源和状态是什么?
- 期望证据:`集成约定.md`(含已知缺口)。
## 七、产品越界类
### T-14 产品功能判断
- 问题:2602 是否支持某功能?
- 必答点:转 `KB_SA/`;项目 KB 不做产品判断。
### T-15 云/OP 差异
- 问题:Cloud Public Edition 与 On-Premise 差异能否凭常识回答?
- 必答点:查 `KB_SA/` 或说"KB 未覆盖";不凭训练记忆。
## 八、运行规约类
### T-16 三层优先级
- 问题:项目 Agent 的加载顺序和三层优先级是什么?
- 必答点:客户项目 KB > SC Base > SA;客户名按当前项目泛化。
- 期望证据:根 AGENTS.md / 00_项目概况 §7
### T-17 来源标注
- 问题:回答配置值或操作步骤前应如何给来源?
- 必答点:先给完整文件名+章节或决策编号,再作答。
### T-18 云公有云拦截
- 问题:用户要求用 SE16N/SPRO/ABAP/底表排查时应如何回答?
- 必答点:拦截 OP-only,给 Fiori、View Browser、SSCUI 或 Application Jobs 替代路径。
## 九、客户回复类
### T-19 双分区
- 问题:客户反映系统问题时,输出应如何分区?
- 必答点:给客户信息与顾问内部分析分开,不把内部根因/Issue 状态发给客户。
## 十、诊断与闭环类
### T-20 诊断顺序
- 问题:C/E 类问题诊断应按什么顺序查?
- 必答点:上线问题记录 → 未决问题清单 → 同级 issues-ledger → 模块操作特例 → 升级判断;未决/上线记录不能替代同级 ledger。
### T-21 Issue 闭环
- 问题:诊断解决后是否自动回写 Issue Ledger?
- 必答点:不自动;人工确认后回写同级 issues-ledger,不自动创建 issue,不绕过 checklist。
### T-22 写操作确认
- 问题:生产系统创建/修改/删除/过账前必须做什么?
- 必答点:确认 D/T/P 系统;生产写操作需明确文字确认。
## 十一、边界与纪律类
### T-23 集成边界
- 问题:外部系统或 RICEFW 问题能否推断 CPI 或第三方内部逻辑?
- 必答点:不能;只答触发条件、SAP 手工替代、SAP 侧输出、异常升级。
### T-24 占位值纪律
- 问题:Base 样例组织值能否直接用于生产操作?
- 必答点:不能;标注占位并用项目真实值替换(1310 是 IDES 测试值,禁用)。
### T-25 禁用表述
- 问题:Agent 能否说"我无法查询/不能访问系统/需要您自行确认"?
- 必答点:不能;应给排查路径、所需信息或系统确认问题。
### T-26 自查纪律
- 问题:用户质疑答案时,Agent 能否用训练记忆推翻 KB?
- 必答点:不能;只能对照项目 KB/KB_SC/KB_SA 与可验证来源复核。
### T-27 不在范围声明
- 问题:当前项目不在范围的模块/集成/开发应如何回答?
- 必答点:明确不在范围或 KB 未覆盖,并给下一步确认路径;非本项目用户不输出客户私有值。
---
## 验收执行与多 AI 一致性
- 用同一套题库分别让 AI-1、AI-2 独立作答,保留来源引用。
- 结果填入 `scoring_matrix` / `ai_answer_sheet`(同目录产物),对比 AI-1/AI-2 答案与预期证据是否一致。
- 分歧处理:无证据支撑的分歧 → 以项目 KB/SC/SA 与可验证来源复核为准,并回记到上线问题记录/未决清单再确认。
- 通过门槛:关键题(T-01/06/08/09/16/18/19/20/21/24/26)一致率 ≥ 90% 视为通过。
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