技能规范评审
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sanyuan0704-sanyuan-skills-skill-review。
技能介绍
要解决什么问题
Agent 技能越来越多,评审却常停在「结构不错」「可以再优化」——模型读不到具体改哪一行、为了什么。本技能把评审收成可复用流程:先锁定目标目录与 SKILL.md 行数,再对照 references/review-criteria.md 在五维上打分,最后输出带引用的优势与可粘贴的修改建议。
工作方式
铁律:不说「could be improved」却不写清改什么、为何影响输出质量。
- 加载目标(必填):支持显式路径
/skill-review path/to/skill、当前目录或按名称在工作区搜索;读取完整SKILL.md并列出目录文件。 - 分析(必填):五维检查——结构合规(标准布局、frontmatter、references 层级)、描述质量(触发词、是否自洽可路由)、工作流设计(
⚠️ REQUIRED/ 检查清单、确认门禁)、Token 效率(Iron Law、按需加载 references、脚本执行而非塞进上下文)、反模式(模糊指令、TODO 残留、巨石 SKILL.md 等)。 - 报告(必填):先列 Strengths(至少 2 条并引用原文),再按影响排序 Suggestions(What / Where / Fix)。
边界与注意
依赖技能包内 review-criteria.md;不负责从零撰写技能,也不替代你对业务域的取舍。目录若缺 references 或 SKILL.md 超长,评审会重点落在结构与 Token 维度上。
使用场景
- 维护 monorepo 里十几个技能包,上线前要对某个 `SKILL.md` 做结构化体检并出修改清单
- 收到同事 PR 只改了描述字段,需要核对 frontmatter 与触发词是否仍能被路由匹配
- 发现某技能上下文经常爆 Token,想按准则判断是 references 全量加载还是正文冗余
- 刚合并第三方技能目录,要确认是否含 README 重复、缺 `scripts/` 或 references 层级过深
适合人员
- 维护 Cursor/Claude 技能库的平台工程师,需要统一评审标准而不是口头 code review
- 写 Agent Skill 的贡献者,希望 PR 反馈能落到文件路径与前后文示例
- 负责技能上架审核的编辑,要核对目录布局与描述是否满足站点规范
- 做多技能合集仓库的 maintainer,定期瘦身 Token 并清理反模式残留