用途:Pathfinder 作为编排器(orchestrator),用于代码库理解与架构收敛。它输出图表、重复点报告、统一方案流程图和交接提示词,不写实现代码。
主要能力:按功能边界盘点代码库;为每个功能产出 Mermaid flowchart TD,节点标注 file:line;查找功能内与跨功能的重复关注点(每条声明需至少引用两处 file:line 证据);提出最简统一设计并给出合并后组件的单一入口与旧调用点改写方式;为每个统一系统生成可直接运行 /make-plan 的提示词。
使用方式:分四个阶段。Phase 0 功能发现(必须先做):部署一个子代理遍历源码树、读顶层 README / CLAUDE.md,产出功能清单,编排器审核边界并写入 00-features.md,边界未批准前不得展开。Phase 1 按功能并行部署子代理产出各功能流程图,写入 01-flowcharts/<feature>.md。Phase 2 并行部署“功能内重复”“跨功能重复”两个子代理,综合写入 02-duplication-report.md。Phase 3 由编排器自己写 03-unified-proposal.md,含一个合并的统一系统 Mermaid 图。Phase 4 每个统一系统写一条 /make-plan 提示词到 04-handoff-prompts.md。
产物目录:仓库根目录 PATHFINDER-<YYYY-MM-DD>/,包含 00-features.md、01-flowcharts/<feature>.md、02-duplication-report.md、03-unified-proposal.md、04-handoff-prompts.md。子代理报告须含所读文件路径与行范围、具体函数名与调用点、标注 file:line 的 Mermaid 图、置信度与已知缺口,否则拒收并重新部署。
原则与限制:证据优先于直觉;先描述现状(Phase 0–2)再描述应然(Phase 3);最简统一优先,倾向删除而非抽象;合法特化不算重复。拒绝的反模式包括:为“灵活性”新增抽象层、用功能开关保留双路径、用注册表/工厂替代 switch、为“以防万一”保留分叉行为。Pathfinder 止于交接提示词,后续由 /make-plan 和 /do 接手。未提供收费、安装命令、平台或运行环境信息。