智能体工作流 monkeyin92/ds-pstack

ds-pstack

pstack 的 DeepSeek Harness 版本。pstack 是 Lauren Tan 的一套智能体工作流：少写代码，但写出更高质量的代码，并且放心地并行推进。

这次移植保留了 pstack 的 playbook、原则和行文规则。有两处改动，因为 DeepSeek Harness 和 Cursor 的工作方式不同。

技能还是同一批技能。 全部 56 个技能都在 / 菜单里，沿用 pstack 的名字。/poteto-mode 运行 playbook，/interrogate 运行对抗式评审，/how 讲解某个子系统，24 个 principle- 技能承载 pstack 赖以成立的推理。

模型由系统替你选，从你自己的清单里选。 Cursor 上的 pstack 给每个角色指定一个模型 slug。ds-pstack 做不到这一点，因为 Harness 配置档里的模型就是你配置并勾选的那些。所以路由器会读取子任务，判断它属于哪类工作，再从你为子代理勾选的模型里挑出最佳路由。你永远不用指定模型，技能也不用。

安装

这个包以 Harness bundle 的形式安装，直接从本仓库装：

plugin_manager install_bundle github:monkeyin92/ds-pstack#main

这会给配置档加上两行插件。禁用其中一行，另一行照常工作。

| 行 | 禁用后的效果 |
| ds-pstack-skills | pstack 的技能从目录中消失；路由仍然工作 |
| ds-pstack-router | 每个子任务都走它继承的路由；技能仍然工作 |

更新

从仓库安装意味着更新是拉取，不是重装。配置档记录的是 git 依赖，所以下次拉取会拿到 main 上的最新内容：

dsh plugin --profile <profile> update @local/ds-pstack

配置档的包管理器会把分支解析成 commit，两者都记录下来。技能文本会自己从磁盘重新加载。路由器的 JavaScript 属于另一个模块代际，所以更新改动了 lib/ 之后，插件必须重新挂载：在 Plugin Manager 里把 ds-pstack-router 那一行关掉再打开，模块就会重新导入。重启整个应用也可以，拿不准的时候这是更省事的选择。

如果想基于本地检出开发，而不是用已发布的副本，就按路径安装（plugin_manager install_bundle /absolute/path），做完之后再从 git spec 重装。

想固定在某个发布版本而不是跟踪 main，就安装一个 tag：

plugin_manager install_bundle github:monkeyin92/ds-pstack#v0.1.0

tag 会把那个 commit 钉住，直到你再次安装。package.json 里的版本号变化时，会发布新的 v<version> tag。

模型池由你掌控

ds-pstack 只从 Settings → Subagent model selection（subagent-model-selection-settings.allowedModels）里勾选的路由中选择。这个设置就是授权边界，路由器从不扩大它：你没勾选的模型永远不会被发送，哪怕它更适合这个任务。
勾选一个模型，意味着每个子代理都用这个模型运行，推理强度由路由决定。勾选多个模型，路由就能把便宜快速的模型分配给机械性工作，把强模型留给审查。从单个模型起步完全可以，这也是你还没添加任何模型时路由的默认行为。

要勾选模型，打开 Settings，找到 Subagent model selection，启用它，然后选择你想启用的路由。

子代理的路由如何选择

每个被委派的子代理都会发起一次模型请求。在第一次请求之前，路由会：

1. 读取委派提示词，也就是父代理写的那份任务说明；
2. 把工作归类到八种意图之一（planning、coding、debugging、review、research、analysis、writing、mechanical），并读取其难度；
3. 根据你的 pstack 预算和该意图选出一个推理强度；
4. 按该意图给已勾选的模型排序，取最优的那个；
5. 把推理强度对齐到所选路由实际声明支持的档位。

这个决定会为该子代理缓存，所以一个子代理的所有请求都走同一条路由。日志 ~/.dsh/ds-pstack-router.jsonl 记录每一次决定和每一次跳过。

三条规则约束这个猜测：

- 显式请求优先。 父代理传了 provider/model/reasoning_effort，或者某个技能固定了路由，路由就不插手。它只填补没人做过的选择。
- 模型池是权威。 已勾选集合之外的路由永远不会被发送。
- 路由绝不破坏委派。 没有模型池、设置读不出来、模型调用失败，或者分类没找到任何结果，子代理都会留在原本该走的路由上。日志会说明发生了哪种情况。

分类是确定性的

日志里的 scores 解释了每一次决定。短语提示分数决定意图，分数相同时取更具体的解读：「rename the util file」算机械性工作，不算新功能，尽管它提到了一个文件。分类不消耗任何模型请求，因为子代理不该在开始前等待一次判断。

预算

pstack 的四个预算标签依然适用。/setup-pstack 会写入你选的那个：

| 预算 | 基础推理强度 | 效果 |
| unlimited | max | 一切都按路由允许的最大强度思考 |
| large | xhigh | pstack 默认值 |
| medium | high | 更便宜，依然彻底 |
| small | medium | 最便宜；机械性工作降到 low |

意图会调整基础值：实现、调试和研究从预算档起步，审查和写作低一档，机械性编辑低两档。读起来困难的任务升一档，明确琐碎的任务降一档。

配置角色

运行 /setup-pstack。它会读取你勾选的模型池，询问预算，然后写入 ~/.dsh/ds-pstack-roles.json：

{
"budget": "large",
"intents": {
"feature": "example-provider/example-model",
"interrogate reviewers": "example-provider/stronger-model @ high"
}
}
键是模式技能里的 pstack 角色名（feature、bug-fix、how explorer、swarm workers、interrogate reviewers、arena runners 等），也可以直接写意图 id。值是完整的 provider/model 路由，后面可选跟 @ effort。

固定项优先于分类，这正是「让人来决定」的含义。固定项的 route 如果不再被勾选，就视为过期，直接忽略、不再发送；所以取消勾选某个模型，也就同时取消了它的固定。

验证技能

/create-verification-skill 和 /create-formal-verification-skill 生成项目本地技能，让智能体能证明改动确实生效，而不是只做断言。它们写入项目的 .dsh/skills/ 目录，Harness 会扫描该目录，且项目技能的优先级高于 ds-pstack 自带的技能。

没有移植的部分

只属于 Cursor 的机制：Automations、Bugbot feed、cloud agents，以及 -fast 速度选择。playbook 的某一步需要用到它们时，技能会用一行说明，然后继续往下走。完整映射见 docs/harness/deepseek-harness.md。

上游

pstack 由 Lauren Tan 以 MIT 协议授权。其许可证保留在 LICENSE.pstack，未经修改的上游 README 在 README.pstack.md。技能文本来自 pstack，只在 Cursor 专有名称必须改成 Harness 名称的地方做了适配。

开发

node --test "test/.test.js"

93 个测试覆盖分类及其位置权重、delegate 前言剥离、effort 映射、模型排序、池约束、固定项冲突、fork 保护、隔离策略、隐私脱敏、失败恢复、frontmatter 解析和目录发布。运行不需要构建步骤，也没有依赖。skills/poteto-mode/scripts/ 下的工具另有一套 73 个测试的 Bun 套件，.github/workflows/ci.yml 会同时跑这两套，外加 tsc 和 bash -n。