Skip to main content

我们不靠「请注意规范」:把 AI 协作写进仓库

把禁止项、必做顺序、产物落盘与排障日志路径写成可版本管理的仓库规则,按任务加载领域技能。

口头「请注意规范」会漂。更稳的做法是把 禁止项 / 必做顺序 / 产物落盘 / 排障读哪份日志 写成可版本管理、可评审的仓库规则,并按任务加载领域技能。

规则类型

类型约束
推送先拉本机权威远程并合并,再双侧推送;冲突未解不推
日志排障优先读固定目录;网关整链耗时与业务耗时对照
产物无头浏览器截图/日志进本机沙箱,禁止落仓库根
边界未经明确授权不改框架与依赖清单目录
风格源码注释语言、文件编码、提交说明类型前缀等
技能模块地图、SQL 布局、建表同步、统一排序等按需加载

为什么有效

长改造线程里,强制先读助手说明与方案再动手;无头浏览器产物进沙箱;对话归档主题统计可以反哺下一条规则。规则可 diff,口头提示不能。

最有用的条目是「禁止 / 必须先…」,不是文风口号。若能补「加规则前后事故类型或返工次数」,分享会更有实证味道。

可复用的落点

  1. 口头提示易漂;规则可 diff。
  2. 优先写硬约束,少写软文风。
  3. 用返工/事故类型验证规则是否真的管用。