用途:为代码仓库生成嵌套的 AGENTS.md 编码规范文件(默认不放在仓库根目录),每个模块一份,内容涵盖高层架构偏好与边界、可运行的格式化/检查/测试命令,以及供验证技能执行的小型可验证配置块。
主要能力:支持 monorepo,扫描候选模块与语言(可用 scripts/scan_modules.py 生成清单);识别现有工具链;在缺失时按最佳实践补齐工具(JVM 的 Gradle/Maven 可配置 Spotless);为每个模块写入 codex-guidelines JSON 块(schema 见 references/verifiable-block.md),模板见 references/agents-template.md,语言默认值见 references/language-defaults.md。
使用方式:先确认模块根目录(除非明确要求,避免仓库根);选择架构风格(layered / hex / clean)并说明硬边界(如 domain/ 不得导入 infra/);确认是否允许在缺失时添加工具(默认是);确定各模块默认的 format / lint / test 命令,尽量优先处理变更文件。若 Python 不可用或脚本失败,会提示用户并询问是否安装 Python 或改为手动扫描。若只检测到仓库根,会建议子目录(如 src/、apps/<name>/、packages/<name>/)或询问代码起点。
交付物:覆盖的模块根列表及创建/更新的各 AGENTS.md;每个模块的 codex-guidelines 命令块(format/lint/test);新增的工具或配置变更及其位置。
限制:资料未提供具体支持的语言清单、命令细节、安装步骤与收费信息,暂未提供。