返回资讯中心
外部精选
软件工程
#开发者实时流

开发者称编码智能体只遵守能导致构建失败的规则

来源标题:Coding agents obey the rules that can fail the build, and none of the others

开发者 Kevin De Notariis 在自建 Git 托管项目 Gitmoap 时发现,编码智能体只遵守那些被写成测试、违反即构建失败的规则。他仓库中禁止注释提及交付阶段的规则被违反 29 次,而自 7 月转为测试后,此后 243 个数据库迁移无一违规。

Hacker News 最新kevindenotariis2026/11/20 · 今天30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

软件工程 人工智能 编程 Rust 开发者生产力 构建 Gitmoap 01/43 —— 我的编码 agent 会遵守每一条能够导致构建失败的规则,其余的则一概不理 Kevin De Notariis 阅读时长 19 分钟· 刚刚

一个人,九个月,一个包含 865 项操作的代码锻造平台。方法的核心不是 AI。而是把每一条约定都写成测试。 这是《构建 Gitmoap》系列的第一篇,讲述我如何独自构建一个 git 远程托管服务:每个决策、每个 bug 或每条经验各成一篇,每篇都可独立阅读。本篇是总览;其余各篇会逐件深入。 我的仓库里有一条规则:任何代码注释都不得提及交付阶段。仓库里有 29 条注释违反了这条规则,其中两条是在规则制定之后写的。还有另一条规则:已发布的数据库迁移永远不得修改。自从这条规则在七月变成测试以来,在之后的 243 个迁移中,没有一个是修改过的。 我对这两条规则的重视程度完全相同。我用同样的格式、在同一组规则文件中写下它们,每条下面都附有理由,并且把这两条都交给了同一批编码 agent。唯一的区别在于,第二条规则是一个测试。当任何东西修改了已发布的迁移时,构建就会变红并指出文件名。而当任何东西写下像 // Phase 1c will pass this through 这样的注释时,什么都不会发生。 我在构建 Gitmoap,一个我自己运行的代码锻造平台。九个月来,我一直用编码 agent 来构建它,从第一次提交起就使用 Claude Code,而这两个数字是我在那段时间里学到的最有用的东西。它也是我最常被问到的问题的答案,这个问题大致是:这怎么可能? 第一次提交的日期是 2026 年 2 月 5 日。今天,11 月 20 日,仓库包含: 以下是它的增长情况,以每月最后一次提交为测量点(2026 年): 项目逐月增长 迁移从七月开始,因为在此之前平台一直运行在单表 DynamoDB 设计上;7 月 23 日开启向 PostgreSQL 迁移的那次提交触及了 382 个文件(新增 30,514 行,删除 65,361 行)。“防漂移守卫”统计的是以这些词开头的测试文件,我用这种方式来命名一个测试,它的职责是让代码库忠实于某条规则,而不是测试某个功能。 增长曲线 看七月。这个月的操作数几乎翻倍,也是守卫数量从一增加到十的月份。我认为这不是巧合,而这正是本文的大部分内容。 对“如何做到”的一词回答是“agent”,但这个答案是错的,而且错得很有启发性。 Agent 写代码很快。代码从来都不是稀缺的东西。在这个规模上,稀缺的是一致性:每个端点都声明它如何缓存,每张表都带有它的租户区块,每个文档页面都与它所描述的 API 匹配。团队通过评审、习惯,以及那位说“我们这里不这么做”的同事来维持约定。一个带着 agent 的独立开发者什么都没有。他们拥有的是一个打字非常快、但在会话之间没有记忆的打字员,它会读取你留在周围的一切,并按照上面说的去做——大多数时候如此。 Anthropic 的文档对此说得很直白。关于 CLAUDE.md 和自动记忆——Claude Code 跨会话传递指令的两种方式——它说:“Claude 将它们视为上下文,而非强制配置。” 这句话就是论点,由工具制造商亲口说出。经过九个月的证据,我用我的话来说: Agent 会放大仓库以机械方式强制执行的任何纪律,而对仅仅被告知的东西一概不理。 所以,一个人的工作不再是写代码。而是把规则写成代码。 Gitmoap 的每个领域在 specs/ 下都有一个规范,分为十一个固定章节,用现在时描述系统是什么:端点、数据模型、授权矩阵、业务规则、事件、测试,以及剩余事项的清单。实现遵循规范,行为的变化在同一提交中改变规范。 横切规则位于 specs/engineering/ 下的九个“支柱”文件中,每条规则都有一个稳定的 ID:

SEC-AUTH-FAIL-CLOSED - 认证是故障关闭的;开发回退是显式选择加入,而不是缺少环境变量。

  • 为什么: 一个以“池 ID 未设置”为条件的 x-user-id 请求头回退是故障开放的: 任何环境中缺少一个环境变量,就会静默地把整个 API 变成信任请求头。
  • 怎么做: 回退通过显式的开发标志启用,绝不推断。每个验证 JWT 的 表面在没有验证器的情况下拒绝启动,除非设置了该标志。
  • 由什么强制执行: 一个启动断言;一个集成测试,它在没有验证器的情况下启动生产配置 并断言它拒绝启动。 九个家族(ARCH-、RUST-、SEC-、TEST-、OBS-、PERF-、DEPS-、TOOL-、DOCS-)中共有 268 个这样的标题。 ID 是永久的:退役的规则会留下墓碑,重命名的规则保留其 ID。这样一来,一条注释、一个测试、一条提交信息或一次评审可以说 SEC-AUTH-FAIL-CLOSED,并且恰好只意味着一个东西。仅 SEC-AUTH-FAIL-CLOSED 一个就在规范、代码和 CLAUDE.md 中被引用了 22 次,而 Rust 源码中按名称出现了 171 个不同的规则 ID。当 agent 在函数上方读到 /// Fail-closed (SEC-AUTH-FAIL-CLOSED) 时,它获得的是指向理由的指针,而不仅仅是代码。 所有这些都是 markdown,而在八月我让这些 markdown 变得机器可读。GSF,即 Gitmoap 规范格式,是一种针对普通 markdown 的语法(frontmatter、按名称标识的章节、被识别为类型化记录的表、可解析的标识符和引用),由同一工作区中的一个 crate 解析。make specs-lint 在一两秒内检查整个语料库。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →