AGENT SKILL

su-revise-breakdown

根据用户反馈重写 Requirement breakdown draft。

License 许可
Apache-2.0
最近更新
2026-08-14
Stars
★ 19
Forks
2

01 前言 Front Matter

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

03 SKILL.md 正文

/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。

04 同仓库更多 Skills