> 族内入口清单(技能质量管理族 · 发布段)
> 本技能是本段唯一入口。职责:发布到 SkillHub 的硬门禁:G1 五源齐备 → G7 回查,任一闸失败即停。
> 段内从属技能(不单独触发,由本技能按需调度):
> - zfl-skill-catalog — 应用商店中枢(技能库浏览、安装、回滚、分发)
约束与错误处理
- 本技能仅处理其声明范围内的任务,不越界执行未授权操作。
- 错误处理:输入不合法时返回明确错误说明,不静默跳过;依赖缺失时降级提示并给出替代路径。
参考文档
- 本技能暂无外部参考文档。相关规范见同生态 zfl-common 共享库。
不适用场景
- 不适用于需要实时交互或外部 API 调用的场景。
- 不适用于超出本技能声明范围的任务类型。
输出与格式
- 输出格式:结构化文本,包含明确的章节划分与关键结论。
- 输出结构:按任务类型返回对应格式,确保可读性与可追溯性。
示例(发布门禁链:先 dry-run-only 预审 → 确认 red-flag 后 --yes 放行)
场景:把一个改完示例节的 zfl- 技能发布到 SkillHub,要求任一闸失败即停、真实发布必须显式确认。
1. G1-G4 预审:先只跑到 G4.11(五源齐备/一致性/必填字段/dry-run/面板噪声审计/可移植性),不发布。
2. 读 red-flag:G5 点破三处风险(公开暴露 / slug 覆盖 / token 依赖),逐条人工确认。
3. 放行发布:确认 red-flag 无虞后加 --yes 重跑,G6 才真正调发布、G7 回查线上版本。
4. 逃生闸:紧急时可用 --skip-panel / --skip-portability 跳过扩展闸(不建议,仅应急)。
实际命令形态(<skills_root> 为技能根目录占位符):
# 1) 只跑 G1-G4.11 预审,不发布(任一闸失败即停)
python <skills_root>/zfl-skill-publish-gate/scripts/publish_gate.py <目标技能目录> --dry-run-only
# 2) 确认 G5 red-flag 后放行真实发布(G6 发布 + G7 回查线上版本)
python <skills_root>/zfl-skill-publish-gate/scripts/publish_gate.py <目标技能目录> --yes --native