audit-skills

audit-skills

扫描所有 src/skills/*/SKILL.md 文件，并报告其是否符合 OrchestKit 编写规范。每个类别都在 rules/ 和 references/ 中设有单独的文件，按需加载。

快速参考

类别	文件	影响	使用时机
审计检查	${CLAUDE_SKILL_DIR}/rules/audit-checks.md	高	验证每项技能的内容
状态规则	${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”、编排类技能

总计：2 个类别中共 2 条规则

关键：任务管理为强制要求（CC 2.1.16）

在进行任何其他操作之前，创建任务以跟踪进度：

# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="Audit Skills: full scan",
  description="Auditing all OrchestKit skills for quality and compliance",
  activeForm="Auditing skill quality"
)

# 2. Create subtasks for each audit phase
TaskCreate(subject="Discover skills", activeForm="Globbing SKILL.md files")
TaskCreate(subject="Run audit checks", activeForm="Checking each skill")
TaskCreate(subject="Classify & render", activeForm="Classifying results and rendering report")

# 3. Set dependencies for sequential phases
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])

# 4. Before starting each task, verify it's unblocked
task = TaskGet(taskId="2")  # Verify blockedBy is empty

# 5. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done

工作流

1. 发现 — 使用 Glob src/skills/*/SKILL.md 获取完整的技能列表
2. 检查每项技能 — 并行运行 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 pass, Y warn, Z fail

快速开始

bash src/skills/audit-skills/scripts/run-audit.sh

也可以手动调用——Claude 会扫描 src/skills/、执行检查并呈现汇总表格。

CC 2.1.152+： 修复审计发现的 SKILL.md 文件后，运行 /reload-skills 重新扫描技能目录，并在当前会话中加载更改（无需重启）。对于打包在插件中的技能，请改为重新构建并运行 /reload-plugins。

关键决策

决策	建议
清单检查	ork.json 中的 "skills": "all" 表示符合条件的是所有技能——标记为 YES
0 条规则 + 参考文件	仅标记为 WARN——有些编排类技能确实无需规则
引用失效	标记为 WARN（而非 FAIL）——文件可能位于其他路径

相关技能

• ork:skill-evolution — 迭代和改进技能的指导
• ork:quality-gates — 更全面的代码库质量检查