su-revise-breakdown

name	su-revise-breakdown
description	根据用户反馈重写 Requirement breakdown draft。
metadata	{"short-description":"拆分草案修订入口"}

/ccb:su-revise-breakdown

1. 指令意图说明

/ccb:su-revise-breakdown 用于用户在拆分审查后要求调整任务切片时，重新生成 breakdown draft。它不是简单编辑 JSON，而是回到任务拆分判断。

2. 节点集声明

主要进入：

节点	Manifest
任务拆分	references/kernel/nodes/task_breakdown.node.md

必要时回退：

情况	回退节点
用户反馈改变需求范围	references/kernel/nodes/requirement_analysis.node.md
用户反馈改变技术方案	references/kernel/nodes/technical_design.node.md

3. 触发约定

/ccb:su-revise-breakdown --payload {"subject":"requirement","requirement_id":"<id>","action":"breakdown_draft_reject","expected_hash":"<hash>","feedback":{"summary":"合并前两个子任务","items":["补齐验收标准"]}}

breakdown-draft revise/reject 契约

当 payload.action=breakdown_draft_reject 时，直接读取 JSON 内的 feedback object 作为用户反馈，再调用状态迁移记录拒绝；随后按 task_breakdown 节点重写新 draft：

import {
  readBreakdownDraft,
  transitionBreakdownDraftStatus,
  updateBreakdownDraft
} from "../../lib/breakdown-draft/index.mjs";

await transitionBreakdownDraftStatus({
  projectRoot,
  requirementId,
  expectedHash,
  fromStatus: "reviewing",
  toStatus: "draft",
  feedback: payload.feedback
});

参数：payload.requirement_id、payload.expected_hash、payload.feedback.summary 必填。重写 draft 时先 readBreakdownDraft() 获取最新 hash，再用 updateBreakdownDraft({ projectRoot, requirementId, patch, expectedHash }) 写回。ConflictError 表示用户反馈基于旧 draft，必须重新审查；ValidationError 表示反馈或 draft 不合法；LockTimeoutError 表示另一个 anchor 正在写。严禁用 fs.writeFile 直接改 docs/.ccb/drafts/breakdown/*.json。

4. Plugin 独立运行约定

定位上下文时先读 docs/00_项目总览.md、docs/00_文档地图.md 和 docs/.ccb/docs-structure-contract.yaml。Requirement 与技术设计等业务文档落点必须经 docs-structure resolver / 目录契约定位；.ccb/drafts 仅保存拆分草稿机制件。

读取当前 draft、用户反馈和相关 Requirement / technical_design 文档，生成新版 docs/.ccb/drafts/breakdown/<requirementId>.json。保留 review history 和旧 revision，不调用 Console 业务写入接口。

5. 强协商与 sc 要求

必须按 task_breakdown 节点要求使用 sc 或替代方式，并找 Codex 协商新切片是否可执行。若用户反馈实际改变需求或技术方案，不得只改 draft，要回退对应节点。

6. 用户可见输出

输出变更摘要、新旧 draft 差异、已在终端问到答案并闭环记录的用户拍板项和下一步审查入口；若仍有命中项未获答复，先停在当前终端等待答案，不落 draft。