用途
plan 是 easy-claude 技能集中的一个实施规划技能,触发条件为工作流步骤或用户请求进行实施规划。其目标是产出一份简明、有证据支撑的实施计划,确定方向与完成证明,而把代码级探索与具体编辑机制留给执行代理。
模式与分发
调用时首先进行模式路由,检测是否存在显式参数:--mode=review、validate、execute、ci、cro;若无则创建计划。各模式对应不同参考文件:
- 默认:创建计划,使用本技能文件。
- --mode=review [plan-path]:评审计划的意图、必要性、替代方案、权衡与证明;默认仅评审,--fix-loop 可启用修复与重新评审(默认上限 3 轮)。
- --mode=validate [plan-path]:通过提问访谈验证已有计划的决策,并记录 ## Validation Summary。
- --mode=execute [plan-path] [--approval=off] [--tests=off] [--parallel={auto|on|off}]:按阶段实施已有计划,代码与测试同步,静态评审后统一验证。
- --mode=ci <log-url>:CI 失败分析入口。
- --mode=cro:转化优化入口。
模式文件需在行动前完整阅读;未选择的模式文件不加载(计划创建后运行独立验证链时加载 mode-validate.md 是例外)。
计划创建流程
解析上下文 → 检查治理证据与代表性模式 → 确定材料决策 → 派生质量门禁清单 → 编写精简计划 → 自检范围、发现项、清单与验证顺序 → 用 $why-review 自审(一般一轮,高风险 full profile 最多三轮)→ 运行验证访谈并应用答案(独立运行或工作流未列出验证步骤时)→ 交回。
创建只做规划:确定方向、归属、依赖、风险、有界发现与证明;代码与编辑机制留给执行。
计划产物契约
计划写入配置的 plans 根目录下的 plan.md,采用紧凑结构。写作前选择 profile:
- full(默认):适用于 M+ 规模工作,以及公共契约、数据/模式、安全、跨模块或不可逆变更;包含全部分节及分支要求的 scope-brief 与场景产物。
- light, spec-supplied:运行提供 canonical spec 作为治理意图时使用,引用 spec_baseline,所有阶段与验收门禁追溯到 spec 章节或用例 ID,保留质量门禁清单,不写 scope-brief 与场景文件。
- light, XS/S:规模为 XS 或 S 且无重大风险决策时使用,受影响文件、有序步骤与回滚内联在 plan.md 中。
关键规则
- 计划说明必须为真的事项、原因、调查位置与完成证明,而非每次编辑。
- 已知仓库事实须引用证据;未来实施证据标记为义务,不得编造路径、符号或行号。
- 缺少任务特定清单的计划不完整:不适用行需标注 NO — 原因,适用行须可核查。
- 开放的产品意图或不可逆决策会阻塞并交由用户决定;有界源码发现属于计划内容,需有负责人和停止条件。
- 测试与实现同步编写;测试套件安排在所有实现和静态评审之后,而非每阶段。
调用上下文
需判断本次是工作流调用还是独立调用。工作流调用结束时返回计划路径与简明摘要,不询问评审、执行等下一步;除非工作流未列出对应步骤,否则跳过或执行自审与验证访谈。独立调用在保存计划后运行自审、按 plan.validation.mode 设置运行独立验证链(默认自动),最后以单一 Standalone Close 问题结束(执行、更深入评审或停止),用户回答启动该独立调用。
适用场景与限制
适用于需要结构化实施规划、计划评审、验证访谈或按计划执行的开发工作流。CI 与 CRO 模式提供对应领域入口。限制包括:计划创建不会自动串联 review 或 execute 模式;验证访谈在特定工作流条件下由父步骤负责;证据缺失时须明确记录而非编造;未提供的具体配置、目录或命令细节暂未提供。