name: plan-design description: 在创建或开发时使用,在编写代码或实施计划之前,通过协作提问、替代探索和增量验证,将粗略想法转化为完整设计。不要在清晰的“机械”过程中使用。
想法到设计
1. 初始设置(强制)
- 立即创建计划: 在任何对话之前,创建
.claude/docs/plans/<topic>-design.md。 - 初始内容: 问题陈述、目标和已知需求。
- 黄金规则: 每次用户响应后更新此文件。不要等到最后。
2. 发现阶段
- 上下文检查: 首先查看现有文件、文档和提交。
- 批量提问: 使用提问工具分组最多4个相关问题(目的、约束、成功指标)。
- 偏好: 尽可能使用工具中的多选或多选选项。
- 循环: 提问 -> 回答 -> 编辑计划 -> 跟进。
3. 设计探索
- 提出替代方案: 呈现2-3种方法及其权衡。
- 推荐: 以首选选项为主导,并解释“为什么”。
- 保持精简: 应用 YAGNI(你不需要它)来削减范围。
4. 呈现与验证
- 分块: 以200-300词的部分呈现设计(架构、数据流等)。
- 增量批准: 在每个部分后使用
AskUserQuestion来确认对齐。 - 范围: 仅高级概念流程(例如,“使用React Query进行状态管理”)。
5. 严格边界(设计与实施)
| 在范围内(设计) | 不在范围内(实施) |
|---|---|
| 高级架构与技术栈 | 具体文件路径和目录结构 |
| 组件职责 | 编号的实施阶段/步骤 |
| 数据流逻辑 | 完整代码片段或Git命令 |
| 权衡与假设 | “要创建/修改的文件”列表 |
注意: 如果开始写“阶段1:设置”或具体文件路径,停止。转而使用 plan-write 技能。
6. 结束
- 最终审查: 确保
.claude/docs/plans/文件已完善和完成。 - 下一步: 询问:“准备好设置实施了吗?”
- 如果是: 转至
plan-write。
- 如果是: 转至