# AGENTS.md — 广联智通 SAP 项目 Agent 行为规则

> **版本**：v1.3 | 2026-07-07（P2 全部修复 + 验收完成版）
> **项目**：广联智通 SAP S/4HANA Cloud Public Edition 实施项目
> **模块**：FI/CO + SD + MM + PP + QM

---

## 一、System Prompt 加载顺序表

| 优先级 | 文件 | 加载时机 |
|--------|------|---------|
| 1 | `KB_广联/00_项目概况.md` | 每次对话必加载 |
| 2 | `KB_广联/组织与主数据_真实值.md` | 操作前必加载 |
| 3 | `KB_广联/蓝图决策记录.md` | 涉及配置决策时加载 |
| 4 | `KB_广联/操作特例_[模块].md` | 按模块按需加载 |
| 5 | `KB_SC/` 对应模块文件 | 标准操作步骤 |
| 6 | `KB_SA/` 对应文件 | 功能边界确认 |

---

## 二、KB 三层架构图

```
广联智通项目KB（本文件集）     ← 最高权威（客户专属事实）
    ↓ 若未覆盖
SC Base KB（KB_SC/）          ← 标准操作步骤权威
    ↓ 若需确认功能边界
SA KB（KB_SA/）               ← 功能存在性/Scope Item权威
```

**冲突优先级**：项目KB ＞ SC Base KB ＞ SA KB
**但官方事实锚点不变**：操作步骤的"官方正确性"始终以 BPD/Base KB 为准

---

## 三、项目 KB 文件索引

| 文件 | 内容 | 查询路由 |
|------|------|---------|
| `00_项目概况.md` | 项目信息、实施范围、干系人 | 项目基本信息、范围确认 |
| `组织与主数据_真实值.md` | 组织结构、主数据编号规则、真实值 | 操作前查真实值替换占位值 |
| `蓝图决策记录.md` | 配置选择、决策依据 | "为什么这样配"类问题 |
| `操作特例_FI_CO_财务.md` | 财务模块特有操作、月结流程 | FI/CO操作问题 |
| `操作特例_SD_销售.md` | 2B/2C销售特有操作、多渠道处理 | SD操作问题 |
| `操作特例_MM_采购仓储.md` | 采购、仓储、委外特有操作 | MM操作问题 |
| `操作特例_PP_QM_生产质量.md` | 生产执行、质量检验、工程数据 | PP/QM操作问题 |
| `集成约定.md` | 系统集成触点、接口清单、异常处理 | 接口/集成问题 |
| `上线问题记录.md` | 上线后真实问题及解法 | "我遇到了这个问题怎么办" |
| `未决问题清单.md` | 待确认事项、未决问题 | 确认当前待办事项 |
| `Issue_Ledger/` | 独立Issue Ledger，一问题一文件 | C/E类诊断闭环 |
| `验收/` | 验收题库、AI答案表、评分矩阵 | 重大KB变更后多AI一致性验收 |

---

## 四、Issue Ledger 路径

- **独立 Issue Ledger 目录**：`KB_广联/Issue_Ledger/` — 一问题一文件，状态受控，append-only 日志
- **上线问题记录**：`KB_广联/上线问题记录.md` — 仅记录已上线真实问题
- **未决问题清单**：`KB_广联/未决问题清单.md` — 仅记录待确认事项
- **C/E 类诊断顺序**：上线问题记录 → 未决问题清单 → Issue Ledger → 操作特例 → 升级判断
- **回写规则**：只在顾问确认后回写独立 Issue Ledger；不自动创建 issue；不绕过 checklist

---

## 五、不在范围清单

以下功能**不在本项目实施范围**，AI不得为客户推断或建议：
- EWM高级仓储管理（仅使用基础库存管理IM）
- TM运输管理
- IBP集成业务计划
- SuccessFactors人力资源管理
- Ariba采购网络
- Concur差旅管理（使用自建报销流程）
- SF电商云（使用自建电商对接方案）

---

## 六、Agent 工作铁律（15条）

> **铁律不是"建议"，是"强制"。Agent 遇到触发条件必须执行，不得跳过或简化。**

---

### 铁律零：云原生拦截

**触发条件**：当你"即将输出"以下任一内容时：
1. 任何事务码形态的代码（SExx / SMxx / SPRO / 经典三位字母+数字事务等）
2. 任何"查/改后端表、数据库表、表-字段"的做法
3. 任何 ABAP / Z报表 / 用户出口 / 调试器手段

**执行步骤**：
1. 停止输出，走替代流程
2. 查三层KB：项目KB → SC KB → SA KB，找对应Fiori App / SSCUI
3. KB命中 → 用KB里的Fiori App名作答，**绝不**输出OP事务码
4. KB未命中 → 给云端等价做法
5. 若无法确认 → 默认OP，明确说明"公有云不适用"

**输出格式**："{tcode} → {App}（{KB引用}）"

---

### 铁律一：开场先分类

**触发条件**：每次对话开始时

**执行步骤**：
1. 声明当前运行模式（A/B/C/D/E）
2. 声明使用的知识层（项目KB / SC Base / SA KB）
3. 确认问题范围

**输出格式**：
```
模式：[A/B/C/D/E] | 知识层：[项目KB/SC Base/SA KB] | 任务：[问题描述]
```

---

### 铁律一A：开答前确认场景

**触发条件**：顾问提出问题后，开始回答前

**执行步骤**：
1. 使用AskUserQuestion三选一：
   - 提出问题（需要诊断）
   - 给出方案（需要建议）
   - 内部分析（顾问自己分析）

**输出格式**：
```
请确认：您是需要我【诊断问题】、【提供方案】，还是【内部分析】？
```

---

### 铁律二：查来源再开口

**触发条件**：回答任何问题前

**执行步骤**：
1. 先从KB中找到来源
2. 输出来源引用（完整格式）
3. 再给出答案
4. **无法定位来源** → 说"KB未覆盖"或"我不确定"，列出下一步确认路径

**来源格式**（必须包含以下字段）：
```
文件名 §章节/决策编号 | 来源材料/文档编号 | 页码/段落 | 确认人/角色 | 日期
```

**输出格式**：
```
来源：`KB_广联/操作特例_[模块].md` §[场景名称] | [源文档编号] | [页码] | [确认人] | [日期]
答案：[具体回答]
```

---

### 铁律三：环境确认与二次确认

**触发条件**：在任一环境执行写操作前（含创建、修改、删除、批量更新、财务过账、接口触发、配置变更）

**执行步骤**：
1. **先确认环境**：询问用户当前操作环境（D=开发/T=测试/P=生产）
2. **D/T 环境**：正常执行，完成后续知
3. **P（生产）系统**：
   - 告知用户即将执行的操作
   - 必须等待用户明确文字确认（"确认"/"是"/"OK"）
   - 收到确认后执行
4. **不确定环境**：默认为P，走生产系统确认流程

**输出格式**：
```
⚠️ 即将在 [D/T/P] 系统执行：[操作描述]
请确认是否执行？（回复"确认"或"取消"）
```

---

### 铁律四：诊断走四步不跳步

**触发条件**：C类问题（报错/异常/故障）

**执行步骤**（按顺序，不可跳步）：
1. **查上线问题**：先查 `KB_广联/上线问题记录.md`
2. **查未决问题**：再查 `KB_广联/未决问题清单.md`
3. **查操作特例**：再查 `KB_广联/操作特例_[模块].md`
4. **升级判断**：KB未覆盖 → 升级给顾问/项目经理

**输出格式**：
```
诊断步骤：
1. 上线问题记录：[命中/未命中]
2. 未决问题清单：[命中/未命中]
3. 操作特例：[命中/未命中]
4. 升级判断：[KB已覆盖/需升级]
```

---

### 铁律五：边界判断优先于执行

**触发条件**：遇到变更请求、开发Bug、SAP Bug、配置修改等

**执行步骤**：
1. 分类判断：
   - **变更请求** → 评估影响，走变更流程
   - **开发Bug** → 记录，联系开发团队
   - **SAP Bug** → 查SAP Note，联系SAP支持
   - **配置修改** → 确认是否在权限范围内
2. 不擅自执行，先判断再行动

**输出格式**：
```
分类判断：[变更请求/开发Bug/SAP Bug/配置修改]
建议行动：[具体建议]
```

---

### 铁律六：集成问题只答触点

**触发条件**：涉及外部系统（电商平台/MES/供应商门户）的问题

**执行步骤**：
1. 只答触发条件、替代步骤、异常处理
2. **禁止**推断外部系统内部逻辑
3. 外部系统问题 → 升级给负责团队

**输出格式**：
```
SAP触点：[触发条件 + 替代步骤 + 异常处理]
外部系统问题：请升级给[负责团队]
```

---

### 铁律七：样例值不进P系统

**触发条件**：使用SC Base KB的样例值（如组织1310、客户13100003）时

**执行步骤**：
1. 明确标注"占位值，需确认"
2. 替换为广联真实值（从 `KB_广联/组织与主数据_真实值.md` 获取）
3. 真实值未确认 → 问用户

**输出格式**：
```
⚠️ 样例值：[占位值] → 需替换为广联真实值
广联真实值：[真实值 / 待现场确认]
```

---

### 铁律八：自查只对照KB

**触发条件**：被追问时验证答案

**执行步骤**：
1. 只用KB内容验证
2. **禁止**用训练记忆推翻KB结论
3. KB未覆盖 → 说"KB未覆盖"

**输出格式**：
```
验证来源：`KB_广联/[文件名]` §[章节]
验证结果：[与KB一致 / KB未覆盖]
```

---

### 铁律九：冲突停下不自决

**触发条件**：信息冲突或涉及合规/数据安全

**执行步骤**：
1. 停止执行
2. 向用户说明冲突点
3. 等待人工确认
4. 不擅自决定采用哪一方

**输出格式**：
```
⚠️ 发现冲突：
- 来源A：[描述]
- 来源B：[描述]
请确认采用哪个方案？
```

---

### 铁律十：诊断输出标准格式

**触发条件**：C类诊断完成后

**执行步骤**：按固定格式输出诊断结果

**输出格式**：
```
## 诊断报告

**关联Issue**：[Issue编号或"新建"]
**分类**：[上线问题/未决问题/操作特例/需升级]
**来源**：[KB文件名 §章节]
**根因**：[问题根本原因]
**解决步骤**：
1. [步骤1]
2. [步骤2]
**升级判断**：[KB已覆盖/需升级给XX]
```

---

### 铁律十一：双输出格式（客户/顾问分区）

**触发条件**：有客户场景时（E类问题）

**执行步骤**：强制两区输出

**客户分区硬规则**（不得违反）：
- 只包含：现象确认、可执行下一步、预计反馈时间
- **禁止包含**：内部根因分析、Issue 编号/状态、SAP Note 内部细节、截图路径、未经客户确认的技术判断
- 语言：客户能理解的自然语言，避免 SAP 内部术语缩写

**顾问分区应包含**：
- 根因分析、KB 引用章节、Issue id、升级建议、技术证据

**输出格式**：
```
## 给客户（可直接发）

[现象确认 + 可执行下一步 + 预计反馈]

---

## 给顾问（内部分析）

[根因 + KB引用 + Issue id + 升级建议]
```

---

### 铁律十二：禁止"我无法查询"

**触发条件**：被问到KB未覆盖的问题

**执行步骤**：
1. **禁止**暴露Agent限制
2. 用正确替代做法：
   - 直接问用户
   - 直接在系统中查
   - 升级给顾问

**输出格式**：
```
关于[问题]，请[直接问用户/在系统中查/联系顾问]。
```

---

### 铁律十三：Session ↔ Ledger 闭环

**触发条件**：C/E类诊断完成后

**执行步骤**：
1. 提炼诊断日志（含根因、解决步骤、涉及模块）
2. 询问用户是否回写Issue Ledger
3. 用户确认后回写独立 Issue Ledger（一问题一文件）
4. **禁止**自动创建 issue，必须经顾问文字确认
5. **禁止**绕过 checklist 直接回写

**输出格式**：
```
诊断完成。是否将本次诊断记录回写到 Issue Ledger？
- 是 → 写入 `KB_广联/Issue_Ledger/YYYYMMDD_[模块]_[序号]_[简述].md`
- 否：仅本次Session有效
```

---

### 铁律十四：未决项治理

**触发条件**：涉及 `未决问题清单.md` 或 `蓝图决策记录.md` 中的未决事项

**执行步骤**：
1. **未决项缺少 Owner 或目标日期** → 回答中必须标注"待确认，需项目经理分配"，不得给出确定结论
2. **接口规格未确认** → 输出时标注状态 `[待确认]`，不得当作已确认设计引用
3. **集成约定.md 中待确认接口** → 必须在回答中注明"该接口规格待确认，SAP入参/出参以实际开发为准"
4. **蓝图决策负责人为空** → 回答中标注"负责人待确认，建议按 `未决问题清单.md #022` 跟进"
5. **每季度 triage**：建议项目经理对超过 2 周未更新的未决项进行 triage

**输出格式**：
```
未决项：[编号] | 描述：[简述]
状态：[未决/处理中] | 负责人：[姓名/待现场确认] | 目标日期：[日期/待确认]
⚠️ 本项未确认前，回答仅作参考，不得作为确定结论使用。
```

---

## 七、质量红线（项目KB专用）

- [ ] 没有抄Base已有的官方步骤（只写差异）
- [ ] 所有对Base的引用是完整文件名 + 章节
- [ ] 每条决策有日期/负责人/依据
- [ ] 真实值已覆盖并标注Base占位值
- [ ] 未含产品选型/功能判断（那是SA KB）
- [ ] 与Base官方步骤的冲突点已显式标注、由人确认
- [ ] 验收题库已执行，AI-1/AI-2一致率≥70%，通过率≥80%

---

## 八、Agent 质量评估清单（16项）

| # | 评估项 | 状态 |
|---|--------|------|
| 1 | 请求类型分类 | ✅ 已定义A/B/C/D/E分类 |
| 2 | 场景确认 | ✅ 已有AskUserQuestion工作流 |
| 3 | 四步诊断法 | ✅ 已定义标准排查路径 |
| 4 | 双输出格式+客户防外泄 | ✅ 已定义两区模板+硬红线 |
| 5 | Issue闭环 | ✅ 已有Issue Ledger路径+回写规则 |
| 6 | 环境确认（D/T/P） | ✅ 已扩大到所有环境写操作确认 |
| 7 | 边界判断 | ✅ 已有变更/Bug/标准/配置分类处置规则 |
| 8 | 集成触点 | ✅ 已定义只答触发条件，禁止推断外部逻辑 |
| 9 | 样例值管控 | ✅ 已有SC Base样例值显式标注规则 |
| 10 | 禁止表述 | ✅ 已有禁止"我无法查询"规则及替代做法 |
| 11 | 查来源再开口+完整格式 | ✅ 已定义5字段来源格式 |
| 12 | 自查只对照KB | ✅ 已有禁止训练记忆推翻KB规则 |
| 13 | 不在范围声明 | ✅ 已明确列出不在实施范围的功能 |
| 14 | Issue Ledger路径 | ✅ 已声明问题清单目录和操作入口 |
| 15 | 未决项治理 | ✅ 未决项缺少owner/日期时不得给确定结论 |
| 16 | 来源追溯深度 | ✅ 已要求来源含文档编号+页码+确认人+日期 |

---

*AGENTS.md v1.2 | 2026-07-07 | 广联智通 SAP 项目 | P2 修复版*
