用途:审计、增强并重构项目的 AI 代理配置文件,让编程代理表现更好——减少错误假设、过度工程,改动更精准,目标可验证。支持 AGENTS.md、CLAUDE.md、.cursorrules、.github/copilot-instructions.md、.cursor/rules/.mdc、.claude/skills//SKILL.md、docs/agent-guides/*.md。开始时会声明“I'm using the agent-md-tuner skill.”。
主要能力:三种模式自动检测(可用户覆盖)。Create:无配置时从零生成项目感知文件;Enhance:配置存在、少于 150 行且有缺口时,用项目细节锐化泛化段落并合并缺失的行为约束;Restructure:配置超过 150 行或杂乱时,提议按三层架构精简重写(根文件 <100 行)。150 行仅为参考,还需考虑内容密度。
使用方式:分五个阶段。阶段 1 只读文件、不执行命令,识别语言框架、包管理器、测试运行器、linter/formatter、构建系统、CI/CD、目录结构与 monorepo 信号,形成项目画像;单体仓库参考 references/monorepo-scoped.md,非应用仓库回退到基础设施/配置分类。阶段 2 检测已存在的代理配置文件并记录行数与内容。阶段 3 按四类清单打分:行为约束(派生自 Karpathy,必查 references/karpathy-principles.md 的四原则:Think Before Coding、Simplicity First、Surgical Changes、Goal-Driven Execution)、项目上下文、渐进式披露、反模式。阶段 4 按严重度输出缺口报告,并请用户确认或覆盖模式。阶段 5 应用修复:Create 必须包含全部四原则;Enhance 仅追加或锐化,不改动既有项目专属规则,写前展示 diff;Restructure 展示完整前后 diff 并要求显式确认,拒绝则退回 Enhance。
输出格式:无文件时优先创建 AGENTS.md(被 OpenCode、Codex、Copilot、Kiro 识别),可改名 CLAUDE.md 供 Claude Code 使用;两者都存在时审计并标记冲突;用户指定格式时按指定生成。
限制:每条审计/创建/增强/重构操作前都必读 references/karpathy-principles.md,且产出必须包含全部四原则;写入前必须获得用户确认;Enhance 不删除已有内容;使用项目真实命令,检测不到时说明并询问;根文件保持精简;不把代理配置当 linter 用。收费、价格、平台与具体安装命令暂未提供。