名称: 计划生成 描述: 协助使用扩展思维从模板生成全面计划。当从元提示模板生成计划、审查计划质量或确保计划符合团队标准时使用。 允许工具: 读取、搜索、全局查找
计划生成
从元提示模板生成高质量计划的指南。
何时使用
- 从
/chore、/bug、/feature模板生成计划 - 审查生成的计划的完整性
- 确保计划遵循团队标准
- 提高计划的质量和具体性
计划生成过程
步骤1: 理解请求
解析高层次描述:
输入: "添加OAuth用户认证"
提取:
- 领域: 认证
- 范围: 面向用户, OAuth协议
- 复杂度: 中高(外部集成)
步骤2: 激活推理
使用扩展思维进行复杂规划:
深思熟虑:
- 哪些文件需要更改?
- 有哪些依赖项?
- 可能出现什么问题?
- 如何验证成功?
步骤3: 探索代码库
规划前收集上下文:
- 阅读README以了解项目结构
- 识别相关现有模式
- 查找测试示例以遵循
- 定位配置文件
步骤4: 填充模板
用具体内容完成每个部分:
## 相关文件
- src/auth/OAuthProvider.ts (创建)
- src/auth/index.ts (修改 - 添加导出)
- src/config/oauth.ts (创建)
- tests/auth/oauth.test.ts (创建)
步骤5: 验证计划质量
最终确定前根据质量标准检查。
质量标准
每个计划都应达到以下标准:
具体性
差: “更新组件” 好: “更新UserProfile.tsx以在第45行添加加载状态”
可操作性
差: “适当处理错误” 好: “在fetchUser()中添加try/catch,用console.error记录错误,显示ErrorBoundary”
完整性
所有模板部分已填写:
- [ ] 描述解释什么和为什么
- [ ] 相关文件列出所有要接触的文件
- [ ] 任务编号明确且具体
- [ ] 验证命令可执行
- [ ] 笔记记录边缘情况
可测试性
每个计划必须包括验证:
## 验证命令
- 运行`npm test -- auth`以验证单元测试通过
- 运行`npm run e2e -- oauth`以验证集成
- 手动: 在浏览器中完成OAuth流程
计划类型和重点领域
杂务计划
重点:
- 明确范围边界
- 幂等操作
- 低风险执行
- 快速验证
错误修复计划
重点:
- 根本原因分析
- 再现步骤
- 回归预防
- 前后验证
功能计划
重点:
- 用户故事对齐
- 实施阶段
- 测试策略
- 验收标准
常见问题和修复
模糊任务
问题: “实施功能” 修复: 分解为具有文件引用的特定子任务
## 逐步任务
1. 在src/contexts/AuthContext.tsx中创建AuthContext
2. 在src/hooks/useAuth.ts中添加useAuth钩子
3. 在src/App.tsx中用AuthProvider包装App组件
4. 在src/routes/index.tsx中添加登录路由
缺失文件
问题: 计划未提及测试文件 修复: 始终包括测试文件的创建/修改
## 相关文件
- src/components/Login.tsx (创建)
- src/components/Login.test.tsx (创建) # 测试!
不清晰的验证
问题: “确保它工作” 修复: 具有预期结果的特定命令
## 验证命令
- 运行`npm test` - 预期0失败
- 运行`npm run build` - 预期成功构建
- 运行`npm run lint` - 预期0错误
范围蔓延
问题: 计划处理了超出请求的内容 修复: 专注于原始请求,在笔记中记录相关工作
## 笔记
- 相关: 登录表单可能需要进行可访问性改进(单独的杂务)
- 相关: 密码重置流程需要类似的OAuth选项(单独的功能)
扩展思维触发
注意: 在Claude Code中默认启用扩展思维(31,999令牌)。短语如“think”、“think hard”、“ultrathink”是提示指令,表示您的期望但不控制令牌分配。使用Alt+T切换思考或MAX_THINKING_TOKENS调整预算。
在元提示中使用“THINK HARD”作为提示指令,表示需要仔细推理:
| 短语 | 何时使用 |
|---|---|
| “THINK HARD” | 中到高复杂度,鼓励仔细推理 |
输出指南
命名约定
specs/[类型]-[描述性名称].md
示例:
- specs/chore-update-dependencies.md
- specs/bug-fix-login-race-condition.md
- specs/feature-oauth-authentication.md
文件位置
始终将计划写入specs/目录(或项目特定等效位置)。
格式一致性
精确匹配模板的计划格式 - 不要添加或删除部分。
相关记忆文件
- @template-engineering.md - 模板如何工作
- @meta-prompt-patterns.md - 提示层次结构
- @plan-format-guide.md - 标准计划结构
- @fresh-agent-rationale.md - 为什么计划然后单独实施
版本历史
- v1.0.0 (2025-12-26): 初始发布
最后更新
日期: 2025-12-26 模型: claude-opus-4-5-20251101