SuperAPI AI 工具集

why

编程与开发

查看项目

更新于 11-01 16:53

技能介绍

用途

why 是一个用于调查代码背后动机与意图的技能。它回答“什么力量导致了代码呈现当前形态”,而配套的 how 技能回答“代码做什么以及如何工作”。适用于设计理由、权衡、激励性边界情况、外部约束、死代码或广泛历史梳理等问题。

主要能力

技能以谨慎、精确的调查者姿态运作,诚实区分已知事实与推断,并遵循 references/epistemics.md 中的置信度框架。执行流程包括:

  1. 理解目标与问题:识别目标代码、模式、特性或命名设计决策;若目标模糊,根据对话上下文做出最佳猜测并简要说明解释。
  2. 建立代码锚点:在生成调查者前,内联构建种子上下文,包括文件路径与行范围、关键符号、最近提交、PR 编号、关联工单 ID 等。使用 git blame、git log、gh pr view 等命令收集信息。
  3. 生成并行调查者:默认进行完整并行调查,目标是完整覆盖图而非最小化。先列出可用 MCP 并按证据类别映射(源代码控制历史、问题/工单跟踪器、长文档、实时团队聊天、基础设施可观测性、错误/异常跟踪、产品分析仓库)。源代码控制始终通过 git 和 gh 可用。每个有匹配 MCP 的类别生成一个调查者,所有调查者在一轮中并发生成,每个只负责一个工具或 MCP。每个调查者获得填写的 references/investigator-prompt.md、类别手册、代码锚点和用户原始问题。调查者默认使用 --read-only 和简短简报,保留其 MCP 服务器。
  4. 综合:生成一个综合者,接收调查者发现(包括空结果和跳过类别及理由)、代码锚点、用户原始问题、置信度框架和综合者提示模板。
  5. 呈现:向用户呈现综合者输出,可轻量编辑以提升清晰度或添加上下文,但不得改写置信度语言。

输出格式

结构包括:问题、相关代码、我们发现的内容、我们可以合理推断的内容、竞争性假设、我们不知道的内容、已咨询来源、置信度摘要。保持置信度分离完整,已咨询来源每个调查者一行,包括返回空结果或跳过的调查者及原因。若用户的 why 问题是修改此代码的前奏,则在已咨询来源之后将沿革发现转换为“保留/更改/避免/风险”约束集,供规划变更使用。

适用场景

  • 询问“为什么 X 这样工作”或“为什么选择 Y”
  • 设计理由调查
  • 回归分析
  • 事后复盘
  • 有数据支撑的阈值问题
  • 代码防御性逻辑(空检查、重试逻辑、超时处理、限流、特性标志、出口守卫、OOM 处理)的动机调查

限制与注意事项

  • 大多数 pstack 技能是用户专用,技能工具无法加载。
  • 调查者仅获得其简报,需要将每个参考文件粘贴到简报中或提供绝对路径。
  • 生成后结束当前轮次,让唤醒行启动下一轮。
  • 跳过调查者需明确书面理由,仅两种情况:环境中无匹配 MCP(标记为缺口而非选择),或来源可证明不相关(高门槛)。
  • 若范围评估表明单个提交的简单目标且 PR 描述已包含完整答案,可在确认所有七个可用类别搜索冗余后内联回答,但应罕见。
  • 避免近期偏差:不要假设最近提交是权威的,当前形态常是许多早期决策的累积,需追溯更早历史。
  • 模型配置来自 ~/.config/pstack/pstack-models.md;当值为 auto 或 inherit-parent,或文件/行缺失时,在自身 harness 及其默认模型上运行 worker;无文件时说明并建议 /setup-pstack。若 worker 模型被拒绝,在该 harness 默认模型上运行并说明。
  • 每个子代理是 Rex worker 窗格,按 ../rex-subagents/SKILL.md 生成、等待和关闭,默认值在 ../poteto-mode/SKILL.md 的 Subagents 部分。
  • 调查者看到的 MCP 服务器是其自身 harness 配置的,因此 MCP 调查者在具有所列 MCP 的自身 harness 上运行。仅当 why investigators 行条目命名了你的 harness 时才从中取模型。

暂未提供的信息

关于收费、价格、平台支持范围、具体效果指标等,资料中暂未提供。