hellyguohellyguo/self-ai-spec/skills/merge-agents-md/SKILL.md

merge-agents-md

Skill8 starsChanged 18 days agoApache-2.0View on GitHub

将语言特定的 AGENTS.md 模板合并进项目现有 AGENTS.md，保留项目特有内容并补齐通用规则。适用于新项目初始化 AGENTS.md、为既有项目补充语言规范。

In this repository32 other files it gives its agents.
- AGENTS.mdAGENTS.md
- ast-grep-blockSkill
- code-deconstructSkill
- code-detect-dupSkill
- code-detect-problemSkill
- code-part-modificationSkill
- code-refactorSkill
- code-reviewSkill
- cpp-checkSkill
- cpp-clang-tidySkill
- cpp-tscancodeSkill
- full-analysisSkill
- gdb-heap-analysisSkill
- java-asprofSkill
- java-check-pmdSkill
- java-check-spotbugsSkill
- java-coverageSkill
- java-envSkill
- java-g2mSkill
- jmh-benchSkill
- lets-loopSkill
- long-term-taskSkill
- md2pdfSkill
- qualitative-assessmentSkill
- requirement-collectSkill
- rust-clippySkill
- rust-flamegraphSkill
- shell-checkSkill
- sql-extractSkill
- sync-dev-specSkill
- sync-repo-docsSkill
- vbox-test-envSkill

The file

Create a free account to mount

Files

SKILL.md

合并 AGENTS.md

概述

将语言特定的 AGENTS.md 模板与项目当前目录下的 AGENTS.md 进行合并，生成更新后的 AGENTS.md 文件。
填充模板中的占位符，按项目实际情况进行填充

环境变量

${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-templates/AGENTS.{lang}.md

Read ${AI_SPEC_ROOT}/agent-templates/AGENTS.{lang}.md

3. 合并规则

模板内容	项目内容	合后结果
通用规则（交互规则、角色定位、工作准则等）	无	直接添加
通用规则	已存在	以模板为准，补齐并替换旧版本
语言规范引用（spec/review/ci 路径）	无	直接添加
语言规范引用	已存在	以模板为准，修正失效路径
项目特定内容（配置、命令、业务规则）	-	保留不变，不被模板覆盖

4. 合并优先级

按内容类型划分权威，避免"模板优先"与"项目优先"相互冲突：

内容类型	权威来源	处理
项目事实（配置、命令、路径、业务规则、接口约定）	项目 AGENTS.md	保留，不得被模板覆盖
通用规则（交互规则、角色定位、工作准则）	模板	以模板为准，补齐或替换旧版本
语言规范引用（spec/review/ci 文件路径）	模板	以模板为准，缺失则补充
冲突条款	项目事实优先	保留项目条款，并在合并报告中标注冲突点

<HARD-GATE>
项目事实（配置、命令、路径、业务规则）不得被模板覆盖；通用规则与语言规范引用以模板为准。
</HARD-GATE>

保留项目特有内容：项目特有的配置、命令、规则不覆盖
补充模板内容：模板中有但项目中没有的内容，添加到项目
校验一致性：相同规则在不同版本中检查一致性
内联优先：篇幅小于 300 行时内联交互规则；超过 300 行时改为引用。
篇幅控制：超过 1000 行的 AGENTS.md 应压缩，优先合并重复条款。

5. 输出

合并后更新当前目录下的 AGENTS.md 文件。

合并示例

Java 项目合并

# 读取 Java 模板
Read ${AI_SPEC_ROOT}/agent-templates/AGENTS.java.md

# 读取项目现有 AGENTS.md（如存在）
Read ./AGENTS.md

# 合并内容，输出到 ./AGENTS.md
Write ./AGENTS.md

Python 项目合并

# 读取 Python 模板
Read ${AI_SPEC_ROOT}/agent-templates/AGENTS.python.md

# 读取项目现有 AGENTS.md（如存在）
Read ./AGENTS.md

# 合并内容，输出到 ./AGENTS.md
Write ./AGENTS.md

合并检查清单

合并完成后检查：

交互规则完整
构建命令正确
代码风格指南存在
语言特定规则已添加
项目特有内容保留
无冲突内容
格式规范（Markdown）

提交变更

合并完成后执行 git 提交：

git add AGENTS.md
git commit -m "docs: update AGENTS.md merged from {lang} template"

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free