SuperAPI AI 工具集

how

编程与开发

查看项目

更新于 10-28 16:16

技能介绍

用途

how 是一个智能体技能,用于探索代码库并回答“X 是如何工作的”这类问题。它面向 Pstack 代码走查、子系统行为分析,以及模块位置与归属问题。其产出是架构层面的讲解,达到一位资深工程师刚接手某个子系统时所需的程度:足以建立可用的心智模型,但不会详细到像逐行注释的源码。

主要能力

  • 通过 /domain-modeling 解析并读取调用项目已配置的产物。
  • 只读调查与评审:报告文档漂移,但不做编辑。
  • 创建或实现:通过对应负责人协调已接受的模型变更。
  • 按复杂度选择执行路径:简单问题直接由单个讲解者一次完成探索与讲解;复杂问题先并行探索再综合讲解。
  • 输出结构化讲解,章节包括 Overview、Key Concepts、How It Works、Where Things Live、Gotchas,不适用的章节可省略。

使用方式

  1. 评估复杂度。若范围不明确,先说明你的理解再开始探索,用户可以纠正方向。
  2. 简单情况(单个模块、小型工具、如“函数 X 如何工作”的窄问题):不派探索者,生成一个讲解者,在一次遍历中完成探索与讲解,该讲解者基于讲解者提示构建,但不含探索者发现部分。随后直接进入呈现步骤。
  3. 复杂情况(跨多文件或服务的子系统、横切特性、完整架构概览):将问题拆解为 2 到 4 个角度,每个角度是子系统的一个独立切片;在单条消息中派出所有探索者,每个探索者使用探索者提示并填入其角度。当每个角度返回源码指针、运行时流程与缺口后,进入综合。
  4. 综合(仅复杂情况):所有探索者返回后,生成一个讲解者,使用讲解者提示并填入所有探索者的发现。当讲解有被检查过的代码支撑时完成。
  5. 呈现讲解者的输出。为清晰或结合对话上下文做轻微编辑是可以的,但不要大幅改写。

每个探索者与讲解者都通过 /swarm 运行,且均为只读。探索者承担 how explorer 角色,讲解者承担 how explainer 角色。若没有委派能力,则按相同顺序串行执行同样的步骤,并披露这一点。

适用场景

  • 需要理解某个子系统如何运作,以便快速上手。
  • 需要定位某个模块的位置与归属。
  • 需要做代码走查或架构概览。
  • 需要区分当前行为与设计理由(设计理由属于 /why)。

限制

  • 探索者与讲解者均为只读,不会修改代码。
  • 只读调查与评审只报告文档漂移,不做编辑;创建或实现才通过对应负责人协调已接受的模型变更。
  • 讲解应基于被检查过的代码,不应编造。
  • 目标是让读者能追踪子系统并区分当前行为与设计理由,设计理由不在本技能范围内。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。