# 流程进化: chain 独立 apply 与 CodeGraph 分层提示

| 字段 | 内容 |
|---|---|
| 版本 | 0.1.15（本轮不 bump package；合入后由维护者 bump） |
| 日期 | 2026-07-26 |
| commit | 7c34f0a |
| MR | 待填 |
| 分支 | evolve/chain-apply-codegraph |

## 改动文件

- `prompts/kb-orchestrator.md`：新增「subagent chain 口径」——design/plan 可同 chain、禁止三合一 apply；chain 失败 exitCode 优先；stderr 非根因
- `prompts/kb-apply.md`：禁止串进 design/plan chain；门禁 `--target "$(pwd)"`；builder 每批回报 tasks、scribe 单写 manifest（被杀前尽量回写 applying+部分 done）
- `agents/kb-admin.md`：派发 apply 独立 chain；chain 失败解读口径（exitCode 优先于 stderr）
- `scripts/kb-codegraph-check.mjs`：成功 exit 前输出分层提示（索引门禁 vs MCP/bridge 工具暴露）
- `prompts/kb-design.md`：CodeGraph 门禁对齐 kb-apply §2.2（bridge `pi__codegraph_*`、CLI 降级、索引可用≠工具暴露）

## 设计取舍

- 本轮**不** bump `package.json`：流程语义仍挂在 0.1.15；合入 main 后由维护者决定是否 bump/publish。
- apply 独立 chain 旨在避免 harness SIGTERM（exit 143）误杀长链；stderr 噪声（如 figma-mcp-oauth-sync）不得冒充失败根因。
- CodeGraph 脚本只检索引；工具暴露由 Agent 按 §2.2 二次确认，避免「索引通过但工具未暴露」空转。

## Issue 处置记录

| Issue | 结论 | 说明 |
|---|---|---|
| [IK48GJ](https://gitee.com/suveng/pi-kb/issues/IK48GJ) | 采纳 | apply 禁止与 design/plan 同 chain；失败续跑/repair |
| [IK48GK](https://gitee.com/suveng/pi-kb/issues/IK48GK) | 采纳 | stderr 非 chain 根因；exitCode 优先 |
| [IK48GL](https://gitee.com/suveng/pi-kb/issues/IK48GL) | 采纳 | CodeGraph 索引 vs 工具暴露分层提示 |

## EvoMap

- 未启用（`enabled=false`）；本轮无网络检索/回传。