用途:writing-plans 用于在开始写代码之前,把一个多步骤任务的规格或需求转化为可被他人直接执行的实现计划。它适合需要交接给不熟悉当前代码库的工程师,或需要让智能体按步骤稳定落地的开发场景。
主要能力:
- 以“执行者对代码库零上下文、不熟悉工具链与问题域”为假设撰写计划,要求写清每个任务需要触碰哪些文件、对应代码、测试与文档。
- 任务按细粒度拆分,每个步骤只做一个动作(约 2-5 分钟),例如先写失败测试、运行确认失败、写最小实现、运行确认通过、提交。
- 计划采用固定文档头,包含功能名称、目标、架构说明与技术栈,并注明后续需使用 executing-plans 技能逐任务实施。
- 每个任务包含组件名、文件清单(创建、修改的具体路径与行号、测试文件)以及分步的代码、命令和预期结果。
- 强调 DRY、YAGNI、TDD 与频繁提交,并要求始终使用精确文件路径、完整代码和带预期输出的准确命令。
使用方式:创建计划开始时需声明“I'm using the writing-plans skill to create the implementation plan.”,计划保存到 docs/plans/YYYY-MM-DD-<feature-name>.md。计划完成后向使用者提供两种执行方式:子智能体驱动(当前会话内每个任务派发新的子智能体,任务间进行代码审查,快速迭代)或批量执行(按批次执行并设置检查点)。选择前者时需配合 subagent-driven-development 技能,选择后者需配合 executing-plans 技能。
适用场景:适用于已有明确规格或需求、需要拆解为多步骤实施的功能开发;也适用于把开发任务交给缺乏项目背景的工程师或智能体执行的交接场景。
限制:资料未提供该技能的安装方式、平台支持、收费或效果信息;其输出是计划文档而非自动完成编码,实际执行依赖配套技能。