关于 correct
correct 是一项 pstack 技能,帮助维护者防止 Agent 在仓库中重复犯错。它先归纳反复出现的问题,再通过架构、类型、检查、测试或文档处理,并记录每条规则的执行方式。
主要功能
- 01依据仓库证据归类重复错误
- 02优先采用架构修复和单一事实来源
- 03添加类型、Lint 或 CI 约束
- 04用过往错误验证检查
- 05维护规则及其执行方式的表格
适用场景
- 01防止 Agent 在代码库中重复犯错
- 02将评审反馈转为可执行检查
- 03用过往错误验证新增检查
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ericlitman/ open-pstack --skill correct安装后在 Claude Code 中输入/correct确认已加载。
详细介绍
Correct
操作人员一直在纠正这个代码库中的 Agent,因为它们反复犯同样的错误。修改代码库,让下一个 Agent 无法再犯这些错误。
假设每位贡献者都是 Agent,只会查看自己打开的文件,照搬最近的示例,并选择能编译通过的最短路径。设计代码库,让只从一个文件看起来正确的改动,在整个代码库中也正确。
找出错误类别
首先,阅读近期提交、回滚、审查意见、Agent 指令文件,以及解释变通方案的注释。将错误归类。某类错误发生两次后,即可认定为一类。
在可行的最高层级修复每一类错误
- 通过架构消除错误。 为每块状态指定唯一所有者,为每项任务指定唯一受支持的做法。隐藏内部实现,让错误的导入无法通过。用单一真实来源替代需要手动同步的列表。删除旧做法和 Agent 可能照搬的废弃代码。
- 通过类型约束,禁止写入错误状态。 如果错误代码仍能编译,就添加 lint 或 CI 检查,让错误信息指出应使用的文件、类型或函数。如果这种模式已经很常见,则只在改动新增此模式时失败。
- 测试行为。 修复或删除任何在所检查的行为失效时仍会通过,或仅在内部实现变化时就会失败的测试。
- 最后才编写文档或 Agent 规则,且仅用于需要判断的情形。 即使 Agent 跳过这些内容,也不会导致任何检查失败。
修复并验证
然后立即修复最常见的错误类别,每类错误各提交一次。证明每项新检查都能针对一个真实的历史错误而失败。在本地和 CI 中运行同一条命令。例外必须写在违规代码所在行,并注明原因、到期日期以及人工批准者。
保留规则表
最后,在 Agent 指令文件中保留一张表,将每条规则与其强制执行方式对应起来。操作人员纠正你时,修复错误并添加相应规则。如果规则早已存在,却没有任何机制强制执行,那么这属于重复错误,应在同一改动中从最高层级修复。某类错误不再可能发生后,删除相应规则。
**回复:**列出每个错误类别及其证据、选择的层级,以及更高层级为何行不通。
评论
支持 Markdown