name: 编写计划 description: 为工程师创建详细的实现计划，包括零代码库上下文下的 bite-sized 任务 when_to_use: 当设计完成时，你需要为零代码库上下文的工程师提供详细实现任务 version: 2.2.0 progressive_disclosure: level: 1 references: - path: references/plan-structure-templates.md title: 计划结构与模板 description: 标准头、任务模板和结构示例 - path: references/best-practices.md title: 最佳实践与指南 description: 为零上下文工程师编写、代码完整性、测试设计模式
编写计划
概述
编写全面的实现计划，假设工程师对我们的代码库零上下文且有可疑品味。记录他们需要知道的一切：每个任务要修改的文件、代码、测试、需要检查的文档、如何测试。以 bite-sized 任务的形式提供整个计划。DRY。YAGNI。TDD。频繁提交。
假设他们是熟练开发者，但对我们工具集或问题域几乎一无所知。假设他们不太了解好的测试设计。
开始时宣布: “我使用编写计划技能来创建实现计划。”
上下文: 这应该在一个专用的工作树中运行（由头脑风暴技能创建）。
保存计划到: docs/plans/YYYY-MM-DD-<feature-name>.md
快速参考
计划头模板: 见计划结构与模板
任务模板: 见计划结构与模板
粒度指南: 每个步骤 = 2-5分钟。见最佳实践
核心原则
- 始终使用确切文件路径 - 不是"在用户模块中"而是"
src/models/user.py" - 计划中包含完整代码 - 不是"添加验证"而是显示验证代码
- 确切命令和预期输出 - “
pytest tests/file.py -v” 以及你会看到什么 - 参考相关技能 - 使用@语法:
@skills/category/skill-name - DRY, YAGNI, TDD, 频繁提交 - 每个任务都遵循这个模式
对于详细指导：最佳实践与指南
执行交接
保存计划后，提供执行选择：
“计划完成并保存到 docs/plans/<filename>.md。两个执行选项：”
1. 子代理驱动（此会话） - 我为每个任务派遣新的子代理，任务间审查，快速迭代
2. 并行会话（分离） - 打开新会话使用 executing-plans，带检查点的批量执行
“哪种方法？”
如果选择子代理驱动：
- 使用 @skills/collaboration/subagent-driven-development
- 留在此会话
- 每个任务的新子代理 + 代码审查
如果选择并行会话：
- 指导他们在工作树中打开新会话
- 新会话使用 @skills/collaboration/executing-plans
记住
- 为零上下文工程师编写（指定一切）
- 完整代码块，非指令
- 确切命令和预期输出
- 先测试，再实现，后提交
- 参考代码库中的现有模式
- 保持任务 bite-sized（每个2-5分钟）
需要示例？ 见计划结构与模板 以获取完整任务示例。
需要模式？ 见最佳实践 以获取错误处理、日志记录、测试设计等。