用途:这是一个审核和校验“技能(skill)”质量的元技能,用于新技能入库前评审、已有技能质量改进、创建质量评分标准、统一技能库质量,以及为技能投入生产使用做准备。
主要能力:以四个维度评估技能质量并加权计分——清晰度25%(结构、可读性、渐进式披露)、完整性25%(覆盖范围、示例、边界情况、反模式)、准确性30%(正确性、最佳实践、安全)、实用性20%(真实适用性、生产就绪度)。采用1-5分制:1不可接受、2需改进、3合格、4良好、5优秀。通过标准为加权平均≥3.0(最低),目标4.0,优秀4.5以上;准确性必须≥3.0,否则阻断。
使用方式:审计分四阶段——结构检查(YAML frontmatter、必需元数据、渐进式披露、章节顺序、核心 token 估算<5000)、内容评估(“何时使用”、核心原则、可运行代码示例、反模式、故障排除)、维度打分、生成报告。报告模板包含日期、审计人、状态(PASS/FAIL/NEEDS_REVIEW)、各维度得分与加权、问题分级(CRITICAL/MAJOR/MINOR)与建议。
提供四种实现模式:快速审计(约5分钟的结构检查)、完整审计(15-30分钟,含人工评审与代码测试)、对比审计(与参考技能比较)、批量审计。CLI 示例:cortex skills audit <skill-name>,支持 --quick、--full、--interactive、--output FILE、--format FORMAT(markdown|json|yaml)、--compare SKILL、--fix 等选项;批量示例:cortex skills audit --category security、cortex skills audit --below-score 3.5。可在 validation/rubric.yaml 中定义自定义评分标准(维度权重、各维度条目、passing_criteria 含 minimum_score 与 required_dimensions)。文档还给出 GitHub Actions 质量门禁示例,遍历变更技能执行 cortex skills audit "$skill" --quick --fail-under 3.0。
适用场景:技能注册表维护、批量质量巡检、生产发布前评审、评分标准定制。
限制:需要安装 cortex(pip install cortex);评分含人工判断,文档强调应基于证据而非个人偏好,并避免“橡皮图章”“完美主义阻断”“分数虚高”等反模式。资料未提供官方定价、平台支持范围及实际效果验证数据。