audit-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

audit-skills

audit-skills

Scans all
src/skills/*/SKILL.md
files and reports compliance with OrchestKit authoring standards. Each category has individual files in
rules/
and
references/
loaded on-demand.
扫描所有
src/skills/*/SKILL.md
文件,检查是否符合OrchestKit创作标准。每个分类的规则和引用分别存储在
rules/
references/
目录下,按需加载。

Quick Reference

快速参考

CategoryFileImpactWhen to Use
Audit Checks
${CLAUDE_SKILL_DIR}/rules/audit-checks.md
HIGHWhat to validate per skill
Status Rules
${CLAUDE_SKILL_DIR}/rules/audit-status.md
MEDIUMPASS/WARN/FAIL classification
Output Format
${CLAUDE_SKILL_DIR}/references/output-format.md
MEDIUMTable layout and column definitions
Edge Cases
${CLAUDE_SKILL_DIR}/references/edge-cases.md
LOWManifest "all", orchestration skills
Total: 2 rules across 2 categories
分类文件影响级别使用场景
审计检查
${CLAUDE_SKILL_DIR}/rules/audit-checks.md
每个skill需要验证的内容
状态规则
${CLAUDE_SKILL_DIR}/rules/audit-status.md
PASS/WARN/FAIL 分类标准
输出格式
${CLAUDE_SKILL_DIR}/references/output-format.md
表格布局和列定义
边缘情况
${CLAUDE_SKILL_DIR}/references/edge-cases.md
清单中的"all"、编排类skill
总计:2个分类下共2条规则

Workflow

工作流程

  1. Discover — Glob
    src/skills/*/SKILL.md
    to get full skill list
  2. Check each skill — Run all checks from
    Read("${CLAUDE_SKILL_DIR}/rules/audit-checks.md")
    in parallel
  3. Classify — Apply status rules from
    Read("${CLAUDE_SKILL_DIR}/rules/audit-status.md")
  4. Render — Output table using format from
    Read("${CLAUDE_SKILL_DIR}/references/output-format.md")
  5. Totals — Show
    X pass, Y warn, Z fail
    at bottom
  1. 发现 — 通配匹配
    src/skills/*/SKILL.md
    获取所有skill列表
  2. 检查每个skill — 并行执行
    Read("${CLAUDE_SKILL_DIR}/rules/audit-checks.md")
    中的所有检查项
  3. 分类 — 应用
    Read("${CLAUDE_SKILL_DIR}/rules/audit-status.md")
    中的状态规则
  4. 渲染 — 按照
    Read("${CLAUDE_SKILL_DIR}/references/output-format.md")
    中的格式输出表格
  5. 统计 — 在底部显示
    X项通过,Y项警告,Z项失败

Quick Start

快速开始

bash
bash src/skills/audit-skills/scripts/run-audit.sh
Or invoke manually — Claude scans
src/skills/
, applies checks, and renders the summary table.
bash
bash src/skills/audit-skills/scripts/run-audit.sh
也可手动调用——Claude会扫描
src/skills/
目录,执行检查并渲染汇总表格。

Key Decisions

关键决策

DecisionRecommendation
Manifest check
"skills": "all"
in ork.json means ALL skills qualify — mark YES
0 rules + refsWARN only — some orchestration skills are legitimately rules-free
Broken refsWARN (not FAIL) — file may exist under a different path
决策项建议
清单检查若ork.json中
"skills": "all"
,则所有skill都符合要求——标记为YES
无规则和引用仅标记警告——部分编排类skill确实无需规则
引用失效标记警告(而非失败)——文件可能存在于其他路径

Related Skills

相关Skill

  • ork:skill-evolution
    — Guidance on iterating and improving skills
  • ork:quality-gates
    — Broader codebase quality checks
  • ork:skill-evolution
    — 关于迭代和优化skill的指南
  • ork:quality-gates
    — 更全面的代码库质量检查