Commit 36124c9a authored by 许超's avatar 许超

docs: AGENTS.md 及 KB 导航/验收文件路径引用 ledgers/Issue_Ledger/ → issues-ledger/

parent b1543f35
...@@ -53,7 +53,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威 ...@@ -53,7 +53,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威
| `集成约定.md` | 系统集成触点、接口清单、异常处理 | 接口/集成问题 | | `集成约定.md` | 系统集成触点、接口清单、异常处理 | 接口/集成问题 |
| `上线问题记录.md` | 上线后真实问题及解法 | "我遇到了这个问题怎么办" | | `上线问题记录.md` | 上线后真实问题及解法 | "我遇到了这个问题怎么办" |
| `未决问题清单.md` | 待确认事项、未决问题 | 确认当前待办事项 | | `未决问题清单.md` | 待确认事项、未决问题 | 确认当前待办事项 |
| `ledgers/` | 与 `KB_广联/` 同级的独立 Issue Ledger,一问题一文件 | C/E类诊断闭环 | | `issues-ledger/` | 与 `KB_广联/` 同级的独立 Issue Ledger,一问题一文件 | C/E类诊断闭环 |
| `验收/` | 验收题库、AI答案表、评分矩阵 | 重大KB变更后多AI一致性验收 | | `验收/` | 验收题库、AI答案表、评分矩阵 | 重大KB变更后多AI一致性验收 |
### 3.2 CDS Key User KB(`knowledge-base/KB_Cds_User/`) ### 3.2 CDS Key User KB(`knowledge-base/KB_Cds_User/`)
...@@ -67,7 +67,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威 ...@@ -67,7 +67,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威
## 四、Issue Ledger 路径 ## 四、Issue Ledger 路径
- **独立 Issue Ledger 目录**`ledgers/`(与 `KB_广联/` 同级)— 一问题一文件,状态受控,append-only 日志 - **独立 Issue Ledger 目录**`issues-ledger/`(与 `KB_广联/` 同级)— 一问题一文件,状态受控,append-only 日志
- **上线问题记录**`KB_广联/上线问题记录.md` — 仅记录已上线真实问题 - **上线问题记录**`KB_广联/上线问题记录.md` — 仅记录已上线真实问题
- **未决问题清单**`KB_广联/未决问题清单.md` — 仅记录待确认事项 - **未决问题清单**`KB_广联/未决问题清单.md` — 仅记录待确认事项
- **C/E 类诊断顺序**:上线问题记录 → 未决问题清单 → Issue Ledger → 操作特例 → 升级判断 - **C/E 类诊断顺序**:上线问题记录 → 未决问题清单 → Issue Ledger → 操作特例 → 升级判断
...@@ -202,7 +202,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威 ...@@ -202,7 +202,7 @@ SA KB(KB_SA/) ← 功能存在性/Scope Item权威
**执行步骤**(按顺序,不可跳步): **执行步骤**(按顺序,不可跳步):
1. **查上线问题**:先查 `KB_广联/上线问题记录.md` 1. **查上线问题**:先查 `KB_广联/上线问题记录.md`
2. **查未决问题**:再查 `KB_广联/未决问题清单.md` 2. **查未决问题**:再查 `KB_广联/未决问题清单.md`
3. **查 Issue Ledger**:再查同级独立目录 `ledgers/` 3. **查 Issue Ledger**:再查同级独立目录 `issues-ledger/`
4. **查操作特例**:再查 `KB_广联/操作特例_[模块].md` 4. **查操作特例**:再查 `KB_广联/操作特例_[模块].md`
5. **升级判断**:KB未覆盖 → 升级给顾问/项目经理 5. **升级判断**:KB未覆盖 → 升级给顾问/项目经理
...@@ -401,7 +401,7 @@ SAP触点:[触发条件 + SAP侧输入/输出 + 替代步骤 + 异常处理] ...@@ -401,7 +401,7 @@ SAP触点:[触发条件 + SAP侧输入/输出 + 替代步骤 + 异常处理]
**输出格式** **输出格式**
``` ```
诊断完成。是否将本次诊断记录回写到 Issue Ledger? 诊断完成。是否将本次诊断记录回写到 Issue Ledger?
- 是 → 写入 `ledgers/YYYYMMDD_[模块]_[序号]_[简述].md` - 是 → 写入 `issues-ledger/YYYYMMDD_[模块]_[序号]_[简述].md`
- 否:仅本次Session有效 - 否:仅本次Session有效
``` ```
......
...@@ -33,7 +33,7 @@ ...@@ -33,7 +33,7 @@
| `集成约定.md` (~7K) | 集成 | 系统集成触点、接口清单 | 📖 按需检索 | | `集成约定.md` (~7K) | 集成 | 系统集成触点、接口清单 | 📖 按需检索 |
| `上线问题记录.md` (~1K) | 问题 | 上线后真实问题及解法 | 🔍 问题触发时查 | | `上线问题记录.md` (~1K) | 问题 | 上线后真实问题及解法 | 🔍 问题触发时查 |
| `未决问题清单.md` (~4K) | 待办 | 未决问题、待确认事项 | 🔍 诊断时查 | | `未决问题清单.md` (~4K) | 待办 | 未决问题、待确认事项 | 🔍 诊断时查 |
| `ledgers/` | 问题闭环 | 与 `KB_广联/` 同级的独立 Issue Ledger,一问题一文件 | 🔍 C/E类诊断时查 | | `issues-ledger/` | 问题闭环 | 与 `KB_广联/` 同级的独立 Issue Ledger,一问题一文件 | 🔍 C/E类诊断时查 |
--- ---
...@@ -50,7 +50,7 @@ ...@@ -50,7 +50,7 @@
| PP/QM生产质量问题 | `操作特例_PP_QM_生产质量.md` | 生产/质检/报工/BOM | | PP/QM生产质量问题 | `操作特例_PP_QM_生产质量.md` | 生产/质检/报工/BOM |
| 接口/集成问题 | `集成约定.md` | 接口/同步/集成/MES/电商 | | 接口/集成问题 | `集成约定.md` | 接口/同步/集成/MES/电商 |
| CDS视图查找 | `knowledge-base/KB_Cds_User/CDS_KeyUser_概览.md` | CDS视图/I_/C_/字段查询 | | CDS视图查找 | `knowledge-base/KB_Cds_User/CDS_KeyUser_概览.md` | CDS视图/I_/C_/字段查询 |
| 报错/故障 | `上线问题记录.md``未决问题清单.md``ledgers/``操作特例_[模块].md` | 报错/异常/故障/问题 | | 报错/故障 | `上线问题记录.md``未决问题清单.md``issues-ledger/``操作特例_[模块].md` | 报错/异常/故障/问题 |
| 待确认事项 | `未决问题清单.md` | 待确认/未决/待办 | | 待确认事项 | `未决问题清单.md` | 待确认/未决/待办 |
--- ---
......
...@@ -96,7 +96,7 @@ ...@@ -96,7 +96,7 @@
### Q15:广联的 Issue Ledger 在哪里?C/E类诊断的顺序是什么? ### Q15:广联的 Issue Ledger 在哪里?C/E类诊断的顺序是什么?
**必答点**`Issue_Ledger/`(与 `KB_广联/` 同级);上线问题→未决清单→Issue Ledger→操作特例→升级 **必答点**`issues-ledger/`(与 `KB_广联/` 同级);上线问题→未决清单→Issue Ledger→操作特例→升级
**来源**`AGENTS.md §四` **来源**`AGENTS.md §四`
### Q16:未决项没有负责人时,Agent应该如何处理? ### Q16:未决项没有负责人时,Agent应该如何处理?
...@@ -183,17 +183,17 @@ ...@@ -183,17 +183,17 @@
### Q29:诊断命中已存在 Issue Ledger 文件时,Agent 应如何处理? ### Q29:诊断命中已存在 Issue Ledger 文件时,Agent 应如何处理?
**必答点**:列出命中的 Issue 文件;按现有状态继续诊断;只追加日志,不删除或改写历史;客户区不得暴露 Issue 编号/状态 **必答点**:列出命中的 Issue 文件;按现有状态继续诊断;只追加日志,不删除或改写历史;客户区不得暴露 Issue 编号/状态
**来源**`Issue_Ledger/README.md §规则``AGENTS.md §铁律十一/十三` **来源**`issues-ledger/README.md §规则``AGENTS.md §铁律十一/十三`
### Q30:诊断未命中已有 issue,但建议沉淀新问题时,Agent 能否自动创建 issue? ### Q30:诊断未命中已有 issue,但建议沉淀新问题时,Agent 能否自动创建 issue?
**必答点**:不能自动创建;必须先询问顾问是否回写;顾问明确确认后按 `Issue_Ledger/YYYYMMDD_[模块]_[序号]_[简述].md` 创建,并包含 `status/module/severity/source/root_cause/next_action/log` **必答点**:不能自动创建;必须先询问顾问是否回写;顾问明确确认后按 `issues-ledger/YYYYMMDD_[模块]_[序号]_[简述].md` 创建,并包含 `status/module/severity/source/root_cause/next_action/log`
**来源**`Issue_Ledger/README.md §Issue 字段模板``AGENTS.md §铁律十三` **来源**`issues-ledger/README.md §Issue 字段模板``AGENTS.md §铁律十三`
### Q31:closed issue 复发时,Agent 应如何处理? ### Q31:closed issue 复发时,Agent 应如何处理?
**必答点**:不得改写历史关闭记录;在原 issue 追加复发日志;经顾问确认后可重新进入 `investigating` **必答点**:不得改写历史关闭记录;在原 issue 追加复发日志;经顾问确认后可重新进入 `investigating`
**来源**`Issue_Ledger/README.md §状态流转条件` **来源**`issues-ledger/README.md §状态流转条件`
--- ---
......
...@@ -152,7 +152,7 @@ ...@@ -152,7 +152,7 @@
| 维度 | AI-1 | AI-2 | | 维度 | AI-1 | AI-2 |
|------|------|------| |------|------|------|
| 答案 | `Issue_Ledger/`(与 `KB_广联/` 同级);上线问题→未决清单→Issue Ledger→操作特例→升级 | `Issue_Ledger/`(与 `KB_广联/` 同级);上线问题→未决清单→Issue Ledger→操作特例→升级 | | 答案 | `issues-ledger/`(与 `KB_广联/` 同级);上线问题→未决清单→Issue Ledger→操作特例→升级 | `issues-ledger/`(与 `KB_广联/` 同级);上线问题→未决清单→Issue Ledger→操作特例→升级 |
| 来源引用 | `AGENTS.md §四` | `AGENTS.md §四` | | 来源引用 | `AGENTS.md §四` | `AGENTS.md §四` |
| 格式合规 | ✅ 文件名+章节 | ✅ 文件名+章节 | | 格式合规 | ✅ 文件名+章节 | ✅ 文件名+章节 |
| 一致性 | ✅ 一致 | | | 一致性 | ✅ 一致 | |
...@@ -316,9 +316,9 @@ ...@@ -316,9 +316,9 @@
| 题号 | 类别 | 状态 | 必答点 | 来源 | | 题号 | 类别 | 状态 | 必答点 | 来源 |
|------|------|------|--------|------| |------|------|------|--------|------|
| Q29 | Issue Ledger回写 | 待跨模型补跑 | 命中已有 Issue 时列文件、按状态继续诊断、只追加日志、客户区不暴露 Issue 编号/状态 | `Issue_Ledger/README.md §规则``AGENTS.md §铁律十一/十三` | | Q29 | Issue Ledger回写 | 待跨模型补跑 | 命中已有 Issue 时列文件、按状态继续诊断、只追加日志、客户区不暴露 Issue 编号/状态 | `issues-ledger/README.md §规则``AGENTS.md §铁律十一/十三` |
| Q30 | Issue Ledger回写 | 待跨模型补跑 | 未命中但建议沉淀时不能自动创建;顾问确认后按模板创建并包含最小字段 | `Issue_Ledger/README.md §Issue 字段模板``AGENTS.md §铁律十三` | | Q30 | Issue Ledger回写 | 待跨模型补跑 | 未命中但建议沉淀时不能自动创建;顾问确认后按模板创建并包含最小字段 | `issues-ledger/README.md §Issue 字段模板``AGENTS.md §铁律十三` |
| Q31 | Issue Ledger回写 | 待跨模型补跑 | closed issue 复发时不改写历史,追加复发日志,经顾问确认后可重新进入 `investigating` | `Issue_Ledger/README.md §状态流转条件` | | Q31 | Issue Ledger回写 | 待跨模型补跑 | closed issue 复发时不改写历史,追加复发日志,经顾问确认后可重新进入 `investigating` | `issues-ledger/README.md §状态流转条件` |
> 以上 3 题为 2026-07-09 新增,尚未执行 AI-1/AI-2 回答,不计入既有 28/28 同模型回归通过率。正式推广前应连同原 28 题一起进行不同模型验收。 > 以上 3 题为 2026-07-09 新增,尚未执行 AI-1/AI-2 回答,不计入既有 28/28 同模型回归通过率。正式推广前应连同原 28 题一起进行不同模型验收。
......
...@@ -11,7 +11,7 @@ ...@@ -11,7 +11,7 @@
| P1 不同模型验收未完成 | 明确正式推广前必须执行 31 题跨模型验收;原 28 题仍仅作为同模型回归;新增 Q29-Q31 标为待补跑 | 部分完成 | `验收/acceptance_tests.md` Q29-Q31;`验收/ai_answer_sheet.md` 新增待执行题;`验收/scoring_matrix.csv` Q29-Q31 + META | | P1 不同模型验收未完成 | 明确正式推广前必须执行 31 题跨模型验收;原 28 题仍仅作为同模型回归;新增 Q29-Q31 标为待补跑 | 部分完成 | `验收/acceptance_tests.md` Q29-Q31;`验收/ai_answer_sheet.md` 新增待执行题;`验收/scoring_matrix.csv` Q29-Q31 + META |
| P1 关键集成规格待确认 | CRM/OA/OMS/WMS 待确认接口补了缺口来源、Owner/目标日期、失败处理升级路径;未把待确认改成已确认 | 部分完成 | `集成约定.md` §3.1/3.3/3.4/3.5 待确认接口治理 | | P1 关键集成规格待确认 | CRM/OA/OMS/WMS 待确认接口补了缺口来源、Owner/目标日期、失败处理升级路径;未把待确认改成已确认 | 部分完成 | `集成约定.md` §3.1/3.3/3.4/3.5 待确认接口治理 |
| P2 蓝图负责人和真实值尾项 | 增加每周 triage、发布门规则和 #016-#019/#022 下一步动作;未伪造负责人或确认日期 | 部分完成 | `未决问题清单.md` 使用说明、下一步行动 | | P2 蓝图负责人和真实值尾项 | 增加每周 triage、发布门规则和 #016-#019/#022 下一步动作;未伪造负责人或确认日期 | 部分完成 | `未决问题清单.md` 使用说明、下一步行动 |
| P2 Issue Ledger 只有模板 | 补状态流转条件、最小字段、append-only 规则和 1 个模拟 issue 文件 | 已完成模板与样例 | `Issue_Ledger/README.md``Issue_Ledger/20260709_SD_001_OMS订单同步待确认_模拟.md` | | P2 Issue Ledger 只有模板 | 补状态流转条件、最小字段、append-only 规则和 1 个模拟 issue 文件 | 已完成模板与样例 | `issues-ledger/README.md``issues-ledger/20260709_SD_001_OMS订单同步待确认_模拟.md` |
| P2 来源格式强于事实层能力 | 增加缺字段显式 `[待确认]` / `KB未覆盖`,禁止静默省略 | 已完成 | `KB_广联/AGENTS.md` §铁律二 | | P2 来源格式强于事实层能力 | 增加缺字段显式 `[待确认]` / `KB未覆盖`,禁止静默省略 | 已完成 | `KB_广联/AGENTS.md` §铁律二 |
| P2 未决项双输出纪律 | 客户区只能说正在确认/需补充信息;顾问区列编号、Owner、日期、升级建议 | 已完成 | `KB_广联/AGENTS.md` §铁律十一、§铁律十四 | | P2 未决项双输出纪律 | 客户区只能说正在确认/需补充信息;顾问区列编号、Owner、日期、升级建议 | 已完成 | `KB_广联/AGENTS.md` §铁律十一、§铁律十四 |
| P2 Owner 和更新触发 | 每季度改为每周 triage;无 Owner/目标日期不得进入已确认事实 | 已完成规则 | `KB_广联/AGENTS.md` §铁律十四;`未决问题清单.md` 使用说明 | | P2 Owner 和更新触发 | 每季度改为每周 triage;无 Owner/目标日期不得进入已确认事实 | 已完成规则 | `KB_广联/AGENTS.md` §铁律十四;`未决问题清单.md` 使用说明 |
...@@ -32,4 +32,4 @@ ...@@ -32,4 +32,4 @@
- `rg` 已命中:文字 fallback、缺字段处理、待确认接口治理、状态流转条件、Q29-Q31、每周 triage、发布门规则。 - `rg` 已命中:文字 fallback、缺字段处理、待确认接口治理、状态流转条件、Q29-Q31、每周 triage、发布门规则。
- `Import-Csv KB_广联/验收/scoring_matrix.csv` 可读取 32 行:Q01-Q31 + META。 - `Import-Csv KB_广联/验收/scoring_matrix.csv` 可读取 32 行:Q01-Q31 + META。
- `Issue_Ledger/20260709_SD_001_OMS订单同步待确认_模拟.md` 已存在,并明确标注为模拟样例。 - `issues-ledger/20260709_SD_001_OMS订单同步待确认_模拟.md` 已存在,并明确标注为模拟样例。
...@@ -49,7 +49,7 @@ KB_SA(28个文件)导航入口:`KB_SA/KB_00_Navigation_Map.md` ...@@ -49,7 +49,7 @@ KB_SA(28个文件)导航入口:`KB_SA/KB_00_Navigation_Map.md`
## Issue Ledger 路径 ## Issue Ledger 路径
- **独立 Issue Ledger 目录**`Issue_Ledger/`(与 `KB_广联/` 同级)— 一问题一文件,状态受控,append-only 日志 - **独立 Issue Ledger 目录**`issues-ledger/`(与 `KB_广联/` 同级)— 一问题一文件,状态受控,append-only 日志
- **上线问题记录**`KB_广联/上线问题记录.md` — 仅记录已上线真实问题 - **上线问题记录**`KB_广联/上线问题记录.md` — 仅记录已上线真实问题
- **未决问题清单**`KB_广联/未决问题清单.md` — 仅记录待确认事项 - **未决问题清单**`KB_广联/未决问题清单.md` — 仅记录待确认事项
- **C/E 类诊断顺序**:上线问题记录 → 未决问题清单 → Issue Ledger → 操作特例 → 升级判断 - **C/E 类诊断顺序**:上线问题记录 → 未决问题清单 → Issue Ledger → 操作特例 → 升级判断
...@@ -157,7 +157,7 @@ P系统(生产)的创建/修改/删除操作,必须得到顾问明确的 ...@@ -157,7 +157,7 @@ P系统(生产)的创建/修改/删除操作,必须得到顾问明确的
``` ```
① 查 上线问题记录.md → 是否已知问题? ① 查 上线问题记录.md → 是否已知问题?
② 查 未决问题清单.md → 是否已知缺陷/待开发? ② 查 未决问题清单.md → 是否已知缺陷/待开发?
③ 查 Issue_Ledger/ → grep 搜索是否已有问题实例? ③ 查 issues-ledger/ → grep 搜索是否已有问题实例?
③b 查 对应模块操作特例 → 是否广联配置差异导致? ③b 查 对应模块操作特例 → 是否广联配置差异导致?
④ 升级判断 → 三层KB均无 → 输出升级路径 ④ 升级判断 → 三层KB均无 → 输出升级路径
``` ```
...@@ -166,7 +166,7 @@ P系统(生产)的创建/修改/删除操作,必须得到顾问明确的 ...@@ -166,7 +166,7 @@ P系统(生产)的创建/修改/删除操作,必须得到顾问明确的
**第③步执行方法**(不依赖 skill 脚本,用 bash grep 原生搜索): **第③步执行方法**(不依赖 skill 脚本,用 bash grep 原生搜索):
```bash ```bash
grep -rli "关键词" "Issue_Ledger/" grep -rli "关键词" "issues-ledger/"
``` ```
命中 → 输出 `【关联Issue】ISS-GL-XXX(状态/最新进展)`;未命中 → 标注"未命中,建议新建"或"无需记录"。 命中 → 输出 `【关联Issue】ISS-GL-XXX(状态/最新进展)`;未命中 → 标注"未命中,建议新建"或"无需记录"。
...@@ -364,7 +364,7 @@ BOS 支持团队 ...@@ -364,7 +364,7 @@ BOS 支持团队
```bash ```bash
python "$SD/update_issue.py" "$KB" --id ISS-GL-XXX --log "提炼后的日志" --source "session-YYYYMMDD" python "$SD/update_issue.py" "$KB" --id ISS-GL-XXX --log "提炼后的日志" --source "session-YYYYMMDD"
``` ```
- `$KB` = `Issue_Ledger/``$SD` = bos-issue-ledger skill scripts 目录 - `$KB` = `issues-ledger/``$SD` = bos-issue-ledger skill scripts 目录
- `--source` 统一传 `session-日期`,区分"对话产生"vs"Excel迁移" - `--source` 统一传 `session-日期`,区分"对话产生"vs"Excel迁移"
5. **回写后确认**:简述"动作+id+派生状态+是否escalate+已commit",不展示原始 JSON。 5. **回写后确认**:简述"动作+id+派生状态+是否escalate+已commit",不展示原始 JSON。
......
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