Tessl 博客:用四类自有文件约束编码智能体
本条为 AI 依据下方公开信源自动整理生成的摘要,不构成转载,可能存在偏差,请以原文为准。整理者:贝果科技 AI 资讯助手。
本条选题由第三方线索发现;线索方提供的摘要未被采用,本页内容依据下方信源整理。线索来源:AIHOT
全文梳理
AI 摘要依据下方信源原文自动整理,非原文转载一个工单暴露的偏差
把一张工单交给编码智能体,却不给它任何章程,会发生什么?作者描述了自己的仓库状况:代码库横跨三个时期,一个符合当下规范的领域层把该做的事都做对了,但旁边还堆着一个早期遗留的巨型文件,以及一个被冻结、谁都不许改动的旧模块,后两者的体量是前者的十倍。智能体始终没有打开正确的代码,而是走向那个巨型文件,用随机数函数掷骰子,并且在序列化结果时没有设置种子。它还通过一个确实存在且能正常工作的辅助函数重写了日志记录,又两次伸手去碰那个冻结模块。最终八项检查只通过一项。仓库本身没有任何损坏,智能体只是照抄了眼前看到的代码。作者由此指出,真正能拦住它的东西,全都是自己尚未写下的文件。
章程其实是四个杠杆
作者从事的是运行智能体的引擎以及它首先读取的规则这两方面的工作,并把这套规则称为章程。他提到,到处都在建议写一个 CLAUDE.md,这个建议本身没错,但那个文件只是四个杠杆之一,另外三个就在同一个仓库里、位于已经归你所有的路径下,而不少团队并没有把它们都写出来。四个杠杆都是文件,都在智能体动手写代码之前会被读取。第一个是指令,也就是 CLAUDE.md,用现在时说明这个仓库是什么。第二个是约束,放在 .claude/rules/ 目录下,按路径划分作用范围,每条规则都标注引发它的那次事故的日期。第三个是能力,涉及 .claude/commands/、.claude/skills/、.claude/agents/、.claude/settings.json 以及 .mcp.json,规定智能体可以调用什么、可以触及什么。作者表示,他会在十一月的一场九十分钟工作坊里,让一屋子工程师现场写出这些文件,并测量每一个文件究竟带来了多少收益。
哪些部分真正扛得住
作者提出的两个问题都可以在一台笔记本电脑上得到答案:当智能体对章程内容有不同意见时,章程的哪一部分仍然站得住;以及每一部分各自买到了什么。他给出的做法是,在同一张工单上反复回答这些问题,并记录下三次尝试的结果。材料中呈现的这次尝试,结果就是八项检查通过一项,失败的原因并不在于仓库里有坏代码,而在于缺少那些本可以约束智能体的文件。对读者而言,这意味着约束编码智能体的手段并不神秘,也不需要额外的基础设施,它们就是仓库里几个特定路径下的文件,关键在于是否把它们写全、写到位。
为什么值得看
用真实仓库案例说明智能体为何会改错文件,并给出四类可落地的约束文件位置,对搭建编码智能体工作流的团队有直接参考价值。
信源1 家
关键事实
作者描述智能体在包含 2026 年领域层、2023 年 god file 和冻结 2021 年模块的仓库中未打开正确代码,八项检查只通过一项。[1]
文章提出章程由四个杠杆组成:CLAUDE.md 是指令,.claude/rules/ 是按路径限定的约束,能力由 .claude/commands/、.claude/skills/、.claude/agents/、.claude/sett…[1]
作者称将在 AIDevCon 举办九十分钟工作坊,让工程师编写这些文件并衡量每个文件带来的效果。[1]
文章提到 Keystone 是作者的开源章程框架工具,Harness Engineering 是其相关书籍主题。[1]
相关 · 工具
本页内容由 AI 自动聚合公开信源生成,仅供了解行业动态参考,不构成任何投资或决策建议。如需引用请以原文出处为准。
