GenerateAgents.md
自动为代码仓库生成AGENTS.md文档的AI工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：GenerateAgents.md。 它的用途是：自动为代码仓库生成AGENTS.md文档的AI工具 完整的 Skill 内容见：https://321skill.com/skills/generateagents-md/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我为本地的Flask项目生成一份AGENTS.md文档，使用严格风格。” 它会自动分析你的代码库，识别关键约束和潜在陷阱，生成一份精炼的Agent指南。或者
对AI说：“分析GitHub上某仓库最近被回退的提交，总结出需要避免的反模式。” 它会交互式地让你选择提交记录，并分析差异，提炼出重要的经验教训。
介绍
GenerateAgents.md 是一个专为AI Agent设计的文档生成工具，它解决了开发者为AI助手（如Claude、Cursor等）手动编写代码库说明文档（AGENTS.md）耗时且不全面的痛点。该工具通过递归语言模型（dspy.RLM）深度分析本地或GitHub上的代码仓库，自动生成一份结构化的AGENTS.md文件，帮助AI Agent快速理解项目架构、核心逻辑和注意事项。
使用方式非常灵活，用户只需通过命令行指定本地路径或GitHub仓库URL即可运行。工具支持多种输出风格，例如“严格风格”专注于提炼代码中难以通过简单搜索发现的约束、未记录的怪癖和绝对禁止的操作，避免生成冗长且分散注意力的描述。它还提供了基于Git历史分析反模式的高级功能，能通过分析被回退的提交来推断项目中的“坑”。
这个工具非常适合开源项目维护者、希望让AI助手更好地参与自身项目的开发者，以及任何需要为团队或AI协作伙伴提供清晰代码库指引的场景。它降低了为复杂项目编写高质量Agent指导文档的门槛。
与同类代码分析或文档生成工具相比，GenerateAgents.md的核心区别在于其目标明确——专为AI Agent优化，而非人类开发者。它生成的AGENTS.md内容格式和侧重点（如约束、反模式）都是为了让LLM能更高效、更准确地理解代码库并执行任务，而非生成供人类阅读的API文档或代码注释。
核心特点
核心区别在于其专为AI Agent优化的文档生成目标，并首创了基于Git历史回退提交来智能推断代码“反模式”和“坑”的功能。它生成的不是传统的人类API文档，而是LLM能高效理解的、包含严格约束和禁忌的操作指南。
注意事项
不适合代码量极小或无实际逻辑的简单项目，其分析价值有限；且深度分析Git历史功能需要仓库本身有足够的提交记录。
常见问题
GenerateAgents.md支持哪些AI模型？
通过LiteLLM支持超过100家提供商，包括Gemini、Anthropic、OpenAI、Ollama、OpenRouter等，只需配置对应API密钥。
生成的AGENTS.md和README.md有什么区别？
AGENTS.md是专门给AI Agent看的“工作手册”，侧重代码约束、反模式和操作禁忌；README.md是面向人类用户的项目介绍和使用说明。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/generateagents-md/raw/index.md 读取 GenerateAgents.md 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/generateagents-md/raw/index.md（查看排版版本）