Community编程与开发github.com

Devolutions/IronRDP

逐行审查现有的 AGENTS.md 或 CLAUDE.md 文件,找出错误、过时、可发现、重复或无内容的指导,并提出修剪后的文件。适用于要求审查、精简、缩减或清理某个文件时。

IronRDP 是什么?

该技能旨在帮助开发者和 AI 代理系统梳理和优化其引用文件(如 AGENTS.md 和 CLAUDE.md)。它通过应用严格的测试标准(见 agents-md),对文件中的每一条规则或示例进行评审,并给出如下分类结果:错误(Wrong,与工具配置不符)、过时(Stale,与当前代码库或分支不匹配)、重复(Duplicated,已在技能或固定读取文件中存在)、可发现(Discoverable)、无内容(Content-free)、以及误放(Misplaced)。此外,技能还会关注缺失的内容,例如未引用的机构政策、非常规布局等。最终,技能输出一个 Markdown 表格形式的评审报告,列出每个判定结果及其证据,再给出经过精简后的完整文件建议,并说明哪些内容应该迁移到技能文件或子文件中,以及哪些部分需要人工决策。该技能特别适用于那些希望保持 AGENTS.md 或 CLAUDE.md 清晰、准确、可维护的开发团队,支持任何使用此类文件的 AI 平台(如 Claude Code、Cursor 等)。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Devolutions/IronRDP/tree/HEAD/.agents/skills/agents-md-review

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

AGENTS.md 审查

判定结果应用 agents-md 中的测试:需要多于一轮低成本反馈来发现和修复,并且不在任何技能或固定读取文件中声明。

验证,然后分类

审查提供的文件并声明其版本。 在评判之前,对照实际情况检查每个块;每个判定提供一条证据即可。

  • 针对使用这些示例和格式的工具(变更日志生成器、发布工具、CI 工作流):错误。 阅读工具的配置就足够了;即使错误输出尚未发布,如果工具会错误地渲染,那就是错误的。
  • 针对代码树和远程默认分支的列表:过时。
  • 对照已合并 PR 的历史声称的约定:如果没有人在遵循,且维护者确认没有人决定过,则从未成为约定。 维护者可能有意引入规则,而人类提交者并不能证明是谁决定的,因此未遵循且维护者未裁定的规则应归入“人类决策”列表。
  • 针对已安装技能和固定读取文件的规则:重复。
  • 针对上述测试的所有其他内容:可发现、无内容或纯命令。
  • 始终加载的指向长指南的指针:误放;它应属于需要它的技能。

一个块可能获得多个判定,每个判定都有各自的证据;优先使用不需要人工确认的判定,这样可以在维护者回复前开始修剪。

同时还要寻找缺失的内容:组织在其他地方应用的策略(意图文件规则、写作惯例、注释标记)、没有指针的非标准布局,以及没有同级 CLAUDE.md 符号链接的 AGENTS.md。 agents-md/references/before-after.md 是一个仓库的现成答案;针对你面前的仓库重新验证每一行,绝不要直接粘贴。

报告

| 块 | 判定 | 证据 |
|---|---|---|
| `Issue: #456`、`Issue: N/A` 作为有效页脚 | 错误,从未成为约定 | `cliff.toml` 将每个 `Issue:` 值转为 Jira 链接;维护者确认两者均未被决定 |
| 测试驱动 CLI 二进制文件,而非库;参见 `testsuite/AGENTS.md` | 保留 | 重做库级测试套件需要多于一轮反馈;没有技能声明这一点 |

然后提出修剪后的完整文件,列出移入技能或嵌套 AGENTS.md 的内容,以及需要人工决策的内容。 除非被要求,否则不要应用更改。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相关技能