用途
planning-work 是一个规划技能:读取受影响的代码,产出一份调用方可以直接执行的计划。计划本身就是交付物,技能不负责实现。
主要能力
- 从目标出发:写下工作完成后系统应有的行为、证明正确性的检查(测试、输出或命令),以及不可改变的部分;需求未明确时,从代码中判断并记录决策。
- 先读代码:定位变更归属与可参照的现有模式(同类模块、相似接口、可比测试)、调用方、类型与测试;可用 rg 查找精确符号,用 rg --files <dir> 查看目录结构,并把独立读取批量合并到一个 shell_command 调用中。
- 核实可核实的事实:在使用版本中确认依赖行为,而非凭记忆列出开放问题。
- 设计路径:给出达成目标的最小完整路径,优先减少新名称、层级和活动部件,优先复用仓库既有模式;若所请求方案存在实际缺点,会指出并提出更优路线及取舍。
- 编写步骤:按顺序编排,使每一步都保持系统可运行并产生可观察结果,先做薄薄的端到端切片;每步通常涉及两三个文件,说明涉及的文件与函数或类型、变更内容与原因,以及验证检查;可跳过步骤标记为可选并排最后;回归测试放在其保护的修复之前,功能测试放在该切片末尾;同一函数、类型或文件在各步骤中名称保持一致。
- 记录决策:针对需求留给自己决定的默认值、范围、接口形态或库选择,给出选择、理由,以及调用方推翻时计划如何变化。
- 报告结构:以推荐方案开头(两三句话,附粗略规模 S 不足 1 小时、M 1–3 小时、L 1–2 天、XL 超过 2 天),随后是目标与检查、先行阅读的三到五个文件、编号步骤、仅在真实存在选择时列出的备选方案、为调用方所作的决策、风险与未知项。窄问题(如“A 还是 B”)直接回答并给理由。
使用方式
作为 ampcode 官方插件中的技能调用,向它提供需求简述;它会先读代码再输出计划。技能明确不修改文件、不运行包管理器、构建或测试,运行什么由计划说明、由调用方执行。
适用场景
功能开发、重构、迁移的规划阶段,尤其是调用方在工作过程中无法答疑、需要一次拿到完整可执行计划的场景;也适用于需要在两种方案间做选择的窄问题。
限制
不实现、不修改代码、不执行构建或测试;计划质量取决于所读代码与需求简述的完整度;具体安装方式与价格信息暂未提供。