SuperAPI AI 工具集

how

通用与其它

查看项目

更新于 10-15 23:46

技能介绍

用途:探索代码库,回答“X 如何工作”类问题,适用于改动前的代码走读,以及放置、归属、分层问题(如“这段该放哪”“哪一层负责什么”)。目标是产出资深工程师接手子系统时所需的架构说明,足以建立可用的心智模型,但不至于像逐行注释的源码。

主要能力与流程:启动前先读取 Paseo 的 list_profiles。探索使用 pstack-explorer,默认 codex/gpt-6.1-sol xhigh;解释与综合使用 pstack-judge,固定为 codex/gpt-6-astra 并设 thinkingOptionId: xhigh。若 Explorer 的 profile 中存在模型与 effort,则照抄。Codex 设 settings.modeId 为 full-access,Claude 设 bypassPermissions;通过提示词保持探索只读。不得为 Judge 替换其他模型或 effort;若 Astra xhigh 不可用,报告该判断步骤被阻塞。使用 notifyOnFinish: true。

步骤:1)评估复杂度。范围含糊时先说明自己的理解再探索,用户可纠正。简单问题(单模块、小工具、窄问题如“函数 X 如何工作”)不派探索者,由一个解释者一次完成探索与解释,转步骤 2b。复杂问题(跨多文件或服务的子系统、横切特性、整体架构概览)先并行派探索者,再交给解释者,转步骤 2a。存疑时走简单路径。2a)仅复杂问题:把问题拆成 2 到 4 个探索角度,每条是子系统的不同切片,在单条消息中并行启动全部探索者,profile 为 pstack-explorer,默认 codex/gpt-6.1-sol xhigh,提示词中声明只读(不编辑);每个探索者使用 references/explorer-prompt.md 并填入其角度,然后转步骤 3。2b)简单问题直接解释:启动一个 Paseo 子代理,一次完成探索与解释,profile 为 pstack-judge,默认 codex/gpt-6-astra xhigh,提示词声明只读;其提示词基于 references/explainer-prompt.md,不含 explorer-findings 部分,转步骤 4。3)仅复杂问题综合:所有探索者返回后,启动一个 Paseo 子代理把发现综合成一份解释,profile 为 pstack-judge,默认 codex/gpt-6-astra xhigh,提示词声明只读;提示词基于 references/explainer-prompt.md 并填入每位探索者的发现。4)呈现:把解释者的输出呈现给用户,可为清晰或结合对话上下文做轻微编辑,不要大幅重写。

输出格式:解释使用 references/explainer-prompt.md 中定义的章节,不适用的可省略:Overview、Key Concepts、How It Works、Where Things Live、Gotchas。

限制:探索必须保持只读;Judge 的模型与 effort 不可替换;Astra xhigh 不可用时需报告阻塞。资料未提供具体安装命令、收费与平台信息。