SuperAPI AI 工具集

grading-claude-agents-md

智能体与模型

查看项目

更新于 10-16 06:39

技能介绍

用途

该技能用于对智能体配置文件进行评分、审计与改进,主要面向两类文件:CLAUDE.md(Claude Code)和 AGENTS.md(Codex/OpenCode)。当用户需要评分、打分、评估、审计、审查或改进这些配置文件时使用。

主要能力

技能采用三阶段工作流:评分(GRADE)、计划(PLAN)、实施(IMPLEMENT)。

评分阶段会自动检测项目中的 CLAUDE.md 和/或 AGENTS.md 文件,依据评分标准对每个文件打分。评分维度包括:结构(25 分)、内容质量(25 分)、PDA 实现(25 分)、可维护性(25 分),基础总分为 100 分,另有 ±10 分的修正项用于奖励或扣分,最终得分限制在 0-100 之间。

等级对应关系:A(90-100)优秀,几乎无需改动;B(80-89)良好,建议小幅改进;C(70-79)合格,有明显问题需修复;D(60-69)较差,需要大幅重构;F(<60)严重,需要重大整改。

评分后生成报告,包含评分卡、按优先级排列的问题清单和改进计划。

使用方式

技能提供评分检查清单,逐步跟踪进度:检测文件、测量大小(行数、字节、token)、依次为四个维度打分、应用修正项、生成带等级的报告、列出按优先级排序的改进项,最后询问用户是否实施这些改进。

若用户批准改进,实施工作流会执行以下操作:备份原文件为 CLAUDE.md.backup;按需创建子目录配置;将内容提取到引用文件;为超过 100 行的文件生成目录;为提取的内容添加 @imports;对新结构运行大小检查;展示前后对比报告。

技能引用了三个参考文件:references/rubric.md 用于所有评分标准,references/improvement-patterns.md 用于实施修复,references/size-guide.md 用于理解阈值。

自动修复项

技能可自动处理以下问题:文件过大(超过 500 行)时拆分为子目录配置或 docs/;缺少目录(超过 100 行)时生成并插入目录;大段内容缺少 @imports 时提取到 docs/*.md 并添加 @imports;配置中存在样式规则时移至 linter 配置并添加指针;仅有否定规则时补充“改用 X”的替代方案;内容重复时合并到单一位置;monorepo 缺少子目录配置时创建包级 CLAUDE.md 文件。

输出格式

评分报告结构包含:文件名与总分/等级、各维度得分表(结构、内容质量、PDA 实现、可维护性、修正项)、按优先级排列的顶部问题(含描述、修复方式和修复后的分数影响)、推荐操作清单,最后询问是否实施改进。

适用场景

适用于需要评估和改进 CLAUDE.md 或 AGENTS.md 配置文件的场景,包括评分、审计、审查、生成改进计划并实施修复。

限制

该技能不适用于以下场景:创建新技能(应使用 skill-creator)、通用 markdown 编辑、README.md 或文档文件、系统提示词或提示工程、MCP 服务器配置。