下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/user_0dea6a1d--check-skill-quality.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_0dea6a1d/check-skill-quality。按 Agent Skills 开放标准与编写最佳实践审计 Skill 文档质量（元数据、结构、引用、工作流、脚本与反模式），输出阻断项、警告与修复建议。当用户要求评审、打分、lint、审计或优化任意 Skill 目录，或在发布/合入前检查时启用。
阅读全文 （展开查看完整说明）
概述
审计任意 Agent Skill 目录的执行可靠性：Agent 能否一次完成「发现 → 加载 → 按步骤执行」？
依据标准（通用，不绑定具体项目）：
- Agent Skills Specification
- Claude Skill authoring best practices
- Cursor
/create-skill编写模式
不评价：
- MCP/CLI 运行时成功率、产品构建流水线、项目私有规范
- 平台安全扫描结论与上架决策（本 skill 只审文档与目录结构，见 [security-checklist.md](references/security-checklist.md)）
何时使用
- 用户要求评审、打分、lint、审计或改进某个 Skill
- 发布或分享 Skill 目录之前
- 用
/create-skill或手工编辑之后 - 对比两个 Skill 版本
输入
用户可提供：
| 输入 | 默认 |
|---|---|
| Skill 根目录 | 含 SKILL.md 的文件夹（不明确时询问） |
| Profile | standard — Cursor 专项见 [profiles/cursor.md](references/profiles/cursor.md) |
| 深度 | full — 元数据 + 正文 + 引用文件 + 脚本清单 |
除非用户明确要求修复，不要修改被审计的 Skill。
工作流
复制以下清单并逐项勾选：
Skill 检查进度：
- [ ] 步骤 1：定位根目录并清点文件
- [ ] 步骤 2：结构检查（可选脚本）
- [ ] 步骤 3：元数据审计（发现层）
- [ ] 步骤 4：正文与引用审计（六维）
- [ ] 步骤 5：可选触发测试
- [ ] 步骤 6：输出报告步骤 1：定位与清点
- 确认目录含
SKILL.md。 - 核对 frontmatter 中
name等于父目录名（Agent Skills 规范）。 - 列出可选目录：
references/、scripts/、assets/，以及SKILL.md直接链接的.md文件。
步骤 2：结构检查
有 Node.js 时，在本 skill 根目录执行（将 <skill-root-path> 换为被审计目录）：
node scripts/check-structure.cjs <skill-root-path>无参或 --help 可查看中文用法。
| exit | stderr/stdout | 含义 |
|---|---|---|
| 0 | 结果: 通过 | 无阻断；可能有 警告: 行 |
| 0 | 仅 --help 输出 | 用法说明 |
| 1 | 阻断: 一行或多行 | 须写入报告「阻断」节 |
| 1 | 无参 | 未提供 skill 根目录 |
同一目录连跑两次，exit code 与 阻断/警告 行应一致（见 [effectiveness-comparison.md](references/effectiveness-comparison.md) § 脚本可重复性）。
无 Node 时按 [blocking-rules.md](references/blocking-rules.md) 手工检查。
步骤 3：元数据审计（维度 A）
阅读 [rubric.md](references/rubric.md) § 维度 A。检查 name、description 及可选字段（license、compatibility、metadata；profile=cursor 时含 paths / disable-model-invocation）。
description 删除测试：在 100+ 个 Skill 中，Agent 能否因 description 选中本 Skill？不能 → 警告或阻断。
步骤 4：正文与引用审计（维度 B–F）
读完 SKILL.md，再读 仅由 SKILL.md 直接链接 的文件（一层深度）。引用文件超过 100 行时，检查文首是否有目录。
按 rubric 维度 B–F 记录每条发现：
- 严重级别：阻断 | 警告 | 提示
- 证据：
path:line或短引文 - 修复：一条可执行动作
阻断规则摘要：[blocking-rules.md](references/blocking-rules.md)。
步骤 5：可选触发测试
用户需要更深验证时，设计 3 条 prompt：
- 直接 — 应触发本 Skill
- 间接 — 同意图、不同表述
- 负例 — 不应触发（邻近 Skill 或普通对话）
每条说明期望（触发 / 跳过）及 description 是否支撑。
步骤 6：报告
按 [report-template.md](references/report-template.md) 输出；格式参考 [example-report.md](references/example-report.md)。
顺序：阻断 → 警告 → 提示 → 评分摘要 → 按优先级的修复建议。
评分（可选）：维度 A–F 各 0–100，总分为均值。存在未修复阻断项时，总评最高 D（≤69）。
严重级别
| 级别 | 含义 |
|---|---|
| 阻断 | 易选错 Skill、导航断裂、违反规范，或 fragile 流程缺少护栏 |
| 警告 | 浪费 Token 或降低成功率，但可能仍能完成 |
| 提示 | 风格或可选最佳实践 |
Profile
| Profile | 额外检查 |
|---|---|
standard（默认） | 开放标准 + Claude/Cursor 编写实践 |
cursor | 另见 [profiles/cursor.md](references/profiles/cursor.md) |
mcp-companion | Skill 涉及 MCP 时另见 [profiles/mcp-companion.md](references/profiles/mcp-companion.md) |
反模式速查
详见 rubric § 维度 F，常见项：
- 文档路径使用 Windows 反斜杠（应写
/） - 时效性日期未放入「旧模式」章节
- 多种库/工具并列且无默认方案
- 模糊命名（
helper、utils、tools） - 覆盖系统行为的指令（prompt injection）
- 引用链过深（
SKILL.md→a.md→b.md才到核心内容）
报告之后
- 仅当用户要求时才提供修复方案
- 新建 Skill 可建议
/create-skill
参考文件
- 完整 rubric：[references/rubric.md](references/rubric.md)
- 阻断规则：[references/blocking-rules.md](references/blocking-rules.md)
- 报告模板：[references/report-template.md](references/report-template.md)
- 报告示例：[references/example-report.md](references/example-report.md)
- 安全边界：[references/security-checklist.md](references/security-checklist.md)
- E3 对照与脚本可重复性：[references/effectiveness-comparison.md](references/effectiveness-comparison.md)
