← 返回「今日头条」栏目

CN语言开发学习文档:011-给AI立法:AGENTS.md与全区间总结

CN语言代码图(IDE高亮·自适应屏宽)

一、这一步要做什么:给干活的人立法

本区间最后一个提交(2026-11-06 17:51,M7 之后 14 分钟)不碰编译器一行代码:新增 AGENTS.md,92 行,全部是给 AI 协作者的工作纪律。

为什么此刻立这部法?因为 M0~M7 已经证明这套"规范先行+门禁执法+负测闭环"的流程能高效产出——而流程的所有执行者里,最不稳定的恰恰是 AI:AI 会"顺手"改文档、会为了变绿删测试、会用"应该没问题"代替实测。

92 行把 AI 的权限、义务、红线钉死,开头第一句就是优先级:

CN语言代码图(IDE高亮·自适应屏宽)

用户指令 > 本文件 > 其他一切文档——三层裁决顺序,且 AI 对本文件自身只读。

这一篇是全系列的收束:给"执行规范的人(AI)"立法,法典才真正闭环。

二、文件所有权:能改什么、不能改什么

CN语言代码图(IDE高亮·自适应屏宽)

三档权限:spec/、底本、docs、README、AGENTS 自身 = 只读(语言的定义与项目的说明,AI 不得碰);src/、tests/、Cargo.toml = 可写但受纪律;target/ = 随便(不进库)。

最关键的是那行加粗:"发现文档与实现不一致时:停下,向用户报告,等指令"——还记得 002/009 篇审计指出的"实现与条文冲突未登记"吗?这条纪律就是它的解法:冲突不许静默处理也不许顺手改文档,必须显形到用户面前。

009 篇"变体名全局唯一与条文冲突"就是这条纪律要拦的现场。

三、代码纪律:七条一页速查

CN语言代码图(IDE高亮·自适应屏宽)

这七条是 M0 宪法 + spec/002 三态规范 + 本系列 004~010 篇所有纪律的一页速查版,且每条标注执法器(gate_former/gate_match)。

第 6、7 条是两道最有针对性的新立法:"未实现 = Undecidable"把报错区分写死(不得把"没做"误报成"非法",也不得静默放行——M2~M7 的范围声明从此有法可依);"不发明语义"把 spec/000 的终极条文重申给实现者。

四、测试与提交:堵死"变绿"的五条邪路

CN语言代码图(IDE高亮·自适应屏宽)

第二节列出的五个"变绿邪路"值得逐条体会:删测试、改期望、放宽断言、跳过、把 Undecidable 改成 Reject——AI(以及赶进度的任何人)让测试变绿有无数种歪路,全部点名禁止。

第 5 条"跳过要打印原因"正是 007 篇审计不足②的立法回应(e2e 无工具链静默跳过的问题)——审计指出的债,14 分钟后立法清偿,这个响应速度本身就是纪律运转的证明。

提交纪律同样具体:一次提交一件事、git status 先看清单、禁 git add -A 盲扫、禁 force push——每条都对应一种真实事故。

五、红线十条与报告纪律

CN语言代码图(IDE高亮·自适应屏宽) CN语言代码图(IDE高亮·自适应屏宽)

红线第 6 条(声称完成但没跑测试)与第 10 条("应该/大概/估计没问题"代替实测)直击 AI 汇报最常见的失真模式;第 5 条把"诚实边界/暂放行/兼容/历史原因/保守处理"这五个委婉词整体列为红线——spec/005 的术语消歧在纪律层的重申。

报告纪律四条的本质是"禁静默"的元立法:失败附完整错误、未实现列边界清单、汇报固定三件套(改了什么/测试结果/下一步)——让信息不对称无处藏身,这是治理 AI 协作的根本。

你自己带 AI 干项目,照抄这 92 行就能起步。

六、全区间总结:两小时从立法到立规

CN语言代码图(IDE高亮·自适应屏宽)

把 002~011 篇的线索收拢成三条主线:主线一:立法先行——spec 批次 A/B~D 约 4000 行条文先行,M1~M7 的每一次实现都有条文可查(实现与条文冲突=改实现);主线二:每特性四件套——M5 数组、M6 ADT、M7 枚举生成都是"条文+实现+负测+端到端"四件齐落,109 项测试步步为营;主线三:三🈲逐层落地——词法层(非法字符 Reject)、语法层(三色分派)、语义层(无 Unknown 类型)、IR 层(净栈互查)、运行层(退码契约)、治理层(AGENTS 红线)——每一层都用自己的方式禁兜底禁默认禁静默。

CN语言代码图(IDE高亮·自适应屏宽)

诚实交底:七项未清偿债全部有修法方向,其中①(门禁灯下黑)和③(变体名冲突)在后续提交里能看到项目的真实偿还动作——这就是这个项目最值得学的地方:债不是污点,登记在案、有修法、按序清偿的债是工程进度的正常组成。

七、动手作业与下一步

作业①:给你的项目写一份 AGENTS.md——十个红线起手(照抄本篇第五节结构,把"spec 只读"换成你项目的核心资产);作业②:把全区间 7 项未清偿债任选一项写出修法草案(条文怎么改/检查器怎么加/负测怎么写);作业③:从 M0 到 M7,把 005~010 篇的动手作业连起来——你的迷你语言现在应该有词法器+Pratt 解析器+语义检查+栈机 IR+解释执行,这就是一个完整的玩具编译器。

学习路径下一步:本区间结束在 AGENTS.md 的路线图 B1 字符串运行时——后续篇目将进入特性扩展期(字符串/结构体/类/泛型/模块),每个特性的"五件套"演练你会越来越熟。

整个系列的核心可迁移物只有一句话:先立法、再施工、债要登记、门禁执法、报告只说实测。

CN语言官网:www.cn-language.com
CN语言开发日志:https://www.cn-language.com/toutiao/
源码仓库:gitcode.com/ChenChao_GitCode/CN_Language
(头条正文不支持外部链接点击,保存下图扫码直达👇)
CN语言官网与开发日志二维码(扫码直达)