ilink-approve

你现在执行 iLink 的 审核通过（Human-Gate 推进 + Coach 协作复盘） 操作。

本命令自 v1.6.0 起为 Slash Command（不再是 shell 脚本），内部串行执行：校验前置 → 调用 Coach 子流程 → 写入 feedback.md → 推进 Status。Coach 子流程详见 iLink/iLink-root-spec.md §4.7 与 iLink/souls/coach.soul.md。

执行任务

在 Story $ARGUMENTS 中找到处于 STAGING 状态的文档，先执行 Coach 子流程，再将其推进到下一阶段。

---

步骤 1：确认 Story 存在

检查 iLink-doc/$ARGUMENTS/ 目录是否存在，不存在则提示用户先执行 /ilink-init $ARGUMENTS，结束。

步骤 2：按优先级查找 STAGING 文档

依次读取以下文件末尾的 Metadata Status，确定本次 approve 的目标文档：

优先级	文档	STAGING 时的目标状态	后续命令
1	$ARGUMENTS-review.master.md	不能自动推进（上游根因）	告知用户查看 [UPSTREAM_BLOCKERS]，与 Designer 讨论修改设计或修改需求定义后结束
2	$ARGUMENTS-design.master.md	PENDING_CODER	/ilink-coder $ARGUMENTS
3	$ARGUMENTS-pm.master.md	PENDING_DESIGNER	/ilink-design $ARGUMENTS

如果没有找到 STAGING 文档，告知用户当前没有需要审核的文档，建议执行 /ilink-status $ARGUMENTS 查看详细状态后结束。

注意：QA review 文档处于 STAGING（上游根因）时 SHALL NOT 推进 Status，但 Coach 子流程仍 MUST 执行（评估的是这一轮人类与 AI 的协作，与 Status 是否推进无关）。

---

步骤 3：调用 Coach 子流程

读取 iLink/souls/coach.soul.md（Coach 角色规范）。

3.1 摘录对话 bracket

按以下规则在当前 Host CLI 主对话中识别 bracket：

• 外层窗口起点：本 Story 的 /ilink-pm $ARGUMENTS 命令完成之后的第一个人类 turn
• 外层窗口终点：本次 /ilink-approve $ARGUMENTS 调用之前的最后一个人类 turn
• 内部分界：外层内的 /ilink-design $ARGUMENTS slash 调用 turn

逐 turn 摘录原文，标注格式：

[turn-1] (user)
<原文>

[turn-2] (assistant)
<原文>

...

[--- /ilink-design 分界 ---]

[turn-N] (user)
...

SHALL NOT 改写、概括或选择性剔除任何 turn 的内容。

3.2 计算直接编辑 diff

• 列出 iLink-doc/$ARGUMENTS/.snapshots/ 目录下所有 design.master.*.md 文件
• 选择最新的快照（按文件名时间戳降序取第一个）
• 使用 diff -u <最新快照> iLink-doc/$ARGUMENTS/$ARGUMENTS-design.master.md 生成 unified diff
• 若 .snapshots/ 目录不存在或为空，记录"无法判定直接编辑（缺少 design 快照）"

若本次目标是 PM 文档（步骤 2 命中优先级 3），跳过 3.2，直接编辑段记为"本段无直接编辑（PM 文档不做编辑检测）"。

3.3 调用 subagent

通过 Agent 工具（general-purpose 类型）调用 subagent，传入以下 bundle（SHALL NOT 传入 master doc、requirement.md、源码）：