arc-planning-work

Arc Planning Work

在编写代码前制定实施计划。开头的关键词是 read-before-plan：在提出任务前，先检查工作项和相关代码。

如需使用共享计划模板，请加载 PLAN_FORMAT.md。检测模式后，如需了解特定目标的命令，请加载 GITHUB_MODE.md、AGILE_ACCELERATOR_MODE.md 或 PRD_MODE.md。如需同步 docs/ 中的计划和进度文件，请遵循 arc-implementation-plan-progress/references/output-contract.md。

步骤

1. 检测计划来源。

   • GitHub 模式：问题编号/URL、#123 或明确提出 GitHub 问题请求。
   • Agile Accelerator 模式：W-000000 工作项或 Salesforce Agile Accelerator 用户故事。
   • PRD 转计划模式：用户要求根据现有 PRD 文档制定实施计划。
   • 如果来源不明确，请在制定计划前询问工作项的跟踪位置。

   完成标准：计划只有一个来源模式；否则应停止并询问目标位置/来源。

2. 阅读来源工作项。

   • 在相关情况下，获取问题/用户故事/PRD 正文和评论。
   • 保留来源中的验收标准、约束和背景信息。
   • 不要创建新的用户故事/问题；此技能只为已有工作项制定计划。

   完成标准：来源中的每项验收标准或场景都可用于映射；或者报告无法访问来源的问题。

3. 分析代码库。

   • 阅读工作项引用的文件。
   • 搜索相关组件、路由、模型、测试、文档和类似实现。
   • 找出依赖项、风险和可能的测试位置。

   完成标准：每项计划任务都引用具体文件/区域，或明确说明文件路径未知的原因。

4. 起草实施计划。

   • 使用有序、独立的任务。
   • 明确列出具体文件变更和测试策略。
   • 将每项验收标准映射到一个或多个任务和验证方法。
   • 如有来源 ID，请据此命名功能分支。

   完成标准：其他 Agent 无需重新确认范围或询问基本的任务顺序，就能实施该计划。

5. 将计划发布到来源位置。

   • GitHub：在问题下发表评论。
   • Agile Accelerator：追加到 agf__Details__c，并在适当时更新状态。
   • PRD 转计划：写入 ./plans/<feature>.md 或用户指定的计划路径。
   • 如果代码库中有匹配的 docs/sprints/ 计划，请更新冲刺计划文档。

   完成标准：计划已发布/写入指定目标位置；否则报告具体的权限/工具阻碍。

6. 创建同步的 docs/ 计划和进度文件。

   • 根据来源工作项确定 <ID>：如有跟踪 ID，则使用该 ID（例如 W-000025、issue-42）；否则根据工作项标题生成简短的 kebab-case slug。
   • 确保项目根目录中存在 docs/。
   • 按照 arc-implementation-plan-progress/references/output-contract.md 编写 docs/<ID>-IMPLEMENTATION_PLAN.md（将起草的计划映射到必需章节：产品目标、基线、含验收标准的里程碑、风险和紧要的后续步骤）。
   • 使用 arc-implementation-plan-progress/scripts/init_progress_txt.sh docs/<ID>-IMPLEMENTATION_PLAN.md docs/<ID>-progress.txt 创建或更新 docs/<ID>-progress.txt；如果脚本不可用，请手动遵循约定模板。
   • 使 docs/ 中的两个文件与第 5 步发布的内容保持同步。

   完成标准：docs/<ID>-IMPLEMENTATION_PLAN.md 和 docs/<ID>-progress.txt 均已创建，且使用相同的 <ID> 前缀，阶段覆盖范围也保持同步。

适用范围

• 使用 arc-creating-user-stories 创建新的 GitHub 用户故事问题待办列表。
• 使用 arc-defining-work 在询问用户要在哪个位置创建工作项后，跨目标创建新的工作项。
• 如果目标输出是根据 PRD 创建新的 GitHub 问题，而非实施计划，请使用 arc-prd-to-issues。
• 在用户批准计划之前，不要开始编码。