SuperAPI AI 工具集

gs-why

编程与开发

查看项目

更新于 11-15 16:33

技能介绍

gs-why 是 goodstack 中的一个技能,用于调查代码背后的动机和意图。它与 gs-how 互补:gs-how 回答代码做什么、如何工作,gs-why 回答是什么力量塑造了它现在的形态。

主要能力:技能按“调查—综合—呈现”的流程运作。先理解目标与问题,目标通常是代码片段、模式、功能或具名设计决策,问题通常是设计理由、取舍、边缘情况、外部约束、死代码或历史梳理。目标含糊时,技能会根据对话上下文(打开的文件、最近编辑、刚讨论的内容)做最佳推测并简要说明,便于用户纠正。

使用方式:技能先建立代码锚点,收集文件路径与行范围、关键符号、最近提交、合并提交中的 PR 编号及关联工单号;可用 git blame、git log --follow、git log --oneline 等命令,以及 gh pr view 或 glab mr view 拉取 PR 正文与讨论。若宿主无对应 CLI,则将 PR 讨论记录为缺口。随后技能列出本会话可用的 MCP 服务器与连接器,将每个映射到一种证据类别:源码管理历史、工单跟踪器、长篇文档、实时团队聊天、基础设施可观测性、错误与异常追踪、产品分析数仓。对每个有匹配 MCP 的类别并行启动一个调查子代理,每个子代理只负责一个工具或 MCP;若目标代码看起来是防御性代码(空值检查、重试、超时、限流、功能开关、OOM 处理等),还会附加事故复盘资料。最后启动一个综合代理,汇总结论。

没有子代理工具时,技能会自行按来源逐个调查再综合,并明确说明。技能要求子代理保留会话的 MCP 访问能力,不使用会移除该访问的只读子代理模式;调查者本身不写入任何内容。

输出结构:包括问题、所涉代码、发现内容、可合理推断、竞争性假设、未知项、来源清单和置信度摘要,并保持“已知”与“推断”的分离。来源清单每个调查者一行,包括返回空结果或被跳过的类别及原因。若该问题是为后续修改代码做准备,还会把沿革发现转化为保留、变更、避免、风险四类约束。

适用场景:设计理由追溯、技术取舍解释、回归与事后复盘、数据支撑阈值的来源核查,以及修改前了解历史约束。

限制:效果取决于环境中可用的 MCP 与连接器;缺少某类来源时只能记录为缺口。跳过调查者需要明确书面理由,仅限“环境无匹配 MCP”或“可证明无关”。默认不采用单提交简单目标的内联回答,除非确认七类搜索均属冗余。关于具体模型选择、平台兼容性与安装方式,资料未提供更多细节。