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