用途:为仓库各文件夹生成高质量的 AGENTS.md。AGENTS.md 面向编码智能体,与面向人类的 README.md 互补,智能体会从当前目录向上查找该文件,子目录中的嵌套文件优先级更高;它与 .github/agents/*.agent.md(智能体身份定义)不同,属于项目上下文。
主要能力:识别需要生成文件的文件夹,包括仓库根目录、deep-wiki 生成的 wiki/(含使用 VitePress 的 package.json),以及存在时可生成的 tests/、src/、lib/、app/、api/、monorepo 的 packages//、apps//、services//、含构建清单(package.json、pyproject.toml、Cargo.toml、.csproj/*.fsproj、go.mod、pom.xml/build.gradle)的目录和含 workflows 或 actions 的 .github/。内容覆盖构建与运行命令(优先)、测试说明、项目结构、代码风格与约定(附真实代码片段)、Git 工作流和三级边界(总是做、先询问、绝不做)。
使用方式:生成前必须先检查是否存在,存在则跳过并报告;对每个文件夹独立判断。用命令 ls AGENTS.md 2>/dev/null 检查后,扫描文件夹识别语言、框架、构建工具与测试框架;读取配置文件(package.json 脚本、Makefile、pyproject.toml、Cargo.toml、CI 配置、docker-compose.yml、linter 配置)提取真实命令;阅读 3-5 个源文件检测命名、导入组织、错误处理等约定;只写适用的章节,并在写入前校验命令与路径真实、无占位符。生成 AGENTS.md 的同时,若 CLAUDE.md 不存在,则在同一文件夹生成内容固定为读取并遵循 AGENTS.md 的 CLAUDE.md。
适用场景与限制:适用于 Python、TypeScript、Rust、Go、Java、C# 等项目的智能体上下文维护。禁止覆盖已存在的 AGENTS.md 或 CLAUDE.md;不生成 node_modules/、.git/、dist/、build/、out/、target/、vendor/、.venv/、venv/、pycache/ 等;不编造章节、命令或路径,不在文件中写入密钥,不重复 README。费用、价格、平台与效果等事实暂未提供。