review-a-skill

审查技能

目标

在某项技能进入或留在库中之前，评估其质量、相关性和安全性。

防护措施

• 在自动化流水线中，始终使用 --format json 输出机器可读的数据。
• 检查目录条目时，始终使用 --fields 限制输出大小。
• 整理或移除技能前，始终先使用 --dry-run。
• 移除技能前，务必先通过 info --format json 检查是否有其他技能依赖它。

工作流

1. 预览技能内容，检查其质量和安全性。

npx ai-agent-skills preview <skill-name>

预览命令会对内容进行净化 — 如果它提示需要净化，请先调查再继续。

2. 检查目录条目的元数据是否完整。

npx ai-agent-skills info <skill-name> --format json --fields name,description,tags,collections,dependencies

3. 验证技能的 SKILL.md 结构。

npx ai-agent-skills validate <skill-name>

4. 如果技能需要整理（备注、集合、验证）：

npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify --dry-run
npx ai-agent-skills curate <skill-name> --notes "Reviewed: solid patterns" --verify

5. 如果应移除该技能：

npx ai-agent-skills curate <skill-name> --remove --dry-run
npx ai-agent-skills curate <skill-name> --remove --yes

决策标准

• 保留：描述清晰，frontmatter 有效，对库的受众有用，且不含注入模式。
• 整理：需要完善 whyHere、集合归属或验证状态。
• 移除：重复、过时、来源失效或包含可疑内容。

注意事项

• preview 命令仅适用于内置（house）技能。上游技能仅显示描述和 whyHere。
• validate 命令会检查 frontmatter 结构，但不会评估内容质量 — 这需要人工或 Agent 判断。
• 移除其他技能所依赖的技能会破坏依赖关系图。务必先检查 dependencies.usedBy。