用途:why 技能用于调查代码背后的动机与意图,回答“为什么 X 这样工作”“为什么我们选了 Y”、设计理由、回归、事后复盘或数据支撑的阈值等问题。它与回答“代码做什么、怎么工作”的 how 技能互补,why 关注是什么力量塑造了代码当前形态。
主要能力:先理解目标与问题,建立代码锚点(文件路径与行范围、关键符号、最近提交、合并提交中的 PR 编号、关联工单),再并行派出调查者。调查者按证据类别划分:源码控制历史、工单跟踪、长文档、实时团队聊天、基础设施可观测性、错误/异常追踪、产品分析数据仓库。源码控制始终可用(git 与 gh),其余类别需环境中存在对应 MCP。每个调查者只负责一个 MCP,并保持 MCP 访问权限,否则会禁用依赖 MCP 的调查者与综合者的引用抽查。调查者不写文件。最后由综合者汇总,保留置信度分层。
使用方式:通过 provider-dispatch.md 解析角色,默认与支持的便携路线是 inherit-parent(或其 auto 别名),按路径传入代码锚点;在 Codex 上通过 codex-tools.md 解析剩余 Claude 工具名。常用命令包括 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 title,body,author,createdAt,mergedAt,labels,closingIssuesReferences,comments,reviews。输出结构为:问题、涉及代码、发现、可合理推断、竞争假设、未知、已查来源、置信度摘要;若问题是为改动代码做准备,还会给出保留/更改/避免/风险的约束集。
适用场景:设计理由与权衡、动机性边界情况、外部约束、死代码、广泛历史追溯,以及防御性代码(空检查、重试、超时、限流、特性开关、出口守卫、OOM 处理)的成因调查。
限制:仅在环境中存在对应 MCP 时才能覆盖相应证据类别,缺失类别应标记为缺口而非主动跳过;跳过需书面理由。目标模糊时需先说明解释再继续。应避免近因偏差,不能假定最近提交即权威。具体收费、价格、平台支持范围等资料暂未提供。