技能包入库规范
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b2bebbe2/skill-package-standard
技能介绍
问题出在哪
在 Skills Registry 的链路验证里,最常见的失败不是实现能力不足,而是施工输入还没对齐就开始编码。比如你想验证一个技能包能否被 Loader 正确读取,却没说清楚验证范围是 upload 还是 publish;包里要不要带 reference/implementation-spec.md、要不要包含 jq-config-template.json,这些决策猜错一次,后面的返工成本远高于前期确认。
这个技能怎么工作
skill-package-standard 把流程拆成两道门禁,核心是先问清楚再动手。
首轮输出强制:第一次回复时,模型不能直接写代码,而是按 Tier A/B/C 三层输出「建议施工输入」。
- Tier A(自动采纳):默认 zip 格式、默认包含
reference/implementation-spec.md,流程清晰时直接推断,无需确认。 - Tier B(建议确认):
testScope(upload/parse/publish/loader/full)、expectedFrontMatter字段等,模型给建议值,用户说「可以」或修正即过。 - Tier C(必问停码):猜错代价大且无法合理推断的项,没有明确答案就禁止编码,每轮只输出缺项。
停码条件很明确:Tier C 任一项未决;或 Tier B 已给出建议但用户明确反对且没给替代方案。满足停码条件时,门禁不通过,模型不能 read implementation-spec.md。
门禁通过后,模型读取 reference/implementation-spec.md,按 §2–§5 落地,并使用固定输出模板(验证范围判定、包结构检查清单、验证步骤、预期结果、自检结果)。
适用边界
- 只针对 Skills Registry 包结构验证场景,命中触发词(
技能包规范、包结构检查、入库自检)才执行。 - 不适用:生产环境业务 Skill 编写 → 参考
doc/output/ai-platform-skills-design.md;VA 分布式事务编排 →lowcode-va-trans。 - 维护原则:本技能只维护「触发 + 门禁 + 实施骨架 + 输出模板」,实现细节全部在
implementation-spec.md,避免两处规则冲突。
使用场景
- 想要验证上传的技能包能否被Skills Registry的Loader正确读取时,需要确认testScope是loader还是upload
- 需要检查技能包是否包含reference/implementation-spec.md等附加文件时,要按Tier A规则确认包结构默认项
- 需要确认技能包的name、description等字段与包内一致时,要按Tier B规则确认expectedFrontMatter的取值
- 遇到Tier C未决的施工输入时,需要停止编码并等待明确答案的场景
适合人员
- 维护Skills Registry的后端工程师,需要确保上传的技能包结构符合入库标准
- 编写技能包的开发者,需要在上传前自查包结构与字段是否符合规范
- 负责技能包审核的团队成员,需要快速确认技能包的验证范围与必填项是否明确
- 想要将技能包发布到Skills Registry的开发者,需要在发布前完成入库自检