文档中心

AgentKit

技能评测与质量安全

查看并修复质量检查问题

质量检查用于展示当前技能版本静态质量检查结果，可用于快速识别技能在结构、格式、资源引用及安全等方面的潜在问题。检查范围通常包括技能包结构、SKILL.md 元信息（例如 frontmatter、name、description）、脚本可解析性，以及链接、参考文档等资源的引用规范。

通过检查概览和问题列表，可查看 P0 阻断、P1 警告、P2 建议等不同等级问题的数量分布，并结合命中规则、问题类别、修复建议及文件位置快速定位问题，辅助开展修复与复查。

触发机制

系统在以下场景自动触发质量检查：

检查范围

检查类别	说明
元信息	检查 SKILL.md 中的 frontmatter 及 name、description、compatibility、metadata 等元信息是否完整、规范并可正确解析。
目录结构	检查文件目录组织、文件命名、产物存放位置及根目录结构是否符合要求。
Markdown	检查 SKILL.md 和其他 Markdown 文件的语法、标题层级、链接及书写格式是否规范。
脚本	检查 Python 等脚本文件的编码和语法是否符合要求，确保相关脚本可解析和执行。
资源引用	检查链接、附件及其他资源的引用方式是否正确，识别失效链接、未引用资源或引用层级过深等问题。
安全	检查是否存在疑似硬编码密钥、高熵字符串、敏感信息或其他安全风险。

推荐场景

操作步骤

注意

步骤一：进入目标技能详情页

步骤二：查看质量检查结果

在技能详情页，单击“质量检查”页签。通过检查概览和问题列表，了解当前技能版本的问题分布及具体问题，为后续修复提供依据。

类别	说明
检查概览	展示当前技能版本的质量检查执行状态、问题总数及各等级问题的数量分布，用于快速了解任务进度和整体质量情况。 ① 检查状态与问题总数展示当前技能版本质量检查任务的执行状态与问题总数量，用于快速了解任务进度及整体问题数量。 ② 当前版本展示质量检查结果所属的技能版本。查看结果时需确认版本号，避免与其他版本的质量检查结果混淆。 ③ 风险概览汇总展示当前技能版本检出的全部质量问题，按P0 阻断、P1 警告、P2 建议三个等级统计对应问题数量，帮助您快速评估技能安全现状。 P0 阻断：存在严重结构错误、安全风险或不可执行问题，强烈建议完成修复，以减少运行、格式及维护隐患。 P1 警告：存在重要规范问题或潜在质量风险，默认不阻断发布，但可能影响运行稳定性，建议优先修复。 P2 建议：与开发最佳实践、代码规范、目录结构或文档格式相关的优化项，默认不阻断发布，可结合业务需求按需处理。
问题列表	展示当前技能版本在质量检查中发现的具体问题。每条检查结果包含命中规则、问题类别和等级、修复建议等信息，可用于快速定位问题文件与具体行号，开展问题整改。

步骤三：修复质量检查问题

查看质量检查检出的各类问题，依据问题等级、修复建议与文件定位信息完成整改。

说明

建议按照 P0 阻断 > P1 警告 > P2 建议的顺序处理，减少基础缺陷对技能运行带来的影响，提升整体修复效率。

单击问题定位信息中对应的文件名称或行号，跳转至问题所在的目标文件。例如，页面显示 SKILL.md:3 时，表示本次质量检查检出的质量问题出现在 SKILL.md 文件的第 3 行。

步骤四：验证修复结果

待系统完成新版本的质量检查后，将返回新版本的质量检查页面并更新扫描结果。可在问题列表中确认原有问题是否已消除，并核查本次修改是否引入新的质量问题。若原有问题尚未修复或检测到新增问题，可参考步骤三再次定位对应文件与行号并继续整改，直至相关问题符合预期或全部处理完成。

最近更新时间：2026.10.10 11:54:25

这个页面对您有帮助吗？

有用

无用