用途:当已有规格或需求、准备处理多步任务且尚未接触代码时,使用 writing-plans 技能编写实施计划。计划面向“熟悉开发但不了解本代码库与问题域”的工程师,假定其测试设计经验有限,需记录每个任务要改哪些文件、代码、测试与文档,并拆成 2-5 分钟的小步骤。
主要能力:先做范围检查,若规格覆盖多个独立子系统,建议拆成每个子系统一份计划,每份计划应能独立产出可运行、可测试的软件。随后规划文件结构,明确每个文件职责与接口,按职责而非技术层拆分,文件改动应集中。任务粒度上,每步一个动作,如写失败测试、运行确认失败、写最小实现、运行确认通过、提交。计划文档必须带固定头部,包含目标、架构、技术栈,并提示使用 subagent-driven-development 或 executing-plans 执行。
使用方式:在专用 worktree 中运行,开始时声明“I'm using the writing-plans skill to create the implementation plan.”。计划默认保存到 docs/plans/YYYY-MM-DD-<feature-name>.md,用户偏好可覆盖。因模型单次输出约 1000 token,文件创建或大改动必须拆成增量步骤:先写骨架,再逐段填充,最后通读修正并提交;计划文档本身也分多轮写入。
限制与要求:禁止占位符,如 TBD、TODO、implement later、fill in details,或“添加适当错误处理”“为上述写测试”等;代码步骤必须给出实际代码,命令需附预期输出,引用类型与函数必须已定义。完成后需自审:核对规格覆盖、扫描占位符、检查类型与命名一致性,发现问题就地修正。资料未提供具体安装命令、收费或平台信息。