关于 setup-pstack
setup-pstack 是用于项目配置的技能,可在根目录的 AGENTS.md 中设置 pstack 模型角色,并让 CLAUDE.md 链接到该文件。它会引导模型选择、预算确认、可用性验证和重复更新。
主要功能
- 01检测可用模型与推理级别
- 02为 pstack 角色映射模型
- 03确认预算和角色分配
- 04更新 AGENTS.md 配置区段
- 05维护相对路径的 CLAUDE.md 符号链接
适用场景
- 01为新项目配置 pstack
- 02预算变更后调整模型角色
- 03为新会话更新配置
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ yor-dev/ pstack-uni --skill setup-pstack安装后在 Claude Code 中输入/setup-pstack确认已加载。
附带文件LICENSE
详细介绍
设置 pstack
在当前活动项目根目录的 AGENTS.md 中编写 pstack 模型配置。确保该目录中的 CLAUDE.md 是指向 AGENTS.md 的相对符号链接,让两个工具读取相同的项目说明。
步骤
1. 检测可用模型
确定本次会话中可用的模型和推理力度。如果无法确定,请询问用户。不要保存未经确认可用的具体模型选择。别名 inherit-parent 和 auto 始终有效。
2. 加载当前状态
上游角色选项如下。它们的 Cursor 名称将模型系列和推理力度编码在一起。将每项解析为一个可用模型和一个独立的推理力度。没有可用对应项的选择,需要在步骤 3 中让用户选择。
feature, refactoring: grok-4.7-xhigh-fast
bug-fix: grok-4.7-xhigh-fast
perf-issue: grok-4.7-xhigh-fast
hillclimb: grok-4.7-xhigh-fast
judgment and prose: claude-opus-5-5-max
hardest tasks: claude-opus-5-5-max
how explorer: grok-4.7-xhigh-fast
how explainer: claude-opus-5-5-max
why investigators: grok-4.7-xhigh-fast
why synthesizer: claude-opus-5-5-max
reflect tooling: gpt-5.6-sol-max
reflect judgment, divergent, synthesizer: claude-opus-5-5-max
arena runners: claude-opus-5-5-max, gpt-5.6-sol-max, grok-4.7-xhigh-fast
arena cross-judge pool: claude-opus-5-5-max, gpt-5.6-sol-max, grok-4.7-xhigh-fast
swarm workers: grok-4.7-xhigh-fast
architect runners: claude-opus-5-5-max, gpt-5.6-sol-max, grok-4.7-xhigh-fast
interrogate reviewers: claude-opus-5-5-max, gpt-5.6-sol-max, grok-4.7-xhigh-fast
如果项目根目录 AGENTS.md 中存在 pstack 模型配置部分,请读取其中的 # budget 行和角色值,作为当前选择。否则,从上述上游选项开始。角色不在上述列表中的行,例如 how critics,属于已废弃角色。删除该行。
3. 预算、映射并确认
(a) 询问预算。 提供以下四个选项,标签必须完全一致;如果规则记录了当前预算,也要注明当前预算。
unlimited — keep maxlarge — xhigh reasoningmedium — high reasoningsmall — medium reasoning
(b) 应用预算。 根据上游选项构建工作表;重新运行时,保留所有按模型系列、列表或别名(inherit-parent、auto)更改过的角色。unlimited 保留表中每项推理力度。large、medium 和 small 分别将每个真实模型条目(包括面板条目)的推理力度设为 xhigh、high 或 medium。分别存储模型和推理力度。如果模型不支持目标推理力度,则按 max > xhigh > high > medium > low 的顺序,选择不高于目标的最高支持力度;如果均不支持,则标记该角色需要用户选择。inherit-parent 和 auto 不作更改。
(c) 显示角色并确认。 显示每个角色及其模型和推理力度,并将不可用的选项标记为需要用户选择。还要列出步骤 2 删除的每一行。询问用户是接受当前设置,还是更改特定角色;提供可用模型以及 inherit-parent 和 auto 作为选项(两者都表示:该角色使用父级聊天模型及其推理力度)。对于面板角色(竞技场运行器、架构师运行器、审问审查者),其值是一个列表,每个条目都会运行一个子 Agent,包括别名条目,因此列表长度决定运行数量。arena cross-judge pool 也是一个列表,但 Arena 会尽可能选择一个与父级模型系列不同的条目。除非竞赛或比较为每个参赛方分配了其他选项,否则 swarm workers 是每个工作者的默认模型和推理力度。
4. 验证
写入的每个具体模型和推理力度都必须在本次会话中可用。inherit-parent 和 auto 始终通过验证。如果某项选择不可用,请停止并再次询问。
5. 编写规则
找到当前项目根目录(Git 根目录;若不存在,则使用当前工作目录)。读取其中的 AGENTS.md,若不存在则创建。仅替换 与 之间的部分;若该部分不存在,则追加。保留其他所有指令。该部分包含一行 # budget,其中写明选定的标签及其目标工作量;并按上述标签为每个角色各写一行。整个部分都要替换,以便重复运行时保持幂等。实际模型值是一个包含 model 和 effort 的对象;别名为 inherit-parent 或 auto。面板值是这类条目的列表。为每个值填写已确认的选项。值的格式示例:
## pstack model configuration. One line per role. Delete a line to fall back to the upstream choice.
# budget: large (xhigh)
how explainer: {"model": "<confirmed model>", "effort": "xhigh"}
swarm workers: inherit-parent
arena runners: [{"model": "<confirmed model>", "effort": "xhigh"}, "auto"]
确保同一目录中的 CLAUDE.md 是一个相对符号链接,目标为 AGENTS.md。如果它已经是该链接,则保持不变。如果它是其他文件或链接,在替换前将其中尚未包含在 AGENTS.md 中的指令保留下来;不要添加 @AGENTS.md 导入,以免自我导入。替换任一文件前,先与用户解决冲突。切勿通过符号链接写入。
6. 确认
告知用户项目指令和符号链接已写入,并且会应用于该项目的新会话。再次运行此技能会更新 pstack 部分。
7. 提供验证技能(可选)
检查项目是否有驱动真实应用以验证效果的方法(verify-* 技能或现有测试框架)。如果没有,只需询问一次:“想要一个项目本地验证技能,让 Agent 像用户一样操作应用并验证更改是否生效吗?我可以生成一个。”如果用户同意,请阅读并遵循 create-verification-skill。如果用户拒绝,则继续,不要再劝说。