skill-pipeline — 技能标准化流水线编排器
> 目标：给一个技能目录（如 books/mc-35-tools/），一次调用完成从零散技能到企业级标准化、可发布、有文档的整包交付。
> 本 skill 自身不重造轮子：机械步骤调自带脚本，诊断/拆解/审计/交接步骤加载对应子技能。
When to Use
> 命中任一即激活本 skill：
> - 用户有一批技能（拆书蒸馏 / 自建 / 市场下载）需要统一补企业级质量门禁
> - 用户说「把这些技能标准化 / 打包 / 跑流水线 / 一次搞定」
> - 用户想把多个单技能治理步骤（优化、依赖、触发词、发布、拆解、审计、handoff）合并执行
>
> 不激活：只改单个技能的小修 → 直接用对应子技能（如 ai-transformation-consultant）；与技能无关的任务 → 不使用。
速查表：用户意图 → 处理动作 (Decision Table) ★
| 用户意图 | 处理动作 | 路由 |
|---|---|---|
| 「把这批技能标准化 / 跑流水线」 | 启动本 skill 全流程 | → skill-pipeline |
| 只优化单个技能质量 | 加载 ai-transformation-consultant | → ai-transformation-consultant |
| 只拆解评审单个技能 | 加载 analyze-skill | → analyze-skill |
| 只做发布前安全审计 | 加载 skill-security | → skill-security |
| 只产出交接文档 | 加载 handoff | → handoff |
执行流程（7 阶段，按顺序）
> 约定：TARGET = 用户给出的技能目录（含 N 个 */SKILL.md）。每个阶段结束打印进度。
阶段 0 · 准备
- 确认
TARGET存在且含*/SKILL.md。 - 列出工具清单（
ls TARGET/*/SKILL.md），告知用户数量。 - 备份统一由
scripts/standardize.py负责：对每个SKILL.md若不存在*.backup-<YYYYMMDD>则复制一份（幂等、防回滚），无需 agent 手动备份。 - 日期戳（备份后缀 / 版本戳）由
standardize.py动态取datetime.now()，无需手动记录。
阶段 1 · 质量门禁机械补齐（脚本 scripts/standardize.py）
python scripts/standardize.py "<TARGET>"
- 机械补齐（幂等）：
version: 1.0.0/agent_created: true/type: task/description_en/## When to Use/## 速查表(决策路由) /### ⚠️ 铁律/## 输入案例(脚手架) /trigger_words_en。 - 修复 frontmatter 中
source_book被吸入description块标量的 YAML bug。 test-prompts.json版本对齐1.0.0（若存在）。- 软内容脚手架：
description_en/ 输入案例 先填 best-effort 模板（含[待agent润色]标记），阶段 5 由 agent 基于各技能方法论改写为实质内容。
阶段 2 · 前置依赖梳理（脚本 scripts/reorg_deps.py）
python scripts/reorg_deps.py "<TARGET>"
- 校验
related_skills的 depends-on/contrasts-with/composes-with 目标全部存在（打印断链清单，0 容忍）。 - 计算 Tier 分层（无前置=T0，递归深度=Tier）。
- 双向打通：消费者补
### ⛓ 前置依赖（启动前确认/引导前置、复用产物、禁止臆造）；提供者补used-by:+### ➡ 下游链路（完成后接下游）。
阶段 3 · 英文触发词 + 打包（脚本 scripts/package.py）
python scripts/package.py "<TARGET>"
- 复用官方
package_skill.py（含 quick_validate）打包为TARGET/dist/*.zip。 - Windows GBK 坑：调用方设
sys.stdout.reconfigure(utf-8)并注入 utf-8 安全版validate_skill；打包前用 staging 目录法（只拷 SKILL.md + test-prompts.json）避免备份污染 zip。
阶段 4 · A2 / 联用关系 authored（agent 手写，不可脚本硬套）
- 扫描所有
SKILL.md的 A2 节「与相邻 skill 区别」：若含占位话（聚焦于本工具视角、从相邻视角切入、或指向其他工具），逐一读取该技能与其对比对象的 I/A 节，改写为实质方法论差异（各看什么、层级关系、先后）。 - 对
composes-with非空的技能，确保有### 🔗 联用提示段，逐对写「各自贡献 + 衔接动作」。 - 改完重跑
scripts/package.py同步 zip。 - 此阶段是质量关键，必须逐工具 authored，禁止批量套模板。
阶段 5 · COSTA 诊断 + 单技能拆解（加载子技能）
- 选 1–3 个代表工具，加载
ai-transformation-consultant做 COSTA 五维诊断；加载analyze-skill产出四部分拆解报告（功能摘要/场景/流程图/评分）。 - 若用户要求全量拆解则遍历，但通常抽样即可。
阶段 6 · 安全审计（加载 skill-security）
- 发布前加载
skill-security对dist/*.zip做安全审计（P0/P1/P2）。 - 有 P0 必须警告并获确认；P1 警告确认；P2 直接过。
阶段 7 · 交接文档（加载 handoff）
- 加载
handoff生成交接文档，覆盖：当前状态（各阶段结果）、Next steps、产物路径清单、建议子技能。
⚠️ 铁律（本工具硬约束）
> ⚠️ 不得伪精确：A2/联用/输入案例的软内容必须基于技能真实方法论 authored，禁止编造工具关系或虚假数据；缺失信息时以 〔假设〕 标记并请用户确认。
> ⚠️ 脚本幂等：所有自带脚本可重复运行，已补齐项跳过、不破坏既有 authored 内容。
> ⚠️ 备份优先：阶段 0 未备份不得改写；每文件保留 *.backup-<YYYYMMDD> 可单文件回滚。
输入案例 (Input Case) ★
输入示例
> 我有一批从《管理咨询35种经典工具》拆出的 35 个技能在 books/mc-35-tools/，质量参差，帮我一次性标准化到可发布。
输出示例
> - TARGET/ 下 35 个 SKILL.md 全部满足 16 项质量门禁（机械项脚本补齐、关系项 authored 落地）
> - TARGET/dist/ 35 个干净 zip（OK=35/bad=0）
> - TARGET/ 下若干报告 md（批量补齐报告 / 依赖梳理报告 / A2 改写报告 / 联用改写报告）
> - 抽样 2–3 份 analyze-skill 四部分拆解报告
> - TARGET/handoff-<时间戳>.md 交接文档
相关 skills
- depends-on：
ai-transformation-consultant（COSTA 诊断/质量门禁方法论来源） - composes-with：
analyze-skill（单技能拆解）、skill-security（发布审计）、handoff（交接文档）
