Align SAP KB agent runtime governance

AGENTS.md

@@ -57,8 +57,13 @@ Key systems integrated with SAP (see `99接口文档/` for specs):
 | 顺序 | 文件路径 | 职责 |
 |------|---------|------|
 | 1 | `客户项目KB_知行科技/KB_SystemPrompt_项目KB.md` | 客户专属规则：四步诊断法、行为红线、双输出格式、Issue Ledger闭环 |
-| 2 | `KB_SA/SYSTEM_PROMPT_Agent1_v1.67.md` | 产品选型规范：Scope Item两步法、格式守卫、跨域校验 |
-| 3 | `KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md` | 操作执行规范：Fiori操作、系统探索、异常处理 |
+| 2 | `客户项目KB_知行科技/KB_00_知行项目_Navigation_Map.md` | 项目KB导航、项目红线与 Issue Ledger 入口 |
+| 3 | `KB_SA/SYSTEM_PROMPT_Agent1_v1.67.md` | 产品选型规范：Scope Item两步法、格式守卫、跨域校验 |
+| 4 | `KB_SA/KB_00_Navigation_Map.md` | SA KB 的强制导航入口 |
+| 5 | `KB_SC/PROMPT_SC_Agent_Runtime_v2.2.md` | 操作执行规范：Fiori操作、系统探索、异常处理 |
+| 6 | `KB_SC/KB_00_SC_Navigation_Map.md` | SC KB 的强制导航入口 |
+
+**强制性**：步骤 1～6 必须在任何路由、检索、回答或操作前完成；不得跳过导航文件，也不得以 RAG 命中替代必读导航文件。系统 Prompt 的职责冲突时，以项目 Prompt 的客户规则为先，并按其规定的项目KB ＞ 蓝图决策 ＞ SC Base KB ＞ SA KB 处理。
 
 ### 明确不在实施范围
 
@@ -91,13 +96,13 @@ EWM · LIMS · APS · 金税数电票五期 · 质量通知单SAP内审批流
 
 ### 项目KB（知行汽车科技）
 
-**KB 文件目录**：`客户项目KB_知行科技/`（47 个 Markdown 文件，重建于 2026-07-02，基于 02/04/05/06/08/99 全量文档提取；含验收与 Issue Ledger 治理文件）
+**KB 文件目录**：`客户项目KB_知行科技/`（34 个 Markdown 文件，重建于 2026-07-02，基于 02/04/05/06/08/99 全量文档提取；Issue Ledger 已作为仓库级独立治理对象维护）
 
-**System Prompt**：`客户项目KB_知行科技/KB_SystemPrompt_项目KB.md v2.2（含请求分类+AskUserQuestion场景确认门+四步诊断法+双输出格式+生产确认规则+Issue Ledger闭环+Cloud Guard+禁止话术）`
+**System Prompt**：`客户项目KB_知行科技/KB_SystemPrompt_项目KB.md v2.3（含请求分类+场景确认门+四步诊断法+双输出格式+SAP写操作确认规则+Issue Ledger闭环+Cloud Guard+禁止话术）`
 
 **项目导航入口**：`客户项目KB_知行科技/KB_00_知行项目_Navigation_Map.md`
 
-**Issue Ledger**：`客户项目KB_知行科技/issues/`（`ISS-ZX-*.md`），宪法 `客户项目KB_知行科技/list-config.md`
+**Issue Ledger**：`issue-ledger/`（`ISS-ZX-*.md`），作为与项目KB并列的独立治理对象；宪法 `issue-ledger/list-config.md`
 
 #### 项目KB内容
 
@@ -111,21 +116,21 @@ EWM · LIMS · APS · 金税数电票五期 · 质量通知单SAP内审批流
 | `未决问题清单.md` | — | 25项已全部闭环（6系统边界+10生产+3财务+6业务） |
 | `上线问题记录.md` | — | 22条上线问题（嘉兴14+温州3+通用5），含状态标记 |
 | `KB_00_知行项目_Navigation_Map.md` | — | 项目KB自解释导航入口（文件清单、路由、红线、Issue Ledger入口） |
-| `list-config.md` | — | Issue Ledger宪法（schema、词表、checklist） |
-| `issues/ISS-ZX-*.md` | — | 12个Issue对象（11个已验证闭环问题 + 1个财务报表待补充问题） |
+| `issue-ledger/list-config.md` | — | 仓库级 Issue Ledger 宪法（schema、词表、checklist） |
+| `issue-ledger/ISS-ZX-*.md` | — | 12个仓库级 Issue 对象（11个已验证闭环问题 + 1个财务报表待补充问题） |
 
 #### Issue Ledger 操作路径
 
 | 变量 | 值 |
 |------|---|
-| `$KB` | `客户项目KB_知行科技/issues/` |
-| `$SD` | `~/.config/opencode/skills/bos-issue-ledger/scripts/` |
+| `$KB` | `issue-ledger/` |
+| `$SD` | 由当前安装的 `bos-issue-ledger` skill 解析；不得硬编码用户目录 |
 
 ```bash
 # 搜索 issue
-grep -rli "关键词" "客户项目KB_知行科技/issues/"
+grep -rli "关键词" "issue-ledger/"
 # 更新 issue（通过 bos-issue-ledger skill）
-python "$SD/update_issue.py" "$KB" --id ISS-ZX-XXX --log "诊断日志" --source "session-YYYYMMDD"
+# 先遵守本文件“BOS Skill 更新”规则，再按当前 skill 提供的 update_issue.py 命令更新 "$KB"
 ```
 
 #### 权威优先级
@@ -145,7 +150,7 @@ python "$SD/update_issue.py" "$KB" --id ISS-ZX-XXX --log "诊断日志" --source
 - 功能选型类 → 查 `KB_SA/`
 - 项目KB Agent行为规则 → 查 `KB_SystemPrompt_项目KB.md`
 - 项目KB入口/路由/红线 → 查 `KB_00_知行项目_Navigation_Map.md`
-- Issue Ledger 对象 → 查 `issues/ISS-ZX-*.md`，宪法 `list-config.md`
+- Issue Ledger 对象 → 查 `issue-ledger/ISS-ZX-*.md`，宪法 `issue-ledger/list-config.md`
 
 #### 数据来源索引
 

KB_SC/KB_REFERENCE_OPOnly_Tools.md

 # KB_REFERENCE_OPOnly_Tools — OP-Only 工具映射表
 
-> 拦截行为由 `PROMPT_SC_Agent_Runtime_v2.1.md §替代流程` 定义，本文件只提供映射数据。
+> 拦截行为由 `PROMPT_SC_Agent_Runtime_v2.2.md §替代流程` 定义，本文件只提供映射数据。
 > 来源：SC KB 扫描 + SAP Fiori Apps Library + SAP Community
 > 标记：✅=KB已覆盖 ⚠️=等价物存在但KB未收 ❌=无Cloud等价物
 

KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md → KB_SC/PROMPT_SC_Agent_Runtime_v2.2.md

@@ -201,4 +201,4 @@ SA KB（产品选型/功能边界）        ← 只读引用：判断"支不支
 
 ---
 
-*PROMPT_SC_Agent_Runtime v2.0 | 2026-06-14 | 模型无关 | 配套：KB_00_SC_Navigation_Map.md + KB_Retrieval_Guide_SC_Agent.md*
+*PROMPT_SC_Agent_Runtime v2.2 | 2026-06-26 | 模型无关 | 配套：KB_00_SC_Navigation_Map.md + KB_Retrieval_Guide_SC_Agent.md*

客户项目KB_知行科技/list-config.md → issue-ledger/list-config.md

@@ -9,7 +9,7 @@ version: 1
 today_source: system
 repo: http://118.31.18.126:9001/yexiaofeng/Imotion.git
 branch: main
-protected_path: 客户项目KB_知行科技/issues/
+protected_path: issue-ledger/
 checklists:
   # 关闭时需跑 checklist
   - id: chk-close

客户项目KB_知行科技/KB_00_知行项目_Navigation_Map.md

@@ -46,8 +46,8 @@
 | `集成约定_*.md` | 7个外围系统的接口约定与边界 |
 | `未决问题清单.md` | 25项已闭环问题的历史记录 |
 | `上线问题记录.md` | 22条上线问题与状态 |
-| `issues/ISS-ZX-*.md` | Issue Ledger 对象，售后问题闭环 |
-| `list-config.md` | Issue Ledger 宪法（schema、词表、checklist） |
+| `../issue-ledger/ISS-ZX-*.md` | 仓库级 Issue Ledger 对象，售后问题闭环 |
+| `../issue-ledger/list-config.md` | 仓库级 Issue Ledger 宪法（schema、词表、checklist） |
 | `KB_验收题库_知行项目.md` | 20题验收题库（含陷阱/反向陷阱/边界/场景/模块覆盖） |
 | `ai_answer_sheet.md` + `scoring_matrix.csv` | 当前验收答题卡与评分矩阵 |
 
@@ -62,7 +62,7 @@
 | 标准操作步骤 | `KB_SC/` | 项目 KB 只补客户差异 |
 | 产品能力/Scope Item选型 | `KB_SA/` | 不从项目 KB 判断 |
 | 集成边界 | `集成约定_*.md` | 只回答 SAP 侧和触发/升级条件 |
-| 售后异常 | `上线问题记录.md` → `issues/` → Issue Ledger | 顾问确认后回写 |
+| 售后异常 | `上线问题记录.md` → `../issue-ledger/` → Issue Ledger | 顾问确认后回写 |
 
 ---
 
@@ -88,9 +88,9 @@
 
 ## 7. Issue Ledger 入口
 
-- **目录**：`客户项目KB_知行科技/issues/`
+- **目录**：`../issue-ledger/`（仓库根目录，与项目KB并列）
 - **文件命名**：`ISS-ZX-{3位序号}.md`
-- **宪法**：`客户项目KB_知行科技/list-config.md`
+- **宪法**：`../issue-ledger/list-config.md`
 - **推荐工具**：`bos-issue-ledger` skill
 - **Owner**：叶小锋（帛丝云商项目经理）
 - **当前规模**：12个 issue（11个已验证闭环问题 + 1个财务报表待补充问题）
@@ -100,7 +100,7 @@
 ## 8. 正式推广门槛
 
 - [x] 项目级导航文件已就位（本文件）
-- [x] Issue Ledger schema 一致（ISS-ZX-### / sap_status / acceptance / checklist）
+- [x] 独立 Issue Ledger schema 一致（仓库级 `issue-ledger/`；ISS-ZX-### / sap_status / acceptance / checklist）
 - [x] AGENTS.md 已同步最新文件数与 System Prompt 版本
 - [x] 双轮独立验收已执行并记录 `ai_answer_sheet.md` / `scoring_matrix.csv`（优先双模型；当前仓内保留两轮独立回答留痕）
 - [ ] 长文件拆分（可选，不阻断）

客户项目KB_知行科技/KB_SystemPrompt_项目KB.md

@@ -2,7 +2,7 @@
 
 > 依据《KB建设方法论指导书 v1.0》原则五设计。
 > 用途：定义 AI 使用项目KB时的行为规则、问题路由和边界。
-> 版本：v2.2 | 2026-07-02 | 变更：新增§三(AskUserQuestion场景确认门)、§五.5(边界判断优先表)、§六.3(C/E类诊断模板)、§七.5(Issue运行时操作命令)
+> 版本：v2.3 | 2026-07-11 | 变更：补齐统一加载链、场景确认回退、全 SAP 写操作确认门与独立 Issue Ledger 路径。
 
 ---
 
@@ -31,7 +31,7 @@ SC Base KB（官方怎么配/怎么跑，永远在）
 
 ### Cloud Guard 继承（公有云禁令）
 
-本 Agent 运行在 SAP S/4HANA Cloud Public Edition 环境，**必须继承** SC Base KB 的公有云拦截规则（`KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md §1.4`）：
+本 Agent 运行在 SAP S/4HANA Cloud Public Edition 环境，**必须继承** SC Base KB 的公有云拦截规则（`KB_SC/PROMPT_SC_Agent_Runtime_v2.2.md §1.4`）：
 
 - ❌ 禁止：SE16N/SE11/SE16（表浏览）、SPRO/IMG（配置）、SM30/SM31（表维护）、经典GUI事务、ABAP/Z开发、直连底表
 - ✅ 替代：Fiori App → SSCUI（Manage Your Solution）→ View Browser → Application Jobs
@@ -74,11 +74,11 @@ SC Base KB（官方怎么配/怎么跑，永远在）
 | 配置/RICEFW类 | 标记"定制开发不在项目KB范围"，给排查路径 | — |
 | 标准功能Bug | 标记"标准功能问题建议查SAP Note或开客户事件"，不推断 | — |
 
-**AskUserQuestion 场景确认门**：在进入 Step 2 之前，必须调用 AskUserQuestion 工具确认场景：
+**场景确认门**：在进入 Step 2 之前，必须确认场景。当前环境提供 AskUserQuestion 时优先调用；工具不可用时，直接用一句澄清问题确认，不得因工具不可用跳过确认：
 
 1. 问题来源是"顾问自己内部了解/分析"还是"需要响应客户"？
 2. 有客户时，进一步确认子类型：是"先提出问题（获取更多信息）"还是"给出解决方案"？
-3. **简化规则**：顾问已写明"客户反映""帮我回复"→ 视为有客户，仅需确认子类型；顾问已写明"我想了解""内部分析"→ 视为内部，跳过 AskUserQuestion，直接给出技术分析
+3. **简化规则**：顾问已写明"客户反映""帮我回复"→ 视为有客户，仅需确认子类型；顾问已写明"我想了解""内部分析"→ 视为内部，可直接给出技术分析
 
 确认后，按 §六 双输出格式的对应子格式输出。
 
@@ -189,17 +189,17 @@ SC Base KB（官方怎么配/怎么跑，永远在）
 6. **返工处理**：返工单在MES手工做单，报工时按实际工序组合记录，成本进对应工单
 7. 以上规则如与Base KB冲突 → **以项目KB为准**，并标注"本客户特例"
 
-### 5.4b 生产写操作确认门
+### 5.4b SAP 写操作确认门
 
-涉及生产系统写操作时，必须执行以下确认门：
+凡涉及 SAP 业务数据写操作（包括生产、采购、销售、库存、财务及配置相关写操作）时，必须执行以下确认门：
 
 | 操作类型 | 确认要求 |
 |---------|---------|
-| 创建/修改工单、PR、PO、SO、交货单、发票 | 必须确认系统环境（生产/测试），取得用户明确文字确认后方可执行 |
-| 批量更新、财务过账 | 必须用户二次确认，并在双输出格式B中记录确认人 |
+| 创建/修改工单、PR、PO、SO、交货单、发票 | D/T 系统须确认目标环境与用户授权；P 系统须取得用户明确文字确认后方可执行 |
+| 批量更新、财务过账 | D/T 系统须用户二次确认；P 系统须用户二次确认并在双输出格式B中记录确认人 |
 | 接口触发（MES/WMS/银企直连） | 仅输出接口触发条件（项目KB集成约定），不直接触发 |
 | 配置变更（SSCUI） | 标记"配置变更需SAP Basis或项目负责人操作"，不代为执行 |
-| 涉及D/T/P系统（开发/测试/生产） | 必须明确当前操作目标系统，**生产系统未经明确文字确认不得执行任何写操作** |
+| 涉及D/T/P系统（开发/测试/生产） | 必须明确当前操作目标系统；**生产系统未经明确文字确认不得执行任何写操作** |
 
 ### 5.5 边界判断优先于执行
 
@@ -338,13 +338,13 @@ Issue Ledger 的物理落盘位置和工作流：
 
 | 项 | 内容 |
 |----|------|
-| **目录** | `客户项目KB_知行科技/issues/` |
+| **目录** | `issue-ledger/`（与 `客户项目KB_知行科技/` 并列） |
 | **文件命名** | `ISS-ZX-{3位序号}.md`（例：`ISS-ZX-013.md`） |
-| **宪法** | `客户项目KB_知行科技/list-config.md` |
-| **工具依赖** | 推荐使用 `bos-issue-ledger` skill（`~/.config/opencode/skills/bos-issue-ledger/`）管理生命周期 |
-| **手动备选** | 直接创建 `客户项目KB_知行科技/issues/ISS-ZX-XXX.md`，按 §7.2 模板与 `list-config.md` 词表填写 |
-| **关闭确认** | 状态转到 `sap_status=已完成` 时触发 `list-config.md` 中的 checklist；人工确认信号通过 `escalate_sa=true` 或 checklist 答案记录 |
-| **git hook** | 每次 Issue 变更后执行 `git add 客户项目KB_知行科技/issues/ && git commit -m "Issue ISS-ZX-XXX: 状态变更"` |
+| **宪法** | `issue-ledger/list-config.md` |
+| **工具依赖** | 推荐使用 `bos-issue-ledger` skill 管理生命周期；读取或执行该 skill 前必须遵守根 `AGENTS.md` 的 BOS Skill 更新规则，并使用该 skill 当前安装路径提供的脚本 |
+| **手动备选** | 直接创建 `issue-ledger/ISS-ZX-XXX.md`，按 §7.2 模板与 `issue-ledger/list-config.md` 词表填写 |
+| **关闭确认** | 状态转到 `sap_status=已完成` 时触发 `issue-ledger/list-config.md` 中的 checklist；涉及人工确认的事项，须在 checklist 答案或 append-only 日志中记录确认人和日期 |
+| **git hook** | 每次 Issue 变更后执行 `git add issue-ledger/ && git commit -m "Issue ISS-ZX-XXX: 状态变更"` |
 
 ### 7.5 Issue 运行时操作命令
 
@@ -352,20 +352,13 @@ C/E 类诊断时按以下流程操作：
 
 **Step 1 — 搜索已有 Issue：**
 ```bash
-grep -rli "关键词" "客户项目KB_知行科技/issues/"
+grep -rli "关键词" "issue-ledger/"
 ```
 命中 → 输出 `【关联Issue】ISS-ZX-XXX（状态/最新进展）`
 未命中 → 标注"未命中，建议新建"或"无需记录"
 
 **Step 2 — 诊断后回写（顾问确认后执行）：**
-```bash
-python ~/.config/opencode/skills/bos-issue-ledger/scripts/update_issue.py \
-  客户项目KB_知行科技/issues/ \
-  --id ISS-ZX-XXX \
-  --log "诊断结论：..." \
-  --source "session-YYYYMMDD"
-```
-（`$KB`、`$SD` 变量见 AGENTS.md）
+先执行根 `AGENTS.md` 要求的 BOS Skill 更新；再按当前 `bos-issue-ledger` skill 提供的 `update_issue.py` 调用方式回写，目标根目录必须为 `issue-ledger/`，并传入 `--id ISS-ZX-XXX`、`--log "诊断结论：..."` 与 `--source "session-YYYYMMDD"`。不得复制其他运行环境的用户目录。
 
 **Step 3 — 拟写日志征求顾问意见：**
 > "本次诊断已关联 ISS-ZX-XXX，是否回写进展？拟写入日志：`[提炼后的日志]`"
@@ -388,8 +381,8 @@ python ~/.config/opencode/skills/bos-issue-ledger/scripts/update_issue.py \
 | `项目_系统架构与限制.md` | BTP架构、系统限制清单、上线转移方案 |
 | `KB_验收题库_知行项目.md` | 项目KB验收测试题库 |
 | `KB_00_知行项目_Navigation_Map.md` | 项目KB自解释导航入口 |
-| `list-config.md` | Issue Ledger 宪法（schema、词表、checklist） |
-| `issues/ISS-ZX-*.md` | Issue Ledger 问题对象 |
+| `issue-ledger/list-config.md` | 仓库级 Issue Ledger 宪法（schema、词表、checklist） |
+| `issue-ledger/ISS-ZX-*.md` | 仓库级 Issue Ledger 问题对象 |
 
 ---
 
@@ -404,4 +397,4 @@ python ~/.config/opencode/skills/bos-issue-ledger/scripts/update_issue.py \
 
 ---
 
-*KB System Prompt — 知行汽车科技 项目KB v2.2 | 2026-07-02 | 变更：新增§三(AskUserQuestion场景确认门)、§五.5(边界判断优先表)、§六.3(C/E类诊断模板)、§七.5(Issue运行时操作命令)；改进参考RefAgent差距分析*
\ No newline at end of file
+*KB System Prompt — 知行汽车科技 项目KB v2.3 | 2026-07-11 | 变更：补齐统一加载链、场景确认回退、全 SAP 写操作确认门与独立 Issue Ledger 路径。*