|
# 技能元数据规范核验工作流
## 套餐描述
核对技能 metadata 字段形状与规范基线,生成不自动发布的人工复核材料。
## 详细介绍
# 技能元数据规范核验工作流
**3个实用技能 · 3步完成 · 每一步都能单独使用**
把技能 frontmatter 中的 metadata 变成可复核的规范材料:先整理字段形状,再对照记录的规范基线和严格字符串映射规则,最后生成不自动发布的人工复核包。套餐不联网、不读取仓库、不修改技能、不连接发布系统。
3个可下载技能 · 每个技能可单独运行
## 3步自动化工作流
### 🔵 1 技能元数据形状整理
技能文件:`skill-metadata-shape-normalizer`
**解决什么:** 不同工具对 frontmatter metadata 的类型理解可能不同,对象、数组、数字或布尔值容易被严格解析器拒绝。
**你会得到:** READY/REVIEW、每个字段的实际类型、严格字符串键值映射兼容性、问题列表和 `metadata_shape_hash`。
**↓ 本步结果自动进入下一步**
### 🟢 2 技能规范基线审计
技能文件:`skill-spec-baseline-auditor`
**解决什么:** 规范说明、校验器规则和本地基线可能不同步,升级后容易继续使用旧的 metadata 约束或缺少复核日期。
**你会得到:** READY/BLOCKED、基线 ID、字段数量、严格解析器不兼容项、建议的校验动作和 `spec_audit_hash`。
**↓ 本步结果自动进入下一步**
### 🟠 3 技能元数据发布门禁
技能文件:`skill-metadata-release-gate`
**解决什么:** 离线核验结果不应直接等于发布或覆盖,负责人还需要看到核验范围、问题和责任归属。
**你会得到:** READY_FOR_HUMAN_REVIEW/HOLD_FOR_HUMAN_REVIEW、`human_decision=PENDING`、`metadata_release=PENDING`、`publish=false`、`release=false` 和 `metadata_release_hash`;这是最终交付。
## 实际示例
脱敏样例包含 display_name、owner_ref 和 reviewed_at 三个字符串字段,以及一份标有基线 ID、发布时间、复核日期和“字符串键值映射”规则的本地策略。第一步固定字段类型和兼容性;第二步检查基线字段、规则和问题;第三步生成等待负责人决定的复核包。若把字段改成数组或对象,第一步会产生 REVIEW,后续门禁会保持 HOLD。样例只验证分支,不代表任何真实规范认证或平台发布成功。
## 适合谁
- 维护 Agent Skills、插件或工具目录的工程师
- 需要跨解析器检查 frontmatter metadata 的团队
- 在规范升级后维护校验器、基线和发布流程的质量人员
- 需要在真实发布前保留人工复核证据的运营与安全人员
## 买家只需提供
- 已授权且脱敏的技能 metadata JSON
- 当前采用的规范基线 ID、发布时间和复核日期
- 团队实际执行的 metadata 类型规则
- 复核负责人引用和发布边界
## 使用方式
1. 使用 Python 3.10 或更高版本,将 metadata、规范基线和复核责任写成 UTF-8 JSON。
2. 依次运行形状整理、规范基线审计和发布门禁,也可以单独运行任一步。
3. 由有权限的负责人在自己的仓库或目录系统中完成规范确认、规则更新和发布;本套餐只提供离线核验材料。
## 交付与验收
- 三个独立技能目录,每个包含元数据、技能说明、执行器、文档和脱敏样例。
- 三步可重复运行:字段形状整理、基线规则审计、人工发布门禁;每个技能也能单独使用。
- metadata 非对象、字段为对象/数组/数字/布尔、缺基线字段、规则不匹配或缺少复核负责人都会产生明确分支。
- 通过样例输出 READY_FOR_HUMAN_REVIEW,并保留 PENDING、publish=false 和 release=false;错误样例输出 REVIEW/BLOCKED,不触碰真实目录或平台。
## 服务说明
脚本只处理买家有权使用且已经脱敏的本地 JSON,不连接网络、仓库、Agent、MCP、数据库或业务系统,不读取 token、不签名、不发布、不修改规范、不覆盖文件。离线字段核验不能证明某个平台当前实现、解析器版本或规范认证结论,也不能代替官方文档确认、集成测试和人工审批。套餐不承诺跨工具导入成功、发布成功、兼容率或业务结果。
## 套餐图标
<img id="aimg_qgy8L" onclick="zoom(this, this.src, 0, 0, 0)" class="zoom" src="https://www.xianshe.com/data/attachment/hl_skillhub/images/bundle_icon_1_1787353205.png" onmouseover="img_onmouseoverfunc(this)" lazyloadthumb="1" border="0" alt="" />
## 包含技能
- [skill-metadata-release-gate
](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=skill-metadata-release-gate)
- [skill-metadata-shape-normalizer
](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=skill-metadata-shape-normalizer)
- [skill-spec-baseline-auditor
](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=detail&slug=skill-spec-baseline-auditor)
## 安装方式
此套餐为**付费套餐**,购买后可一键下载全部技能。
🛒 [点击购买并下载 技能元数据规范核验工作流](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=buy&bundle_id=498)
## 收费方式
💴 **现金购买** - 需要支付 ¥183.00
## 前往安装
**[👉 点击前往套餐安装页面](https://www.xianshe.com/plugin.php?id=hl_skillhub&mod=bundle&ac=detail&slug=skill-metadata-shape-normalizer-b22af868a6d7)**
|