merge-agents-md

# 合并 AGENTS.md ## 概述 1. 将语言特定的 AGENTS.md 模板与项目当前目录下的 AGENTS.md 进行合并，生成更新后的 AGENTS.md 文件。 2. 填充模板中的占位符，按项目实际情况进行填充 ### 环境变量 ${AI_SPEC_ROOT} 定义在 bash/zsh 环境变量中，可被读取: `echo ${AI_SPEC_ROOT}` ## 语言支持 | 语言 | 模板文件 | |------|----------| | Java | `AGENTS.java.md` | | Python | `AGENTS.python.md` | | C++ | `AGENTS.cpp.md` | | Rust | `AGENTS.rust.md` | | Kotlin | `AGENTS.kotlin.md` | | JavaScript | `AGENTS.js.md` | | ANSI C | `AGENTS.ansi_c.md` | | Shell | `AGENTS.shell.md` | ## 合并流程 ### 1. 确定语言类型 根据以下方式确定语言类型： - 用户明确指定语言 - 根据项目源代码文件类型自动推断 - 优先级：用户指定 > 自动推断 ### 2. 授权读取模板 ``` 授权读取：${AI_SPEC_ROOT}/agent-template/AGENTS.{lang}.md Read ${AI_SPEC_ROOT}/agent-template/AGENTS.{lang}.md ``` ### 3. 合并规则 | 模板内容 | 项目内容 | 合后结果 | |----------|----------|----------| | 通用规则（交互规则、角色定位等） | 无 | 直接添加 | | 通用规则 | 已存在 | 检查一致性，补充缺失项 | | 语言特定规则（构建命令、代码风格等） | 无 | 直接添加 | | 语言特定规则 | 已存在 | 以项目内容为主，模板内容为补充 | | 项目特定内容 | - | 保留不变 | ### 4. 合并优先级 <HARD-GATE> 在合并时，如遇雷同条款，模板优先级高于项目 AGENTS.md。 </HARD-GATE> 1. **保留项目特有内容**：项目特有的配置、命令、规则不覆盖 2. **补充模板内容**：模板中有但项目中没有的内容，添加到项目 3. **校验一致性**：相同规则在不同版本中检查一致性 4. **内联优先**：在篇幅小于300行时，优先内联交互规则。超300行时，引用。 5. **篇幅控制**：超 1000 行的 AGENTS.md，不合理，应予以压缩。 ### 5. 输出 合并后更新当前目录下的 `AGENTS.md` 文件。 ## 合并示例 ### Java 项目合并 ``` # 读取 Java 模板 Read ${AI_SPEC_ROOT}/agent-template/AGENTS.java.md # 读取项目现有 AGENTS.md（如存在） Read ./AGENTS.md # 合并内容，输出到 ./AGENTS.md Write ./AGENTS.md ``` ### Python 项目合并 ``` # 读取 Python 模板 Read ${AI_SPEC_ROOT}/agent-template/AGENTS.python.md # 读取项目现有 AGENTS.md（如存在） Read ./AGENTS.md # 合并内容，输出到 ./AGENTS.md Write ./AGENTS.md ``` ## 合并检查清单 合并完成后检查： - [ ] 交互规则完整 - [ ] 构建命令正确 - [ ] 代码风格指南存在 - [ ] 语言特定规则已添加 - [ ] 项目特有内容保留 - [ ] 无冲突内容 - [ ] 格式规范（Markdown） ## 提交变更 合并完成后执行 git 提交： ```bash git add AGENTS.md git commit -m "docs: 更新 AGENTS.md 合并 {lang} 模板" ```