SuperAPI AI 工具集

claude-md-improver

智能体与模型

查看项目

更新于 10-15 18:31

技能介绍

用途:审计、评估并改进代码库中的 CLAUDE.md 文件,让 Claude Code 获得更合适的项目上下文。该技能可以写入 CLAUDE.md 文件,但会先给出质量报告并取得用户批准,再做针对性改进。

主要能力:发现仓库中的 CLAUDE.md 文件,包括项目根目录 ./CLAUDE.md、本地覆盖 ./.claude.local.md、全局默认 ~/.claude/CLAUDE.md、monorepo 中的包级文件以及任意子目录文件。发现命令为:find . -name "CLAUDE.md" -o -name ".claude.md" -o -name ".claude.local.md" 2>/dev/null | head -50。随后按命令与工作流、架构清晰度、非显而易见模式、简洁性、时效性、可执行性等标准评分,等级从 A(90-100)到 F(0-29)。

使用方式:先输出质量报告,包含文件数量、平均分、需更新文件数及逐文件评估;再询问用户确认,之后用 Edit 工具应用改动,并以 diff 形式展示每处新增内容及理由,同时保留原有内容结构。

适用场景:检查、审计、更新、改进或修复 CLAUDE.md 文件;monorepo 中模块级上下文维护;补充构建、测试、部署命令与配置要点。

限制与注意:更新应保持最小化,避免复述代码中显而易见的内容、通用最佳实践和一次性修复;建议提醒用户使用 # 快捷键、保持简洁、命令可复制粘贴、个人偏好放入 .claude.local.md 并加入 .gitignore、全局偏好放入 ~/.claude/CLAUDE.md。模板与详细评分标准见 references/templates.md 和 references/quality-criteria.md。