11月中旬两件事把同一个趋势推到台前。一件是开发者社区的热文《别给编码Agent写Markdown文件,写脚本》:作者把团队规则从AGENTS.md改写成带退出码的脚本挂进钩子,一个检查回复长度的Stop钩子在10次Agent回复里拦下9次违规,并让Agent返回修复。另一件是Anthropic把Agent Skills规范捐给Agentic AI基金会,谷歌、微软、OpenAI进入技术委员会,已有70多个平台集成。给AI立规矩这件事,正在从「写文档劝」变成「设关卡卡」。对Java团队来说,规矩落地的位置不在文档里,而在工具的机制里:目标怎么下、边界怎么设、出错怎么办。

一、文档式规矩为什么管不住Agent

热文的判断很尖锐:AGENTS.md是建议,Agent会掂量它——当它认为代码是对的、文档过时了,它完全可以无视。这不是Agent叛逆,更是Markdown文件没有任何执行机制:读不读、信不信、做不做,全凭模型自觉。

作者的解法是把规则翻译成脚本:每条规则一个脚本,通过或失败对应退出码,挂进钩子,本地钩子背后再配一个必需的CI任务兜底。效果立竿见影——一个用Claude Code Stop钩子检查回复句长的例子,10次回复里拦下9次违规,并自动把Agent打回去修。规矩一旦有了退出码,就从「劝」变成了「卡」。

这套思路的延伸是分工:脚本管得住的交给脚本,管不住的才留给文档。作者自己也承认,Markdown并没有失业——那些没法用脚本检查的部分(比如架构取舍的说明、领域背景的交代)仍然要靠文字。但判断标准要倒过来:先问这条规矩能不能变成退出码,能就绝不写在文档里。这个判断顺序,比任何一条具体规则都更值得Java团队抄走。

同一周,Anthropic把Agent Skills规范捐给Agentic AI基金会(AAIF),技术委员会里坐着谷歌、微软和OpenAI,70多个平台已集成这套规范。行业巨头们用基金会的方式回答了另一个问题:跨工具的规矩要有统一格式——但格式统一只是第一步,规矩真正的牙齿,依然是各家工具里的执行机制。

二、Thoughtworks补上另一半:没有评测的规矩等于没立

11月Thoughtworks的方法论讨论把这件事又推进了一层:Agent的运行环境要当产品来运营——有负责人、有测试策略,铁律是「没有评测,不许变更」。具体做法是从真实工作里挑20到30个任务打成黄金集,和harness一起版本化管理,每次显著变更都跑一遍;成本和延迟也算指标,分数翻倍但价格翻番不算改进。

这套打法和一个细节互为印证:LangChain仅靠改进harness(不换模型),Terminal-Bench通过率从53%提到67%。规矩和评测合在一起,才是Agent工程化的完整闭环——规矩告诉Agent不能做什么,评测证明规矩真的在起作用。评测集没人维护会漂移,三月还准的题到六月就在骗你,这也是为什么Thoughtworks坚持要指定负责人。

对Java团队来说,这两条加起来的启示很直接:给Agent立规矩的投入,本质是工程基建,不是一次性配置。写在群公告里的规矩、贴在wiki上的规范,在Agent洪峰面前都不如一个退出码。

三、Java团队的三道关卡:下目标、设边界、兜错误

3.1 第一关:目标怎么下

规矩的第一落点是下指令的方式。提示词写得越细,Agent越容易断章取义;目标写得越清楚,Agent越难跑偏。飞算JavaAI的「/目标模式」让开发者直接下目标而不是写步骤——「让订单服务的接口全部返回统一错误结构」是一个目标,「先改A类再改B类」是一份猜不透意图的说明书。目标驱动配合智能体模式的自动规划,Agent的自由度收在结果口径上,而不是过程口令上。

3.2 第二关:边界怎么设

第二道关卡是硬边界。飞算的智能体模式支持设置中断条件:跑到不许动的文件、不许执行的操作,自动停下等人确认。这等效于给Agent挂了一个内置钩子——区别是Java团队不需要自己写脚本,配置即可。政务系统开发者秦工的用法可以参考:「涉及资金计算的模块我们全设了中断,Agent改到那一片必须停下来给我看diff,一年下来拦住的隐性风险比评审会上抓到的还多。」

3.3 第三关:错误怎么兜

第三道关卡是出错后的处理。Agent跑长任务,偶发报错不该让整轮报废。飞算的容错机制经过两轮迭代(3.9.19、3.9.22),中断后提供「继续生成」按钮,停下来的活随时接着干;配合思考内容显示,出错前Agent在怎么想全程可见,排查不用靠猜。三道关卡连起来,就是Java团队版本的「规矩即机制」:目标卡方向,中断卡边界,容错兜意外。

四、结语

10次回复拦下9次违规,靠的不是把规矩写得更多,更是让规矩有了执行机制。Agent Skills进基金会解决的是格式统一,真正的分野在于每家工具愿意把多少规矩做进机制里。

给AI立规矩这件事,文档时代结束了。下一个比拼的维度很明确:谁家的关卡越多、越隐蔽、越不打扰人,谁家的Agent越敢放开用。

Logo

宁波官方开源宣传和活动阵地,欢迎各位和我们共建开源生态体系!

更多推荐