create-plan

创建实施计划

生成全面的实施计划，提供战略指导，但不进行实际代码更改。

适用场景

• 用户明确要求制定计划、路线图或实施策略
• 复杂任务需要在实施前进行结构化拆解
• 需要评估风险并分析替代方案
• 实施前分析架构决策

规划流程

1. 初步评估

调研代码库，了解：

• 项目结构和组织方式
• 相关文件和组件——仔细阅读，了解完整流程
• 现有模式和约定
• 潜在挑战和风险
• 从入口点到最终使用位置的数据流

使用 search、sem_search 和 read 工具检查代码库。如果用例需要更深入的调研，请使用 sage。在计划中明确使用 filepath:line 格式引用来源。

2. 制定战略计划

在 plans/ 目录中生成一个 Markdown 计划文件，命名格式为：plans/{YYYY-MM-DD}-{task-name}-v{N}.md

示例：plans/2025-11-24-add-auth-v1.md

3. 验证计划

**必须：**运行验证脚本，确保计划符合所有要求：

./.forge/skills/create-plan/validate-plan.sh plans/{YYYY-MM-DD}-{task-name}-v{N}.md

修复所有错误或警告，并重新验证，直到计划通过所有检查。

4. 计划结构

# [Task Name]

## Objective

[Clear statement of goal and expected outcomes]

## Implementation Plan

- [ ] 1. [First task with detailed description and rationale]
- [ ] 2. [Second task with detailed description and rationale]
- [ ] 3. [Third task with detailed description and rationale]

## Verification Criteria

- [Criterion 1: Specific, measurable outcome]
- [Criterion 2: Specific, measurable outcome]

## Potential Risks and Mitigations

1. **[Risk Description]**
   Mitigation: [Specific mitigation strategy]

2. **[Risk Description]**
   Mitigation: [Specific mitigation strategy]

## Alternative Approaches

1. [Alternative 1]: [Brief description and trade-offs]
2. [Alternative 2]: [Brief description and trade-offs]

关键要求

• 创建计划后，始终使用 ./.forge/skills/create-plan/validate-plan.sh 验证计划
• 所有实施任务始终使用复选框格式（- [ ]）
• 实施计划部分不得使用编号列表或普通项目符号
• 计划中不得编写代码、代码片段或代码示例
• 编写全面的任务，说明内容、原因、受影响文件和集成点
• 使用 filepath:line 格式引用文件（例如 crates/forge_repo/src/provider.rs:45）
• 为每项任务提供明确的理由
• 提供具体、可衡量的验证标准
• 记录针对模糊需求所作的假设
• 关注战略层面的“做什么”和“为什么做”，而非战术层面的“怎么做”
• 使用自然语言描述需要完成的工作，而不是代码

最佳实践

• 需求模糊时作出合理假设
• 根据代码库模式推断最佳实践
• 针对复杂问题提供多种解决路径
• 兼顾全面性和可执行性
• 制定实施 Agent 能够逐步执行的计划

边界

这是一项仅限规划的技能：

• ✅ 调研代码库并分析结构
• ✅ 制定战略计划并编写文档
• ✅ 评估风险并提出替代方案
• ✅ 使用自然语言描述实施方案
• ❌ 进行实际代码更改
• ❌ 修改文件或创建实现
• ❌ 运行测试或构建命令
• ❌ 在计划中编写代码、代码片段或代码示例

如果用户要求实施工作，请建议切换到实施 Agent。