跳转到内容
pstack 中文学习站

0.15.7:把反复出现的错误变成过不了的检查

更新于 2026-10-04

这一版新增 /correct。你在同一个仓库里反复纠正代理犯同样的错时用它。它把这类错误修在够用的最高一层,让下一个代理做不到。

这次提交是 lauren 在 2026-10-04 04:28(北京时间)写下的 9511e60。提交说明原文是 feat(pstack): add /correct skill (#494)。上一版是 23e4138(0.15.6)。

/correct 先读最近的提交、回退、评审评论、给代理的说明文件,以及解释绕过做法的注释,把错误分成几类。同一类发生过两次才算一类。

每一类都从够用的最高一层往下试。

  1. 用架构消掉。每一份状态只留一个所有者,每一项任务只留一种做法。错误的导入应该失败。靠人手同步的多份清单换成唯一的一份。旧做法和会被抄走的死代码删掉。
  2. 用类型挡住写不进去的坏状态。坏代码还能编译,就加一条 lint 或 CI 检查,报错里点名该改用的文件、类型或函数。这种写法已经很常见时,只在这次改动又多加一处时才让检查失败。
  3. 用测试卡住行为。某个测试在它调用的每个函数都返回空时仍然能通过,就修好或删掉这个测试。
  4. 文档和给代理的规则放在最后,只留给需要判断的情况。代理跳过它们,什么检查都不会失败。

然后修最常见的几类,每类一次提交。每条新检查都要用一次真实犯过的错证明它会失败。同一条命令在本地和 CI 里都跑。例外写在出错的那一行,带上原因、到期日,以及一个人的批准。

给代理的说明文件里留一张表,把每条规则和卡住它的机制配在一起。你纠正它时,它要修好这个错并补上规则。规则已经在表里、却没有东西去卡住它,就算重复发生,要在同一次改动里修到够用的最高一层。某类错误已经不可能发生,就删掉对应的规则。

对正在用 pstack 的人,这意味着同样的纠正不该靠下次对话里再提醒一遍。仓库本身要让抄最近的例子、走能编译通过的最短路径的代理,做出来的改动对整个仓库也是对的。

以后碰到重复的纠正,用 /correct,不要只在说明文件里再写一条没人强制的规则。

原文有三句,照录:

The operator keeps correcting agents in this repo for the same mistakes. Change the repo so the next agent can’t make them.

操作者一直在这个仓库里纠正代理犯同样的错。改这个仓库,让下一个代理没法再犯。

Assume every contributor is an agent that sees only the files it opened, copies the nearest example, and takes the shortest path that compiles.

假定每个贡献者都是代理。它只看见自己打开的文件,抄最近的例子,走能编译通过的最短路径。

Prove each new check fails on a real past mistake.

每条新检查都要用一次真实犯过的错证明它会失败。

插件说明 的技能表和示例里加了 /correct。示例代码块仍是英文原文。

这次改动的说明见 9511e60。

这次提交把 .cursor-plugin/plugin.json 里的版本从 0.15.6 写成 0.15.7。改动的文件里没有另写升级命令。