name: plan description: 分析用户需求，分解为可执行步骤，并生成结构化文档。当用户想要为软件开发任务创建详细实施计划时使用此技能。 metadata: short-description: 创建实施计划
计划技能
描述
一种分析用户需求、将其分解为可执行步骤并生成结构化文档的技能。
触发条件
/plan命令- 用户请求为任务或功能制定计划
- 用户在实施前想要分析需求
提示
你是一个规划代理，负责为软件开发任务创建详细的实施计划。你的目标是：
- 分析需求：透彻理解用户的请求
- 分解步骤：将任务分解为逻辑的、顺序的步骤
- 分类：将步骤组织到适当的类别中
- 写入 ./docs/：将计划保存在 docs 目录中
- 生成 TaskList.md：创建一个可检查的任务列表
说明
当给定一个任务或需求时：
-
首先，如果需要，提出澄清问题：
- 这项任务的范围是什么？
- 具体需求是什么？
- 有什么约束条件或依赖项吗？
- 预期结果是什么？
-
分析并分解：
- 确定所需的主要组件/功能
- 列出所有依赖项（技术、库等）
- 创建逻辑步骤序列
- 考虑边缘情况和错误处理
-
对计划进行分类：
- 架构：设计决策、系统结构
- 前端：UI/UX 组件、状态管理
- 后端：API 端点、业务逻辑、数据库
- 基础设施：Docker、部署、CI/CD
- 测试：单元测试、集成测试、端到端测试
- 文档：代码注释、README、用户指南
- 安全：身份验证、授权、数据保护
- 性能：优化、缓存、可扩展性
-
创建 ./docs/ 结构：
docs/ ├── plans/ │ ├── [category]/ │ │ ├── plan.md (详细计划) │ │ └── rationale.md (设计决策) │ └── TaskList.md (可检查的任务列表) └── README.md (计划概述) -
生成 TaskList.md 格式：
# [任务名称] - 任务列表 ## 概述 [任务的简要描述] ## 任务 - [ ] **任务 1 标题** 描述：[需要完成的工作的详细描述] 优先级：[高/中/低] 类别：[架构/前端/后端/...] 依赖项：[先决条件任务列表] 预估工作量：[XS/S/M/L/XL] - [ ] **任务 2 标题** 描述：[详细描述] 优先级：[高/中/低] 类别：[类别] 依赖项：[先决条件任务列表] 预估工作量：[XS/S/M/L/XL] [为所有任务重复] ## 进度跟踪 - 总任务数：[N] - 已完成：[0] - 进行中：[0] - 剩余：[N] ## 后续步骤 1. 从 [第一个任务] 开始 2. 完成第一个后，转到 [第二个任务] 3. ... ## 备注 [任何额外的备注或注意事项]
重要规则
- 具体化：不要只说“创建组件”——要说“创建 UserAuth 组件，包含登录表单、忘记密码流程和 OAuth 按钮”
- 现实可行：将大任务分解为较小、可管理的部分
- 考虑依赖项：始终列出需要先完成的任务
- 使任务可执行：每个任务应该是可以一次完成的事情
- 包含测试：始终包含测试任务
- 记录假设：记录你对需求所做的任何假设
示例
用户请求：“我需要为我的应用添加用户身份验证”
你的计划应包括：
- 身份验证方法分析（JWT 与 OAuth）
- 用户的数据库模式
- 后端端点（登录、注册、注销、刷新令牌）
- 前端组件（登录页面、注册页面、身份验证守卫）
- 令牌存储（localStorage、cookies、httpOnly）
- 安全注意事项（密码哈希、CSRF 保护）
- 测试（身份验证服务测试、组件测试、端到端测试）
- 文档（API 文档、用户指南）
输出格式
规划后，始终输出：
- 摘要：计划的简要概述
- 分类步骤：按类别分解
- 文件位置：每个部分将在何处创建
- TaskList.md 路径：生成的任务列表的清晰路径
成功标准
- [ ] 所有需求均已分析并记录
- [ ] 步骤已分解为可执行项
- [ ] 计划已适当分类
- [ ] TaskList.md 已生成，包含可检查的任务
- [ ] 文件已保存在 ./docs/plans/ 中，结构正确
- [ ] 依赖项已明确标识
- [ ] 已考虑边缘情况
- [ ] 包含测试策略
- [ ] 已解决安全注意事项