用途
writing-plans 用于在设计阶段已完成、需要为对代码库熟悉度极低的工程师编写详细实现任务的场景。它生成一份综合性的实现指南,其中包含精确的文件路径、代码示例和验证步骤。
主要能力
任务粒度
每个步骤代表约 2-5 分钟的工作量,将功能拆解为原子动作,例如:编写失败测试、实现解决方案、提交变更。
文档标准
计划遵循强制性的头部格式,包含目标、架构与技术栈,随后是带文件位置、代码片段和精确命令序列的编号任务。
计划结构
# Feature Name
## Goal
[One sentence: what this accomplishes]
Architecture
[How this fits in the system]
Tech Stack
[Libraries/frameworks used]
Tasks
1. [Task name]
File: path/to/file.ts
[What to do]
Code:
[Exact code or snippet]
Verify:
[Commands to run]
Commit: [commit message]
2. [Next task...]
核心原则
- DRY - Don't Repeat Yourself
- YAGNI - You Aren't Gonna Need It
- TDD - Test-Driven Development
- 频繁提交 - 一个任务,一次提交
使用方式
执行工作流
计划完成后,提供两种实现路径:
- 子智能体驱动 — 在当前会话中为每个任务分派全新的智能体并进行评审
- 并行会话 — 使用 executing-plans 技能引导至独立的会话
计划应包含的内容
- 精确的文件路径(不使用模糊位置)
- 完整的代码片段(不是伪代码)
- 验证命令
- 预期输出
- 每个步骤的提交信息
- 任务之间的依赖关系
- 需要处理的边界情况
输出位置
保存至:docs/plans/YYYY-MM-DD-<feature-name>.md
适用场景
- 设计阶段已完成
- 需要逐步实现指南
- 与不熟悉代码库的工程师协作
- 拆解复杂功能
- 确保实现方式的一致性
限制
关于本技能的收费、价格、平台支持或具体效果等事实,资料中暂未提供。