SuperAPI AI 工具集

why

编程与开发

查看项目

更新于 11-19 03:06

技能介绍

用途

Why 技能用于调查代码背后的动机与意图,是 how 技能的补充。how 回答代码做什么、如何工作;why 回答是什么力量导致代码形成当前形态。适用于“为什么 X 这样工作”“为什么我们选择 Y”、设计理由、回归、事后复盘、数据支撑阈值等问题。

主要能力

  • 解析用户问题,确定调查目标(代码块、模式、功能或命名的设计决策)与问题类型(设计理由、权衡、边缘案例、外部约束、死代码或历史梳理)。
  • 建立代码锚点:获取相关文件路径与行范围、关键符号、最近提交列表、合并提交中的 PR 编号,并通过 git blame、git log、gh pr view 等命令收集种子上下文。
  • 发现可用 MCP,并将其映射到七类证据来源:源代码管理历史、工单跟踪、长文档、实时团队聊天、基础设施可观测性、错误/异常追踪、产品分析仓库。
  • 默认并行启动调查子代理,每个可用证据类别一个,各自负责一个工具或 MCP,并接收基础提示、类别 playbook、代码锚点和用户原始问题。
  • 对防御性代码(空检查、重试逻辑、超时处理、限流、功能开关、出口防护、OOM 处理)额外提供跨领域的事后复盘 playbook。
  • 启动综合子代理,整合调查发现(包括空结果和跳过类别),遵循置信度框架与输出格式。
  • 输出结构包括:问题、相关代码、发现内容、可合理推断、竞争假设、未知内容、已咨询来源、置信度摘要。若用户的问题是为修改代码做铺垫,还会将沿革发现转化为 Preserve / Change / Avoid / Risk 约束集。

使用方式

该技能以技能文件形式提供,包含多个参考文件:epistemics.md(置信度层级与措辞指南)、investigator-prompt.md(调查子代理基础提示模板)、source-playbook.md(类别 playbook 索引)、sources/*.md(每类一个自包含示例 playbook,外加跨领域的 incident-postmortem.md)、synthesizer-prompt.md(综合子代理提示模板及输出格式)。使用时按步骤执行:理解目标与问题、建立代码锚点、发现 MCP 并启动并行调查员、综合、呈现。子代理配置中指定 subagent_type 为 generalPurpose,模型按 pstack-models.mdc 规则中的角色行取值或使用默认值;调查员默认模型为 grok-4.7-xhigh-fast,综合器默认模型为 claude-opus-5-5-max。readonly 设为 false(agent 模式),因为 readonly/Ask 模式会剥离 MCP 访问权限。

适用场景

  • 询问某段代码为何采用当前设计、为何选择某个方案。
  • 调查回归、事后复盘、数据支撑的阈值设定。
  • 需要跨源代码、工单、文档、聊天、监控、错误追踪、产品分析等多来源拼凑决策背景。
  • 在修改代码前需要理解历史沿革并形成约束集。

限制

  • 调查质量依赖环境中可用的 MCP;某类别无匹配 MCP 时只能标记为缺口,无法搜索该来源。
  • 跳过调查员需要明确书面理由,仅当无 MCP 或来源可证明无关时才允许。
  • 需避免近期偏差,不能假设最近提交就是权威,应追溯更早决策。
  • 输出需保持置信度分离,不得改写置信度语言。
  • 具体收费、价格、平台支持范围等事实暂未提供。