# 回顾技能格式根据 Agentskills.io 开放标准验证 SKILL.md 文件。此技能检查 YAML frontmatter 完整性、所需部分是否存在、过程步骤格式（预期/失败块）、行数限制和注册表同步。在合并任何新的或修改的技能之前使用此功能。 ## 何时使用 * 已编写新技能，合并前需要进行格式验证 * 现有技能已被修改，需要重新验证 * 对某个领域的所有技能进行批量审核 * 验证由“create-skill”元技能创建的技能 * 在拉取请求中审查贡献者提交的技能 ## 输入 * **必需** ：SKILL.md 文件的路径（例如 `skills/setup-vault/SKILL.md`） * **可选** ：严格级别（`lenient` 或 `strict`，默认值：`strict`） * **可选** : 是否检查注册表同步（默认：是） ## 程序 ### 第 1 步：验证文件是否存在并读取内容确认 SKILL.md 文件存在于预期路径并读取其完整内容。 # 验证文件是否存在 test -f Skills/<技能名称>/SKILL.md && echo "EXISTS" ||回声“失踪” # 计算行数 wc -l <技能/<技能名称>/SKILL.md **预期：** 文件存在且内容可读。显示行数。 **失败时：** 如果文件不存在，请检查路径是否有拼写错误。使用“ls Skills//”验证技能目录是否存在。如果该目录丢失，则该技能尚未创建 - 首先使用“create-skill”。 ### 步骤 2：检查 YAML Frontmatter 字段解析 YAML frontmatter 块（在 `---` 分隔符之间）并验证所有必填和推荐字段是否存在。必填字段： * `name` — 匹配目录名称（kebab-case） * `description` — 少于 1024 个字符，以动词开头 * `许可证` — 通常是`MIT` * `allowed-tools` — 逗号分隔或空格分隔的工具列表推荐的元数据字段： * `metadata.author` — 作者姓名 * `metadata.version` — 语义版本字符串 * `metadata.domain` — `skills/_registry.yml` 中列出的域之一 * `metadata.complexity` — 以下之一：`basic`、`intermediate`、`advanced` * `metadata.language` — 主要语言或 `multi` * `metadata.tags` — 逗号分隔，3-6 个标签，包括域名 # 检查所需的 frontmatter 字段是否存在 head -30 技能/<技能名称>/SKILL.md | grep -q '^name:' && echo "name: OK" || echo“姓名：失踪” head -30 技能/<技能名称>/SKILL.md | grep -q '^描述：' && echo "描述：确定" || echo“描述：丢失” head -30 技能/<技能名称>/SKILL.md | grep -q '^许可证：' && echo "许可证：确定" || echo“许可证：丢失” head -30 技能/<技能名称>/SKILL.md | grep -q '^允许的工具：' && echo "允许的工具：确定" || echo“允许的工具：丢失” **预期：** 所有四个必填字段均存在。所有六个元数据字段都存在。 `name` 匹配目录名称。 “描述”少于 1024 个字符。 **失败时：** 将每个缺失字段报告为 BLOCKING。如果“name”与目录名称不匹配，则报告为 BLOCKING 并具有预期值。如果“描述”超过 1024 个字符，则报告为当前长度的“建议”。 ### 第 3 步：检查所需部分验证技能正文中是否存在所有六个必需部分（在 frontmatter 之后）。所需部分： 1. `## 何时使用` 2. `## 输入` 3.“## 程序”（带有“### 步骤 N：”小节） 4. `## Validation`（也可能显示为 `## Validation Checklist`） 5. `## 常见陷阱` 6.`##相关技能` # 检查每个必需的部分对于“## 何时使用”“## 输入”“## 过程”“## 常见陷阱”“## 相关技能”中的部分；做 grep -q "$section" Skills/<技能名称>/SKILL.md && echo "$section: OK" ||回显“$部分：丢失” 完成 # 验证部分可以使用任一标题 grep -qE "## 验证（检查表）？" Skills/<技能名称>/SKILL.md && echo "验证：OK" || echo“验证：缺失” **预期：** 所有六个部分都存在。程序部分至少包含一个“### 步骤”子标题。 **失败时：** 将每个丢失的部分报告为 BLOCKING。没有全部六个部分的技能不符合agentskills.io 标准。提供“create-skill”元技能中的部分模板。 ### 步骤 4：检查程序步骤格式验证每个过程步骤都遵循所需的模式：编号的步骤标题、上下文、代码块和 **预期：** /**失败时：** 块。对于每个“### Step N:”子部分，检查： 1. 该步骤有一个描述性标题（不仅仅是“步骤 N”） 2. 至少存在一个代码块或具体指令 3. 存在 `**Expected:**` 块 4. 存在“**On failure:**”块 **预期：** 每个过程步骤都有 **预期：** 和 **失败时：** 块。步骤包含具体的代码或说明，而不是模糊的描述。 **失败时：** 将每个缺少预期/失败的步骤报告为“阻塞”。如果步骤仅包含模糊说明（“适当配置系统”），请报告为“建议”，并添加注释以添加具体命令。 ### 步骤 5：验证行数检查 SKILL.md 是否在 500 行限制之内。行=$(wc -l <技能/<技能名称>/SKILL.md) [“$lines”-le 500] && echo“确定（$lines行）”|| echo“超出限制（$lines行> 500）” **预期：** 行数为 500 或更少。 **失败时：** 如果超过 500 行，则报告为 BLOCKING。建议使用“refactor-skill-struct”技能将超过 15 行的代码块提取到“references/EXAMPLES.md”。典型减少：通过提取扩展示例减少 20-40%。 ### 步骤 6：检查注册表同步验证该技能是否列在具有匹配元数据的正确域下的“skills/_registry.yml”中。检查： 1.技能“id”存在于正确的域部分下 2. `path` 匹配 `<技能名称>/SKILL.md` 3.“复杂性”与 frontmatter 匹配 4.存在“描述”（可以缩写） 5. 注册表顶部的“total_skills”计数与实际技能计数相符 # 检查技能是否在注册表中 grep -q“id：<技能名称>”技能/_registry.yml && echo“注册表：找到”|| echo“注册表：未找到” # 检查路径 grep -A1“id：<技能名称>”技能/_registry.yml | grep -q“路径：<技能名称>/SKILL.md”&& echo“路径：确定”|| echo“路径：不匹配” **预期：** 技能在注册表中的正确域下列出，并具有匹配的路径和元数据。总数准确。 **失败时：** 如果在注册表中找不到，则报告为“阻塞”。提供注册表项模板： - id：技能名称路径：技能名称/SKILL.md 复杂度：中等语言：多语言描述：一行描述 ## 验证 * SKILL.md 文件存在于预期路径中 * YAML frontmatter 解析没有错误 * 存在所有四个必需的 frontmatter 字段（`name`、`description`、`license`、`allowed-tools`） * 存在所有六个元数据字段（“作者”、“版本”、“域”、“复杂性”、“语言”、“标签”） * `name` 字段匹配目录名称 * `描述` 少于 1024 个字符 * 存在所有六个必需部分（何时使用、输入、过程、验证、常见陷阱、相关技能） * 每个过程步骤都有 **预期：** 和 **失败：** 块 * 行数为 500 或更少 * 技能在 `_registry.yml` 中列出，具有正确的域、路径和元数据 * 注册表中的“total_skills”计数是准确的 ## 常见陷阱 * **仅使用正则表达式检查 frontmatter** ：YAML 解析可能很微妙。 `description: >` 多行块看起来与 `description: "inline"` 不同。搜索字段时检查这两种模式。 * **缺少验证部分变体**：某些技能使用“## 验证检查表”而不是“## 验证”。两者都可以接受；检查任一标题。 * **忘记注册表总数** ：将技能添加到注册表后，顶部的“total_skills”数字也必须增加。这是 PR 中常见的失误。 * **名称与标题混淆**：`name` 字段必须是短横线大小写，与目录名称匹配。 “# Title”标题是人类可读的，并且可以有所不同（例如，名称：“review-skill-format”，标题：“# Review Skill Format”）。 * **宽松模式跳过拦截器**：即使在宽松模式下，仍应标记缺少必需的部分和 frontmatter 字段。宽松模式仅放宽样式和元数据推荐。 ## 相关技能 * `create-skill` — 规范格式规范；用作有效 SKILL.md 的权威参考 * `update-skill-content` — 格式验证通过后，使用它来提高内容质量 * `refactor-skill-struct` — 当技能未通过行数检查时，使用它来提取和重组 * `review-pull-request` — 在审查添加或修改技能的 PR 时，将 PR 审查与格式验证结合起来

复习技能格式

包含技能