研发治理各项目在用

Harness Engineering

让 Claude、Codex 等几个 AI 编程助手在多个项目里守同一套规矩:犯一次错记一条,同类错误变成自动检查。

2026-05 至今 · 独立开发 · Python · YAML · GitHub Actions

私有仓库,见面可演示
2,482
次提交,2026-05 起
ai-coding-rules.md
[OPS-01] 按名字找进程或杀进程
[FE-09]  同一个数字出现在几处
[BE-11]  读配置、凭据或外部数据出错时
[TEST-02] 和基线比
[DEL-08] 出修复方案时
… 共 112 条,来自 453 条事故记录

流程它怎么工作

  1. 01AI 犯错
  2. 02记一条事故
  3. 03提炼成规则卡
  4. 04变成自动检查
  5. 05每个会话开场载入

01概况

背景
代码大多交给 AI 写。规则在每个仓库各写一份,时间一长就对不上;同一个错,AI 换个项目再犯一遍。10 月有 1,153 次提交,平均每天 37 次,靠人盯不过来。
目标
规则只写一份,各项目引用同一份;每条规则都配一个机器能跑的检查,不靠在提示词里多叮嘱。
我负责
独立设计和开发。2,482 次提交里,2,403 次署我的名字。

02方案与取舍

规则分三层:总目录在每个 AI 会话开场自动载入;规则卡一行一条,写清什么时候、做什么、怎么查;事故记录写每条规则的来历。

选了个人项目用本地链接,团队复现用 Git 子模块

没选每个项目复制一份规则

副本会各自改、各自过时。代价是接入的项目运行时不能依赖规则仓库的文件,为此单独写了检查。

选了提交前只跑快速检查,全量交给 CI

没选每次提交都跑全套

一天几十次提交,全量会卡住所有线。代价是本地通过不代表 CI 通过。

03难点

现象

规则明明写了,同一类错误换个项目又出现。

原因

规则没送到干活的 AI;或送到了没人检查;或检查本身假绿。

解法

每条事故标明漏在哪一步:没送到的改成开场自动载入,没照做的改成提交前拦截,规则写错的直接改那一行。

04结果

453 条事故提炼成 112 条规则,覆盖运维、前端、后端、测试、协作交付;配套 44 个技能和一个手机回复服务。

05复盘

规则只增不减会越来越重,所以又定了测试剪枝和每周按耗时复核,把没用的检查合并或退役。

提交每月提交数

  1. 226.05
  2. 426.06
  3. 226.07
  4. 33826.08
  5. 39326.09
  6. 115326.10
  7. 59026.11

取自代码仓库(2026-11-06)。