用途:该技能在代理从请求直接跳到任务清单并开始编辑之前,插入一个规划阶段,设置三个默认流程会跳过的检查点:用项目持久原则校验方案、写出“不做什么”的范围边界、在方案变成任务拆解前停下来等待人工明确“开始”。其价值在时机——一段方案可以在几秒内改写,而已经铺开、改了一半的拆解代价高昂。
何时值得用:当改动是开放式、或跨多个文件/模块/步骤时规划。一行修复、查询、或形态已固定的改动可跳过这套流程,仅复述显而易见任务清单的“规划”是纯开销。
流程:一、起草前先澄清意图。用自己的话陈述目标,暴露歧义:完成是什么样、用户是谁、必须产生的一个结果是什么。缺少关键答案就问,不要猜。二、起草方案,并用项目持久原则校验。写下方案而非步骤:扩展哪个已有模块、遵守哪条边界、数据经过什么路径;再对照项目长期原则检查。原则可在 AGENTS.md、CONTRIBUTING.md、docs/adr、decisions/、CLAUDE.md 或约定中查找。若项目未记录原则,可从现有结构推断,并说明哪些是推断的,便于人工在“开始”时纠正。三、明确写出本次刻意不做什么,列出读者可能合理期待但本次不覆盖的相邻事项,范围蔓延常从遗漏进入。四、停下来等待人工明确“开始”。呈现意图、方案和范围外事项,等待明确批准后再拆步骤;“看起来可以,继续”算批准,沉默不算。若无法让人类参与,说明并将方案视为暂定。五、获得同意后才拆解为有序、可单独检查的步骤;拆解继承已批准方案与范围外边界,不得悄悄扩大。若拆解发现方案有误,应回到第二步重新规划。
常见问题:脱离项目实际、忽略既有约定做规划;没有范围外说明导致方案悄悄膨胀;跳过人工检查点直接铺开错误方案;方案只是复述任务清单而无方案说明;把推断的原则当作已确认原则。
不适用:在方案获人工同意前拆解步骤;在项目已有持久约定时另创临时约定;没有范围外说明或只有任务清单的方案;具体实现本身——本技能止于已批准、已拆解的方案。其他收费、价格、平台等资料暂未提供。