> 族内折叠指针(技能质量管理族 · 治理段)
> 本技能已归入 zfl-skill-governance(本段唯一入口)。日常使用请从主技能进入。
> 目录与脚本资产保留,供主技能及其他技能直接调用,请勿重复实现本技能已有能力。
约束与错误处理
- 本技能仅处理其声明范围内的任务,不越界执行未授权操作。
- 错误处理:输入不合法时返回明确错误说明,不静默跳过;依赖缺失时降级提示并给出替代路径。
参考文档
- 本技能暂无外部参考文档。相关规范见同生态 zfl-common 共享库。
输出与格式
- 输出格式:结构化文本,包含明确的章节划分与关键结论。
- 输出结构:按任务类型返回对应格式,确保可读性与可追溯性。
示例(存量技能大版本升级:能力点补全 → bump → 五源一致性 → 发布)
场景:某存量 zfl 技能要补全 ≥5 个能力点并跨技能同步依赖(creator/review/quality/syncer),走一次大版本升级。
1. 盘点差异:对照升级文档列出现有能力缺口(≥5 项),同步 package_dependencies 里依赖技能的版本。
2. 确定性 bump:用 skill_upgrade.py 升版本(或显式 --target-version),自动走五源一致性(frontmatter/metadata/VERSION/CHANGELOG/版本表)。
3. 质量门:跑 quality-checker 复扫到 P0=0,再过发布门禁。
4. 发布上线:publish_to_skillhub --native 上线,回查线上版本与本机一致。
实际命令形态(<skills_root> 为技能根目录占位符):
# 1) 对单个技能做确定性升级(不显式给版本则 +0.1 步进),并写升级报告
python <skills_root>/zfl-skill-upgrade/scripts/skill_upgrade.py --skill <目标技能目录> --report upgrade_report.md
# 2) 升级后过质量门(P0=0 才放行发布)
python <skills_root>/zfl-skill-quality-checker/scripts/quality_checker.py --skill-dir <目标技能目录> --fail-on P0