plan-writing

# 计划编写 > 来源: obra/superpowers ## 概述 此技能提供了一个将工作分解为清晰、可执行的任务并设定验证标准的框架。 ## 任务分解原则 ### 1. 小而专注的任务 - 每个任务应在 2-5 分钟内完成 - 每个任务有一个明确的结果 - 可独立验证 ### 2. 清晰的验证 - 如何确认任务已完成？ - 可以检查/测试什么？ - 预期的输出是什么？ ### 3. 逻辑排序 - 识别依赖关系 - 尽可能并行工作 - 突出关键路径 - **阶段 X：验证永远是最后一步** ### 4. 项目根目录下的动态命名 - 计划文件保存为项目根目录下的 `{task-slug}.md` - 名称源自任务（例如："add auth" → `auth-feature.md`） - **绝不要**放在 `.claude/`、`docs/` 或临时文件夹中 ## 规划原则（非模板！） > ? **没有固定模板。每个计划对任务而言都是唯一的。** ### 原则 1：保持简短 | ❌ 错误 | ✅ 正确 | |----------|----------| | 50 个带有子任务的任务 | 最多 5-10 个清晰的任务 | | 列出每个微小步骤 | 仅列出可执行项 | | 冗长的描述 | 每个任务一行 | > **规则：** 如果计划超过 1 页，则太长了。请简化。 --- ### 原则 2：具体，而非通用 | ❌ 错误 | ✅ 正确 | |----------|----------| | "设置项目" | "运行 `npx create-next-app`" | | "添加身份验证" | "安装 next-auth，创建 `/api/auth/[...nextauth].ts`" | | "设计 UI 样式" | "为 `Header.tsx` 添加 Tailwind 类" | > **规则：** 每个任务都应有明确、可验证的结果。 --- ### 原则 3：基于项目类型的动态内容 **对于新项目：** - 技术栈是什么？（先决定） - MVP 是什么？（最小功能集） - 文件结构是什么？ **对于功能添加：** - 哪些文件受到影响？ - 需要哪些依赖？ - 如何验证它是否有效？ **对于 Bug 修复：** - 根本原因是什么？ - 需要更改哪个文件/行？ - 如何测试修复？ --- ### 原则 4：脚本是项目特定的 > ? **不要复制粘贴脚本命令。根据项目类型进行选择。** | 项目类型 | 相关脚本 | |--------------|------------------| | 前端/React | `ux_audit.py`, `accessibility_checker.py` | | 后端/API | `api_validator.py`, `security_scan.py` | | 移动端 | `mobile_audit.py` | | 数据库 | `schema_validator.py` | | 全栈 | 根据涉及的内容混合使用上述脚本 | **错误：** 将所有脚本添加到每个计划中 **正确：** 仅添加与此任务相关的脚本 --- ### 原则