# 计划生成器技能 ### 第 1 步：分析需求解析用户需求： * 提取明确的需求 * 识别隐含的需求 * 确定规划范围 * 评估复杂性 ### 第 2 步：协调专家请求相关代理商提供规划意见： * **分析师**：业务需求和市场背景 * **PM** ：产品要求和用户故事 * **架构师**：技术架构和设计 * **数据库架构师**：数据要求 * **UX 专家**：接口要求 ### 步骤 3：生成计划结构按照此 **EXECUTABLE** 结构创建计划： # 计划：[标题] ## 执行摘要 [2-3句话概述] ## 目标 - [目标 1] - [目标 2] ## 阶段 ### N 阶段：[阶段标题] **依赖关系**：[阶段编号或“无”] **并行 OK**：[是/否 - 任务可以同时运行吗？] #### 任务 - [ ] **N.1** [任务描述]（~X 分钟） - **命令**：`实际的 shell 命令在这里` - **验证**：`验证成功的命令` - **回滚**：`如果需要则撤消命令` - [ ] **N.2** [任务描述]（~X 分钟）[⚡ 并行 OK] - **命令**：`...` - **验证**：`...` #### N 阶段错误处理如果任何任务失败： 1. 对已完成的任务运行回滚命令（相反顺序） 2. 文档错误： `echo "Phase N failed: [error]" >> .claude/context/memory/issues.md` 3. 不要进入 N+1 阶段 #### N阶段验证门 ````bash # 必须全部通过才能继续 [验证命令] ```` ## 风险风险|影响 |缓解措施 |回滚 ---|---|---|--- 【风险】| [高/中/长] | [攻略] | [命令] ## 时间线总结相|任务 |预计。时间 |平行线？ ---|---|---|--- 1 | 5 | 30 分钟 |部分 2 | 3 | 20 分钟 |否 ### 可执行任务格式（强制）每项任务必须包括： 1. **复选框** - `- [ ]` 用于进度跟踪 2. **ID** - `N.M` 格式供参考 3. **时间估计** - `(~X 分钟)` 4. **命令** - 实际可执行命令 5. **Verify** - 确认成功的命令 6. **回滚** - 撤消命令（如果适用） 7. **并行标记** - `[⚡并行OK]`如果可以并发运行 ### 指南 - 定义明确的目标 - 分为几个阶段（总共 <=7 个阶段） - 每个阶段有<=7个任务 - 每个任务都有可执行命令 - 包括阶段之间的验证门 ### 步骤 4：评估风险识别风险和缓解措施： - 技术风险 - 资源风险 - 时间线风险 - 依赖性风险 - 缓解策略 ### 第 5 步：验证计划验证计划的完整性： - 满足所有要求 - 依赖关系映射 - 定义成功标准 - 已识别的风险 - 计划可行 ### 第 6 步：生成工件使用模板渲染器技能创建计划工件： **使用模板渲染器**：创建计划数据结构后，调用模板渲染器生成格式化输出： ```javascript // 将计划数据映射到模板标记常量计划令牌 = { PLAN_TITLE: 计划.标题, 日期: new Date().toISOString().split('T')[0], FRAMEWORK_VERSION: 'Agent-Studio v2.2.1', 状态：计划.状态 || “第 0 阶段 - 研究”， EXECUTIVE_SUMMARY：计划.executiveSummary， TOTAL_TASKS: `${plan.totalTasks} 原子任务`, FEATURES_COUNT：计划.features.长度， ESTIMATED_TIME：计划.estimatedTime，策略：计划.策略， KEY_DELIVERABLES_LIST: plan.keyDeliverables.map(d => `- ${d}`).join('\n'), // 阶段特定的标记 PHASE_0_PURPOSE：计划.阶段[0].目的， PHASE_0_DURATION: plan.phases[0].duration, PHASE_1_NAME：计划.阶段[1].名称， PHASE_1_PURPOSE：计划.阶段[1].目的， PHASE_1_DURATION：计划.阶段[1].持续时间，依赖项：计划.阶段[1].依赖项， PARALLEL_OK: plan.phases[1].parallelOk ？ '是' : '否', VERIFICATION_COMMANDS：plan.phases[1].verificationCommands， // 根据需要添加更多阶段标记 }; // 调用模板渲染器技能技能（{ 技能：“模板渲染器”，参数：{ templateName: '计划模板', 输出路径：`.claude/context/plans/${planId}.md`, 代币：planTokens } }); ```` **输出位置**： - 计划降价（来自模板）：`.claude/context/plans/.md` - 计划 JSON（结构化数据）：`.claude/context/plans/.json` - 计划摘要（供快速参考） <计划类型> **功能开发计划**： - 目标：功能目标 - 步骤：分析->设计->实施->测试 - 代理：分析师 -> PM -> 架构师 -> 开发人员 -> QA **重构计划**： - 目标：代码质量目标 - 步骤：分析->规划->实施->验证 - 代理：代码审查员 -> 重构专家 -> 开发人员 -> QA **迁移计划**： - 目标：迁移目标 - 步骤：分析->计划->执行->验证 - 代理：架构师 -> 传统现代化者 -> 开发人员 -> QA **架构规划**： - 目标：架构目标 - 步骤：分析 -> 设计 -> 验证 -> 文档 - 代理：架构师 -> 数据库架构师 -> 安全架构师 -> 技术作家 <整合> **与 Planner Agent 集成**：规划代理使用此技能来： - 根据需求生成计划 - 协调专家的意见 - 验证计划的完整性 - 跟踪计划执行情况 <最佳实践> 1. **尽早协调**：在最终确定计划之前获取专家的意见 2. **保持步骤集中**：每个计划部分 <=7 个步骤 3. **映射依赖关系**：明确确定先决条件 4. **评估风险**：主动识别和减轻风险 5. **彻底验证**：确保计划完整且可行 <例子> <格式示例> **计划输出示例** **命令**：“生成用户身份验证功能计划” **生成的计划**： ``降价 # 计划：用户认证功能 ## 执行摘要添加带有登录/注销端点的基于 JWT 的身份验证。包括密码散列、会话管理和安全测试。 ## 目标 - 实施基于 JWT 的身份验证 - 支持登录、注销和会话管理 - 提供安全的密码处理 ## 阶段 ### 第 1 阶段：设置和设计 **依赖关系**：无 **并行OK**：部分 #### 任务 - [ ] **1.1** 创建功能分支（~2 分钟） - **命令**：`git checkout -b feature/auth` - **验证**：`git分支--show-current | grep 功能/auth` - [ ] **1.2** 创建身份验证模块目录（~1 分钟）[⚡ 并行 OK] - **命令**：`mkdir -p src/auth` - **验证**：`ls -d src/auth` - [ ] **1.3** 设计授权架构（~15 分钟） - **命令**：`任务（{task_id：'task-1'，代理：“架构师”，提示：“设计JWT身份验证...”}）` - **验证**：`ls .claude/context/artifacts/auth-design.md` #### 第一阶段验证门 ````bash git 分支 --显示当前 | grep feature/auth && ls src/auth && ls .claude/context/artifacts/auth-design.md ### 第 2 阶段：实施 **依赖性**：阶段 1 **并行 OK**：否（顺序 TDD） #### 任务 * **2.1** 编写身份验证端点测试（约 10 分钟） * **命令** : `任务({ task_id: 'task-2', 代理: "开发人员", 提示: "TDD: 为 /login 端点编写失败的测试" })` * **验证** : `npm test -- --grep "login" 2>&1 | grep -E“失败|失败”` * **回滚** : `git checkout -- src/auth/__tests__/` * **2.2** 实施登录端点（约 15 分钟） * **命令** : `Task({ task_id: 'task-3', agent: "developer", Prompt: "实现登录以通过测试" })` * **验证** : `npm test -- --grep "login" 2>&1 | grep -E "通过|PASS"` * **2.3** 实施注销端点（约 10 分钟） * **命令** : `任务({ task_id: 'task-4', 代理: "开发人员", 提示: "TDD: 注销端点" })` * **验证** : `npm test -- --grep "logout" 2>&1 | grep -E "通过|PASS"` #### 第 2 阶段错误处理如果任何任务失败： 1. 运行：`git stash && git checkout -- src/auth/` 2. 文档： `echo "第 2 阶段失败：$(date)" >> .claude/context/memory/issues.md` 3. 不要进入第 3 阶段 #### 第二阶段验证门 npm test -- --grep "auth" && echo "所有身份验证测试均通过" ### 第 3 阶段：安全审查 **依赖关系**：第 2 阶段 **并行 OK**：是 #### 任务 * **3.1** 安全审核（~20 分钟）[⚡ 并行 OK] * **命令** : `任务({ task_id: 'task-5', 代理: "安全架构师", 提示: "审核身份验证实现" })` * **验证** : `ls .claude/context/reports/security/security-audit.md` * **3.2** 运行安全测试（~5 分钟）[⚡ 并行 OK] * **命令** : `npm run test:security` * **验证** : `echo $?` (退出代码 0) ## 风险风险|影响 |缓解措施 |回滚 ---|---|---|--- 智威汤逊秘密曝光 |高|使用环境变量 |立即轮换秘密 SQL注入|高|参数化查询 | `git 恢复 HEAD` ## 时间线总结相|任务 |预计。时间 |平行线？ ---|---|---|--- 1 | 3 | 18 分钟 |部分 2 | 3 | 35 分钟 |否 3 | 2 | 25 分钟 |是的 **总计** | **8** | **~78 分钟** | **计划生成后**，调用模板渲染器： ```javascript // 将计划数据映射到标记常量标记 = { PLAN_TITLE: '用户身份验证功能', 日期: '2026-01-28', FRAMEWORK_VERSION: 'Agent-Studio v2.2.1', 状态：“第 0 阶段 - 研究”， EXECUTIVE_SUMMARY: '使用登录/注销端点添加基于 JWT 的身份验证...', TOTAL_TASKS: '8 个原子任务', FEATURES_COUNT: '1', ESTIMATED_TIME: '~78 分钟', 策略：“基础优先 → 核心功能 → 安全审查”， KEY_DELIVERABLES_LIST: '- 身份验证模块\n- 登录/注销端点\n- 安全审核', PHASE_1_NAME：“设置和设计”， PHASE_1_PURPOSE: '创建功能分支并设计架构', PHASE_1_DURATION：“18 分钟”，依赖项：“无”， PARALLEL_OK: '部分', VERIFICATION_COMMANDS: 'git 分支 --show-current | grep 功能/auth && ls src/auth', }; // 使用模板渲染计划技能（{ 技能：“模板渲染器”，参数：{ templateName: '计划模板', 输出路径：'.claude/context/plans/user-auth-plan.md', 代币：代币 } }); ## 铁律 1. **始终**在每个任务中包含可执行命令 - 没有命令的任务是愿望，而不是行动；带着愿望的计划在执行时停滞不前，因为代理人没有什么可运行的。 2. **永远不要** 创建一个包含超过 7 个任务的阶段 - 超过 7 个任务的阶段会导致认知过载，失去并行机会，并使回滚范围界定变得不可能。 3. **始终**在每个阶段之间包含一个验证门 - 不进行验证就意味着在第 N+3 阶段会发现第 N 阶段的失败，从而使回滚变得更加复杂。 4. **永远不要** 生成没有明确回滚命令的计划来进行破坏性操作 - 没有回滚路径的计划是不可恢复的；尝试操作之前必须指定回滚。 5. **始终**在最终确定计划之前协调专家的意见（分析师、项目经理、架构师）——未经领域专家审查而生成的计划通常会错过隐含的需求，从而产生不完整的执行路径。 ## 规则 ### 规划铁律每个任务都必须有一个可执行的命令没有命令的任务不是任务——而是愿望。 ### 强制要素 * **每个任务**必须有：复选框、ID、时间估计、命令、验证 * **每个阶段**必须有：验证门、错误处理 * **每个风险**必须有：回滚命令 ### 反模式（不要）反模式|问题 |修复 ---|---|--- 无需命令“安装 X” |不可执行 |添加：`cp -r source dest` “验证 Y 是否有效”|模糊|添加：`npm 测试 | grep PASS` “更新Z” |什么文件？有什么变化？ |添加精确的“Edit”或“sed”命令没有时间估计 |无法追踪进度 |将 `(~X min)` 添加到每个任务没有回滚|无法从失败中恢复 |添加回滚命令 ### 质量检查表在最终确定任何计划之前，请验证： * 我可以复制粘贴每个命令并运行它吗？ * 每个验证命令都有明确的通过/失败输出吗？ * 每个破坏性操作都会回滚吗？ * 时间估算是否现实且细致？ * 并行任务是否标有⚡？ ## 模板集成该技能使用“模板渲染器”技能来生成格式化计划： **集成流程**： 1. plan-generator 创建结构化计划数据（JSON） 2. 将计划数据映射到模板标记（参见步骤 6） 3. 使用计划模板调用模板渲染器 4. 将渲染后的计划输出到 `.claude/context/plans/` **所需的令牌**（对于计划模板）： * 核心：`PLAN_TITLE`、`DATE`、`FRAMEWORK_VERSION`、`STATUS` * 摘要：`EXECUTIVE_SUMMARY`、`TOTAL_TASKS`、`ESTIMATED_TIME`、`STRATEGY` * 阶段：`PHASE_N_NAME`、`PHASE_N_PURPOSE`、`DEPENDENCIES`、`PARALLEL_OK` * 验证：`VERIFICATION_COMMANDS` 有关完整的令牌列表，请参阅“.claude/templates/plan-template.md”。 ## 相关技能 * [`template-renderer`]() \- 使用令牌替换渲染计划模板 * [`writing-plans`]() \- 带有完整实现代码的小型任务计划 ## 内存协议（强制） **开始之前：** 猫.克劳德/上下文/内存/learnings.md **完成后：** * 新模式 -> `.claude/context/memory/learnings.md` * 发现问题 -> `.claude/context/memory/issues.md` * 做出决定 -> `.claude/context/memory/decisions.md` > 假设中断：您的上下文可能会重置。如果它不在记忆中，那么它就没有发生。

计划生成器

包含技能