SuperAPI AI 工具集

analyzing-component-quality

测试与质量

查看项目

更新于 10-15 18:45

技能介绍

用途:在组件已通过技术校验(YAML 前置元数据有效、字段齐全、命名规范、文件结构正确)的前提下,系统评估 Claude Code 组件的质量与有效性,而非正确性。适用于 agent 构建者新建或增强组件、用户询问某 agent/skill 质量、审查或优化组件、发布到市场前及组件审计时使用。

主要能力:按五个维度各打 1-5 分——描述清晰度(触发条件是否具体、能力陈述是否明确、有无示例)、工具权限(是否遵循最小权限、每个工具是否有理由)、自动触发(触发条件是否具体无歧义、误报率、覆盖度)、安全(权限是否最小、是否考虑输入校验、有无危险模式)、易用性(文档、示例、命名与行为是否直观)。最终给出综合评分(1.0-1.9 需大改,2.0-2.9 问题较多,3.0-3.9 需重要改进,4.0-4.4 良好,4.5-5.0 优秀可发布),并按 Critical/Important/Minor 归类问题,附前后对比的改进建议与预测分数提升。

使用方式:先读取组件文件并识别类型(agents/ 下的 .md、skills/*/SKILL.md、commands/ 下的 .md、hooks.json),逐步打分、识别问题、给出具体改进。附带脚本位于 {baseDir}/scripts/:quality-scorer.py(启发式自动评分与问题标记)、effectiveness-analyzer.py(触发与权限分析、预期激活率)、optimization-detector.py(简化与性能优化建议),运行示例:python {baseDir}/scripts/quality-scorer.py path/to/component.md;参考资料位于 {baseDir}/references/,包括 quality-standards.md、best-practices-guide.md、security-checklist.md、usability-guidelines.md。

组件特定要点:agents 重点看何时该调用、工具是否匹配任务,若含 Task 工具属严重问题(子代理不能生成子代理),若需编排应改为 skill;skills 看自动触发是否具体、是否用 {baseDir} 引用资源;commands 看描述、参数文档、提示是否可执行;hooks 看匹配器、类型与安全影响。

限制:技能假设组件已通过技术校验,不负责正确性验证;评分依据启发式规则,属主观但有原则的评估;市场组件标准更高,内部标准可放宽。未提供具体价格、平台支持范围等信息。