用途
how 是一个智能体技能,用于探索代码库并回答“X 是如何工作的”这类问题。它面向 Pstack 代码走查、子系统行为分析,以及模块位置与归属问题。其产出是架构层面的讲解,达到一位资深工程师刚接手某个子系统时所需的程度:足以建立可用的心智模型,但不会详细到像逐行注释的源码。
主要能力
- 通过 /domain-modeling 解析并读取调用项目已配置的产物。
- 只读调查与评审:报告文档漂移,但不做编辑。
- 创建或实现:通过对应负责人协调已接受的模型变更。
- 按复杂度选择执行路径:简单问题直接由单个讲解者一次完成探索与讲解;复杂问题先并行探索再综合讲解。
- 输出结构化讲解,章节包括 Overview、Key Concepts、How It Works、Where Things Live、Gotchas,不适用的章节可省略。
使用方式
- 评估复杂度。若范围不明确,先说明你的理解再开始探索,用户可以纠正方向。
- 简单情况(单个模块、小型工具、如“函数 X 如何工作”的窄问题):不派探索者,生成一个讲解者,在一次遍历中完成探索与讲解,该讲解者基于讲解者提示构建,但不含探索者发现部分。随后直接进入呈现步骤。
- 复杂情况(跨多文件或服务的子系统、横切特性、完整架构概览):将问题拆解为 2 到 4 个角度,每个角度是子系统的一个独立切片;在单条消息中派出所有探索者,每个探索者使用探索者提示并填入其角度。当每个角度返回源码指针、运行时流程与缺口后,进入综合。
- 综合(仅复杂情况):所有探索者返回后,生成一个讲解者,使用讲解者提示并填入所有探索者的发现。当讲解有被检查过的代码支撑时完成。
- 呈现讲解者的输出。为清晰或结合对话上下文做轻微编辑是可以的,但不要大幅改写。
每个探索者与讲解者都通过 /swarm 运行,且均为只读。探索者承担 how explorer 角色,讲解者承担 how explainer 角色。若没有委派能力,则按相同顺序串行执行同样的步骤,并披露这一点。
适用场景
- 需要理解某个子系统如何运作,以便快速上手。
- 需要定位某个模块的位置与归属。
- 需要做代码走查或架构概览。
- 需要区分当前行为与设计理由(设计理由属于 /why)。
限制
- 探索者与讲解者均为只读,不会修改代码。
- 只读调查与评审只报告文档漂移,不做编辑;创建或实现才通过对应负责人协调已接受的模型变更。
- 讲解应基于被检查过的代码,不应编造。
- 目标是让读者能追踪子系统并区分当前行为与设计理由,设计理由不在本技能范围内。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。