用途:面向大规模代码库研究。适合理解复杂跨领域系统、进行多智能体并行调研与综合排查。小范围单点查询应改用 /code-explore,双 Claude+Codex 确认用 /code-investigate,Git 历史追踪用 /git-investigate,代码评审用 /codex-review-fast。
主要流程:Phase 0 意图分析,解析研究问题、用 Grep 估算相关文件数,若少于等于 25 个文件则重定向到 /code-explore,并规划 2-3 个不重叠探索分片,分片策略优先用户指定(--areas),其次按领域聚类,最后按目录回退,产出所有权矩阵。Wave 1 广度(强制):并行派发 2-3 个 Explore 智能体,各自负责一个分片,须在单条消息内并行派发。每个智能体遵循 80/20 契约:80% 用于主分片,20% 用于外围视角(安全、边界、跨领域),外围发现最多 2 条且必须有 file:line 证据并打标签。波次之间收集结果、构建论断登记表、按影响×不确定性排序问题、生成上下文包(只传有证据的事实与开放问题,不传递上一波结论)。Wave 2 深度(强制):聚焦最高影响热点,2-3 个智能体独立验证 Wave 1 假设。
完整度门禁:score = round(100 × (0.7 × (1 - novelty_rate) + 0.3 × is_zero(critical_open)))。score>=80 且无关键开放问题时停止并输出报告;score>=80 但有关键问题时执行 Wave 3;Wave 3 后仍低于 80 则停止并标注 Inconclusive。硬失败条件强制继续:未回答的关键用户问题、未解决的高严重度矛盾、高影响论断缺少证据。--waves 为硬上限,超出会输出 Inconclusive。Wave 3 跨领域为可选,仅在关键问题属跨领域、发现超 70% 集中在一个子系统或涉及高风险管理时触发。
参数:<query> 必填;--agents N 每波智能体数(1-3,默认 3);--waves N 最大波次(2-3,默认 3 自适应);--areas "a, b, c" 手动分片;--quick 重定向到 /code-explore。派发失败时回退为 general-purpose,仍失败则降级为单智能体内联探索并标注覆盖缺口。
输出为探索报告,包含完整度评分、执行波次与派发数、执行摘要、逐波发现、论断登记表、覆盖矩阵、外围主动发现、分歧与残余风险。报告遵守证据脱敏规则,只引用 file:line,不记录密钥。不执行 git add/commit/push。具体报告模板与综合算法见 references/synthesis.md,智能体提示词模板见 references/agent-prompt.md。