用途:探讨代码背后的动机与意图——为何这样构建、考虑过哪些边界情况、受哪些产品、业务或运营约束影响、否决过哪些替代方案。它是 how 技能的姊妹篇:how 回答代码做什么、如何工作,why 回答是什么力量塑造了它。
主要能力:历史背景散落在七类证据中——源码控制历史、问题或工单跟踪、长文文档、团队实时聊天、基础设施可观测性、错误或异常跟踪、产品分析仓库。技能在运行时枚举可用 MCP,将每个映射到一个类别,并行查询全部七类,再做显式置信度校准的综述。已检索类别的空结果视为关于决策如何做出的一等证据,与正面发现一并报告。默认追求覆盖而非最小化。
使用方式:先理解目标与问题,建立代码锚点(文件路径、行号、关键符号、涉及提交、PR 号),可用 git blame、git log --follow -p、git log --oneline、git log 查看 PR 号,用 gh pr view 拉取 PR 正文与讨论。随后默认并行启动调查者,每个可用证据类别一个,每个调查者获得基础提示、对应类别手册、必要时的事后复盘参考、代码锚点与原始问题。最后启动一个综合者,产出带置信度权重、引用证据的叙述,区分“我们所知的”与“我们推断的”,并诚实说明空白与空结果来源。
适用场景:设计理由、权衡与替代方案、防御性边界情况、外部强制约束、死代码成因、广泛考古式历史梳理。
限制:工单会失效、聊天会删除、提交信息会说谎,原始作者可能已离职,必须区分已知与推断。每条意图主张需引用具体提交哈希、PR 号、工单 ID、文档 URL、聊天永久链接或代码注释,否则只能标为推断。证据间接时使用“似乎”“可能”“表明”等措辞,不得为显得权威而删除限定语。信息不足时明确说明,不编造。部分参数、收费与价格信息暂未提供。