SuperAPI AI 工具集

pstack-how

编程与开发

查看项目

更新于 10-28 16:17

技能介绍

pstack-how 用于回答“X 是如何工作的”一类问题,面向 Pstack 代码走查、子系统行为说明,以及模块位置与归属问题。它的目标是给出资深工程师刚接手某个子系统时所需的架构级解释,足以建立可用的心智模型,但不会详细到像带注释的源代码。

主要能力与流程:

一、只读调查。该技能用于只读的调查与评审;如发现文档漂移,只报告,不做修改。创建或实现相关变更时,通过相应所有者来协调已接受的模型变更。技能可调用 /domain-modeling 来解析并读取发起项目已配置的制品。

二、复杂度评估。先判断范围;若范围不明确,先说明自己的理解再开始探索,用户可随时纠正方向。 简单情况指单个模块、小型工具或范围很窄的问题(例如“函数 X 是如何工作的”):不派探索者,直接生成一个解释者,在一次执行中完成探索与解释,并跳过探索者发现部分。 复杂情况指跨多个文件或服务的子系统、横切功能或整体架构概览:进入多角度探索流程。拿不准时走简单路径。

三、探索(仅复杂情况)。把问题拆成 2 至 4 个角度,每个角度对应子系统的不同切片;在一条消息中同时启动所有探索者,每个探索者带上探索者提示词并填入其角度。每个角度需返回源码指针、运行时流程和缺口。

四、综合(仅复杂情况)。所有探索者返回后,启动一个解释者,填入解释者提示词和全部探索者的发现,产出由实际检查过的代码支撑的解释。

五、呈现结果。直接呈现解释者的输出,可为清晰或补充对话上下文做轻微编辑,但不要大幅改写。解释按解释者提示词定义的分段组织,不适用的分段可省略:概览、关键概念、运作方式、代码分布、注意事项。完成标准是读者能够追踪该子系统,并能区分当前行为与设计理由;设计理由属于 /pstack-why 的范畴。

并行执行方面,每个探索者和解释者都使用 /pstack-swarm;它们均为只读。若无法委派,则按相同步骤串行执行,并明确说明这一点。

适用场景:理解陌生子系统、梳理跨服务功能链路、回答模块归属与放置问题、为新成员准备架构说明。限制:仅用于只读调查;解释理由应转用 /pstack-why;具体支持的平台、安装方式、收费与价格等,资料暂未提供。