用途:为复杂或高风险改动产出完整、自包含的实施计划,尽量消除歧义,便于由 execute-plan 执行,即使经历 /clear 或由其他智能体接手。该技能只做规划:不实现代码,不修改生产文件(计划产物除外)。
主要能力与流程:
- 加载项目上下文,只检查与改动相关的代码区域,记录用户可见目的、可循既有模式、约束依赖、执行者所需的文件/模块/命令/文档、风险与未知。
- 初始化计划产物:创建 docs/plans/YYMMDD-HHmm-<plan-slug>/,含 SUMMARY.md 和每个实施阶段的 phase-XX-<name>.md;需要时加 research/;时间戳命令沿用共享通用原则。
- 澄清需求:就范围边界、成功标准、约束与非目标、优先级与取舍提问;需求已明确或来自头脑风暴则免确认;假设须显式写入 SUMMARY.md,多种解释要列出并询问,不得静默选择。
- 定义策略与阶段:各阶段含目标、复杂度与风险等级(S/M/L/XL)、有序任务、验证命令、可观察验收与退出标准;任务粒度约 2-10 分钟,阶段可安全恢复,高风险工作记录幂等性、恢复与回滚约束。
- 仅在需要时研究,优先项目文档与代码、既有技能与本地参考、当前环境可用的外部参考;无外部研究能力时基于本地证据并列明假设与开放问题,结论写入 research/<topic>.md。
- 按 references/summary-template.md 与 references/phase-template.md 撰写计划;SUMMARY.md 需是活的计划,含进度、意外发现、决策日志、结果与回顾等空段。
- 审查:核验路径、阶段顺序、任务可执行、每阶段有验证、验收可观察、风险与假设显式、计划无隐藏上下文;随后向用户呈现,多方案时用 Question Tool 选择:批准执行、批准并可视化、进一步澄清。若选可视化,沿用当前会话上下文与刚创建的计划产物,输出 docs/plans/YYMMDD-HHmm-<plan-slug>/visualize.html 与 visualize-assets/,复制固定主题并核验 HTML、本地 CSS、Mermaid 引入、来源元数据与主要内容块。
- 交接:提示使用 /clear 后运行 /execute-plan <plan>/SUMMARY.md;若已生成可视化,另行提示。
限制:绝不在同一会话自动实现或执行代码改动;仅用户选择后可为计划产物做可视化;偏好显式路径与具体命令;保持计划自包含、确定、可恢复;只规划最小可行改动,避免投机阶段与未请求的抽象;若计划 3 阶段够用就不做 6 阶段;每个任务须可追溯到已述需求。来自头脑风暴的请求可跳过文档收集、需求澄清与研究,直接从第 4 步开始。