repo harness 该怎么设计

repo harness 分三层:精简入口规则文件、挂在 Hook 上自动触发的确定性检查、跨上下文的状态交接,规则管不确定的事,Hook 管确定的事。

要点

  1. 入口规则文件只写 agent 猜不到的内容:禁碰目录、构建测试命令、历史踩坑,控制在几十行。
  2. 确定性传感器是核心,把 lint、类型检查、单测挂在 Hook 上自动跑,报错自带修法并直接回喂给 agent。
  3. 状态交接靠 progress 日志和 commit message,长任务用 JSON 格式的 feature list 限制每次范围。
  4. 入口文件写得太全反而涨推理成本不涨成功率,只写被同一个坑踩过两次的规则。
  5. 对一次性梭哈、提前宣布完工、没测就说做完设防线,强制端到端验证并只允许改 passes 字段。

来源