阿里用AGENTS.md和自动验证约束管控项目编码
概述
针对前后端分仓导致上下文割裂、AI 不认识闭源私域组件(ProTable/ProForm/ProAction)、不知道项目编码规约、不会启动与自测四类痛点,团队做了五项改造:一是仓库聚合,先用 setup-repos.sh 把前端仓库克隆到后端子目录(frontend/ 已 gitignore)过渡,重构时直接改为 server/ + web/ + user-guide/ + reference-projects/ + scripts/ + docs/ 的 monorepo,团队已不再区分前后端,AI 在同一上下文全栈编码。 二是把闭源组件库、Higress、Nacos、HiMarket 及其他产品前后端源码以 git submodule 引入 reference-projects/(ignore = all),并为每个参考项目维护 ref-* 架构说明文档(文档本身亦由 AI 基于源码生成)。三是环境配置统一到 ~/.<project>_env 并封装 start-server.sh(构建+启动+健康检查)等一键脚本,让 AI 能自主启动项目。 四是定义严格的 curl 验证规范(单命令单步、临时文件中转、Token 模板化)并用 Qoder 的 agent-browser 做前端页面验证,支撑睡前派单、次日验收的自主执行模式。五是写 shell 脚本扫描 Java import 校验 L0-L5 分层依赖方向、错误信息按 WHAT/WHY/HOW 输出,并以 Makefile 提供 lint-arch/lint-format/build/test 统一入口。 核心规则全部收敛到约 200 行的 AGENTS.md,团队使用 Qoder、Cursor、灵码、Kiro、Claude Code 等多种工具均可读取。