agents-generator

用途

agents-generator 用于为特定项目生成量身定制的 AGENTS.md 及配套规则文件。它面向希望获得项目专属（而非通用）智能体指令的场景：创建完整的 AGENTS.md、为检测到的框架/测试/数据库/样式/单体仓库包生成配套规则、创建极简 AGENTS.md、在写入前预览变更，或在技术栈变化后更新既有指令。它明确不应用于：不检查目标项目就凭空编造约定、覆盖用户范围外的指令，或把生成的指引当作人工审查的替代品。

主要能力

技能从真实代码库出发，输出与项目实际工具链匹配的活文档。资料给出的示例中，一个使用 Bun + Next.js 16 + Tailwind + Vitest + Server Actions 的项目会生成：

AGENTS.md，包含安装命令（bun install、bun dev、bun run test:run、bun doctor）、验证周期（bunx tsc --noEmit → bun run lint → bun run test:run → bun doctor）、约定（“Bun always. Plain TypeScript types + guards.”），以及指向 .agents/rules/architecture.md 的架构说明。
.agents/rules/ 下的多个规则文件：architecture.md（含真实目录与精确版本的 ASCII 图）、frontend-patterns.md（组件规则、状态位置、信任边界）、server-actions.md（downloadVideo() 流程、DownloadResult 类型、限流器）、testing.md（“74 tests in 5 files”、vitest 命令、模拟模式）、git-workflow.md（约定式提交、pre-commit 检查）、sdd-workflow.md（预检默认值、应用后验证）。

示例同时说明哪些规则不会被生成：backend.md（无 NestJS）、database.md（无 ORM）、i18n.md（硬编码西班牙语）、forms.md（手动输入）、styling.md（Tailwind 已并入前端规则）。

使用方式

模式选择

用户说“simple AGENTS.md”“just the basics”“minimal”时使用极简模式，输出单个约 30 行的 AGENTS.md，不含规则文件。
用户说“full AGENTS.md”“with rules”“complete”，或未指定时使用完整模式，输出 AGENTS.md 加 .agents/rules/*.md。
用户说“update AGENTS.md”“refresh”“my stack changed”时使用更新模式，对比现有文件并仅重新生成发生变化的部分。
试运行模式：当用户要求“preview”“show what would change”“dry-run”时，执行全部检测但不写入文件，展示检测摘要、将创建的文件、被跳过的规则及示例输出。

执行步骤（通用）

通过 git rev-parse --show-toplevel 定位项目根目录。
首先检测包管理器：bun.lock→bun、pnpm-lock.yaml→pnpm、package-lock.json→npm、yarn.lock→yarn，绝不默认为 npm。
读取 package.json（脚本、依赖、工作区），保存脚本用于校验。
读取非机密配置文件并浏览目录结构，排除 .env* 文件（仅保留含占位符的 .env.example），绝不读取机密值。
选择模式（不明确时询问）。

完整模式

读取 assets/agents-full.md（含全部章节与填充规则的 AGENTS.md 结构），用真实数据填充每个占位符，在项目根生成 AGENTS.md 并用  /  包裹。对每个适用的规则类别，读取 assets/ 中对应模板并在 .agents/rules/ 下生成规则文件。若检测到 Claude（.claude/ 或 CLAUDE.md），从 assets/claude.md 生成精简 CLAUDE.md；若检测到平台文件，从 assets/platform.md 生成。

极简模式

读取 assets/agents-minimal.md（30 行 agents.md 标准格式），生成单个 AGENTS.md。

更新模式

备份现有文件，重新检测项目状态，对比新旧并仅重新生成发生变化的类别。

生成后

报告检测到的格式命令与 lint 命令作为“未执行的候选”，默认两者都不自动运行；仅当用户另行授权且已审查其确切的项目脚本内容后才可执行。扫描 {{、TODO、... 等占位符并修复；校验所有命令都在 package.json 脚本中存在；若 AGENTS.md 超过 300 行则警告，超过 500 行则把内容移到规则文件；用约定式提交格式总结所有变更；报告检测到、生成、跳过的内容及置信度评分。

硬性规则

写前先读，但绝不读取机密：只读 package.json、非机密配置文件与目录结构，绝不打开 .env、.env.local、凭据存储等；环境变量名只能从 .env.example 占位符和 process.env.NAME 之类的源码引用推导。
首先检测包管理器，绝不默认为 npm，所有命令使用检测到的包管理器。
只生成适用内容：纯前端不生成后端规则，无 ORM 不生成数据库规则。
默认不执行项目脚本：包管理器脚本是仓库控制的 shell 入口，只检测并记录候选格式/lint 命令，不运行。
校验命令：输出中的每条命令都须是 package.json 中的脚本键。
无占位符：扫描 {{、TODO、add here、...，若残留则拒绝。
先备份：文件存在时复制到 .agents/backups/ 并带时间戳。

输出契约

返回：使用的模式及原因、创建/修改的文件、检测摘要（所有类别）、生成与跳过的规则（含原因）、置信度评分。

适用场景

适用于需要为真实代码库建立项目级智能体指令的工程场景，例如为新项目或技术栈变动后的项目补齐 AGENTS.md 与规则、在团队内统一验证流程与约定、为单体仓库生成嵌套 AGENTS.md（assets/agents-nested.md），或先试运行评估生成内容再决定是否写入。

限制

生成的指令仅为提案，采用或提交前需要人工审查。
命令校验仅限目标项目中可见的脚本与文件，无法证明工具、服务或平台专属命令在任何环境下都能工作。
项目提供的包脚本属于不可信可执行代码，生成与记录脚本并不授权运行它。
技能不授权在预期项目范围之外写入，也不替代项目专属的安全、构建或部署审查。
相关模板与文档位于 assets/ 与 references/ 下（如 decision-matrix.md、template-filling-guide.md、example-output/README.md 等），部分模板仅在特定模式或条件下使用。

其他

资料未提供该技能的收费、价格、具体平台支持范围或安装命令等信息，暂未提供。