> 族内入口清单(技能质量管理族 · 治理段)
> 本技能是本段唯一入口。职责:跨技能治理编排:质量检查 → 面板清理 → 触发卫生 → 专家评审 → PDCA → 工厂。
> 段内从属技能(不单独触发,由本技能按需调度):
> - zfl-skill-upgrade — 存量技能大版本升级与跨技能依赖同步
> - zfl-skill-trace-iterate — 基于 SkillHub TRACE 五维评测的产品经理视角迭代 SOP
> - zfl-skill-edit-gate — 改前快照 + 改后回归、不降才接受的回滚硬门控
> - zfl-skill-self-test — 自验证三件套(samples + 冒烟 + 回归)
> - zfl-skill-lifecycle — 启用数治理(A 常驻 / B 按需 / C 冷存三层分类)
约束与错误处理
- 本技能是编排器:六阶段每一步都委托给对应专才技能(quality-checker / panel-cleanup / trigger-audit / expert-review / factory),任一阶段缺技能、被禁用或失败时自动跳过并在报告写明原因,不硬失败、不假装跑过。
- 默认只报告不改;整改动作必须显式加
--apply才落地,避免编排器越权改技能内容。 - 错误处理:
--skills-dir指向不存在目录时显式报错退出;基线对比缺--baseline-dir时降级为单次评分并标注「无基线可比」。
参考文档
references/implementation-details.md:六阶段管线编排、优雅降级与基线对比的实现细节references/dev-methodology.md:PDCA 治理方法论与阶段出入约定scripts/governance_pipeline.py:本编排器唯一入口(--governance-root / --skills-dir / --apply / --baseline-dir)
不适用场景
- 不适用于需要实时交互或外部 API 调用的场景。
- 不适用于超出本技能声明范围的任务类型。
输出与格式
- 输出格式:结构化文本,包含明确的章节划分与关键结论。
- 输出结构:按任务类型返回对应格式,确保可读性与可追溯性。
示例(六阶段治理管线全库回归闭环)
用户:「把整个技能库跑一遍治理,看看谁不及格」→ 本技能串起六阶段管线,任一阶段缺失/失败自动降级、绝不硬失败:
1. 质量检查:对全库或指定技能跑 7 维评分(委托 zfl-skill-quality-checker),汇总 P0/P1/P2 flags。
2. 面板噪声清理:委托 zfl-skill-panel-cleanup 收行、删冗余段(超出行数阈值才动)。
3. 触发词卫生:扫全库触发词冲突与瘦场景(trigger-scene-thin)。
4. 专家评审:可选调 zfl-expert-review 给长文/架构技能加人工维度。
5. PDCA 整改:对命中问题给整改建议;加 --apply 才真改,默认只报告不动手。
6. 复扫闭环:整改后重跑管线,对比基线(--save-baseline 存、--baseline-dir 比),确认 P1 下降、无新增 flag。
实际命令形态(<skills_root> 为技能根目录占位符):
# 1) 全库六阶段扫描,输出 Markdown 报告(任一阶段缺失自动降级)
python <skills_root>/zfl-skill-governance/scripts/governance_pipeline.py --governance-root <skills_root> --markdown "D:\reports\governance.md"
# 2) 只盯某个技能,整改后复扫并对比基线(P1 下降、达标才放行)
python <skills_root>/zfl-skill-governance/scripts/governance_pipeline.py --skills-dir "<skills_root>/zfl-skill-x" --baseline-dir "D:\reports\baseline" --target-score 90
# 3) 跑内置自检,证明优雅降级路径可用
python <skills_root>/zfl-skill-governance/scripts/governance_pipeline.py --self-test