用途:调查代码背后的动机与意图,回答“为什么这样做”“为什么选 Y”等设计理由、取舍、历史遗留、死代码或回归与事后复盘问题。它是 how 技能的配套,how 说明代码做什么,why 追问是什么力量塑造了它。
主要能力:默认并行展开调查,先建立代码锚点(文件路径与行号、关键符号、近期提交、合并提交中的 PR 编号),再用只读来源逐类核查。覆盖七类证据:源代码历史、工单/议题跟踪、长文档、实时团队聊天、基础设施可观测性、错误/异常跟踪、产品分析仓库。未搜到的类别记为 null 结果而非跳过。产出结构含问题、相关代码、发现、可合理推断、竞争假设、未知项、来源与置信度小结;若之后要改代码,还转成保留/变更/避免/风险约束集。
使用方式:代码锚点命令包括 git blame -L <start>,<end> <file>、git log --follow -p -- <file>、git log --oneline -20 -- <file>、git log -1 --format=%B <commit>,拉取 PR 用 gh pr view <number> --json title,body,author,createdAt,mergedAt,labels,closingIssuesReferences,comments,reviews。各分类参考 references/sources/*.md 及 incident-postmortem.md,调查者用 investigator-prompt.md,综合者用 synthesizer-prompt.md 与 epistemics.md。
限制:仅限只读和已授权来源,禁止写作用域、转发凭据或发送消息;某来源被拒绝即视为不可用证据,不得据此切换工具或推断答案。需验证本地 Git 检出与 gh 远程可访问性。资料中“只读模式移除 MCP 访问”的说法被标为未经验证的政策,不作为平台契约。应避免近因偏差,不能假定最近提交就是权威答案。