Skill 全生命周期运营手册（skill-lifecycle-playbook v1.0）

> 把今天这一整轮的真实经验——审查、优化、开源调整、优化提升、上架 SkillHub——压成一个可复用的闭环。
> 它不是「怎么从零写 skill」（那是 skill-creator 的事），而是「skill 写完了，怎么把它打磨到能发布、再发布出去」。

价值与边界

价值：自建 skill 从审查、优化、开源调整到上架的全生命周期闭环运营手册，发布纪律与冲 A 路径一目了然。
局限：不替代 skill-methodology 的创作决策、不替代 skill-audit 的审计执行；平台规则冲突时以官方为准。

使用说明（输入 / 调用 / 纠错）

• 输入格式：运营问题，如「审计这个 skill」「skill 要上架」。
• 调用方式：五步闭环（审查→优化→开源调整→冲 A→上架）；与制造机/审计分工明确。
• 纠错兜底：流程是运营指导，具体平台规则以官方为准；冲突时以平台要求优先。

English Overview

This playbook covers the complete closed loop of self-built skills: review -> optimize -> open-source adaptation -> quality improvement -> publishing to SkillHub/ima. It includes mandatory instructions for game/interactive skills, dual-platform release preparation, and strict standards for novice-friendly skills. It manages the 'after it is built' operations loop, complementing the creation-side skill.

一、与 skill 制造机（技能工坊 · Skill 创作方法论）的衔接边界

这是本手册最关键的一条——别和制造机抢活，也别留空档。

> ⚠️ 制造机身份更正（2026-08-24）：真正的「制造机」是 技能工坊 · Skill 创作方法论（@user_946e03ef/skill-methodology，已于 2026-08-24 安装，v1.9.1），不是 skill-dev-playbook（后者是「开发协作强制手册」，管人机协作闸门）。本手册的「产出规格」以制造机为准；下方三项通用约束即制造机 v1.9.1 第 11 条「零外链与供应链安全」+ 开发协作协议「交互红线 / P1+P2 联推」的同源同步。

衔接铁律：本手册的「优化」阶段，输入标准直接复用制造机（skill-methodology）的产出规格（frontmatter 五字段 slug/displayName/version/summary/license、隐私脱敏、独立自包含）。也就是说——制造机定规格，skill-audit 验规格，本手册修规格 + 发规格。三者一线串起，不重复定义。

> 制造机产出规格扩展（2026-08-24 固化，待制造机装好后并入其文档）：制造机的产出规格除五字段/隐私/独立自包含外，新增三项通用硬约束，本手册优化阶段与 skill-audit 验收阶段同步对照：
> 1. 零外链：自建 HTML / 工具引用默认零外链（不引入外部库/CDN，除白名单放行）；
> 2. 供应链先审后装：装 skill/CLI/依赖先审计源码、拒 curl|bash、关自升级与 telemetry；
> 3. 可视化交付 + 交互红线：分析/复盘/对比/盘点类产出默认自包含零外链 HTML 图文表；交互遵守 A/B/C 快速拍板+推荐项、UI 中文标签、不强行展示思考过程。

> 版本对齐：本手册引用的 skill-audit 以你实际在用的版本为准（当前 v1.3.3 十维），随 skill-audit 升级同步更新引用，不写死旧口径。

二、全生命周期五步闭环

审查 ──▶ 优化 ──▶ 小白引导核查 ──▶ 开源调整 ──▶ 冲A循环 ──▶ 发布前闸门 ──▶ 上架 SkillHub
  │                                                              │              │
  └──────── 审核 pending / 用户反馈回来 ◀────── 闸门驳回/未满A ◀────┘              │
                         （迭代回到优化/小白核查/开源调整）                        │
                                                                                   │
                                   ⚠️ 游戏/互动/老少皆宜类：闸门前必须附《说明书》   │

> 发布纪律（硬闸门，2026-08-23 第七轮沉淀）：
> 1. 先开源化改造（Step 3）；
> 2. 再查「通俗易懂小白引导」是否齐备（Step 2.5）；
> 3. 审计评级，不到 A 就按意见调整优化、再审计，循环直到 A 为止；
> 4. A 级之后先请用户审查，用户确认没问题才允许发布（禁止自动跳过审查直接 publish）；
> 5. 若是老少皆宜 / 游戏 / 互动类，还必须在发布前写《说明书》说清玩法步骤、准备、边界——没有说明书不放行。
> 6. 审计达 A ≠ 可发布（发布闸门，2026-08-25 新增）：A 级只是质量「及格线」，不是发布许可。A 级后、请用户审查前，还须额外闯三道硬前置——①多轮迭代（同一 skill 数版打磨，非一次成型即发）②实测跑通（真实输入跑 1–2 个完整用例，输出可用/无报错/边界正确）③元数据打磨（displayName/summary/description 标题简介经推敲，第一眼说清「价值+边界」）。任一不达标回炉续改，绝不审计一过就发。三道硬前置详见「三·六」。

Step 1 · 审查（audit-gate）

调用 skill-audit 跑三问前置门 + 十维审计（六维 + 四查 G/H/I/J）+ frontmatter 五字段检查，产出 A/B/C/D 评级。
- 任一三问 No → 封顶 C；四查严重问题 → 直接 D。
- 详细判定见 references/audit-gate.md。

Step 2 · 优化（按审计意见修）

按 skill-audit 报告「必须修改 / 建议修改 / 可选修改」三档逐项修：
- 补 frontmatter 五字段（缺失即不通过，发布前置）；若目标平台是 ima SKILL 平台，还需补 name（与 slug 同值）+ description（平台自动生成「使用说明」的数据源）成七字段，缺则校验不通过——SkillHub 五字段即可，发布前先确认目标平台字段规格（2026-08-24 实战教训，与 skill-audit v1.3.2 / 制造机 v1.8.2 对齐）
- 打包合规（v1.5.0 新增，源自 2026-08-26 zsxq-topic-archive 上架 ima 失败复盘）：① 包内禁止夹带平台发布产物（SkillHub 发过的目录会残留 _meta.json，含 ownerId/publishedAt，上传 ima 被当冗余文件 → 删净再打包）；② 正文中文语境禁 ASCII 双引号 "（除代码块/命令行参数外，统一用中文引号「」）；③ 文件名纯 ASCII；④ frontmatter 可用 yaml.safe_load 解析
- 触发用语 ≤5 条（v1.6.0 调整，由 ≤3 放宽，小张 2026-08-26 明确要求）：铭牌「触发指令实例」清单 + description 触发短语一律 ≤5 条，选最高频典型说法（对齐 douban-archive v1.4.4 / netdisk-audit v1.1.0 已写的 5 条触发实例）
- 小白类用户向数据抓取/导出 skill 硬标准（v1.6.0 新增，源自小张 2026-08-26 明确要求，与开发手册 v1.3.0 同源）：凡做「用户向、小白类、帮用户抓取/导出软件平台个人数据」的 skill（豆瓣归档/知识星球导出/网盘盘点族），强制含四件套——①集中式「坑清单」节（真实踩坑单列，分页虚标/漏抓类/结构差异/需登录态/防风控频率/天量卡死）；②「小白用户指导（第一次用也能跑通）」节（三件事/零基础启动清单/最容易卡的点/自救话术/术语速查）；③出厂铭牌含「触发指令实例 ≤5 条 + 数据/经验来源」；④确认门/隐私脱敏/耐心红线/边界/CHANGELOG 五件套。范本：zsxq-topic-archive（SkillHub 已发）
- 清依赖：所有 references/ 必须本地化，不引用其他 skill
- 补隐私：命中 SOUL.md 2.2 敏感字段一律剔除
- 补 WHY：关键指令带「为什么」，不只有 MUST

Step 2.5 · 小白引导核查（发布前置，必过）

冲 A 之前先自查「新手能不能零门槛上手」：
- 是否有一份通俗易懂的小白引导（README 快速上手 / PLAYGUIDE / 0 基础示例），不让新手读不懂就放弃；
- 关键指令是否带「为什么」而不只有 MUST（呼应 Step 2 补 WHY）；
- 游戏 / 互动 / 老少皆宜类：必须显式写《说明书》——说清为什么好玩、自由度与边界、需什么准备/道具、人数场地、分步玩法。没有说明书 = 小白引导不合格，封顶 B、不放行发布。
- 详细核查项见 references/audit-gate.md 的「小白引导 / 说明书核查」。

Step 3 · 开源调整（opensource-adjust）

发布到 SkillHub 前必过：
- ⚠️ 删独立 LICENSE 文件（社区源报 400「不允许的文件类型: LICENSE」）
- 许可证走 frontmatter license: 字段（如 license: MIT）
- 许可全文（MIT 全文 + Copyright 行）并入 README「许可证」节
- 详细见 references/opensource-adjust.md。

Step 3.5 · 更名/重构专项（rename-rebuild，v1.4.0 新增）

改 displayName / slug / 定位重构时，走更名手术六件套，缺一即残留（源自 2026-08-25 图鉴/以人为镜/拆解器三技能同源解耦实战——一引擎三马甲 + 更名后旧 slug mindset-extractor 仍挂线）：
1. 定位解耦声明：先定义新定位的专属区间（对象 / 问题 / 输入 / 输出 / 触发词），族内互不相同而非互补；四问答不出区分的，说明不该分裂；
2. displayName / slug 更新：frontmatter 同步改，更名单独成版（对齐制造机 v1.10.0 第 12/15 条）；
3. 目录名对齐 slug：本地目录名与 slug 一致，避免 WorkBuddy 加载索引错乱（教训：mindset-extractor 目录装 baiye-tujian）；
4. 正文引擎重定向：按新定位改写正文主线与契约卡，禁止「声明变、正文不变」（名实不符，审计封顶 C）；
5. 触发词分流：族内一意图一命中，description 不适用边界注明归属（「XX类问题归XX技能」）；
6. 旧版本平台下线：旧 slug 若仍在线必须下架——CLI 无下架命令，走 SkillHub 平台网页操作；发布新版本前先检查同源残留（skill-audit v1.4.0 H4 会查）。

Step 4 · 冲 A 循环（audit-until-A）

• 调 skill-audit 拿评级；不到 A 就按报告「必须修改 / 建议修改」逐项调整优化，再审计，循环直至 A 级为止；
• 每轮调整同步升版本号（x.y.z 语义化；修 bug/小优化升 PATCH，加能力升 MINOR，破坏性改升 MAJOR）+ 写 CHANGELOG（日期 + 变更项 + 来源）；
• 严禁「评级没到 A 就发布」——A 级是发布的硬性前置条件；
• 详细见 references/version-iterate.md 与 references/audit-gate.md。

Step 4.5 · 发布前闸门（user-review gate，硬）

A 级之后、publish 之前，必须先请用户审查：
- 把审计报告结论 + 改动摘要 + 待发布版本一并交给用户，等用户明确「没问题」才执行 skillhub publish；
- 禁止以「已到 A 级」为由自动跳过用户审查直接发布；
- 游戏 / 互动 / 老少皆宜类：闸门额外校验《说明书》是否已写入 skill（玩法步骤 / 准备 / 边界齐全），缺说明书则闸门驳回、退回 Step 2.5 补写。

Step 5 · 上架 SkillHub / ima（publish-checklist）

• ⚠️ 仅当通过 Step 4.5 用户审查闸门后才可执行；
• SkillHub：预检 skillhub publish <目录或.zip> --dry-run → 正式 skillhub publish <目录或.zip> --changelog "本次变更" --json（联网需放开沙箱）→ 状态 pending（平台审核：内容/安全/人工），通过才进公开索引；用 skillhub install <slug> 验证。详细 + 400 避坑 + 改名重发闭环 + 409 幂等陷阱见 references/publish-checklist.md。
• ima：按 Step 2 打包合规四查（删 _meta.json 平台产物 / 文件名纯 ASCII / 正文中文引号 / yaml 可解析）+ frontmatter 七字段 + 内容三节 + 触发用语 ≤5 条后上传；失败排查顺序：① 七字段 → ② 包内文件清单 → ③ grep 引号（源自 2026-08-26 zsxq-topic-archive 实战，与 skill-audit v1.5.1 / 开发手册 v1.3.0 对齐）

三、发布前安全自检门（不通过不发布）

复用 skill-dev-playbook 的 G0–G9 清单：能力声明一致、供应链先审后装、无危险命令、无未授权外传、不碰敏感路径、无注入句式、拒 curl|bash、无混淆、无后门、逐文件扫描。任一命中 = 禁止发布。

> 零外链 + 供应链强化（2026-08-24）：安全自检除 G0–G9 外，额外固化两条贯穿全程的通用约束——①自建 HTML/工具零外链（不引外部库/CDN，除白名单）；②供应链先审后装（装 skill/CLI/依赖先审计源码、拒 curl|bash/irm|iex、关自升级与 telemetry 上报）。这两条不是发布环节才查，而是 skill 从开发到发布的全程硬约束。

三·五、迭代节奏：P1+P2 一站式联推（2026-08-24 固化）

小张的迭代偏好——倾向 P1（核心）+ P2（增强）一次性联推，避免分阶段确认拖慢节奏；多方案（A/B/C/D 或上中下三策）快速拍板并主动指定推荐项。落进本手册发布闭环：

• 能联推的改动不分两轮：例如「补五字段 + 同步写记忆 + 更新三个 skill」这类关联改动，一站式执行，不拆成「先确认再做」来回；
• 对外/破坏性动作仍先确认：发布（publish）、提交、删/覆盖/批量改 等对外或破坏性操作，必须先经 Step 4.5 用户审查闸门确认，与本偏好不冲突；
• 开发内部走原子步：Step 1–Step 4 的执行内部仍遵循「拆小步走一步验一步」，只是对外确认点合并到关键闸门，不每个子动作都打断用户。

三·六、发布闸门 + 迭代三板斧（2026-08-25 固化，与制造机 v1.9.1 对齐）

源自小张 2026-08-25 明确要求：光审计不发布，要多迭代几次、测试跑通、打磨简介标题之后才能发布。本手册的「发布前闸门（Step 4.5）」管「用户审查」，本节补「质量达标 ≠ 发布时机达标」——二者是前后两道关，缺一不可。

发布闸门：审计通过 ≠ 可发布

skill-audit 审计达 A 只是质量「及格线」，不是发布许可。即便 A 级 + 用户审查通过，发布前还须额外闯三道硬前置，任一不达标回炉续改，绝不审计一过就发：
- ① 多轮迭代：同一 skill 至少数版打磨（每版只加 1 个聚焦能力点，按「迭代三板斧·单点迭代」），非一次成型即发；
- ② 实测跑通：用真实输入跑 1–2 个完整用例，输出可用、无报错、边界正确（红线命中按 Phase 0 拒绝、降级路径生效）；
- ③ 元数据打磨：displayName / summary / description 标题简介经推敲，第一眼说清「价值 + 边界」，不凑合。

迭代三板斧（修/发每个 skill 默认套用，对齐制造机 v1.9.0 第 12/13 条）

• 单点迭代铁律：每版只加 1 个聚焦能力点（不一次性大改）；版本号严格递增（语义化 v主.次.修，不跳号）；CHANGELOG 每条 ≤20 字且可追溯到源；更名单独成版。
• 验收清单前置：发布/交付前必过验收清单（本手册 references/audit-gate.md 的「冲 A 级必备补齐项清单」，对齐制造机 references/acceptance-checklist.md 16 项），逐项打勾，不过不交/不发布。
• 证据分层：任何涉及外部资料/信源/他人内容的分析类 skill，出厂前必走证据金字塔 L1 本人发声 > L2 本人整理 > L3 旁人记述（仅旁证），主要结论以 L1 为准、L3 必标注，资料有多少分析多少、不编造不硬挖。

> 与制造机关系：制造机定「造 skill 的规格 + 三板斧 + 发布闸门」，本手册负责「把造好的 skill 按这把尺子审、改、发」。三板斧与发布闸门两把尺子，造（制造机）和发（本手册）共用一套，不各说各话。

四、使用示例

用户：把这个 skill 准备发布到 skillhub
技能执行：
1. Step1 调 skill-audit 审计 → 拿评级（假设 B，有小瑕疵）
2. Step2 按报告修 frontmatter + 补 WHY
3. Step2.5 小白引导核查 → 补 README 快速上手（游戏/互动类另写《说明书》）
4. Step3 删 LICENSE 文件、确认 license 字段、README 内嵌许可
5. Step4 冲A循环：再审计→仍非A则按意见修→再审计，直到 A 级
6. Step4.5 发布前闸门：把审计结论+改动摘要+待发版本交用户审查，等用户确认"没问题"
7. Step5 --dry-run 预检 → 正式 publish → 等 pending

> ⚠️ 游戏 / 互动 / 老少皆宜类在 Step 2.5 就必须写《说明书》，Step 4.5 闸门会二次校验；缺说明书不进 Step 5。

五、参考文献

• references/audit-gate.md —— skill-audit 十维审计 + 三问前置门 + 冲 A 级必备补齐项清单
• references/opensource-adjust.md —— 开源合规调整（LICENSE/license 字段/README 内嵌）
• references/publish-checklist.md —— SkillHub 上架命令 + 400 避坑 + pending 审核 + 改名重发闭环 + 409 幂等陷阱
• references/version-iterate.md —— 版本号与 CHANGELOG 优化提升规范

出厂铭牌

• 作者：海边小张（小张自用 + 社区共享）
• 版本：v1.6.0（2026-08-26）
• 简介：自建 skill 审查→优化→小白引导核查→开源调整→更名/重构专项→冲A循环→用户审查闸门→上架 SkillHub/ima 的全生命周期闭环，含发布闸门（审计通过≠可发布）+ 迭代三板斧（单点迭代/验收清单/证据分层）+ 更名手术六件套（定位解耦/slug目录/正文重定向/触发词分流/旧版下线）+ 双平台发布准备（ima 七字段/打包四查/触发用语≤5）+ 小白类硬标准（坑清单/小白指导/铭牌触发≤5/五件套）、游戏/互动/老少皆宜类强制《说明书》规则、零外链+供应链安全全程约束、可视化HTML交付铁律、P1+P2联推节奏，与 制造机（skill-methodology）/ skill-audit 无缝衔接。
• 数据/经验来源：2026-08-23 三轮真实发布实战（首轮 little-inventor 更名发布 + 审计达 A；次轮沉淀改名/409/冲A 经验；三轮补发布纪律）；2026-08-24 固化 skill 开发通用要求（零外链/供应链/可视化HTML/交互红线/P1+P2联推）；2026-08-26 zsxq-topic-archive 上架 ima 失败复盘（打包四查 + 触发用语≤5）+ 小白类硬标准（对齐 douban-archive / netdisk-audit 实战）。
• 触发实例：「审计 skill」「优化 skill」「skill 上架」。

隐私与安全底线（统一增补 2026-09-03）

敏感个人信息七类，从严处理：生物识别、宗教信仰、特定身份、医疗健康、金融账户、行踪轨迹，以及不满十四周岁未成年人的个人信息——不主动采集、不追问、不记录、不输出、不外传；用户无意说出即跳过并轻提醒；结果输出前二次过滤。

危地不往，乱地不去（安全边界）：识别到用户拟进入高风险或混乱环境（线下见陌生网友、野游野泳或未开发区域、承诺高息回报与荐股、培训贷与押金陷阱、秩序混乱的拥挤现场等），在正常回答之外追加一句轻量避险提醒——不评判、不说教，给出「不去 / 不碰 / 不贷 / 不信」的边界选项，最终决定权在用户。

数据本地优先：个人数据整理默认只落本地文件；联网请求只带关键词、不携带个人数据；用户可随时要求删除已记录内容。

作者与联系

用着顺手，或者想聊聊养娃、写作与 AI 实战，欢迎来公众号找我——一个一边倒班一边折腾 AI 的一线工程师父亲。

更新日志

• v1.13.3（2026-09-25）｜按平台安全规范收敛联系信息章节。

• v1.6.0（2026-08-26）｜①触发用语由 ≤3 放宽为 ≤5 条（对齐 douban-archive v1.4.4 / netdisk-audit v1.1.0 已写 5 条触发实例）；②Step 2 新增「小白类用户向数据抓取/导出 skill 硬标准」四件套（坑清单/小白指导/铭牌触发≤5/五件套）；③Step 5 ima 侧引用版本对齐 skill-audit v1.5.1 + 开发手册 v1.3.0。源自小张 2026-08-26 明确要求。同步制造机 v1.12.0 + 审计 v1.5.1 + 开发手册 v1.3.0。

• v1.5.0（2026-08-26）｜①Step 2 优化补「打包合规四查」——平台产物零残留（删 _meta.json）/ 正文中文语境禁 ASCII 双引号 / 文件名纯 ASCII / yaml 可解析；②Step 2 补「触发用语 ≤3 条」（铭牌触发实例 + description 触发短语）；③Step 5 扩展为「上架 SkillHub / ima」双平台——ima 侧按打包四查 + 七字段 + 内容三节执行，失败排查顺序（七字段→文件清单→引号）；④出厂铭牌触发实例收敛 3 条。源自 2026-08-26 zsxq-topic-archive 上架 ima 失败实战 + 小张明确要求。同步制造机 v1.11.0 + skill-audit v1.5.0 + 开发手册 v1.2.0。
• v1.4.0（2026-08-25）｜新增「Step 3.5 更名/重构专项」——更名手术六件套（定位解耦/slug与目录对齐/正文重定向/触发词分流/旧版平台下线），源自 2026-08-25 图鉴/以人为镜/拆解器同源解耦 + 更名残留实战。同步制造机 v1.10.0 第 15 条 + skill-audit v1.4.0 技能族专项。
• v1.3.2（2026-08-25）｜新增「发布闸门：审计通过≠可发布」+「迭代三板斧」：A 级只是及格线，发布前须多轮迭代+实测跑通+元数据打磨三道硬前置；修/发每个 skill 默认套用单点迭代/验收清单前置/证据分层。与制造机 v1.9.1 对齐。源自小张 2026-08-25 要求。
• v1.3.1（2026-08-24）｜Step 2 优化补充 ima 七字段：目标平台为 ima SKILL 平台时，frontmatter 除五字段外须补 name（与 slug 同值）+ description（自动生成「使用说明」的数据源），缺则校验不通过；SkillHub 五字段即可，发布前先确认目标平台规格。源自台风/反诈/选型参谋三技能上架 ima 反复报错实战教训（与 skill-audit v1.3.2 / 制造机 v1.8.2 对齐）。
• v1.3.0（2026-08-24）｜固化 skill 开发通用要求，与 SOUL.md 2.1.1/2.2/2.5/2.6 对齐：①衔接边界更正「制造机」身份为 技能工坊·Skill创作方法论（@user_946e03ef/skill-methodology，当前未安装，装好后以它为准），并补「制造机产出规格扩展」——零外链、供应链先审后装、可视化HTML交付+交互红线三项通用约束，优化/验收阶段同步对照；②安全自检门补零外链+供应链两条全程硬约束；③新增「三·五 迭代节奏 P1+P2 一站式联推」——关联改动联推不分两轮，但对外/破坏性动作仍走 Step 4.5 用户审查闸门。源自小张 2026-08-24 明确要求固化（含修正制造机误认）。
• v1.2.0（2026-08-23）｜发布纪律硬闸门：①五步闭环扩为「审查→优化→小白引导核查→开源调整→冲A循环→发布前闸门→上架」；②新增 Step 2.5 小白引导核查（游戏/互动/老少皆宜类必须写《说明书》说清玩法/准备/边界，否则封顶 B、不放行）；③Step 4 明确为「冲A循环」——不到 A 不发布，按意见调优再审计直至 A；④新增 Step 4.5 发布前闸门——A 级后必须先请用户审查、确认没问题才 publish，禁止自动跳过；⑤游戏/互动类闸门二次校验《说明书》。源自 2026-08-23 第七轮用户明确要求沉淀。
• v1.1.1（2026-08-23）｜补坑：publish-checklist.md 的 400 清单新增「zip 文件名必须严格为 <slug>.zip」（带 -publish 等后缀会被 400「不允许的文件类型」）。源自 2026-08-23 真实发布踩坑。
• v1.1.0（2026-08-23）｜经验补全：①publish-checklist.md 新增「改名重发闭环」（版权角色名→全仓库扫描替换+删版权声明行+旧slug网页端撤回）与「409 幂等陷阱」（同slug+version重发报VERSION_EXISTS是已存在证据）；②audit-gate.md 新增「冲 A 级必备补齐项清单」（五字段/铭牌/日志/受众三档/边界声明/库内边界/有WHY/无爹味八样齐）；③SKILL.md 触发实例补「改名重发」。源自 2026-08-23 真实发布轮次第二轮沉淀。
• v1.0.0（2026-08-23）｜初始发布：五步闭环（审查/优化/开源调整/优化提升/上架）+ 与 skill-creator 衔接边界 + G0–G9 安全自检门 + 4 个 references。源自 2026-08-23 真实发布轮次经验沉淀。