用途
claude-md-improver 面向需要维护 AGENTS.md 等代理上下文文件的代码仓库,帮助审计、评估并改进这些文件,使 Google Antigravity 获得更优的项目上下文。该技能可写入 AGENTS.md 文件,但会先输出质量报告并取得用户批准后再更新。
主要能力
- 发现仓库中的上下文文件:扫描 AGENTS.md、.claude.md、.claude.local.md,来源资料给出的示例命令为
find . -name "AGENTS.md" -o -name ".claude.md" -o -name ".claude.local.md" 2>/dev/null | head -50。 - 区分文件类型与位置:项目根 ./AGENTS.md(提交到 git 的团队共享上下文)、本地覆盖 ./.claude.local.md(个人本地设置,被 gitignore)、全局默认 ~/.gemini/config/AGENTS.md、包级 ./packages/*/AGENTS.md(monorepo 模块上下文)、子目录中的特定功能/领域上下文。资料说明 Antigravity 会自动发现父目录中的 AGENTS.md,因此 monorepo 可自动生效。
- 质量评估:按六项标准评分,包括命令/工作流(高权重)、架构清晰度(高)、非显而易见的模式(中)、简洁性(中)、时效性(高)、可执行性(高);给出 A(90-100)到 F(0-29)的等级。
- 输出质量报告:汇总文件数量、平均分、需更新文件数,并逐个文件列出评分表、问题与建议补充内容。
- 定向更新:在报告后请求用户确认;仅提议真正有用的补充,如分析中发现的命令/工作流、代码中的易错点、包关系、可用的测试方式、配置怪癖;避免重复显而易见的内容、通用最佳实践、一次性修复和冗长解释。每项变更以 diff 形式展示文件、具体补充内容和理由。经批准后使用 replace_file_content 工具应用变更,保留原有内容结构。
使用方式
当用户要求检查、审计、更新、改进或修复 AGENTS.md 文件时使用。流程为:发现文件 → 质量评估 → 先输出质量报告 → 征求确认 → 展示 diff 形式的定向更新 → 获批后应用。资料还提到 references/quality-criteria.md 提供详细评分细则,references/templates.md 提供按项目类型的 AGENTS.md 模板。
适用场景
适用于需要让 Google Antigravity 获得准确项目上下文的仓库,尤其是包含多个包或子模块的 monorepo;也适合定期检查构建、测试、部署命令是否过时,环境变量与配置是否遗漏,以及记录不明显的代码模式与常见错误。
限制与注意事项
资料未提供收费、价格、支持平台或效果保证等信息。该技能会写入 AGENTS.md 文件,因此必须遵循先报告、后确认、再更新的流程。更新应保持最小化、人类可读、命令可复制粘贴,并优先项目特定模式而非通用建议。资料提示的常见问题包括:过时命令、缺失依赖、过期架构、缺失环境设置、失效测试命令、未记录的易错点。另建议用户了解:Antigravity 会话中按 # 可将学习内容自动纳入 AGENTS.md;个人偏好放入 .claude.local.md 并加入 .gitignore;用户级偏好放入 ~/.gemini/config/AGENTS.md。