| name | su-resume |
| description | 从 docs 人读真相源与 .ccb 协调件恢复 paused/deferred/in-progress 主体的上下文。 |
| metadata | {"short-description":"恢复推进入口"} |
/ccb:su-resume
1. 指令意图说明
/ccb:su-resume 用于恢复上次中断、暂停或暂缓的工作。它先回答“我们停在哪里、为什么停、恢复后应该进入哪个节点”。
2. 节点集声明
恢复后可能进入任一节点:
| 节点 | Manifest |
|---|
| 需求分析 | references/kernel/nodes/requirement_analysis.node.md |
| 技术设计 | references/kernel/nodes/technical_design.node.md |
| 任务拆分 | references/kernel/nodes/task_breakdown.node.md |
| 派工 | references/kernel/nodes/dispatch.node.md |
| 实施 | references/kernel/nodes/implementation.node.md |
| 审查 | references/kernel/nodes/review.node.md |
| 归档 | references/kernel/nodes/archive.node.md |
3. 触发约定
/ccb:su-resume
/ccb:su-resume requirement_id=<id>
/ccb:su-resume task_id=<id>
如果多个进行中主体冲突,先列出候选并让用户选择;不要自动猜。
breakdown-draft read 契约
恢复停在 task_breakdown / review 门口的 Requirement 时,必须通过 lib 读取 draft:
import { readBreakdownDraft } from "../../lib/breakdown-draft/index.mjs";
const { draft, hash } = await readBreakdownDraft({ projectRoot, requirementId });
恢复逻辑只能报告 draft 状态、hash、最近 review_history 和建议节点;不得在 resume 中直接改 draft。若需要修订,进入 /ccb:su-revise-breakdown --payload {...};若需要批准,进入 /ccb:su-approve --payload {"action":"breakdown_draft_approve",...}。严禁用 fs.writeFile 直接修复 docs/.ccb/drafts/breakdown/*.json。
4. Plugin 独立运行约定
定位上下文时先读 docs/00_项目总览.md、docs/00_文档地图.md 和 docs/.ccb/docs-structure-contract.yaml。直接读取经 resolver 定位的 Requirement / dev_task 等人读文档、EventJournal、draft 和文档地图;任务停点以 dev_task frontmatter 为准。不得调用 Console 业务写入接口恢复状态或消费 user intent。
5. 强协商与 sc 要求
恢复本身是管理动作;如果恢复后进入业务节点,该节点必须执行 v1.x always-on 协商和 sc 要求。若恢复状态冲突,需要找 Codex 协商判断真实停点,并写 4 锚点反思。
6. 用户可见输出
输出候选主体、当前节点、停止原因、最近事件、恢复建议、需要用户拍板的冲突项和下一步将进入的节点。