agents-md-improver

AGENTS.md 改进器

此技能可帮助确保仓库说明准确且一致。当用户纠正编码 Agent 的行为时，应将其视为可能需要更新仓库说明文件，并提议对 AGENTS.md 进行简洁、整合的修改。

用法

在以下情况使用此技能：

• 用户纠正 Agent（“不要做 X”“改为做 Y”“从现在起……”“记住……”“添加一条规则……”）。
• 用户要求更新 AGENTS.md、CLAUDE.md、.claude/CLAUDE.md 或 GEMINI.md 等说明文件，或要求对齐或整合这些文件。
• 用户发现仓库说明文件之间存在矛盾、重复或内容偏差。

要求

• 具备仓库本地文件访问权限，以便读取和编辑 AGENTS.md。
• 如果仓库中存在 CLAUDE.md 和／或 .claude/CLAUDE.md，则需具备读取权限。

功能

• 提议以无缝方式将用户的纠正纳入 AGENTS.md。
• 查找并解决矛盾；如有需要，则请求澄清。
• 如果仓库中存在 CLAUDE.md 或 .claude/CLAUDE.md，则提议将说明整合到 AGENTS.md，然后提供删除、创建符号链接或替换为说明占位文件等后续选项。

工作方式

范围

此技能仅针对当前仓库。

• 仅考虑仓库本地的说明文件：
  • AGENTS.md
  • CLAUDE.md（仓库根目录）
  • .claude/CLAUDE.md
  • GEMINI.md（仓库根目录和／或仓库子目录中存在的文件）
• 忽略系统级说明和用户主目录下的文件（例如 ~/.claude/、~/.gemini/、~/.config/ 等）。

先提议的工作流（不要自动编辑）

1. 阅读 AGENTS.md。
2. 确认用户的纠正，并将其转化为持久、针对当前仓库的说明。
3. 确定说明应放置的位置：
   • 优先编辑最相关的现有章节。
   • 如果涉及真正的新主题，则提议在相关内容附近新增一个 ## 章节。
4. 起草具体的修改内容，作为小型补丁／片段。
5. 应用修改前先征求确认：
   • “要将这些修改应用到 AGENTS.md 吗？（y/n）”

只有在用户确认后，才应用修改。

无缝整合规则

• 不要添加带日期的变更日志条目，例如“YYYY-MM-DD：修正”。
• 更新现有的段落／项目／步骤，让新增规则读起来像文档原本就有的内容。
• 保持格式与 AGENTS.md 周围内容一致。

矛盾检查

提议补丁之前：

1. 检查 AGENTS.md，查找与新纠正相冲突的内容。
2. 如果存在冲突，应在提议的补丁中一并解决，重写或删除冲突的行。
3. 如果无法明确解决方式，则先提出一个有针对性的问题。

然后检查仓库本地的说明（如存在）：

• 对照 AGENTS.md 与 CLAUDE.md 和 .claude/CLAUDE.md。
• 标出重复和冲突。
• 优先整合到 AGENTS.md，将其作为唯一权威来源。

整合 CLAUDE.md 文件的流程（如存在）

如果仓库中存在 CLAUDE.md 和／或 .claude/CLAUDE.md：

1. 提议将内容整合到 AGENTS.md 的补丁。
2. 用户批准 AGENTS.md 的补丁后，针对每个 CLAUDE 文件提议后续处理方式：
   • 删除文件。
   • 将文件替换为指向 AGENTS.md 的符号链接。
   • 将文件内容替换为一个简短的占位说明，指引人和工具查看 AGENTS.md（当不便使用符号链接时的备用方案）。
3. 删除操作需单独征求确认。

选择符号链接时，链接方向如下：

• CLAUDE.md -> AGENTS.md
• .claude/CLAUDE.md -> ../AGENTS.md

多说明环境注意事项

某些运行环境会合并多个说明来源，并可能以非确定性方式应用相互冲突的规则。优先采用唯一权威来源（AGENTS.md），并通过整合和删除／创建符号链接／替换为说明占位文件来减少并行说明文件。