Agent Skills
返回列表
技能包入库规范

技能包入库规范

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 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的开发者,需要在发布前完成入库自检