SKILL审查

name: skill-check description: 审查和优化现有技能（Skill）结构质量。当用户请求「优化技能」「审查技能」或需要检查技能规范性时触发。

SKILL 技能审查器

分析技能目录结构，识别改进点，输出优化建议和执行方案。

专注于静态审查：分析 SKILL 目录结构和逻辑完整性。

技能工作流

调用 todo_write 工具创建待办任务：

结构分析 → 问题识别 → 逻辑审查 → 输出报告

审查维度

结构性维度（脚本检测）

逻辑性维度（LLM 分析）

Agent 兼容性维度（脚本 + LLM 分析）

工作流展示模板

## 技能工作流

调用 `todo_write` 工具创建待办任务：

步骤1 → 步骤2 → 步骤3 → 步骤4 → 步骤5

### 步骤1

步骤1详解

### 步骤2

步骤2详解

……

执行流程

输入校验： - 参数 <skill-dir> 必须为有效目录路径 - 目录必须包含 SKILL.md 文件

自我迭代模式： - 执行 python3 scripts/review-loop.py <skill-dir> 循环审查-修复直到无问题 - 自动检测结构性问题并修复，支持 --max-iterations 限制迭代次数

异常处理： - 脚本执行失败（退出码非零）→ 跳过结构检查，LLM 手动分析 - SKILL.md 不存在 → 输出 P0 问题，终止审查 - manifest.json 不存在 → 输出 P1 问题，继续审查

完成标准： - 所有 P0 问题已识别并给出建议 - 所有 P1 问题已识别并给出建议 - 输出可执行的优化方案

自由度匹配原则

脚本化信号（详见 references/structure-patterns.md#脚本化方案）： - 相同代码反复写 - LLM 多次推理相同逻辑 - 操作步骤固定、易出错 - 需要高可靠性

目录结构规范

skill-name/
├── manifest.json    # 可选：技能元数据（name、description、normalizedName、category）
├── SKILL.md         # 必需：核心工作流（< 500 行）
├── scripts/         # 可选：可执行脚本（确定性操作）
├── references/      # 可选：参考文档（按需加载）
└── assets/          # 可选：资源文件（输出中使用）

审查报告模板

# 技能审查报告：{skill-name}

## 结构概览

| 目录/文件 | 状态 | 说明 |
|-----------|------|------|
| manifest.json | ✅/⚠️/❌ | 元数据完整性 |
| SKILL.md | ✅/⚠️/❌ | {行数} 行 |
| scripts/ | ✅/❌ | {脚本数量} 个 |
| references/ | ✅/❌ | {文档数量} 个 |
| assets/ | ✅/❌ | {资源数量} 个 |

## 章节结构

| 章节 | 行数 | 状态 |
|------|------|------|
| {章节名} | {行数} | ✅/⚠️ |

## 问题清单

| 优先级 | 问题 | 建议 |
|--------|------|------|
| P0 | {问题描述} | {优化建议} |

## 优化方案

{具体执行步骤，可直接应用}

常见优化模式

逻辑问题修正

禁止事项

• ❌ 删除 SKILL.md 核心工作流
• ❌ 将脚本移出 scripts/ 目录
• ❌ 破坏现有脚本的执行能力
• ❌ 修改 frontmatter 中的 name 字段（必须与目录名一致）

参考资料

• 结构优化模式 → references/structure-patterns.md

这个技能能帮你检查和管理其他技能的质量，自动找出问题并给出修复方案，还能生成可视化的仪表板。做得好的地方是安全意识强——修复前会自动备份、出问题了能回滚，不会乱动非自建的技能。但它的自动修复能力比较有限，很多问题只能检测出来没法自动修；而且功能比较复杂，刚上手需要花时间理解。总体适合愿意折腾、对技能质量有要求的用户，但如果你想要省心省力的全自动化管理，可能会失望。