[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M757BCQVG1Z2FFS6JDHXDNF5":3,"skill-same:01M757BCQVG1Z2FFS6JDHXDNF5":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M757BCQVG1Z2FFS6JDHXDNF5","su-flow",null,"CCB 主流程入口：按用户意图在 7 个节点中选择工作模式，推进需求分析、设计、拆分或后续执行。","SeemSeam\u002Fagent-roles-spec","SeemSeam","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F29205273?v=4","01M7572MDYPSM30Y29C9HRMGK7","01M7572MEGCX02T16BHYV9PBVK",19,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-flow\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: su-flow\ndescription: CCB 主流程入口：按用户意图在 7 个节点中选择工作模式，推进需求分析、设计、拆分或后续执行。\nmetadata:\n  short-description: CCB AI 编排主入口\n---\n\n# \u002Fccb:su-flow\n\n## 1. 指令意图说明\n\n`\u002Fccb:su-flow` 是用户把目标交给 AI 团队的主入口。它不是固定流水线命令，而是让 Claude 根据用户意图、当前文件和已有状态，选择合适节点并推进工作。\n\n典型用户意图：\n\n1. “帮我分析这个需求”\n2. “继续做技术设计”\n3. “把这个需求拆成任务”\n4. “按这个 spec 往下推进”\n5. “从 review 回退后重新规划”\n\nClaude 必须先判断当前该进入哪个节点，再读取对应 manifest。不要把本 SKILL.md 当作节点内执行规则。\n\n## 2. 节点集声明\n\n本指令可调用完整 7 节点集：\n\n| 节点 | Manifest |\n|---|---|\n| 需求分析 | `references\u002Fkernel\u002Fnodes\u002Frequirement_analysis.node.md` |\n| 技术设计 | `references\u002Fkernel\u002Fnodes\u002Ftechnical_design.node.md` |\n| 任务拆分 | `references\u002Fkernel\u002Fnodes\u002Ftask_breakdown.node.md` |\n| 派工 | `references\u002Fkernel\u002Fnodes\u002Fdispatch.node.md` |\n| 实施 | `references\u002Fkernel\u002Fnodes\u002Fimplementation.node.md` |\n| 审查 | `references\u002Fkernel\u002Fnodes\u002Freview.node.md` |\n| 归档 | `references\u002Fkernel\u002Fnodes\u002Farchive.node.md` |\n\n进入任一业务节点后，必须遵守该节点 manifest 的 6 章节规则：进入条件、核心要点、完成条件、硬约束、sc 推荐和三档样例。\n\n## 3. 触发约定\n\n支持自然语言和显式参数两种入口：\n\n```text\n\u002Fccb:su-flow 帮我分析 docs\u002F02_需求设计\u002Ffoo.md\n\u002Fccb:su-flow --payload {\"subject\":\"requirement\",\"requirement_id\":\"\u003Cid>\",\"step\":\"analysis\"}\n\u002Fccb:su-flow --payload {\"subject\":\"requirement\",\"requirement_id\":\"\u003Cid>\",\"step\":\"design\"}\n\u002Fccb:su-flow --payload {\"subject\":\"requirement\",\"requirement_id\":\"\u003Cid>\",\"step\":\"breakdown_draft\"}\n\u002Fccb:su-flow --payload {\"subject\":\"subtask\",\"task_id\":\"\u003Cid>\",\"step\":\"execution\"}\n```\n\npayload 只用于帮助定位主体和用户意图，不代表固定步骤。即使传了 `payload.step=\"design\"`，如果需求仍有歧义，也必须先回到需求分析。\n\nConsole 可以把用户点击转换成 `--payload` JSON 命令投递到 anchor；Console 是触发器，不是业务写入者。\n\n### artifact projection 契约\n\n节点产物必须落到 Console 实际投影读取的位置；不得只写临时 spec 后声称完成。\n\n| 节点 | canonical 产物 | 完成后动作 |\n|---|---|---|\n| `requirement_analysis` | 经 docs-structure resolver 定位的 requirement 文档（当前契约为 `docs\u002F02_需求设计\u002F`）里的 `## 需求描述` \u002F `## 原话（verbatim）` + 可选模板主体 + `## Claude 解读` \u002F `## 歧义点` \u002F `## 保真差异` + frontmatter `analysis_input_hash` | 节点入口先调用 `promoteRequirementToPlanning({ projectRoot, requirementId })`；把分析结果写入 JSON 文件后调用 `applyRequirementAnalysis({ projectRoot, requirementId, analysisFile })`，该 lib 会在分析成功后再次 affirm planning |\n| `technical_design` | 经 resolver 定位的 technical_design 文档（当前契约为 `docs\u002F03_开发计划\u002F`） | 技术设计文档 frontmatter 必须写 `doc_type: technical_design` 与 `requirement_id: \u003CrequirementId>`，正文非空 |\n| `task_breakdown` | `docs\u002F.ccb\u002Fdrafts\u002Fbreakdown\u002F\u003CrequirementId>.json` | 使用 breakdown-draft action 契约 |\n\n调用前 import：\n\n```js\nimport {\n  applyRequirementAnalysis,\n  promoteRequirementToPlanning\n} from \"..\u002F..\u002Flib\u002Frequirement-analysis\u002Findex.mjs\";\n```\n\n进入 `requirement_analysis` 或 `technical_design` 节点后，只要已定位 `requirementId`，必须先执行：\n\n```js\nawait promoteRequirementToPlanning({ projectRoot, requirementId });\n```\n\n该调用通过 `requirement.promote:planning` capability outcome 写 canonical requirement md，幂等 key 由 `\u003CrequirementId>:\u003CbaseHash>` 派生；`planning` 会 no-op，`delivering` \u002F `delivered` \u002F `deferred` \u002F `cancelled` 或 hash 冲突会被 guard 拒绝。拒绝时不得手写 `status`，记录返回的 `code` \u002F `issues`，再按节点 manifest 判断继续、停止或升级用户。\n\n`analysisFile` 必须是 JSON，字段为非空字符串：`claudeInterpretation`、`ambiguities`、`fidelityDiff`；可选字段 `bodyMarkdown` 为字符串，用于按需求模板主体产出二~十三章（复杂度自适应，用不上的章节可删）。`ambiguities` 必须写闭环形态：已问已答的拍板记录（含答案与理由）或显式移交下一节点的技术项；不得把未获答复的问题写成\"待用户××\"。命中未决用户拍板项时，不调用 `applyRequirementAnalysis`，先在当前终端问到答案。`bodyMarkdown` 不得包含以下二级标题：`需求描述`、`原话（verbatim）`、`原话`、`verbatim`、`Claude 解读`、`Claude 解读（可选）`、`歧义点`、`歧义点（可选）`、`保真差异`、`保真差异（可选）`。提供 `bodyMarkdown` 时，`applyRequirementAnalysis` 会以 O2 语义整段替换「原话 section 后 ~ Claude 解读 section 前」的主体区；未提供时保持旧三锚点写入路径。严禁在 anchor 内用 `fs.writeFile` 直接改 requirement md 的分析 section；必须走 lib 的 safeWriteFile\u002FCAS\u002FEventJournal 路径。\n\n### breakdown-draft action 契约\n\n当 payload 携带 `action=breakdown_draft_*` 时，Claude 必须把 JSON payload 解析为 lib 调用，不得自由手写 JSON：\n\n| action | 必填参数 | 调用 |\n|---|---|---|\n| `breakdown_draft_create` | `requirement_id` | `createBreakdownDraft({ projectRoot, requirementId, draftPayload })` |\n| `breakdown_draft_update` | `requirement_id`, `expected_hash` | `updateBreakdownDraft({ projectRoot, requirementId, patch, expectedHash })` |\n| `breakdown_draft_begin_review` | `requirement_id`, `expected_hash` | `transitionBreakdownDraftStatus({ projectRoot, requirementId, expectedHash, fromStatus: \"draft\", toStatus: \"reviewing\" })` |\n| `derive_followup` | `requirement_id`, `followup.type`, `followup.title`, `source_task_id`, `source_task_key` | `deriveFollowupBreakdownDraft(...)` 后按 approved hash 调用 `transitionBreakdownDraftStatus(... toStatus: \"consumed\")` 与 `materializeRequirement(...)` |\n\n调用前 import：\n\n```js\nimport {\n  createBreakdownDraft,\n  deriveFollowupBreakdownDraft,\n  readBreakdownDraft,\n  updateBreakdownDraft,\n  transitionBreakdownDraftStatus\n} from \"..\u002F..\u002Flib\u002Fbreakdown-draft\u002Findex.mjs\";\nimport { materializeRequirement } from \"..\u002F..\u002Flib\u002Fsubtask\u002Findex.mjs\";\n```\n\n`derive_followup` 使用 reopen 新代次语义：先 `readBreakdownDraft()` 获取当前 hash；若 draft 已 `consumed`，用 `transitionBreakdownDraftStatus({ fromStatus: \"consumed\", toStatus: \"draft\" })` 重开；再通过 `updateBreakdownDraft()` 追加一条 follow-up subtask。新 subtask 的 `order = max(order)+1`、`section_id = pr\u003Corder>-\u003Cslug>`、`include: true`；source task provenance 只能写进 `spec_section_md` 正文块，例如 `> 派生自:task \u003Csource_task_id>(\u003Csource_task_key>)`，不得新增 breakdown draft 字段或 dev_task frontmatter 字段。\n\nbreakdown draft 的 `spec_section_md` 应贴合开发任务模板核心章节写作，至少覆盖任务概述、任务分解、验收标准相关信息；物化器会在不改变 draft schema 的前提下，把 `spec_section_md` 包进 dev_task 模板骨架。\n\n`derive_followup` 的完整物化顺序必须全程使用 CAS hash：`deriveFollowupBreakdownDraft()` 返回 approved draft hash 后，先调用 `transitionBreakdownDraftStatus({ fromStatus: \"approved\", toStatus: \"consumed\", expectedHash: approvedHash })`，再调用 `materializeRequirement({ expectedDraftHash: approvedHash })`。`materializeRequirement` 会跳过已存在的旧 dev_task，只为新 follow-up 子任务写 `docs\u002F03` 文档。严禁在 anchor 内用 `fs.writeFile` 直接改 draft JSON 或 dev_task markdown。\n\n除 `derive_followup` 会先读当前 draft hash 外，其它显式 draft mutation 的 `expected_hash` 缺失时必须停止并要求调用方重读当前 draft hash。`ConflictError` 表示用户看到的 draft 已过期；`ValidationError` 表示 draft 内容或状态机非法；`LockTimeoutError` 表示另一个 anchor 正在写，稍后重试或升级用户。严禁在 anchor 内用 `fs.writeFile` 直接改 `docs\u002F.ccb\u002Fdrafts\u002Fbreakdown\u002F*.json`。\n\n### ask target 路由契约\n\n当本 skill 在协商或派工流程内需要发起 `ccb ask` 时，提交前必须通过 routing helper 锚定自身并解析目标。不要自行用项目级默认值、`main_*`、`ccb_codex` 或名称前缀猜目标。\n\n调用前 import：\n\n```js\nimport {\n  buildCcbAskInvocation,\n  resolveAskRouting\n} from \"..\u002F..\u002Flib\u002Fask-routing\u002Findex.mjs\";\n```\n\n提交前流程：\n\n1. 若用户或 payload 已给出实际 agent 名，作为 `explicitTarget` 传入；`owner=ccb_codex` 只表示执行角色，不等于 ask target。\n2. 若没有显式 target，调用 `resolveAskRouting({ projectRoot })`；helper 会用当前 CCB actor 与 `.ccb\u002Fccb.config [windows]` 解析同组互补对端。\n3. 返回 `status=\"needs_explicit_target\"` 时必须停止并要求显式 target，不得猜测。\n4. 返回 `status=\"ok\"` 后，用 `routing.target` 作为 `ccb ask` 目标；可用 `buildCcbAskInvocation({ target: routing.target, taskId, callback })` 生成命令参数。\n5. `routing.warnings` 非空或 `routing.crossGroup.requiresReason=true` 时，必须在提交前让跨组理由显式化，或在用户可见输出中记录 warning；合法跨组不硬拦。\n\n## 4. Plugin 独立运行约定\n\n本 skill 不调用 Console 业务写入接口。定位上下文时先读 `docs\u002F00_项目总览.md`、`docs\u002F00_文档地图.md` 和 `docs\u002F.ccb\u002Fdocs-structure-contract.yaml`；业务文档落点必须经 docs-structure resolver \u002F 目录契约定位。人读 docs 文档是业务真相，`.ccb` 只承载协调和索引投影：\n\n1. Requirement 文档：经 resolver 定位 `requirement`，当前契约落点为 `docs\u002F02_需求设计\u002F`。\n2. 技术设计 \u002F 开发任务文档：经 resolver 定位 `technical_design` \u002F `dev_task`，当前契约落点为 `docs\u002F03_开发计划\u002F`。\n3. 拆分草案：`docs\u002F.ccb\u002Fdrafts\u002Fbreakdown\u002F\u003CrequirementId>.json`。\n4. 状态：Requirement \u002F dev_task \u002F ADR frontmatter。\n5. 反思 \u002F 协商 \u002F 授权 \u002F 审计记录：`docs\u002F.ccb\u002Fevents\u002Fjournal.jsonl`。\n6. 可复用经验沉淀：`docs\u002F05_经验沉淀\u002F`。\n\n如果 Console 存在，它只监听文件并投影展示。没有 Console 时，用户仍可通过文件系统、grep 和编辑器审计完整工作。\n\n## 5. 强协商与 sc 要求\n\nv1.x 阶段进入任何业务节点都必须至少完成：\n\n1. 1 轮 Codex 或其他 agent 协商。\n2. 1 段 4 锚点反思。\n3. 命中的必问项扫描。\n4. 节点推荐 sc 指令的使用记录，或不可用时的替代说明。\n\n当一轮协商没有新增信息时，不为讨论而讨论；升级用户或进入下一步。\n\n## 6. 用户可见输出\n\n每次运行结束时输出：\n\n1. 当前进入的节点。\n2. 已完成的关键判断。\n3. 已处理和仍命中的必问项。\n4. Codex 协商摘要和你的反思摘要。\n5. 写入的文件路径。\n6. 下一步是自动继续、因命中拍板项未获答复而停在终端等待答案，还是节点已完成后自然停下等待下一意图。\n","# \u002Fccb:su-flow\n\n## 1. 指令意图说明\n\n`\u002Fccb:su-flow` 是用户把目标交给 AI 团队的主入口。它不是固定流水线命令，而是让 Claude 根据用户意图、当前文件和已有状态，选择合适节点并推进工作。\n\n典型用户意图：\n\n1. “帮我分析这个需求”\n2. “继续做技术设计”\n3. “把这个需求拆成任务”\n4. “按这个 spec 往下推进”\n5. “从 review 回退后重新规划”\n\nClaude 必须先判断当前该进入哪个节点，再读取对应 manifest。不要把本 SKILL.md 当作节点内执行规则。\n\n## 2. 节点集声明\n\n本指令可调用完整 7 节点集：\n\n| 节点 | Manifest |\n|---|---|\n| 需求分析 | `references\u002Fkernel\u002Fnodes\u002Frequirement_analysis.node.md` |\n| 技术设计 | `references\u002Fkernel\u002Fnodes\u002Ftechnical_design.node.md` |\n| 任务拆分 | `references\u002Fkernel\u002Fnodes\u002Ftask_breakdown.node.md` |\n| 派工 | `references\u002Fkernel\u002Fnodes\u002Fdispatch.node.md` |\n| 实施 | `references\u002Fkernel\u002Fnodes\u002Fimplementation.node.md` |\n| 审查 | `references\u002Fkernel\u002Fnodes\u002Freview.node.md` |\n| 归档 | `references\u002Fkernel\u002Fnodes\u002Farchive.node.md` |\n\n进入任一业务节点后，必须遵守该节点 manifest 的 6 章节规则：进入条件、核心要点、完成条件、硬约束、sc 推荐和三档样例。\n\n## 3. 触发约定\n\n支持自然语言和显式参数两种入口：\n\n```text\n\u002Fccb:su-flow 帮我分析 docs\u002F02_需求设计\u002Ffoo.md\n\u002Fccb:su-flow --payload {\"subject\":\"requirement\",\"requirement_id\":\"\u003Cid>\",\"step\":\"analysis\"}\n\u002Fccb:su-flow --payload {\"subject\":\"requirement\",\"requirement_id\":\"\u003Cid>\",\"step\":\"design\"}\n\u002Fccb:su-flow --payload {\"subject\":\"requirement\",\"requirement_id\":\"\u003Cid>\",\"step\":\"breakdown_draft\"}\n\u002Fccb:su-flow --payload {\"subject\":\"subtask\",\"task_id\":\"\u003Cid>\",\"step\":\"execution\"}\n```\n\npayload 只用于帮助定位主体和用户意图，不代表固定步骤。即使传了 `payload.step=\"design\"`，如果需求仍有歧义，也必须先回到需求分析。\n\nConsole 可以把用户点击转换成 `--payload` JSON 命令投递到 anchor；Console 是触发器，不是业务写入者。\n\n### artifact projection 契约\n\n节点产物必须落到 Console 实际投影读取的位置；不得只写临时 spec 后声称完成。\n\n| 节点 | canonical 产物 | 完成后动作 |\n|---|---|---|\n| `requirement_analysis` | 经 docs-structure resolver 定位的 requirement 文档（当前契约为 `docs\u002F02_需求设计\u002F`）里的 `## 需求描述` \u002F `## 原话（verbatim）` + 可选模板主体 + `## Claude 解读` \u002F `## 歧义点` \u002F `## 保真差异` + frontmatter `analysis_input_hash` | 节点入口先调用 `promoteRequirementToPlanning({ projectRoot, requirementId })`；把分析结果写入 JSON 文件后调用 `applyRequirementAnalysis({ projectRoot, requirementId, analysisFile })`，该 lib 会在分析成功后再次 affirm planning |\n| `technical_design` | 经 resolver 定位的 technical_design 文档（当前契约为 `docs\u002F03_开发计划\u002F`） | 技术设计文档 frontmatter 必须写 `doc_type: technical_design` 与 `requirement_id: \u003CrequirementId>`，正文非空 |\n| `task_breakdown` | `docs\u002F.ccb\u002Fdrafts\u002Fbreakdown\u002F\u003CrequirementId>.json` | 使用 breakdown-draft action 契约 |\n\n调用前 import：\n\n```js\nimport {\n  applyRequirementAnalysis,\n  promoteRequirementToPlanning\n} from \"..\u002F..\u002Flib\u002Frequirement-analysis\u002Findex.mjs\";\n```\n\n进入 `requirement_analysis` 或 `technical_design` 节点后，只要已定位 `requirementId`，必须先执行：\n\n```js\nawait promoteRequirementToPlanning({ projectRoot, requirementId });\n```\n\n该调用通过 `requirement.promote:planning` capability outcome 写 canonical requirement md，幂等 key 由 `\u003CrequirementId>:\u003CbaseHash>` 派生；`planning` 会 no-op，`delivering` \u002F `delivered` \u002F `deferred` \u002F `cancelled` 或 hash 冲突会被 guard 拒绝。拒绝时不得手写 `status`，记录返回的 `code` \u002F `issues`，再按节点 manifest 判断继续、停止或升级用户。\n\n`analysisFile` 必须是 JSON，字段为非空字符串：`claudeInterpretation`、`ambiguities`、`fidelityDiff`；可选字段 `bodyMarkdown` 为字符串，用于按需求模板主体产出二~十三章（复杂度自适应，用不上的章节可删）。`ambiguities` 必须写闭环形态：已问已答的拍板记录（含答案与理由）或显式移交下一节点的技术项；不得把未获答复的问题写成\"待用户××\"。命中未决用户拍板项时，不调用 `applyRequirementAnalysis`，先在当前终端问到答案。`bodyMarkdown` 不得包含以下二级标题：`需求描述`、`原话（verbatim）`、`原话`、`verbatim`、`Claude 解读`、`Claude 解读（可选）`、`歧义点`、`歧义点（可选）`、`保真差异`、`保真差异（可选）`。提供 `bodyMarkdown` 时，`applyRequirementAnalysis` 会以 O2 语义整段替换「原话 section 后 ~ Claude 解读 section 前」的主体区；未提供时保持旧三锚点写入路径。严禁在 anchor 内用 `fs.writeFile` 直接改 requirement md 的分析 section；必须走 lib 的 safeWriteFile\u002FCAS\u002FEventJournal 路径。\n\n### breakdown-draft action 契约\n\n当 payload 携带 `action=breakdown_draft_*` 时，Claude 必须把 JSON payload 解析为 lib 调用，不得自由手写 JSON：\n\n| action | 必填参数 | 调用 |\n|---|---|---|\n| `breakdown_draft_create` | `requirement_id` | `createBreakdownDraft({ projectRoot, requirementId, draftPayload })` |\n| `breakdown_draft_update` | `requirement_id`, `expected_hash` | `updateBreakdownDraft({ projectRoot, requirementId, patch, expectedHash })` |\n| `breakdown_draft_begin_review` | `requirement_id`, `expected_hash` | `transitionBreakdownDraftStatus({ projectRoot, requirementId, expectedHash, fromStatus: \"draft\", toStatus: \"reviewing\" })` |\n| `derive_followup` | `requirement_id`, `followup.type`, `followup.title`, `source_task_id`, `source_task_key` | `deriveFollowupBreakdownDraft(...)` 后按 approved hash 调用 `transitionBreakdownDraftStatus(... toStatus: \"consumed\")` 与 `materializeRequirement(...)` |\n\n调用前 import：\n\n```js\nimport {\n  createBreakdownDraft,\n  deriveFollowupBreakdownDraft,\n  readBreakdownDraft,\n  updateBreakdownDraft,\n  transitionBreakdownDraftStatus\n} from \"..\u002F..\u002Flib\u002Fbreakdown-draft\u002Findex.mjs\";\nimport { materializeRequirement } from \"..\u002F..\u002Flib\u002Fsubtask\u002Findex.mjs\";\n```\n\n`derive_followup` 使用 reopen 新代次语义：先 `readBreakdownDraft()` 获取当前 hash；若 draft 已 `consumed`，用 `transitionBreakdownDraftStatus({ fromStatus: \"consumed\", toStatus: \"draft\" })` 重开；再通过 `updateBreakdownDraft()` 追加一条 follow-up subtask。新 subtask 的 `order = max(order)+1`、`section_id = pr\u003Corder>-\u003Cslug>`、`include: true`；source task provenance 只能写进 `spec_section_md` 正文块，例如 `> 派生自:task \u003Csource_task_id>(\u003Csource_task_key>)`，不得新增 breakdown draft 字段或 dev_task frontmatter 字段。\n\nbreakdown draft 的 `spec_section_md` 应贴合开发任务模板核心章节写作，至少覆盖任务概述、任务分解、验收标准相关信息；物化器会在不改变 draft schema 的前提下，把 `spec_section_md` 包进 dev_task 模板骨架。\n\n`derive_followup` 的完整物化顺序必须全程使用 CAS hash：`deriveFollowupBreakdownDraft()` 返回 approved draft hash 后，先调用 `transitionBreakdownDraftStatus({ fromStatus: \"approved\", toStatus: \"consumed\", expectedHash: approvedHash })`，再调用 `materializeRequirement({ expectedDraftHash: approvedHash })`。`materializeRequirement` 会跳过已存在的旧 dev_task，只为新 follow-up 子任务写 `docs\u002F03` 文档。严禁在 anchor 内用 `fs.writeFile` 直接改 draft JSON 或 dev_task markdown。\n\n除 `derive_followup` 会先读当前 draft hash 外，其它显式 draft mutation 的 `expected_hash` 缺失时必须停止并要求调用方重读当前 draft hash。`ConflictError` 表示用户看到的 draft 已过期；`ValidationError` 表示 draft 内容或状态机非法；`LockTimeoutError` 表示另一个 anchor 正在写，稍后重试或升级用户。严禁在 anchor 内用 `fs.writeFile` 直接改 `docs\u002F.ccb\u002Fdrafts\u002Fbreakdown\u002F*.json`。\n\n### ask target 路由契约\n\n当本 skill 在协商或派工流程内需要发起 `ccb ask` 时，提交前必须通过 routing helper 锚定自身并解析目标。不要自行用项目级默认值、`main_*`、`ccb_codex` 或名称前缀猜目标。\n\n调用前 import：\n\n```js\nimport {\n  buildCcbAskInvocation,\n  resolveAskRouting\n} from \"..\u002F..\u002Flib\u002Fask-routing\u002Findex.mjs\";\n```\n\n提交前流程：\n\n1. 若用户或 payload 已给出实际 agent 名，作为 `explicitTarget` 传入；`owner=ccb_codex` 只表示执行角色，不等于 ask target。\n2. 若没有显式 target，调用 `resolveAskRouting({ projectRoot })`；helper 会用当前 CCB actor 与 `.ccb\u002Fccb.config [windows]` 解析同组互补对端。\n3. 返回 `status=\"needs_explicit_target\"` 时必须停止并要求显式 target，不得猜测。\n4. 返回 `status=\"ok\"` 后，用 `routing.target` 作为 `ccb ask` 目标；可用 `buildCcbAskInvocation({ target: routing.target, taskId, callback })` 生成命令参数。\n5. `routing.warnings` 非空或 `routing.crossGroup.requiresReason=true` 时，必须在提交前让跨组理由显式化，或在用户可见输出中记录 warning；合法跨组不硬拦。\n\n## 4. Plugin 独立运行约定\n\n本 skill 不调用 Console 业务写入接口。定位上下文时先读 `docs\u002F00_项目总览.md`、`docs\u002F00_文档地图.md` 和 `docs\u002F.ccb\u002Fdocs-structure-contract.yaml`；业务文档落点必须经 docs-structure resolver \u002F 目录契约定位。人读 docs 文档是业务真相，`.ccb` 只承载协调和索引投影：\n\n1. Requirement 文档：经 resolver 定位 `requirement`，当前契约落点为 `docs\u002F02_需求设计\u002F`。\n2. 技术设计 \u002F 开发任务文档：经 resolver 定位 `technical_design` \u002F `dev_task`，当前契约落点为 `docs\u002F03_开发计划\u002F`。\n3. 拆分草案：`docs\u002F.ccb\u002Fdrafts\u002Fbreakdown\u002F\u003CrequirementId>.json`。\n4. 状态：Requirement \u002F dev_task \u002F ADR frontmatter。\n5. 反思 \u002F 协商 \u002F 授权 \u002F 审计记录：`docs\u002F.ccb\u002Fevents\u002Fjournal.jsonl`。\n6. 可复用经验沉淀：`docs\u002F05_经验沉淀\u002F`。\n\n如果 Console 存在，它只监听文件并投影展示。没有 Console 时，用户仍可通过文件系统、grep 和编辑器审计完整工作。\n\n## 5. 强协商与 sc 要求\n\nv1.x 阶段进入任何业务节点都必须至少完成：\n\n1. 1 轮 Codex 或其他 agent 协商。\n2. 1 段 4 锚点反思。\n3. 命中的必问项扫描。\n4. 节点推荐 sc 指令的使用记录，或不可用时的替代说明。\n\n当一轮协商没有新增信息时，不为讨论而讨论；升级用户或进入下一步。\n\n## 6. 用户可见输出\n\n每次运行结束时输出：\n\n1. 当前进入的节点。\n2. 已完成的关键判断。\n3. 已处理和仍命中的必问项。\n4. Codex 协商摘要和你的反思摘要。\n5. 写入的文件路径。\n6. 下一步是自动继续、因命中拍板项未获答复而停在终端等待答案，还是节点已完成后自然停下等待下一意图。\n",{"name":5,"metadata":23,"description":7},{"short-description":24},"CCB AI 编排主入口","main","d07398b0a36ffa994efd970a554dd9596932ed5c","roles\u002Fsu-ccb\u002Fskills\u002Fsu-flow",2,"https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec","https:\u002F\u002Fgithub.com\u002FSeemSeam","2026-08-14 10:00:06",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add SeemSeam\u002Fagent-roles-spec --skill su-flow",{"tool":38,"command":39},"bunx","bunx skills add SeemSeam\u002Fagent-roles-spec --skill su-flow",{"tool":41,"command":42},"pnpm","pnpm dlx skills add SeemSeam\u002Fagent-roles-spec --skill su-flow","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-flow\u002FSKILL.md",true,[46,52,58],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"__tests__\u002Fsu-flow-skill.test.mjs","SCRIPT","脚本",784,"https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-flow\u002F__tests__\u002Fsu-flow-skill.test.mjs",{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"examples\u002F01-su-flow-entry.md","REFERENCE","参考文档",1220,"https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-flow\u002Fexamples\u002F01-su-flow-entry.md",{"path":59,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":60,"sourceHtmlUrl":61},"examples\u002F02-su-plan-deprecation.md",923,"https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-flow\u002Fexamples\u002F02-su-plan-deprecation.md",[63,69,76,83,90,97],{"skillNo":64,"name":65,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":18},"01M757C4HNYHR92Z3MDGPW9JSA","example-skill","https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Ftemplates\u002Frole-with-skills\u002Fskills\u002Fexample-skill\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M757C2B2YT62JBH98CG1BKWG","su-status","从 docs 人读真相源与 .ccb 协调件读取当前项目、Requirement 或子任务状态。","https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-status\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":18},"01M757C0DVFT88AFBXN1PFXH9D","su-revise-breakdown","根据用户反馈重写 Requirement breakdown draft。","https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-revise-breakdown\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":18},"01M757BY5XVMPKEK118D782PRM","su-review","审查执行回执、diff 和验证证据，决定通过、返工、replan 或升级用户。","https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-review\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M757BW1R61F61X7JJF2SSJET","su-resume","从 docs 人读真相源与 .ccb 协调件恢复 paused\u002Fdeferred\u002Fin-progress 主体的上下文。","https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-resume\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M757BTEAFRRXA9DY3KBRTRNY","su-reconcile","AI-native 自检 docs 人读真相源、.ccb 协调件与 Console 投影漂移，并按审批结果执行修复。","https:\u002F\u002Fgithub.com\u002FSeemSeam\u002Fagent-roles-spec\u002Fblob\u002Fmain\u002Froles\u002Fsu-ccb\u002Fskills\u002Fsu-reconcile\u002FSKILL.md",[],[]]