SuperAPI AI 工具集

why

设计与创作

查看项目

更新于 10-16 09:58

技能介绍

用途:why 技能用于调查代码背后的动机与意图,是 how 技能的补充。how 回答代码做什么、如何运作;why 回答是什么力量塑造了它的当前形态。适用于设计理由、权衡取舍、边界情况、外部约束、死代码或历史脉络类问题。

主要能力:先定位目标代码(文件与行范围、关键符号、提交列表、PR 编号),再按可用 MCP 并行派出调查者,覆盖七类证据:源码版本历史(始终可用,基于 git 与 gh)、工单跟踪、长文档、团队即时聊天、基础设施可观测性、错误/异常跟踪、产品分析数据仓库。若目标代码带有防御性特征(空值检查、重试、超时、限流、特性开关、OOM 处理),还会参考事故复盘资料。

使用方式:先读取 Paseo 的 list_profiles。探索使用 pstack-explorer,默认 codex/gpt-6.1-sol xhigh;解释与综合使用 pstack-judge,始终为 codex/gpt-6-astra 并设 thinkingOptionId: xhigh。Codex 设 settings.modeId 为 full-access,Claude 用 bypassPermissions;探索环节应通过提示保持只读,不要替换 Judge 的模型或推理力度,Astra xhigh 不可用时需报告该判断步骤受阻。使用 notifyOnFinish: true。用 git blame、git log、gh pr view 建立代码锚点后,在单条消息中并发启动多个调查者,每个调查者只对应一个 MCP,不应让单个代理覆盖多个 MCP。最后启动一个综合子代理,结合置信度框架输出结果。

输出结构:包含问题、所涉代码、发现、可合理推断、竞争假设、未知信息、来源咨询与置信度总结。Sources Consulted 每个调查者一行,包括无结果或被跳过者及原因;若用户的问题是为后续修改代码做准备,还会把发现转化为保留/变更/避免/风险约束集。

限制:跳过某类调查必须有明确书面理由,只有该环境无对应 MCP 或该来源可证明无关才可跳过;不要仅凭“可能无关”跳过。需避免近期偏差,不能假设最近提交就是决定性依据。仅当确认七类可用来源搜索都冗余时,才可内联回答。官方文本暂未提供。