用途:为开源项目贡献做策略性规划,把调研结果转化为可执行的实施计划。它接收 pr-research 的输出,生成贡献计划文件,路径为 .agents/plans/YYYY-MM-DD-pr-plan-{repo-slug}.md。
主要能力与流程:先发现并加载 pr-research 产出;再界定范围(具体改什么功能、涉及哪些文件或包、明确排除项、是单个 PR 还是系列);选择要处理的目标 issue 或区域;依据调研定义验收标准(代码质量、PR 要求、项目特定要求);做风险评估(如评审周期、范围蔓延、破坏性变更及其缓解措施);形成实现策略与前置检查清单;最后写出计划产物。输出模板包含执行摘要、范围、目标、验收标准、风险评估、实现策略与下一步。
使用方式:在完成 $pr-research 之后、开始实现之前使用;典型流程为 $pr-research <repo> -> $pr-plan <research> -> 实现 -> $pr-prep。也用于检查某个 PR 计划是否过大,超出范围时拆分为分阶段贡献。
不适用场景:尚未调研仓库、修复错别字等琐碎贡献、内部项目规划(应使用 $plan)。
限制与排错:验收标准需可测量,否则转为具体行为检查;范围过宽时按用户可见变更或子系统边界拆分;风险分析不足时补充集成、评审与回滚风险;计划与仓库惯例冲突时,重新运行 $pr-research 刷新约束。官方未提供收费、价格、支持平台等信息。