Commit 776de21c authored by 许超's avatar 许超

feat: 新增 CDS Key User KB 知识库(58个CDS视图文件+概览)及AGENTS.md四层架构更新

parent 4b4d3f44
# AGENTS.md — 广联智通 SAP 项目 Agent 行为规则 # AGENTS.md — 广联智通 SAP 项目 Agent 行为规则
> **版本**:v1.5 | 2026-07-09(审计 v4.0 整改落地版:fallback + 来源缺字段 + Issue Ledger 状态机 > **版本**:v1.6 | 2026-07-21(新增 CDS Key User KB 层:knowledge-base/KB_Cds_User/
> **项目**:广联智通 SAP S/4HANA Cloud Public Edition 实施项目 > **项目**:广联智通 SAP S/4HANA Cloud Public Edition 实施项目
> **模块**:FI/CO + SD + MM + PP + QM > **模块**:FI/CO + SD + MM + PP + QM
...@@ -15,26 +15,31 @@ ...@@ -15,26 +15,31 @@
| 3 | `KB_广联/蓝图决策记录.md` | 涉及配置决策时加载 | | 3 | `KB_广联/蓝图决策记录.md` | 涉及配置决策时加载 |
| 4 | `KB_广联/操作特例_[模块].md` | 按模块按需加载 | | 4 | `KB_广联/操作特例_[模块].md` | 按模块按需加载 |
| 5 | `KB_SC/` 对应模块文件 | 标准操作步骤 | | 5 | `KB_SC/` 对应模块文件 | 标准操作步骤 |
| 6 | `KB_SA/` 对应文件 | 功能边界确认 | | 6 | `knowledge-base/KB_Cds_User/` | CDS视图查询时加载 |
| 7 | `KB_SA/` 对应文件 | 功能边界确认 |
--- ---
## 二、KB 层架构图 ## 二、KB 层架构图
``` ```
广联智通项目KB(本文件集) ← 最高权威(客户专属事实) 广联智通项目KB(本文件集) ← 最高权威(客户专属事实)
↓ 若未覆盖 ↓ 若未覆盖
SC Base KB(KB_SC/) ← 标准操作步骤权威 SC Base KB(KB_SC/) ← 标准操作步骤权威
↓ 若需CDS视图参考
CDS Key User KB(knowledge-base/KB_Cds_User/) ← CDS视图目录(技术参考)
↓ 若需确认功能边界 ↓ 若需确认功能边界
SA KB(KB_SA/) ← 功能存在性/Scope Item权威 SA KB(KB_SA/) ← 功能存在性/Scope Item权威
``` ```
**冲突优先级**:项目KB > SC Base KB > SA KB **冲突优先级**:项目KB > SC Base KB > CDS Key User KB > SA KB
**但官方事实锚点不变**:操作步骤的"官方正确性"始终以 BPD/Base KB 为准 **但官方事实锚点不变**:操作步骤的"官方正确性"始终以 BPD/Base KB 为准
--- ---
## 三、项目 KB 文件索引 ## 三、KB 文件索引
### 3.1 项目 KB(`KB_广联/`)
| 文件 | 内容 | 查询路由 | | 文件 | 内容 | 查询路由 |
|------|------|---------| |------|------|---------|
...@@ -48,14 +53,21 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威 ...@@ -48,14 +53,21 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威
| `集成约定.md` | 系统集成触点、接口清单、异常处理 | 接口/集成问题 | | `集成约定.md` | 系统集成触点、接口清单、异常处理 | 接口/集成问题 |
| `上线问题记录.md` | 上线后真实问题及解法 | "我遇到了这个问题怎么办" | | `上线问题记录.md` | 上线后真实问题及解法 | "我遇到了这个问题怎么办" |
| `未决问题清单.md` | 待确认事项、未决问题 | 确认当前待办事项 | | `未决问题清单.md` | 待确认事项、未决问题 | 确认当前待办事项 |
| `Issue_Ledger/` | 与 `KB_广联/` 同级的独立 Issue Ledger,一问题一文件 | C/E类诊断闭环 | | `ledgers/` | 与 `KB_广联/` 同级的独立 Issue Ledger,一问题一文件 | C/E类诊断闭环 |
| `验收/` | 验收题库、AI答案表、评分矩阵 | 重大KB变更后多AI一致性验收 | | `验收/` | 验收题库、AI答案表、评分矩阵 | 重大KB变更后多AI一致性验收 |
### 3.2 CDS Key User KB(`knowledge-base/KB_Cds_User/`)
| 文件 | 内容 | 查询路由 |
|------|------|---------|
| `CDS_KeyUser_概览.md` | 概览表:8493个视图索引 | CDS视图查找入口 |
| `CDS_KeyUser_01_0001-0113.md` ~ `_58_8282-8482.md` | CDS视图详情(I_ / C_ 视图定义) | "某个CDS视图有哪些字段"类问题 |
--- ---
## 四、Issue Ledger 路径 ## 四、Issue Ledger 路径
- **独立 Issue Ledger 目录**`Issue_Ledger/`(与 `KB_广联/` 同级)— 一问题一文件,状态受控,append-only 日志 - **独立 Issue Ledger 目录**`ledgers/`(与 `KB_广联/` 同级)— 一问题一文件,状态受控,append-only 日志
- **上线问题记录**`KB_广联/上线问题记录.md` — 仅记录已上线真实问题 - **上线问题记录**`KB_广联/上线问题记录.md` — 仅记录已上线真实问题
- **未决问题清单**`KB_广联/未决问题清单.md` — 仅记录待确认事项 - **未决问题清单**`KB_广联/未决问题清单.md` — 仅记录待确认事项
- **C/E 类诊断顺序**:上线问题记录 → 未决问题清单 → Issue Ledger → 操作特例 → 升级判断 - **C/E 类诊断顺序**:上线问题记录 → 未决问题清单 → Issue Ledger → 操作特例 → 升级判断
...@@ -91,7 +103,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威 ...@@ -91,7 +103,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威
**执行步骤** **执行步骤**
1. 停止输出,走替代流程 1. 停止输出,走替代流程
2.三层KB:项目KB → SC KB → SA KB,找对应Fiori App / SSCUI 2.四层KB:项目KB → SC KB → CDS Key User KB → SA KB,找对应Fiori App / SSCUI
3. KB命中 → 用KB里的Fiori App名作答,**绝不**输出OP事务码 3. KB命中 → 用KB里的Fiori App名作答,**绝不**输出OP事务码
4. KB未命中 → 给云端等价做法 4. KB未命中 → 给云端等价做法
5. 若无法确认 → 默认OP,明确说明"公有云不适用" 5. 若无法确认 → 默认OP,明确说明"公有云不适用"
...@@ -111,7 +123,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威 ...@@ -111,7 +123,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威
**输出格式** **输出格式**
``` ```
模式:[A/B/C/D/E] | 知识层:[项目KB/SC Base/SA KB] | 任务:[问题描述] 模式:[A/B/C/D/E] | 知识层:[项目KB/SC Base/CDS Key User/SA KB] | 任务:[问题描述]
``` ```
--- ---
...@@ -190,7 +202,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威 ...@@ -190,7 +202,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威
**执行步骤**(按顺序,不可跳步): **执行步骤**(按顺序,不可跳步):
1. **查上线问题**:先查 `KB_广联/上线问题记录.md` 1. **查上线问题**:先查 `KB_广联/上线问题记录.md`
2. **查未决问题**:再查 `KB_广联/未决问题清单.md` 2. **查未决问题**:再查 `KB_广联/未决问题清单.md`
3. **查 Issue Ledger**:再查同级独立目录 `Issue_Ledger/` 3. **查 Issue Ledger**:再查同级独立目录 `ledgers/`
4. **查操作特例**:再查 `KB_广联/操作特例_[模块].md` 4. **查操作特例**:再查 `KB_广联/操作特例_[模块].md`
5. **升级判断**:KB未覆盖 → 升级给顾问/项目经理 5. **升级判断**:KB未覆盖 → 升级给顾问/项目经理
...@@ -389,7 +401,7 @@ SAP触点:[触发条件 + SAP侧输入/输出 + 替代步骤 + 异常处理] ...@@ -389,7 +401,7 @@ SAP触点:[触发条件 + SAP侧输入/输出 + 替代步骤 + 异常处理]
**输出格式** **输出格式**
``` ```
诊断完成。是否将本次诊断记录回写到 Issue Ledger? 诊断完成。是否将本次诊断记录回写到 Issue Ledger?
- 是 → 写入 `Issue_Ledger/YYYYMMDD_[模块]_[序号]_[简述].md` - 是 → 写入 `ledgers/YYYYMMDD_[模块]_[序号]_[简述].md`
- 否:仅本次Session有效 - 否:仅本次Session有效
``` ```
...@@ -457,4 +469,4 @@ SAP触点:[触发条件 + SAP侧输入/输出 + 替代步骤 + 异常处理] ...@@ -457,4 +469,4 @@ SAP触点:[触发条件 + SAP侧输入/输出 + 替代步骤 + 异常处理]
--- ---
*AGENTS.md v1.5 | 2026-07-09 | 广联智通 SAP 项目 | 审计v4.0整改落地版* *AGENTS.md v1.6 | 2026-07-21 | 广联智通 SAP 项目 | 新增 CDS Key User KB 层*
# KB_00 广联智通项目KB导航图 # KB_00 广联智通项目KB导航图
> **load_policy: ALWAYS**(常驻context,不依赖RAG) > **load_policy: ALWAYS**(常驻context,不依赖RAG)
> **作用**:层路由、冲突裁决、回答红线 > **作用**:层路由、冲突裁决、回答红线
--- ---
## 一、层KB架构 ## 一、层KB架构
``` ```
┌─────────────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────────────┐
│ 客户业务需求(自然语言) │ │ 客户业务需求(自然语言) │
│ ├── 是项目专属问题?────────────────→ 【项目KB】(最高权威) │ │ ├── 是项目专属问题?────────────────→ 【项目KB】(最高权威) │
│ ├── 是标准操作问题?────────────────→ SC Base KB │ │ ├── 是标准操作问题?────────────────→ SC Base KB │
│ ├── 是CDS视图查询?──────────────────→ CDS Key User KB │
│ └── 是功能边界问题?────────────────→ SA KB │ │ └── 是功能边界问题?────────────────→ SA KB │
└─────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────┘
``` ```
...@@ -32,7 +33,7 @@ ...@@ -32,7 +33,7 @@
| `集成约定.md` (~7K) | 集成 | 系统集成触点、接口清单 | 📖 按需检索 | | `集成约定.md` (~7K) | 集成 | 系统集成触点、接口清单 | 📖 按需检索 |
| `上线问题记录.md` (~1K) | 问题 | 上线后真实问题及解法 | 🔍 问题触发时查 | | `上线问题记录.md` (~1K) | 问题 | 上线后真实问题及解法 | 🔍 问题触发时查 |
| `未决问题清单.md` (~4K) | 待办 | 未决问题、待确认事项 | 🔍 诊断时查 | | `未决问题清单.md` (~4K) | 待办 | 未决问题、待确认事项 | 🔍 诊断时查 |
| `Issue_Ledger/` | 问题闭环 | 与 `KB_广联/` 同级的独立 Issue Ledger,一问题一文件 | 🔍 C/E类诊断时查 | | `ledgers/` | 问题闭环 | 与 `KB_广联/` 同级的独立 Issue Ledger,一问题一文件 | 🔍 C/E类诊断时查 |
--- ---
...@@ -48,7 +49,8 @@ ...@@ -48,7 +49,8 @@
| MM采购仓储问题 | `操作特例_MM_采购仓储.md` | 采购/收货/库存/委外 | | MM采购仓储问题 | `操作特例_MM_采购仓储.md` | 采购/收货/库存/委外 |
| PP/QM生产质量问题 | `操作特例_PP_QM_生产质量.md` | 生产/质检/报工/BOM | | PP/QM生产质量问题 | `操作特例_PP_QM_生产质量.md` | 生产/质检/报工/BOM |
| 接口/集成问题 | `集成约定.md` | 接口/同步/集成/MES/电商 | | 接口/集成问题 | `集成约定.md` | 接口/同步/集成/MES/电商 |
| 报错/故障 | `上线问题记录.md``未决问题清单.md``Issue_Ledger/``操作特例_[模块].md` | 报错/异常/故障/问题 | | CDS视图查找 | `knowledge-base/KB_Cds_User/CDS_KeyUser_概览.md` | CDS视图/I_/C_/字段查询 |
| 报错/故障 | `上线问题记录.md``未决问题清单.md``ledgers/``操作特例_[模块].md` | 报错/异常/故障/问题 |
| 待确认事项 | `未决问题清单.md` | 待确认/未决/待办 | | 待确认事项 | `未决问题清单.md` | 待确认/未决/待办 |
--- ---
...@@ -60,6 +62,7 @@ ...@@ -60,6 +62,7 @@
| 项目KB vs SC Base KB | 项目KB优先(客户特例覆盖标准默认) | | 项目KB vs SC Base KB | 项目KB优先(客户特例覆盖标准默认) |
| 项目KB vs SA KB | 分工不同:项目KB装操作特例,SA KB装功能边界 | | 项目KB vs SA KB | 分工不同:项目KB装操作特例,SA KB装功能边界 |
| SC Base KB vs SA KB | SC装"怎么配/怎么跑",SA装"支不支持/选哪个" | | SC Base KB vs SA KB | SC装"怎么配/怎么跑",SA装"支不支持/选哪个" |
| CDS Key User KB 与其他层 | CDS KB 仅做视图参考,不做操作/配置判断 |
| 官方步骤正确性矛盾 | 标出冲突,由顾问判断,不自动采用任一方 | | 官方步骤正确性矛盾 | 标出冲突,由顾问判断,不自动采用任一方 |
--- ---
...@@ -87,4 +90,4 @@ ...@@ -87,4 +90,4 @@
--- ---
*KB_00 广联智通项目KB导航图 v1.2 | 2026-07-08* *KB_00 广联智通项目KB导航图 v1.3 | 2026-07-21 | 新增 CDS Key User KB 层*
This source diff could not be displayed because it is too large. You can view the blob instead.
This source diff could not be displayed because it is too large. You can view the blob instead.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
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