用途
该技能用于调查代码背后的动机与意图,回答“为什么 X 会这样工作”“为什么我们选了 Y”这类问题,也覆盖设计理由、回归问题、事后复盘以及有数据支撑的阈值。它与回答“代码做什么、如何工作”的 companion how 技能互补,why 关注的是“是什么力量塑造了代码当前形态”。
主要能力
- 代码锚定:在派出调查员之前,先构建种子上下文,包括文件路径与行号范围、关键符号、最近触及目标的提交、合并提交中的 PR 编号及关联工单 ID。常用命令包括
git blame -L <start>,<end> <file>、git log --follow -p -- <file>、git log --oneline -20 -- <file>、git log -1 --format=%B <commit>,并通过gh pr view <number> --json ...拉取 PR 正文与讨论。 - MCP 发现与分类:列出当前会话可用的 MCP 服务与工具,将其映射到七类证据:源代码历史、工单追踪、长文文档、实时团队聊天、基础设施可观测性、错误/异常追踪、产品分析仓库。源代码历史始终可通过 git 与 gh 获得。
- 并行调查:为每个有对应 MCP 的类别各派一名调查员,在同一消息中并发运行,每人只负责一个工具或 MCP。每名调查员会获得填充好的调查员提示模板、对应类别的来源 playbook(必要时附带事故复盘 playbook)、代码锚定以及用户原始问题。
- 综合与呈现:由一名综合器汇总发现,包括空结果与有理由跳过的类别,并遵循认识论框架(置信度框架),最终按固定结构呈现:问题、相关代码、发现内容、可合理推断的内容、竞争性假设、尚不知道的内容、已咨询来源、置信度摘要。若用户的 why 问题是修改代码的前奏,还会将沿革发现转化为“保留 / 变更 / 避免 / 风险”的约束集。
使用方式
该技能以调查流程组织:先理解目标与问题,再建立代码锚定,然后并行派出调查员,最后由综合器汇总并以置信度分离的方式呈现。操作姿态要求像谨慎、精确的调查员,诚实区分已知与推断,综合器必须遵循认识论框架中的措辞指南。所有子代理以 generalPurpose 且 readonly: false(agent 模式)派出,不使用 readonly/Ask 模式,因为那会剥离 MCP 访问能力;但调查员本身不应写入任何内容。模型选择按规则中的角色行取值,缺失时使用默认值,值为 auto 或 inherit-parent 时保持未设置。
适用场景
- 询问某段代码、模式、功能或具名设计决策的设计理由、权衡取舍、驱动性边界情况或外部约束。
- 调查死代码或进行大范围历史追溯。
- 当目标代码看起来具有防御性(空值检查、重试逻辑、超时处理、限流、功能开关、出口守卫、OOM 处理)时,附加事故复盘 playbook 进行调查。
限制
- 仅在目标清晰或可从对话上下文合理推断时推进;目标模糊时会先说明自己的理解再继续。
- 跳过某类调查员必须有明确书面理由并记入“已咨询来源”:要么该类别在当前环境无可用 MCP(标记为缺口而非选择),要么来源可证明无关(门槛很高)。
- 只有当确认七类可用类别搜索都会冗余时,才可内联回答,且应明确说明,这种情况应很少见。
- 需避免近因偏误,不能假定最近提交就是权威,当前形态往往是许多早期决策的累积。
- 关于收费、价格、平台或具体效果,资料暂未提供。