SuperAPI AI 工具集

how

编程与开发

查看项目

更新于 10-16 02:43

技能介绍

How 是一个面向代码库理解的 AI 技能(skill),收录于 xgent-ai/skills,其在线地址为 https://www.skills.sh/xgent-ai/skills/how。它的核心用途是回答“X 是如何工作的”(how does X work?)这类问题,通过探索代码库产出架构层面的解释。官方描述明确划定了适用范围:用于代码行为、走查(walkthroughs)、模块归属或分层(module ownership or layering)相关的问题;如果想探究设计动因(rationale),应改用 why 技能。

主要能力与产出定位:它的目标是给出“资深工程师 onboarding 到一个子系统”这一层级的架构解释,足以让读者建立可工作的心智模型,但又不会细到读起来像带注释的源码。解释的呈现结构由 references/explainer-prompt.md 中定义的章节决定,不适用的章节会被省略,可能包括 Overview、Key Concepts、How It Works、Where Things Live、Gotchas。最终输出会直接呈现给用户,允许为清晰度做轻微编辑或补充对话上下文,但不做实质性重写。

使用方式(按其说明的流程):

第一步,评估复杂度。若范围含糊,先陈述自己的理解再探索,用户可以纠正。简单问题指单个模块、小型工具、或诸如“函数 X 如何工作”这样的狭窄问题,此时不派发 explorer,由一个 explainer 在一次过程里同时探索并解释,直接进入 Step 2b。复杂问题指跨多文件或服务的子系统、横切特性、完整架构概览,此时先并行派发 explorer,再交给 explainer,进入 Step 2a。若拿不准,走简单路径。

第二步 a(仅复杂问题),探索。把问题拆成 2 到 4 个探索角度,每个角度是子系统的不同切片。在同一条消息中派发全部 explorer,参数为:subagent_type 为 generalPurpose,model 取 how 的 explorer 行,默认 grok-4.7-xhigh-fast,readonly 为 true。每个 explorer 使用 references/explorer-prompt.md 中的提示词,并填入各自的角度。

第二步 b(简单问题),直接解释。派发一个 Task 子代理,一次完成探索与解释:subagent_type 为 generalPurpose,model 取 how 的 explainer 行,默认 claude-opus-5-5-max,readonly 为 true。其提示词基于 references/explainer-prompt.md 构建,不包含 explorer-findings 部分。

第三步(仅复杂问题),综合。所有 explorer 返回后,派发一个 Task 子代理把它们的发现综合成一份解释:subagent_type 为 generalPurpose,model 取 how 的 explainer 行,默认 claude-opus-5-5-max,readonly 为 true。提示词基于 references/explainer-prompt.md 构建,并填入每个 explorer 的发现。

第四步,呈现。把 explainer 的输出呈现给用户,可做轻微编辑。

模型选择规则:上述每个派生(spawn)都对应 pstack-models.mdc 规则中的一行角色以及一个默认值。把 model 设为该行的值;如果规则或该行缺失,则使用默认值。当值为 auto 或 inherit-parent 时,不设置 model。如果 Task 工具拒绝了某个 slug,就使用默认值并说明这一点;如果默认值也被拒绝,则从错误信息中选用同一家族里最接近的合法 slug。

适用场景:需要快速理解一个模块或子系统的运行流程与架构、需要判断某段代码行为发生在哪里、需要梳理模块归属与分层时,都可使用该技能。限制方面:它用于解释代码行为与架构,不用于回答设计动因类问题(应使用 why);简单问题与复杂问题走不同路径,且拿不准时按简单处理;所有子代理均为只读(readonly: true),本身不修改代码。

关于安装方式、运行环境依赖、是否收费与价格、以及实际效果等事实,当前资料暂未提供。