SuperAPI AI 工具集

why

通用与其它

查看项目

更新于 10-16 02:32

技能介绍

用途:why 技能用于调查代码背后的动机与意图,回答设计理由、权衡取舍、回归问题或事后复盘。它是 how 技能的补充——how 说明代码做什么、如何运行,why 说明哪些力量促成了当前形态。

主要能力:以谨慎、精确的调查员姿态运作,区分已知事实与推断,遵循置信度框架。流程包括:解析用户问题与目标;用 git 命令锚定代码,如 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 讨论;随后按证据类别并行启动调查子代理,覆盖源码控制、工单跟踪、长文档、团队聊天、基础设施可观测性、错误跟踪、产品分析仓库七类,每类对应一个 MCP,各自独立;最后由综合子代理汇总。

使用方式:默认执行完整并行调查。每个子代理配置 subagent_type: generalPurpose,model 取 why 调查员行或默认 grok-4.7-xhigh-fast,readonly: false(agent 模式,只读模式会剥夺 MCP 访问)。综合子代理 model 默认 claude-opus-5-5-max。输出结构包括:问题、涉及代码、发现内容、合理推断、竞争假设、未知项、已查来源、置信度摘要。若 why 问题是改代码的前置,还会将沿革发现转为 Preserve / Change / Avoid / Risk 约束集。

适用场景:设计理由、权衡取舍、防御性代码(空值检查、重试、超时、限流、特性开关等)、回归与事后复盘、外部约束、死代码、历史梳理。

限制:只有源码控制类别始终可用;其余类别需环境中存在对应 MCP,否则记录为缺口而非主动跳过。跳过某调查员需书面理由,且仅限无对应 MCP 或可证明无关。若 Task 工具拒绝 slug,则使用默认值并说明;默认值也被拒时,采用错误信息中同族最近的有效 slug。仅当确认七类搜索全部冗余时才可内联回答,且应明确说明。其他细节如具体收费、价格、平台支持暂未提供。