用途:why 用于调查代码背后的动机与意图,回答“为什么 X 是这样工作的”“为什么选了 Y”、设计理由、回归、事后复盘或数据支撑的阈值等问题。它与回答“代码做什么、怎么工作”的 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 title,body,author,createdAt,mergedAt,labels,closingIssuesReferences,comments,reviews 拉取 PR 正文与讨论。
使用方式:默认进行完整并行调查。先列出 Cursor 环境中可用的 MCP,将每个 MCP 映射到一类证据:源码控制历史、工单跟踪、长文档、实时团队聊天、基础设施可观测性、错误/异常追踪、产品分析仓库。源码控制始终通过 git 和 gh 可用。每个有匹配 MCP 的类别生成一个调查员,在单条消息中并发运行,每个调查员只负责一个工具或 MCP。调查员以 generalPurpose 且 readonly: false(agent 模式)运行,不使用 readonly/Ask 模式,因为会剥离 MCP 访问。调查员本身不应写入任何内容。最后生成一个综合器,接收调查结果(含空结果与跳过理由)、代码锚点、原始问题与认识论框架。
适用场景:设计理由与权衡、动机性边界情况、外部约束、死代码、广泛历史梳理;对防御性代码(空检查、重试、超时、限流、特性开关、出口守卫、OOM 处理)可结合事故复盘资料。
限制:仅在环境中有对应 MCP 时才调查该类别,否则记为缺口而非选择;跳过需明确书面理由,且仅限“无可用 MCP”或“可证明无关”两种。输出需保持置信度分层,包含 The Question、The Code in Question、What We Found、What We Can Reasonably Infer、Competing Hypotheses、What We Don't Know、Sources Consulted、Confidence Summary,Sources Consulted 每个调查员一行并注明空结果或跳过原因。若问题是改代码的前置,需将沿革发现转为 Preserve / Change / Avoid / Risk 约束集。需避免近因偏差,不能假设最近提交最具权威性。模型行与默认值、具体 MCP 名称等细节以资料为准,未提供处暂未说明。