Ccdawn Planning

CCDawn 实施规划

目标

把已经对齐的需求整理成足以安全实施的最小方案。规划是风险工具，不是所有开发的固定阶段；能够在一个上下文中直接实现并验证的任务留给当前 owner。

BRT interface

• Context Boundary: 已确认意图、相关代码/文档/测试、owning surface、保护边界、已有决策和会改变方案的外部证据。
• Output Contract: 推荐实施路径、影响面、顺序、风险决策、验证策略和直接实施/实际拆分/阻塞路由。
• Allowed Action: 只读分析与方案编写；不修改业务代码，不扩大用户范围，不替专项 owner 执行。
• Success Evidence: 方案能映射到具体文件、行为、依赖和验证，且下一执行者无需重新猜测关键取舍。
• Stop Condition: 需求仍有高影响分叉、owning surface 不清、关键证据缺失、高风险动作未确认或方案不能安全实施。
• Route Out: 当前 owner 直接实施、ccdawn-task-splitting、专项 owner、ccdawn-brt 或 BLOCKED。

统一调用契约

• 只处理 BRT interface 范围；不匹配时回 ccdawn-brt 或更具体 owner，复合任务不吞其他 owner。
• 用户可见内容默认中文，完成只报状态、产出、证据和剩余风险；代码、命令、路径、错误原文、API/协议、skill 名和枚举保留原样；Route Out 仅以 BRT interface 为准，末行写 下一步建议: 。

进入闸门

只在规划 artifact 会被审阅、复用、交接或防止具体错误时进入本 skill，例如：

• 存在会改变行为、架构、兼容性或成本的真实设计选择；
• 涉及跨模块契约、状态迁移、数据、权限、安全、发布或回滚顺序；
• 需要多个 owner、多人/agent 或跨会话协作；
• 用户明确要求先看方案。

以下情况不进入：明确机械修改、单一 owning surface、低风险可逆修复、当前 owner 已能直接实施和验证。文件多不等于需要规划。

规划方法

1. 继承 BRT 的可观察结果、非目标、约束和成功证据，不重新发明需求。
2. 只读检查会改变方案的文件、接口、状态、测试、日志和项目规则。
3. 先考虑项目内复用和平台原生能力；只有外部候选会实质改变架构、依赖或成本时才进入 ccdawn-feature-reuse-research。
4. 选择最小充分路径，说明影响文件、关键行为/数据流、实施顺序、保护边界和验证方式。
5. 只有真实取舍才给 2-3 个方案；否则给一个推荐路径。
6. 内部从 1-3 个最相关视角检查需求覆盖、实施可行性、验证和风险。没有 finding 不输出矩阵；发现缺口直接修订方案。
7. 根据剩余工作决定直接实施、实际拆分或阻塞。

路由判定

默认 DIRECT_IMPLEMENTATION，满足以下条件即可由当前 owner 连续实施和验证：

• 一个主题、一个主要 owner，能放入同一推理上下文；
• 顺序可以在内部维护，不需要独立交付或逐项用户验收；
• 风险和验证可以由同一执行契约覆盖。

只有任一条件成立才路由 SPLIT_REQUIRED：

• 存在多个独立交付物或 owner；
• 有真实先后依赖，后续任务必须消费前一任务的 artifact；
• 某个高风险步骤需要独立验收、回滚或权限闸门；
• 需要并行、分 PR、跨会话交接，或不同任务需要不同验证契约；
• 用户明确要求拆分。

多个文件、较长描述、同机制机械替换、需要测试或普通跨模块修改，本身不触发拆分。NO_SPLIT 是 BRT/Planning 的内部结论，不调用 ccdawn-task-splitting 来证明无需拆分。

输出

默认使用紧凑方案：

实施方案:
- 目标与范围:
- 推荐路径:
- 影响面与保护边界:
- 关键顺序/依赖:
- 风险决策:
- 验证与成功证据:
- 路由: DIRECT_IMPLEMENTATION / SPLIT_REQUIRED / BLOCKED
- 路由原因:
下一步建议: 

只有跨会话、正式审阅或高风险方案才增加：备选路径、复用决策、假设、回滚、详细影响面和 ledger 增量。不要输出“无新增影响面”“无真实缺口”等占位式自审字段。

高风险补强

权限、安全、删除、迁移、发布、公共 API 或难回滚变更必须明确：受影响对象、兼容/迁移策略、失败检测、回滚路径和授权闸门。只有这些证据仍有缺口时才读取 plan-document-reviewer-prompt.md 做专项审查。

延续

用户原始目标包含“修复/添加/实现/优化/继续”等执行许可且没有自然闸门时，方案完成后直接按推荐路由推进，不再次询问是否进入下一阶段。

只有跨会话、正式交接、Deferred 项或高风险决策需要持久状态时才更新 Workflow Ledger；普通规划把必要上下文放进紧凑方案即可。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: CCDawn
• Source: CCDawn/codex-skills
• License: MIT
• Homepage: https://skills.sh/CCDawn/codex-skills

Install and usage instructions live in the source repository linked above.