Harness Engineering
让 Claude、Codex 等几个 AI 编程助手在多个项目里守同一套规矩:犯一次错记一条,同类错误变成自动检查。
私有仓库,见面可演示
- 2,482
- 次提交,2026-05 起
[OPS-01] 按名字找进程或杀进程 [FE-09] 同一个数字出现在几处 [BE-11] 读配置、凭据或外部数据出错时 [TEST-02] 和基线比 [DEL-08] 出修复方案时 … 共 112 条,来自 453 条事故记录
流程它怎么工作
- 01AI 犯错
- 02记一条事故
- 03提炼成规则卡
- 04变成自动检查
- 05每个会话开场载入
01概况
- 背景
- 代码大多交给 AI 写。规则在每个仓库各写一份,时间一长就对不上;同一个错,AI 换个项目再犯一遍。10 月有 1,153 次提交,平均每天 37 次,靠人盯不过来。
- 目标
- 规则只写一份,各项目引用同一份;每条规则都配一个机器能跑的检查,不靠在提示词里多叮嘱。
- 我负责
- 独立设计和开发。2,482 次提交里,2,403 次署我的名字。
02方案与取舍
规则分三层:总目录在每个 AI 会话开场自动载入;规则卡一行一条,写清什么时候、做什么、怎么查;事故记录写每条规则的来历。
选了个人项目用本地链接,团队复现用 Git 子模块
没选每个项目复制一份规则
副本会各自改、各自过时。代价是接入的项目运行时不能依赖规则仓库的文件,为此单独写了检查。
选了提交前只跑快速检查,全量交给 CI
没选每次提交都跑全套
一天几十次提交,全量会卡住所有线。代价是本地通过不代表 CI 通过。
03难点
现象
规则明明写了,同一类错误换个项目又出现。
原因
规则没送到干活的 AI;或送到了没人检查;或检查本身假绿。
解法
每条事故标明漏在哪一步:没送到的改成开场自动载入,没照做的改成提交前拦截,规则写错的直接改那一行。
04结果
453 条事故提炼成 112 条规则,覆盖运维、前端、后端、测试、协作交付;配套 44 个技能和一个手机回复服务。
05复盘
规则只增不减会越来越重,所以又定了测试剪枝和每周按耗时复核,把没用的检查合并或退役。
提交每月提交数
取自代码仓库(2026-11-06)。