用途:当一个多步骤任务已有规格或需求、但尚未开始写代码时,先用本技能产出实现计划。计划写给“技术合格但对本项目工具链和问题域几乎不了解、测试设计能力较弱”的工程师,因此要把一切写清楚:每个任务改哪些文件、确切代码、测试流程、相关文档、每步如何验证。核心原则:先有计划再实现(NO IMPLEMENTATION WITHOUT A PLAN FIRST),并遵循 DRY、YAGNI、TDD、频繁提交。
适用:跨多文件或多行为的特性、跨组件的缺陷修复、跨模块边界的重构、需要跨文件协调测试+代码+提交的任务、意图发现会话产出的规格或设计。不适用:范围明确的单行修复(拼写、配置值)、为现有代码加单个测试、仅文档改动、单文件内变量重命名。
入口协议:写计划前须确认设计已批准、范围已定义、需求具体(有验收标准)、技术栈已知、测试策略已定义、已在隔离 worktree 中工作;任一项不清楚则停下,回到 intent-discovery 或咨询人类伙伴,不要带着空缺写计划。
产出格式:计划保存到 docs/plans/YYYY-MM-DD-<feature-name>.md。文档头包含目标、架构、技术栈,并注明“REQUIRED SUB-SKILL: Use godmode:task-runner to implement this plan task-by-task”;每个任务以模板展开,列出创建/修改/测试的确切路径,步骤拆为 2-5 分钟的单动作:写失败测试、运行确认失败、写最小实现、运行确认通过、提交,并给出确切命令与预期输出,例如 pytest tests/path/test.py::test_name -v。
护栏:禁止模糊步骤(如“实现该功能”),不得省略测试命令与预期输出,每步须引用确切路径,未保存并评审计划前不得开始实现;代码写完整片段而非描述,每步含确切 shell 命令与预期输出,列出全部创建/修改/删除文件,每个任务以含精确提交信息的提交步骤收尾。开始时应声明“I'm applying the task-planning skill to build the implementation plan.”。
执行交接:计划保存后提供两种选择——本会话内委派执行(每个任务派新子智能体、任务间做代码评审,使用 godmode:delegated-execution),或另开会话用 task-runner 批量执行并在检查点停顿。
关联技能:godmode:intent-discovery、godmode:workspace-isolation(必需)、godmode:task-runner、godmode:delegated-execution、godmode:test-first、godmode:merge-protocol。限制:不负责意图发现与代码实现本身;不适用于单文件小改动。