技能描述审计(Skill Description Audit)是用户级元技能,用于审计其它 Agent Skill 的 SKILL.md,重点核对 frontmatter 的 description 与正文能力是否一致。资料显示其只读被审技能,不改 SKILL.md、不执行被审脚本,唯一写出口是在被审技能同目录生成或覆盖 DESCRIPTION-AUDIT.md(默认名,用户可指定其它文件名但须同目录)。
主要能力:规范合规检查(description 非空、折叠后不超过 1024 字符、含 WHAT 与 WHEN、第三人称、name 规则与目录一致、YAML 可解析与 frontmatter 闭合、描述不吞正文、正文非空、语言一致、官方字段合法、无 emoji 等);正文能力与强制点抽取及交叉验证矩阵;触发词与误触发风险评估,含 NOT for 反触发建议;数据外置检查(易变数据是否分层到 references/ 并带 lastUpdated、refreshInterval、置信度);调用与授权检查(高影响/元技能是否收敛为 user-invoked、allowed-tools 是否最小权限);前向引用视野(点名退役件、近似名、客户端专有件等判定);名称语义与旧名残留检查。
使用方式:仅用户显式调用,技能设 disable-model-invocation: true,agent 不得自主触发;用户未指定目标时先询问。输入为技能目录或其中 SKILL.md 的路径。落盘报告须含问题、建议、验收标准三节,报告头注明审计日期、审计指纹(python3 skill-audit-fp.py <技能名>,取 12 位输出)与审计独立性状态,出报告前完成改动,出报告后再改被审技能则本次审计作废。流程中还会运行 bash skill-smoke.sh 做只读校验。
适用场景:检查某技能描述是否覆盖正文强制能力、触发词是否足够、是否合规。限制:不审计 scripts/ 与参考文档细节(数据外置仅查目录存在性与表头);审计员须独立于被审对象,无独立方时须先获用户明确授权;建议文案仅写入报告,不写回 SKILL.md;部分字段跨实现支持不一,收敛属尽力而为。具体价格与平台信息暂未提供。