By name: xgjk-skill-auditor description: Audit and score Agent Factory skills across 5 dimensions before publishing. Use when reviewing a skill before ClawHub release, checking skill quality, running security scan, generating PASS/REVISE verdict, or auditing cms-cwork / cms-sop / tpr-framework and other factory skills. homepage: https://github.com/evan-zhang/agent-factory issues: https://github.com/evan-zhang/agent-factory/issues/new?labels=xgjk-skill-auditor metadata: requires: env: []
xgjk-skill-auditor
工厂专属 Skill 质检工具。5 维度评分，给出 PASS/REVISE 判定 + 具体改进方向。
When to Use
- 发布 Skill 到 ClawHub 之前做质检
- 修改现有 Skill 后验证是否符合标准
- 对某个 Skill 进行安全合规扫描
- 生成评分报告（附 file:line 问题定位）
Do Not Use When
- 只是想快速读一个 Skill 的内容（直接用 read 工具）
- 想决定"要不要建 Skill"（用颗粒度决策树，见 SKILL-QUALITY-PRINCIPLES.md）
Audit 流程
Step 1 — 盘点 + 分类
find /path/to/skill -type f | sort，读取 SKILL.md 全文。
确定 Skill 类型（API集成/工作流/纯文档/混合），加载 references/factory-weights.md 获取权重。
Step 2 — 安全扫描（优先）
加载 references/security-patterns.md，运行 C1-C5 CRITICAL 扫描。
任意命中 → D4 = 1，直接 REVISE，停止后续评分。
无 CRITICAL → 继续 S1-S3 严重 / M1-M2 轻微扫描。
Step 3 — 逐维度评分
加载 references/scoring-rubric.md，按 D1→D5 顺序评分。
每个问题标注 [file:line]，不双重扣分。
Step 4 — 判定
加权总分 = Σ(维度分 × 权重) PASS：总分 ≥ 7.5 AND D4 ≥ 6；否则 REVISE
Step 5 — 输出报告
用以下格式输出（Telegram 适配，先结论）：
【PASS / REVISE】skill-name v版本号
综合得分：X.X / 10（API集成类）
• D1 结构质量（15%）：X/10
• D2 触发质量（15%）：X/10
• D3 内容质量（20%）：X/10
• D4 安全合规（35%）：X/10
• D5 发布合规（15%）：X/10
问题清单：
- [D1] SKILL.md 超过 80 行（当前 120 行）→ 推细节入 references/
- [D4] setup.md 缺失，有外部 API 调用 → 新建 setup.md 声明 endpoints
改进方向：
- 优先修复 D4（门控维度）
- 其次处理 D1 超长问题
Core Rules
- D4 是门控维度：CRITICAL 安全问题一票否决，不论其他维度分数。
- 白名单优先：
env_credential_access是已知误报，不扣分，报告中注明。 - 问题定位到行：每个问题必须标注
[file:line]，不写模糊描述。 - 不做修复：本工具只审计，不修改文件。发现问题 → 列清单 → 等人工处理。
References
references/maintenance.md— 维护信息（版本/GitHub/Issue 入口）references/factory-weights.md— Skill 类型分类 + 5 维度权重矩阵references/scoring-rubric.md— D1-D5 详细 checklist + 评分规则references/security-patterns.md— CRITICAL/严重/轻微 grep pattern + 误报白名单