开发协作与 Skill 全生命周期手册（含质量审计 · 三合一）
> v3.0.0 合并升级说明（2026-08-27）：本手册已整体合并「Skill 全生命周期运营手册（skill-lifecycle-playbook v1.9.0）」与「Skill 质量审计（skill-audit v2.0.0）」，三合一为唯一权威载体：
> - 能力增多：合并前本手册只负责「协作闸门 + 生命周期流程」，审计需要跳去 skill-audit；合并后内置完整十维审计能力（出厂铭牌 / 更新日志 / 隐私脱敏 / 内容质量 / 用户友好 / 依赖独立 + ima 上架校验 + 对外发布去敏感检查），直接说「审计这个 skill」即可在本手册内完成 A/B/C/D 评级与修改建议，无需切换技能；
> - 边界变化：原「skill 质量审计执行那是 skill-audit 的职责」的边界已取消，审计能力并入本手册；skill-methodology（制造机）仍负责「要不要建、怎么设计」，边界不变；
> - 触发不变：原两个技能的触发词全部并入（「审计 skill」「检查 skill 合规性」「skill 上架」等）；
> - 历史零丢失：原 lifecycle 与 audit 完整内容归档于 references/merged-skill-lifecycle-playbook.md 与 references/merged-skill-audit.md（含 audit 全部检查清单），能力零丢失。
> v2.0.0 合并说明（2026-08-26）：本文件由 skill-dev-playbook v1.3.0（开发协作强制手册）与 skill-lifecycle-playbook v1.5.0（Skill 全生命周期运营手册）合并而成，是两块职能的唯一权威载体。原 lifecycle 已归档移除，其 references 整体并入本目录 references/。自此不再双文件维护，杜绝口径冲突（如触发用语 ≤3 与 ≤5 打架）。
价值与边界
价值：把「与 AI 协作做开发」「skill 全生命周期运营」「skill 质量审计」的强制纪律、话术模板、发布规范收在一处，开发前有闸门、发布前有清单、上架前有审计，避免拍脑袋开工和带病上架。
局限：不替代 skill-methodology 的创作决策；具体平台规则以官方为准。
一、强制闸门（Hard Gate）
与小张一起做软件 / 网页 / SKILL / 任何工具类开发时，始终运行此环，且不在子阶段之间自动跳步：
> 需求 → 计划（附证据）→ 逐项确认 → 执行 → 汇报 → 验收
- 每完成一个子阶段，先停下汇报，等小张明确说「继续」再走下一步。
- 严禁一口气把多个子阶段连做；严禁未验收就自动推进。
- 对外动作（发布、提交、发邮件）与破坏性操作（删除、覆盖、批量改）执行前先确认。
二、六条高频 Prompt 速查模板
与小张协作时，主动按场景套用以下原话：
- 需求收束 / Scope lock（防瞎干）：
先帮我整理需求，有疑问先问我，等我确认后再执行。 - 拆真源文档 / Split real source docs：
把当前阶段拆成实施文档，写清做什么、不做什么，怎么验收。 - 开工框定 / Phase fencing（防漂移）：
只做当前子阶段，做完先汇报，严禁自动跳到下一步。 - 阶段验收三问 / Phase acceptance 3-questions：
做完了什么？改了什么？怎么验证？下一步是什么？ - 守底线检查 / Baseline guard：
这次改动会不会影响架构、表结构、权限等底层基盘？ - 大白话追问 / Plain-language check：
请用大白话解释：做了什么、还差什么、结果是什么意思。
三、五条实操心法
- 🚩 需求讲清楚：模糊需求最容易翻车，不要让 AI 猜。
- 先沟通，后动手：先确认规划，再进入执行。
- 🚩 拆小步，走一步验一步：一次只做一小段，做完再继续。
- 看不懂就问：所有技术词汇都可以要求 AI 用大白话解释。
- 流程写下来：文档化流程是 Agent 最好的执行说明书。
四、人机协作交互红线
与小张协作开发任何 skill / 网页 / 工具时，默认遵守其交互偏好（与 SOUL.md 2.1.1 并列）：
- 多方案 A/B/C 快速拍板 + 指定推荐项：给选项默认列 A/B/C 三选一，主动标出推荐项，不绕圈、不堆开放式问题。
- 中文回复 + 结构化表格 + 明确风险/审计结论：分析/规划/复盘类产出用中文、用表格，给出明确风险判断或审计结论（A/B/C/D 或红黄绿）。
- UI 标签中文显示：即便界面是 English，主题 / 栏目 / 频道 / 按钮等 UI 标签也保持中文。
- 不展示思考过程：除非小张主动问「你怎么想的 / 为什么」，否则直接交付成品，少铺垫、少自报步骤。
五、产出物可视化铁律
凡产出「分析报告 / 规划 / 复盘 / 对比 / 盘点」类内容，默认做成自包含 HTML 文件交付（内联 CSS/JS，零外链），双击即可在浏览器阅读：
- 图文表并茂：每个分析结论配套视觉载体——图表（趋势/对比/占比）、表格（结构化清单/指标卡）、图示（流程/结构/优先级矩阵）；能用图说清的不用大段文字。
- 图服务判断不堆砌：每张图服务于一个具体结论，标注单位与结论；不为了「有图」而图。
- 样式贴合阅读：浅色背景 + 深色文字；数据图遵循中文习惯（涨红跌绿）。
六、零外链 + 供应链安全
- 零外链：自建 HTML / 工具 / skill 引用默认零外链（不引入任何外部库 / CDN），除 CDN 白名单明确放行。
- 供应链安全 · 先审后装：安装任何 skill / CLI / 依赖，先审计脚本与源码（拒绝直接
curl | bash/irm|iex），验证签名/校验、关闭自升级与 telemetry 上报后再装。 - 以上两条与「发布前安全自检门 G0–G9」（见九）一致，作为 skill 从开发到发布的全程通用约束。
六·B、信息核查铁律（v3.3.0 新增，做 skill / 专家包 / 报告 / 建库通用）
> 与永久记忆「十三、信息核查铁律」同源同文。一句话总纲：查询有等级，入库有门槛，报告有留痕。 四原则：宁缺不编 / 存疑标注 / 勘误留痕 / 辅助非终审。
6B.1 信源四级 + 三道关
- 信源四级：一级官方一手 > 二级行业权威 > 三级百科与大众媒体 > 线索级（社区 / 自媒体，永不直接入库，只作检索线索）。三级必须两个独立来源交叉（独立＝彼此无转载关系——同一篇通稿被十家转发仍算一个来源）；核心结论至少两个独立来源。
- 第一道关 · 查询关（管住从哪来）：先分事实 / 观点（观点不核对错，只查引用出处）；优先一级源，降级必补交叉验证；每查一条当场记「来源 + 日期 + 级别」，缺一样后面补不回来。
- 第二道关 · 把关关（管住进不进）：交给事实核验工具（凡能「拆解事实表述 + 多源交叉 + 输出溯源」的工具均可，如秘塔 AI 事实核验）→ 拆解事实性表述（人物/时间/数字/事件/因果）→ 多源交叉检索 → 四标签报告 + 溯源链接 → 逐条处置。
- 第三道关 · 报告关（管住怎么写）：结论先行（先给裁决再给依据，不确定的明说）；每条事实带信源栏（来源 + 日期 + 级别）；待核实清单是报告的正式组成部分，不是耻辱柱；存疑与勘误区留在明面。
6B.2 四标签处置
| 标签 | 含义 | 处置 |
|---|---|---|
| 已证实 | 公开渠道可找到对应说法 | 可采信；仍记录来源与查询日期 |
| 有争议 | 来源之间说法冲突 | 回信源分级裁决（一级优先）；裁不了 → 入库并标「存疑」 |
| 查无实据 | 公开资源找不到佐证 | ≠ 内容错误 → 转「待核实」清单，宁缺不编 |
| 不属实 | 找到明确反证 | 删除或改写；已发布过 → 勘误留痕 |
入库门槛四件套（缺一件不进门）：① 过了脱敏 → ② 信源定级齐全 → ③ 来源日期齐全 → ④ 四标签处置完毕。
6B.3 三条边界（工具方明示，务必守住）
- 只核事实，不核观点——主观评价、感受、个人感悟无法判定对错；引用他人评价必须注明原始出处，不自行加工成事实陈述。
- 公开资源有局限——小众、内部、未数字化的信息找不到佐证 ≠ 错误，正确动作是挂「待核实」。
- 辅助非终审——「已证实」只代表公开渠道能找到说法，不等于核对过权威原件，见 6B.4。
6B.4 人工终审（没有捷径，不外包给任何工具）
关键数字（金额 / 日期 / 排名 / 口径）、关键归属（荣誉 / 头衔 / 记录 / 断代）、关键变动（人事 / 规则 / 权属）、涉他负面——定稿前必须人工打开一级信源原件亲核。
6B.5 幻觉与实战陷阱（做 skill 最易踩）
| 陷阱 | 表现 | 处置 |
|---|---|---|
| AI 幻觉 | 生成内容编造数据 / 文献，且语气笃定 | 生成内容 = 待核草稿，全过第二道关 |
| 单一来源依赖 | 全文只有一处来源，错无从发现 | 三级必须双源；核心结论至少两独立来源 |
| 口径漂移 | 同一指标不同时期统计口径不同 | 记录口径与日期，跨期对比前先对口径 |
| 旧闻新炒 | 把旧事件当新进展引用 | 每条带查询日期，引用前先查时效 |
| 关联误认 | 把 A 的历史安到 B 头上（易主 / 改名 / 合并场景高发） | 沿革类信息单独做史实澄清，冲突记载显式取舍 |
| 谣言澄清缺失 | 库内只有错误版本或只有澄清版本 | 澄清与错误一并留痕：先记流传说法，再记证据与结论 |
| 假成功陷阱 | 工具返回 success 但内容未写入；API 静默失败不报错 | 关键写操作后必须实查复核，不信任单次返回 |
| 索引延迟陷阱 | 刚导入的内容搜不到 ≠ 不存在 | 导入后延迟再查；查无结果先换查询词，不急于断言「没有」 |
| AI 味污染 | 转述检索结果时加工成笃定语气，把「据查」写成「事实就是」 | 转述保留「来源说 / 据查」，不确定的保留不确定 |
6B.6 落到制作流程里（skill / 专家包必过的闸门）
skill 与专家包必然内嵌事实性内容——法规条款、政策文号、数据口径、榜单排名、案例细节、参考文献、行业标准、人物职务、时间线。这些编错一次，就跟着 skill 传播出去，比单篇文章错一次严重得多。 故交付前必须过闸：
制作 / 优化 skill 或专家包
│
├─ 交付前：事实与观点分流（观点只查引用出处）
├─ 事实逐条：信源定级 → 双源交叉 → 记「来源 + 日期」
├─ 过四标签处置；查无实据一律移入「待核实」，不写进正文
├─ 关键项：人工打开一级信源原件亲核
└─ 交付物标配：信源栏 + 待核实清单 + 存疑与勘误区
- 专家包同样适用：知识素材含事实的照此过闸；方法论里不得教 AI「缺数据就编一个填上」（最隐蔽的幻觉源）。
- 勘误留痕：改错不静默覆盖，条目末尾留「勘误：改了什么 + 日期」——错误轨迹本身是档案的一部分。
- 与 §五 可视化铁律、§六 零外链 + 供应链安全并列，作为从开发到发布的全程通用约束；审计时（8.4.5）增列「事实核查」维度：内嵌事实是否定级、是否留痕、是否有待核实清单。
七、迭代节奏：P1+P2 一站式联推
小张的迭代偏好——倾向 P1（核心）+ P2（增强）一次性联推，避免分阶段确认拖慢节奏；多方案快速拍板并主动指定推荐项。落进协作与发布闭环：
- 能一站式联推的关联改动（如「补五字段 + 同步写记忆 + 更新多个 skill」）不分两轮来回；
- 但对外动作（发布/提交）与破坏性操作（删/覆盖/批量改）仍必须先确认（不与此偏好冲突）；
- 心法 3「拆小步走一步验一步」聚焦开发执行内部的原子动作，对外确认点合并到关键闸门，不每个子动作都打断用户。
第二部分 · Skill 全生命周期运营闭环
> 本节并入自 skill-lifecycle-playbook v1.5.0。它不是「怎么从零写 skill」（那是制造机 skill-methodology 的事），而是「skill 写完了，怎么把它打磨到能发布、再发布出去」的完整闭环。
八、全生命周期运营
8.0 开发前置条件五问（生命周期入口闸门，v2.2.0 新增）
> skill 生命周期的起点不是「写流程」，而是「想清楚」。在进入审查/优化/发布闭环之前，先过制造机定义的「开发前置五问」（详细定义见 skill-methodology「零、开发前置条件」）——⑤ 积累的第一抓手是「先建库，再建技能」：ima 知识库没建好、整理好，别动手造 skill。
| # | 问 | 这一关在生命周期里的意义 |
|---|---|---|
| ① 用途 | 解决什么具体问题？ | 决定 skill 值不值得进入闭环 |
| ② 用户 | 给谁用、什么状态下来？ | 决定设计语气与门槛 |
| ③ 场景 | 什么触发下被调用？ | 决定触发词与交付形态 |
| ④ 优势特色 | 不可替代性在哪？ | 决定与库内技能的差异边界（防重复） |
| ⑤ 积累 | 燃料来自哪？库建好了吗？ | 建库先于建技能；没地基不进闭环 |
- 建库要耐心：知识库是慢功夫，持续导入整理，别指望一次性倒完。
- 知识库也是服务台：用户有相关需求，先引导去搜知识库/知识号（对外发布按去敏感规范统一用发布人设名），让已有沉淀先发挥作用，再判断是否新做 skill。
- 五问任一答不清 → 退回去想，不进入 Step 1 审查。
8.1 与制造机 / 审计的衔接边界（别抢活，也别留空档）
> ⚠️ 制造机身份：真正的「制造机」是 技能工坊 · Skill 创作方法论（@user_946e03ef/skill-methodology），不是本手册。本手册是「开发协作 + 生命周期运营 + 质量审计」手册，管人机协作闸门、发布运营闭环与审计执行。
| 阶段 | 谁负责 | 说明 |
|---|---|---|
| 从零新建 / 大改结构 | 制造机（skill-methodology） | 按出厂规格新建 skill，产出 frontmatter 五字段、隐私脱敏、独立自包含等 |
| 写完后审查 | 本手册（v3.0.0 起内置审计） | 直接用「九、发布前安全自检门 G0–G9」+ 内置十维审计（见 8.4.5），拿 A/B/C/D 评级；完整审计清单见 references/merged-skill-audit-refs/ |
| 按审计意见优化 | 本手册 | 补 frontmatter、清依赖、补隐私、补 WHY |
| 开源合规调整 | 本手册 → opensource-adjust | 删独立 LICENSE、license 字段、README 内嵌许可全文 |
| 版本迭代提升 | 本手册 → version-iterate | 升版本号、写 CHANGELOG |
| 上架 SkillHub | 本手册 → publish-checklist | publish 命令、400 避坑、pending 审核 |
衔接铁律：制造机定规格（frontmatter 五字段/隐私脱敏/独立自包含 + 零外链/供应链/可视化HTML/交互红线/P1+P2 三项通用硬约束），本手册验规格 + 修规格 + 发规格。v3.0.0 起质量审计已内置，不再外挂 skill-audit。
8.2 五步闭环与发布纪律
审查 ──▶ 优化 ──▶ 小白引导核查 ──▶ 开源调整 ──▶ 冲A循环 ──▶ 发布前闸门 ──▶ 上架 SkillHub
│ │ │
└──────── 审核 pending / 用户反馈回来 ◀────── 闸门驳回/未满A ◀────┘ │
（迭代回到优化/小白核查/开源调整） │
│
⚠️ 游戏/互动/老少皆宜类：闸门前必须附《说明书》 │
发布纪律（硬闸门）：
1. 先开源化改造（Step 3）；
2. 再查「通俗易懂小白引导」是否齐备（Step 2.5）；
3. 审计评级，不到 A 就按意见调整优化、再审计，循环直到 A 为止；
4. A 级之后先请用户审查，用户确认没问题才允许发布（禁止自动跳过审查直接 publish）；
5. 游戏 / 互动 / 老少皆宜类，还必须在发布前写《说明书》——没有说明书不放行；
6. 审计达 A ≠ 可发布（发布闸门）：A 级只是质量「及格线」。A 级后、请用户审查前，还须额外闯三道硬前置——①多轮迭代 ②实测跑通 ③元数据打磨。任一不达标回炉续改，绝不审计一过就发（详见 8.9）。
8.3 Step 1 · 审查（audit-gate）
调用 skill-audit 跑三问前置门 + 十维审计（六维 + 四查 G/H/I/J）+ frontmatter 五字段检查，产出 A/B/C/D 评级。任一三问 No → 封顶 C；四查严重问题 → 直接 D。详细判定见 references/audit-gate.md。
8.4 Step 2 · 优化（按审计意见修）
按 skill-audit 报告「必须修改 / 建议修改 / 可选修改」三档逐项修：
- frontmatter：补五字段（slug/displayName/version/summary/license）；目标平台是 ima 还需补
name（与 slug 同值）+description成七字段——SkillHub 五字段即可，发布前先确认目标平台字段规格； - 打包合规四查（源自 2026-08-26 zsxq-topic-archive 上架 ima 失败复盘）：① 包内禁止夹带平台发布产物（SkillHub 发过的目录会残留
_meta.json，删净再打包）；② 正文中文语境禁 ASCII 双引号（除代码块/命令行参数外，统一用中文引号「」）；③ 文件名纯 ASCII；④ frontmatter 可用yaml.safe_load解析； - 触发用语 ≤5 条（2026-08-26 小张明确口径，原 ≤3 已废弃）：铭牌「触发指令实例」清单 + description 触发短语一律 ≤5 条，选最高频典型说法；
- 清依赖：所有 references/ 必须本地化，不引用其他 skill；
- 补隐私：命中 SOUL.md 2.2 敏感字段一律剔除；
- 补 WHY：关键指令带「为什么」，不只有 MUST。
8.4.5 内置质量审计 · 直接执行（v3.0.0 起，无需切换技能）
用户说「审计这个 skill」「检查 skill 合规性」时，直接在本手册内完成：
- 跑十维审计：对目标 skill 的 SKILL.md + README + references/ 全量检查——出厂铭牌（frontmatter 五字段）、更新日志、隐私脱敏（SOUL.md 2.2 敏感字段）、内容质量、用户友好（小白引导）、依赖独立（零外链）、事实核查（内嵌事实性内容是否定级 / 留痕 / 有待核实清单）**、打包合规（无
_meta.json残留/中文引号/纯 ASCII 文件名）、触发用语 ≤5 条、ima 上架校验（frontmatter 七字段 + 价值/用法/局限三节 + 联网征求同意）、对外发布去敏感检查（领导人/官方部门/文号/网址/个人库名/真实地名/案例细节零命中）； - 输出 A/B/C/D 四级评分 + 逐条问题清单 + 修改建议 + 不通过坏处说明（完整检查清单与评分规则见
references/merged-skill-audit-refs/）； - 按审计意见回 8.4 优化，循环到 A 级再放行发布。
8.5 Step 2.5 · 小白引导核查（发布前置，必过）
冲 A 之前先自查「新手能不能零门槛上手」：
- 是否有一份通俗易懂的小白引导（README 快速上手 / PLAYGUIDE / 0 基础示例），不让新手读不懂就放弃；
- 关键指令是否带「为什么」而不只有 MUST；
- 游戏 / 互动 / 老少皆宜类：必须显式写《说明书》——说清为什么好玩、自由度与边界、需什么准备/道具、人数场地、分步玩法。没有说明书 = 小白引导不合格，封顶 B、不放行发布。
8.6 Step 3 · 开源调整（opensource-adjust）
发布到 SkillHub 前必过：
- ⚠️ 删独立 LICENSE 文件（社区源报 400「不允许的文件类型: LICENSE」）；
- 许可证走 frontmatter
license:字段（如license: MIT）； - 许可全文（MIT 全文 + Copyright 行）并入 README「许可证」节。
详细见 references/opensource-adjust.md。
8.7 Step 3.5 · 更名/重构专项（rename-rebuild）
改 displayName / slug / 定位重构时，走更名手术六件套，缺一即残留（源自图鉴/以人为镜/拆解器同源解耦实战）：
- 定位解耦声明：先定义新定位的专属区间（对象 / 问题 / 输入 / 输出 / 触发词），族内互不相同而非互补；四问答不出区分的，说明不该分裂；
- displayName / slug 更新：frontmatter 同步改，更名单独成版；
- 目录名对齐 slug：本地目录名与 slug 一致，避免加载索引错乱；
- 正文引擎重定向：按新定位改写正文主线与契约卡，禁止「声明变、正文不变」（名实不符，审计封顶 C）；
- 触发词分流：族内一意图一命中，description 不适用边界注明归属；
- 旧版本平台下线：旧 slug 若仍在线必须下架——CLI 无下架命令，走 SkillHub 平台网页操作；发布新版本前先检查同源残留。
8.8 Step 4 · 冲 A 循环（audit-until-A）
- 调 skill-audit 拿评级；不到 A 就按报告「必须修改 / 建议修改」逐项调整优化，再审计，循环直至 A 级为止；
- 每轮调整同步升版本号（语义化 x.y.z：修 bug 升 PATCH，加能力升 MINOR，破坏性改升 MAJOR）+ 写 CHANGELOG（日期 + 变更项 + 来源）；
- 严禁「评级没到 A 就发布」——A 级是发布的硬性前置条件。
冲 4.7 分对照（TRACE 版，v3.1.0 升级，源自 SkillHub 平台官方 TRACE 评测体系 + 2026-08-27 全量 30 技能实测）：A 级是「作者侧质量」，SkillHub 官方 TRACE 评价 ≥4.7 是「平台侧口碑」——两者都要达标才算真过。TRACE 五维是一条评估链路：T 可信任度（能不能放心用）→ R 可靠性（能不能稳定用）→ A 适用性（该不该在这个场景用）→ C 规范性（能不能被理解、维护和复用）→ E 有效性（问题是否真的解决）。发布前对照 skill-audit v2.1.0「Step 3.6」TRACE 五维 15 子项自查：
- 可靠与容错三件套（R 可靠性 errorHandling/stability 失分主因，27/30 技能中招）：输入格式说明（用户该发什么）+ 调用方式说明（多轮/上传/API 是否支持）+ 纠错兜底（模型跑偏怎么拉回）；
- 目标用户明示（A 适用性）：description/summary 第一段点名「给谁用」，禁止「给所有人/老少皆宜」；
- 反模式 FAQ（C 规范性）：单列「常见坑 / 别做什么」清单（antiPatternFaq 全库最低 4.10）；
- 触发一句话能命中（A 适用性 trigger）：触发词 ≤5 条 + 可复制任务句；
- 信任与本土化（T 信任 domestic）：中文交互、不依赖海外 API、不做无关高权限请求。
- 检查方法：skillhub skill evaluation <slug> --namespace <ns> --json 拉平台官方 TRACE 评价，看五维均分与子项失分点；无评价报告时按 Step 3.6 自查表预检。
详细见 references/version-iterate.md 与 references/audit-gate.md。
8.9 Step 4.5 · 发布前闸门（user-review gate，硬）
A 级之后、publish 之前，必须先请用户审查：
- 把审计报告结论 + 改动摘要 + 待发布版本一并交给用户，等用户明确「没问题」才执行 publish；
- 禁止以「已到 A 级」为由自动跳过用户审查直接发布；
- 游戏 / 互动 / 老少皆宜类：闸门额外校验《说明书》是否已写入（玩法步骤 / 准备 / 边界齐全），缺则退回 Step 2.5 补写。
发布闸门（审计通过 ≠ 可发布）：即便 A 级 + 用户审查通过，发布前还须闯三道硬前置，任一不达标回炉续改：
- ① 多轮迭代：同一 skill 至少数版打磨（每版只加 1 个聚焦能力点），非一次成型即发；
- ② 实测跑通：用真实输入跑 1–2 个完整用例，输出可用、无报错、边界正确（红线命中按拒绝路径生效）；
- ③ 元数据打磨：displayName / summary / description 标题简介经推敲，第一眼说清「价值 + 边界」，不凑合。
8.10 Step 5 · 上架 SkillHub / ima / WorkBuddy 开放平台（publish-checklist）
- ⚠️ 仅当通过 Step 4.5 用户审查闸门后才可执行；
- 选路：长尾实验 → SkillHub；知识型/整理型能力 → ima；核心成熟能力 → 开放平台（权重更高、品牌更完善）。两边都要＝写两套产物；
- SkillHub：预检
skillhub publish <目录或.zip> --dry-run→ 正式skillhub publish <目录或.zip> --changelog "本次变更" --json（联网需放开沙箱）→ 状态pending（平台审核：内容/安全/人工），通过才进公开索引；用skillhub install <slug>验证。详细 + 400 避坑 + 改名重发闭环 + 409 幂等陷阱见references/publish-checklist.md； - ima：按 Step 2 打包合规四查 + frontmatter 七字段 + 内容三节（价值/怎么用/局限性边界）+ 触发用语 ≤5 条后上传；失败排查顺序：① 七字段 → ② 包内文件清单（_meta.json）→ ③ grep 引号。
- WorkBuddy 开放平台：先过「九·B 自检清单」 → 按官方字段表重写 frontmatter（不是自研五字段）→ 上传 ZIP → 后台补分类/服务类目/头像 → 提交审核（约 7 个工作日）→ 通过后记得回后台手动点发布；连接器须找运营同学代上架。完整规范见「十一·B」。
8.11 迭代三板斧（修/发每个 skill 默认套用）
- 单点迭代铁律：每版只加 1 个聚焦能力点（不一次性大改）；版本号严格递增（语义化，不跳号）；CHANGELOG 每条 ≤20 字且可追溯到源；更名单独成版；
- 验收清单前置：发布/交付前必过验收清单（
references/audit-gate.md的「冲 A 级必备补齐项清单」），逐项打勾，不过不交/不发布； - 证据分层：任何涉及外部资料/信源/他人内容的分析类 skill，出厂前必走证据金字塔 L1 本人发声 > L2 本人整理 > L3 旁人记述（仅旁证），主要结论以 L1 为准、L3 必标注，资料有多少分析多少、不编造不硬挖。
8.12 总纲贯穿 · 价值观底盘（v3.4.0 新增，与制造机第 9 条、审计 v2.5.0「总纲贯穿」并列执行）
> 来源：小张 2026-09-05 总纲指示（用户级 MEMORY.md「skill 开发总纲」同步存档）。本手册作为「开发协作 + 生命周期运营 + 质量审计」唯一权威载体，须把以下总纲性约束贯穿到每个 skill 的开发与发布：
一、延续性 · 一致性 · 重叠≤10% 红线
- 新增 skill 先想清与既有 skill 的延续性与一致性：同族/同场景/同对象能力要接得上、不打架、口径不漂移。
- 功能重叠超过 10% 即视为重复建设，原则上不建或合并；确有差异化价值也须把重叠压到 10% 以下，并在铭牌/description 写明边界与分工。
- 跨 skill 联动：skill 之间互相搭配/衔接/推荐，相关 skill 正文显式标注「配套使用 / 关联技能」入口，不做孤岛。
二、合并建议：可行性 + 必要性双判
- 发现疑似重叠/可合并 skill，先分析可行性（技术/架构/用户认知成本）与必要性（合并后更省/更清晰/不丢能力），两判通过才提建议——只提建议不执行，等小张拍板。
三、IP 统一 · 广东小张开发人设
- 所有对外 skill 坚持统一开发 IP——发布人设名「海边小张」（对外去敏感规范统一口径）；风格、价值观、边界口径前后一致，不换皮不跑调。
四、受众锚定 · 面向普通人与底层劳动者
- 主要服务普通人和一线底层劳动者（产业工人、农民、外卖骑手、保洁、护工等），语言大白话、门槛低、场景真实；不服务于小众精英炫技。
- 老人与孩子优先：凡涉及老人（照护/防骗/用药/跌倒/走失）、孩子（育儿/防拐/校园/健康/网络）的 skill，把其权益、安全、健康作为硬约束与优先项。
五、行业底层逻辑 · 安全质量并重（工程思维底盘）
把一线仪控/能源运维的底层安全逻辑贯穿进 skill 设计：① 预防为主 ② 纵深防御 ③ 风险无处无事无时不在 ④ 安全第一 ⑤ 识别→预警→预案→响应 ⑥ 响应快动手慢 ⑦ 有疑问及时澄清核实 ⑧ 追求卓越 ⑨ 注重外部经验反馈 ⑩ 代入自检（这事会不会落到我/我家老人孩子头上）⑪ 安全质量并重。
九、发布前安全自检门 G0–G9（不通过不发布）
任何自建 skill 在打包 / 发布 / 上传平台之前，必须先过安全自检——这是发布的前置闸门。依据腾讯云安全评估标准（cloudsec 8 大引擎维度 + tix 文件级扫描），完整判定细则即下方 G0-G9 清单（本文件为持久权威副本，开发与审计时逐条对照）：
- G0 能力声明：skill 用到 DNS 查询 / 调用外部 API / 读文件 / 写文件 / HTTP 请求等能力时，SKILL.md 必须显式声明 + 说明用途，声明与行为一致
- G1 供应链风险：无可疑第三方依赖、供应链污染；引入依赖须先审后装、关自升级与上报
- G2 命令执行风险：无危险系统命令 / 子进程 / 命令注入
- G3 网络请求与数据外传：无未经授权网络请求、无敏感数据外传（零外链默认达标）
- G4 文件操作与敏感路径访问：不碰敏感系统路径 / 凭证文件 / 用户主目录
- G5 Prompt 注入风险：无「忽略指令 / 假装系统 / 执行用户任意代码」类注入句式
- G6 远程脚本下载执行：拒
curl|bash、无远程下载执行（与供应链安全「先审后装」一致） - G7 可疑编码/混淆：代码 / 文档明文可读，无 base64 / 密文包裹可执行内容
- G8 其他安全风险：无挖矿 / 后门 / 反弹 shell 等异常行为
- G9 文件级扫描：SKILL.md / _meta.json / CHANGELOG.md / README.md / references/ / scripts/ / assets/* 逐文件独立判安全
红线：以上任一命中 = 禁止发布，修复后重新自检；自检结果写入 CHANGELOG / 发布说明留档。审计时由 skill-audit 的 G 维度正式核验。
九·B、开放平台提交前自检清单（v3.5.0 新增，投开放平台时逐条过）
通用（技能 / 专家都适用）：
- [ ] 资质已确认：个人认证只发技能 / 专家 / 连接器；buddy 应用与硬件需企业认证
- [ ] 中英文名与中英描述全部备齐（
description_zh+description_en，或displayName.en/zh） - [ ] YAML 全量检查：冒号后空格、无中文引号
- [ ] 接入 WorkBuddy 用真实任务实测一轮，再按四维各测一次（任务完成度 / 指令遵从性 / 事实辨别性 / 规则遵从性）
- [ ] 越界需求测试：故意给一个超出范围的需求，确认会被拦住
- [ ] 能力边界写进文档（什么该问、什么不该接）
- [ ] 规则写成「闸门」而不是「建议」
- [ ] 隐私脱敏：不含真实单位、地名、人名、凭证、内部路径
- [ ] 头像 / 图标尺寸格式合规
- [ ] 分类与类目已选定（选最贴近实际用途的，别蹭热门类目）
技能专项：
- [ ] 目录含 SKILL.md；references / scripts / templates 按需，不放无用文件
- [ ] frontmatter 按官方字段表填写，不直接搬自研五字段规范
- [ ]
description里写清用途 和触发词 - [ ] 参考资料用
@references/xxx.md引用 - [ ] 后台只需补三项：分类 / 服务类目 / 技能头像
专家专项：
- [ ]
name小写 + 连字符，且与plugin字段值一致 - [ ]
displayDescription中文严格控制在 40～50 字 - [ ]
tags恰好 3 个；quickPrompts恰好 3 个 - [ ]
defaultInitPrompt与quickPrompts第一条完全一致 - [ ]
agents/xxx.md的description用英文；name与文件名一致 - [ ] 头像 512×512、≤500KB、画风统一
- [ ] 选了正确的
categoryId - [ ] 不自行添加 tools；如声明 MCP 依赖，包内无任何真实 Token
提交后要跟的三件事：① 盯状态流转（通过后是「待发布」，要手动点发布；连接器找运营代上架）；② 记版本台账（版本号 + 发布日期 + 变更点）；③ 收集反馈迭代。
十、SkillHub 发布规范
自建 skill 发布到 SkillHub 社区源时，按下述规范执行（本文件为用户级持久权威副本，内置 skill-creator 同规则可能被官方升级覆盖，以本文件为准）：
发布命令：
- 预检：skillhub publish <目录或.zip> --dry-run（本地校验 metadata + 打包，不发请求）
- 正式：skillhub publish <目录或.zip> --changelog "本次变更" --json（联网需放开沙箱）
- 支持目录或 .zip（须含 SKILL.md）
硬规则（违反即 400 拒绝）：
- ⚠️ zip/目录内禁止独立 LICENSE 文件——SkillHub 社区源报「不允许的文件类型: LICENSE」；许可证声明走 frontmatter license: 字段（如 license: MIT）
- 适配方案：删除独立 LICENSE → 许可全文（MIT 全文 + Copyright 行）并入 README「许可证」节 → 重新打包发布
- 开源合规不依赖独立 LICENSE 文件：frontmatter license 字段 + README 内嵌许可全文即为合规
发布前必过：
1. skill-audit v1.5 十维审计（含 G 安全检测零红线 + 隐私零命中 + frontmatter 五字段 + 触发用语 ≤5 条 + 小白类用户向数据抓取/导出 skill 专项硬检查）
2. --dry-run 预检通过
发布后：状态 pending（平台审核：内容审核/安全扫描/人工复核），审核通过才进公开索引可搜索/安装；可用 skillhub install <slug> 验证。
细节补充（400 全清单 / 改名重发闭环 / 409 幂等陷阱 / zip 命名规范）：见 references/publish-checklist.md。
十一、ima 平台发布规范
自建 skill 发布到 ima SKILL 平台时，按下述规范执行（源自 zsxq-topic-archive 上架失败实战复盘——缺 name 字段 + 夹带 _meta.json + 正文 ASCII 引号三连挂，与 skill-audit v1.5.0 / 制造机 v1.11.0 对齐）：
frontmatter 七字段（ima 硬性校验）：slug / name（与 slug 同值，表单「名称」栏数据源） / displayName / version / summary / license / description（平台自动生成「使用说明」的数据源）——缺 name 或 description → 校验直接不通过。SkillHub 只要五字段，发布前先确认目标平台规格，别拿一套走天下。
打包四查（上传前必过）：
1. 平台产物零残留：包内禁止夹带 _meta.json（SkillHub 发布产物，含 ownerId/publishedAt）等平台元数据，只留 SKILL.md + README.md + references/ + scripts/ + assets/
2. 文件名纯 ASCII：中文文件名跨平台解压易乱码
3. 正文中文语境禁 ASCII 双引号：除代码块 / 命令行参数外，正文一律用中文引号「」——避免渲染歧义与审核误判
4. frontmatter 可解析：yaml.safe_load 无异常（summary/description 文本内禁 ASCII 双引号）
内容三节必齐：正文含「对用户的价值 / 怎么用 / 局限性与边界」三节；联网类 skill 需「联网征求同意」闸门。
触发用语 ≤5 条（所有平台通用）：出厂铭牌「触发指令实例」清单 + description 触发短语一律 ≤5 条，选最高频典型说法，不堆同义表达。
排查姿势：平台报错先要报错截图/文案，别靠猜；其次拿「能过的」与「不能过的」技能逐字段 diff。ima 高频翻车三连排查顺序：① frontmatter 七字段 → ② 包内文件清单（_meta.json）→ ③ grep 引号。
十一·B、WorkBuddy 开放平台发布规范（v3.5.0 新增，重审核通道）
自建 skill / 专家发布到 WorkBuddy 开放平台（open.workbuddy.cn）时按本节执行。权威源＝官方开放平台文档 + 2026-09-02 官方上架 Q&A，细节以官方原文为准。
三平台选路（先想清楚投哪，别拿一套走天下）
| 平台 | 通道性质 | 审核强度 | 适合什么 |
|---|---|---|---|
| SkillHub | 轻量自由 | 安全扫描 + 人工复核 | 长尾实验、小步快跑、改得勤的 |
| ima SKILL 广场 | 中等 | 七字段校验 + 内容三节 | 面向 ima 用户的知识型/整理型能力 |
| WorkBuddy 开放平台 | 重审核 + 严规范 | 机器审核（基础安全 + 内容安全 + 质量检测四维）+ 人工审核（类目资质） | 核心成熟能力——市场展示与被 Agent 自动调用权重更高、端内主页品牌更完善 |
铁律：同一个能力想两边都上，产物要写两套，不是一个包改名双投——frontmatter 规范根本不同（见下）。
资质分水岭（开工前先确认，别做到一半发现资质不够）
- 个人认证：只能发 技能 / 专家(Agent) / 连接器三类
- buddy 应用 / 硬件接入：必须企业认证，个人开发者做不了
质量检测四维（不通过的真正原因）
| 维度 | 官方定义 | 落地动作 |
|---|---|---|
| 任务完成度 | 资产是否能完整完成其声明的核心任务 | 声明的每个能力都必须真跑通；没实测过的能力不要写进 description |
| 指令遵从性 | 对用户指令的响应是否准确、一致 | 越界需求必须被拦住；同需求换说法结果稳定 |
| 事实辨别性 | 输出内容的事实准确性和可靠程度 | 有信源与优先级约束；拿不准要追问或标注存疑，不硬编 |
| 规则遵从性 | 是否遵守资产内部要求的规则和行为规范 | 自己定的规则要写成「闸门」（前置检查 → 不通过就终止），不能只是文档里的建议 |
> 优化姿势（官方原文）：不通过时先接入 WorkBuddy 真实调试，再改文档——盲改文档找不到掉分点。
审核流程与时间表
提交 ZIP → 机器审核（基础安全 → 内容安全 → 质量检测四维）
→ 人工审核（类目资质）→ 自动流转「待发布」→ 上线
- 技能 / 专家整体约 7 个工作日（是工作日，不是天，排期别按自然日算）
- ⚠️ 「审核通过」≠「已上架」——通过后是「待发布」状态，要自己回后台点发布
- ⚠️ 连接器发布后不自动上架，必须由运营同学代操作，发布到上架亦约 7 个工作日；已上架后版本更新重新提交审核，10～15 分钟生效
技能包规范（开放平台）
{skill-name}/
├── SKILL.md # ★ 必须
├── references/ # 可选（正文用 @references/xxx.md 引用）
├── scripts/ # 可选（AI 通过 Bash 执行）
└── templates/ # 可选
目录层级硬限制：最多两级（根目录 / 二级目录 / 文件）：
{slug}/references/xxx.md✅{slug}/references/sub/xxx.md❌ 直接报「目录层级超限」- ⚠️ 校验口径是「文件所在目录的层数」，不是路径段数——按段数算会把自己误判成超限，白改一轮
- SkillHub 导出包常带
references/*-refs/这类二级子目录，必须扁平化；撞车靠文件名前缀解决（mindset-archive-rules.md），不能再套一层 - 扁平化后必须回查正文里的路径引用（
references/modules/xxx.md、references/industry-frameworks/之类），同步改平，否则留下悬空引用——「任务完成度」维度会扣分
frontmatter 官方字段（⚠️ 与我们自研五字段规范 slug/displayName/version/summary/license 不是同一套，上开放平台必须按官方表补，不能直接搬）：
- 必填：
description（写清用途和触发词）/description_zh/description_en/version/author（合作方名称） - 实测必填（官方字段表标「否」，但缺失直接解析失败）：
display_name（中文展示名）/display_name_en（英文展示名；官方示例里是空值，但空着照样报错） - 可选：
name/allowed-tools（工具白名单，逗号分隔）/disable-model-invocation（true 则 AI 不自动触发、只能手动调用）/user-invocable（false 则隐藏菜单，仅供 AI 内部使用） - ⚠️
category别写进 frontmatter：官方示例里有（注释「分类之一」）但字段表未列必填，且平台明确「上传后手工补 3 项：分类 / 服务类目 / 技能头像」——猜错枚举会引入新的解析失败，留后台选
做法：只加不改。新增官方字段，保留原有 slug / displayName / summary 等，避免破坏已发布的 SkillHub 版本（同一能力两边都上，展示信息保持一致）。
打包卫生：剔除 SkillHub 安装器产物 _meta.json 与 config.json（后者含 autoupdate:true + skillhub 下载 URL，属第三方自升级源，重审核通道不该带）；文件名纯 ASCII；每包仅一个 SKILL.md。
三个字符级杀手（最高频翻车点）：
- YAML 冒号后必须空一格——
name: your-skill对，name:your-skill直接解析失败 - 纯标量里出现 ASCII
:会被当键值分隔符——英文简介里的Kit): look up、writers: six必须改写成-；撇号（person's）也一并绕开，防朴素解析器 - 禁用中文引号「」“”；要引号一律用英文半角，或干脆不加
> 上传后系统自动解析 frontmatter 里的字段，手工只需补三项：分类 / 服务类目 / 技能头像。所以 frontmatter 写对了，后台就少填一半。
> 解析失败定位不到时联系 openworkbuddy@tencent.com，或扫开放平台首页下方二维码进社群。
专家包规范（开放平台专有，SkillHub 无此形态）
my-expert/
├── .codebuddy-plugin/plugin.json # 核心配置
├── avatars/expert.png # 头像
├── agents/my-expert.md # Agent 定义（系统提示词）
└── README.md
plugin.json 必填字段：name（小写 + 连字符）/ expertType（"agent" | "team"）/ version / description（英文）/ author{name,email} / agents[] / agentName / teamInfo（team 时）/ displayName{en,zh} / profession{en,zh} / displayDescription{en,zh} / avatar / categoryId / defaultInitPrompt{en,zh} / plugin（与 name 同值）/ tags{en,zh}[] / quickPrompts{en,zh}[]
三个硬数字（错一个就退回）：
1. displayDescription 中文 40～50 字（是区间，不是「不少于」）
2. tags 恰好 3 个
3. quickPrompts 恰好 3 个，且第一条必须与 defaultInitPrompt 一字不差
agents/xxx.md 的 frontmatter：name（与文件名同，不含 .md）/ description（英文，AI 用来判断何时激活）/ displayName{en,zh} / profession{en,zh} 必填；maxTurns（默认 50）/ skills 可选。开发者不可自行添加 tools，工具权限由系统统一分配。
头像规范：PNG（推荐）或 JPG；512×512 px；单张 ≤500KB；统一漫画 / 插画风格；放 avatars/，plugin.json 用相对路径引用。
categoryId 15 类：01-ProductDesign / 02-Engineering / 03-GameSpatial / 04-DataAI / 05-MarketingGrowth / 06-ContentCreative / 07-SalesCommerce / 08-FinanceInvestment / 09-OperationsHR / 10-ProjectQuality / 11-SecurityCompliance / 12-IndustryConsultant / 13-TencentZone / 14-WorldWise / 15-Education
MCP / 连接器依赖（简单专家不必声明）：用 dependencies{mcpServers, connectors[]} 声明；包内严禁硬编码任何真实 Token / 密钥；x-workbuddy 是平台私有字段，连接后会被剥离，不污染用户本地 mcp.json。
连接器规范（开放平台专有）
- 两种接入方式，一个连接器只能选一种，不可混用：MCP + Skill（推荐，远程优先 HTTPS SSE / streamableHttp）/ CLI + Skill（已有成熟 CLI 时）
- 包结构：
connector-meta.json+mcp.json（或cli.json）+icon.svg+skills/{name}/SKILL.md - 一个连接器只配一个 MCP Server；单次请求建议 30 秒内响应；可用性建议 ≥99.9%
- 图标：SVG 优先，PNG/JPG 建议 64×64，背景建议透明
- 凭证红线：不得在任何文件硬编码真实 Token / 密钥；最小权限；远程 MCP 强制 HTTPS；敏感字段用 password 类型
解析失败处理（官方路径）
- 复制页面上显示的失败原因 → 粘贴给 AI，让它定位并改文件内容
- 仍定位不了 → 邮件
openworkbuddy@tencent.com，或扫开放平台首页二维码进开发者群 - 自查顺序：官方文档的【基础结构】→【配置文件】逐项对照
其它口径（避坑）
- 下架：市场不再出现、新用户搜不到；但已安装用户可继续用，只是拿不到后续版本更新——下架等于把老用户冻结在旧版本，下架前想清楚
- 旧版资产迁移：用对应 WorkBuddy 账号认证，系统弹窗指引完成存量迁移；运营代管的资产需主动联系运营同学迁回本人账号
- 分成机制：规划中；成员管理：暂不支持
- 灵感案例（可选加分项）：用
playbook-case-factory产出案例，12 分类可关联 Skill / 专家 / 专家团 / MCP；硬性前提＝必须含可执行 Prompt + 真实产物（只交封面 + 描述不行），产物须来自真实执行可复现；导出完整案例 ZIP 交运营同学
> 完整速查（含 9 张对照表、自检清单、Q&A 原文十二条）见本地交付物 WorkBuddy开放平台上架规范速查.html。
十一·A、对外发布去敏感检查（v2.1.0 新增，必过）
凡要上架 / 重发 / 概述异常的 skill，除 G0–G9 与审计外，整包扫描（SKILL.md + README.md + references/** 全部 .md，题库/清单/模板都可能藏雷），命中即去敏后再发——源自 2026-08-27 disaster-response-assistant 概述异常实战，与永久记忆「对外发布去敏感规范」、skill-audit v1.8.0「A+++++」、制造机 v1.15.0 第 17 条对齐：
必去清单（出现即移除或泛化）：
1. 领导人姓名与职务（各类职务称谓）——删
2. 官方部门名（各类部委与专项机构）→ 泛化「主管部门/官方渠道/权威官方源」
3. 官方文件全名与文号（各类红头文件与发文字号）→ 只留知识点，不列文件与文号
4. 官方网址与热线（任何政府域名与官方热线）→ 泛化「官方门户/官方热线」
5. 个人知识库名与 kb_id（场景库名、政策库名等 + ima kb_id 数字）→ 中性化「融合多方公开资料与实战经验」
6. 真实地名与脱敏映射表（县/街道级地名 + 映射文件）→ 泛化或从发布包剔除
7. 具体案例细节（台风名、真实事件地名）→ 泛化「某次台风/某地」
8. 真实 IP 全名 → 统一发布人设名「广东小张」，不写具体公众号名
概述（description/summary）规范：概述异常/丢失时重写——重点说用法和用途 + 说清局限性（不替代/不预测/不编造、依赖联网、地域精度、启发式非专业等），不引领导人/部门。
重发流程：审查 → 去敏 → 简化省略 → 按本地存档重写 → 版本 bump（习惯 minor+1）→ --dry-run 预检 → 发布 → 等审核（pending→listed）。
全量体检：定期拉本人线上清单（dashboard API），本地全量扫敏感词，有问题的逐个修复重发；扫描脚本模式见 Desktop/待整理/我自制的skill/scan_sensitive.py。
十二、小白类用户向数据抓取/导出 skill 硬标准
今后凡做用户向、小白类、帮用户处理工作软件抓取数据/导出的 skill（如豆瓣归档、社区平台导出、网盘盘点），默认按以下统一硬标准执行——源自 douban-archive 对标 zsxq-topic-archive（范本）的实战固化：
- 集中式「坑清单」：单列一章，罗列该工具/平台最易翻车的真实坑（分页虚标、长评漏抓、容量口径、删前先列路径等），陪跑/自查时一眼可见，不散落在流程里。
- 「小白用户指导（第一次用也能跑通）」：单列一章——零基础启动清单（要装什么/连什么/点哪里）、卡点自救话术、术语速查（术语→人话），让用户不靠问人也能跑通第一次。
- 出厂铭牌含「触发指令实例」+「数据/经验来源」：铭牌给 ≤5 条可直接复制的高频触发句 + 标注数据/经验真实来源（实战坑位，非凭空）。
- 确认门 / 隐私脱敏 / 耐心红线 / 边界 / CHANGELOG 五件套齐备：长流程有关键确认点；涉及个人数据默认脱敏；陪跑有耐心不甩「必须 X」；写清「不做什么」；每版 CHANGELOG 可追溯（≤20 字/条）。
> 此标准与「产出物可视化铁律」「零外链+供应链安全」并列，作为此类 skill 从开发到发布的全程通用约束。范本：zsxq-topic-archive（SkillHub 已发）。已落地：douban-archive v1.4.4 / netdisk-audit v1.1.0。
十三、用法（Usage）
开发协作场景：小张说「开发/做工具/建个 SKILL/搭个网页」或任何工程类意图时，先触发本手册。进入每个子阶段前，用模板 1–2 收束需求、拆文档；开工用模板 3 框定；收尾用模板 4 验收、模板 5 守底线、模板 6 大白话复盘。心法 3 是核心节奏：永远小步快跑、步步验收，不堆大批量交付。
生命周期运营场景：小张说「审计 skill / 优化 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
十四、与 skill-creator / 制造机的关系
- skill-creator（内置「SKILL 开发制造机」）文末嵌入的协作手册版本，可能在官方升级时被覆盖；本文件是用户级、持久不丢的权威副本，两者以本文件为准。
- skill-methodology（技能工坊 · Skill 创作方法论）：真正的「制造机」，管「造 skill 的规格 + 三板斧 + 发布闸门」；skill-audit 管「质量审计验规格」；本手册管「协作闸门 + 修规格 + 发规格」。三道尺子（制造机/审计/本手册）共用一套，不各说各话。
十五、token 经济性纪律（省 token / 省积分，v3.2.0 新增）
自建 skill 从设计到使用都要替用户省 token、省积分——这是「零成本」铁律在 AI 用量上的延伸。源自知识库建设实战经验（省 token 方法论第八章），与制造机第 19 条、审计 D 维度联动：
设计期工程纪律（让 skill 本身省）：
1. references 按需拆分加载——SKILL.md 只留主线，长清单/模板/话术进 references/，免占上下文；
2. 检索带 scope——知识库查询显式限定文件夹/标签，不整库扫；
3. 长文先大纲后深入——大文件用 get_outline 替代 get_content（>1MB 易 -32603 i/o timeout）；
4. 产物可复用——AI 产出存回知识库/文件，下次直接调用不重生成；
5. 会话边界清晰——一事一对话，旧上下文不滞留；自动化任务注意 API 每日额度上限、拆批按天跑、防僵尸进程烧额度。
使用期用户引导（教用户省）：在引导/说明里提示——先想后问一次问清（背景+任务+要求）、限制输出长度（100字内/只列3点/表格）、少喂精喂（一次1-2篇最相关先摘要）、用编号定位、复用已有成果、打包处理（批量一次跑）。整体省钱六招：先用免费额度 / 订阅前算账（月费÷次数）/ 能搜不调AI / 知识库替你省钱 / 轻活用小模型 / 打包处理。口诀：资料少喂精喂 · 问题一次问清 · 输出限长 · 库存瘦身。
发布前审计挂钩：冲 A 循环与 skill-audit 的 D 维度「token 经济性」检查须同过——凡提示用户「把全部资料一股脑丢给 AI」「无 scope 整库检索」「长文不摘要直接全文喂」的写法，视为未达标，回炉修正。
出厂铭牌
- 作者：广东小张（能源行业一线技术工人，AI 技能自建者）
- 版本：v3.8.0（2026-09-14）
- 简介：开发协作强制手册（强制闸门/六条模板/五条心法/交互红线/可视化HTML/零外链供应链/P1+P2联推）+ Skill 全生命周期运营闭环（五步流程/发布纪律/更名手术六件套/发布闸门/迭代三板斧/三平台发布规范/小白类硬标准/对外发布去敏感检查）+ 内置 Skill 质量审计（TRACE 官方评测体系预检/十维 A/B/C/D 评级/双平台上架校验），为 skill-dev-playbook、skill-lifecycle-playbook、skill-audit 三合一后的唯一权威载体。新增「十一·B WorkBuddy 开放平台发布规范」+「九·B 开放平台提交前自检清单」：三平台选路与铁律（两边都要＝写两套产物）、资质分水岭、质量检测四维、专家三个硬数字、YAML 两个字符级杀手。v3.8.0 新增「六·B 信息核查铁律」：信源四级 + 核查三道关 + 四标签处置 + 人工终审 + 幻觉与实战陷阱九条，skill 与专家包同标。
- 数据/经验来源：2026-08-20 开发协作铁律固化；2026-08-23 三轮真实发布实战（更名/409/冲A）；2026-08-24 交互红线/可视化/供应链固化；2026-08-26 zsxq-topic-archive 上架 ima 失败复盘（打包四查/触发用语≤5）；2026-08-27 SkillHub 全量 30 技能官方评价实测 + 技能家族合并（31→20）工程 + SkillHub 平台官方 TRACE 评测体系；2026-09-10 WorkBuddy 开放平台官方文档四页（概述/技能/专家/连接器）+ 2026-09-02 官方上架 Q&A 十二条实战梳理；2026-09-14 信息核查铁律固化（同步永久记忆第十三节 + 制作规范 zhang-skill-standards v1.2 §六），衔接开放平台质量检测「事实辨别性」维度，把「不硬编」从原则落成闸门。
- 触发实例：「开发」「做工具」「建个 SKILL」「审计这个 skill」「skill 要上架」。
- 不适用边界：从零新建 skill 的创作决策（归 skill-methodology）；与 skill 无关的通用咨询。
隐私与安全底线（统一增补 2026-09-03）
敏感个人信息七类，从严处理：生物识别、宗教信仰、特定身份、医疗健康、金融账户、行踪轨迹，以及不满十四周岁未成年人的个人信息——不主动采集、不追问、不记录、不输出、不外传；用户无意说出即跳过并轻提醒；结果输出前二次过滤。
危地不往，乱地不去（安全边界）：识别到用户拟进入高风险或混乱环境（线下见陌生网友、野游野泳或未开发区域、承诺高息回报与荐股、培训贷与押金陷阱、秩序混乱的拥挤现场等），在正常回答之外追加一句轻量避险提醒——不评判、不说教，给出「不去 / 不碰 / 不贷 / 不信」的边界选项，最终决定权在用户。
数据本地优先：个人数据整理默认只落本地文件；联网请求只带关键词、不携带个人数据；用户可随时要求删除已记录内容。
作者与联系
| 渠道 | 账号 |
|---|---|
| 作者 | 广东小张 |
| ima 知识号 | 广东小张 |
| 公众号 | 广东小张的养娃纪事 |
| 微信 | bujuetianyayuan |
用着顺手，或者想聊聊养娃、写作与 AI 实战，欢迎来公众号找我——一个一边倒班一边折腾 AI 的一线工程师父亲。
更新日志
- v3.8.3（2026-09-25）｜按平台安全规范收敛联系信息章节。
-
v3.8.0（2026-09-14）｜新增「六·B 信息核查铁律」：总纲「查询有等级，入库有门槛，报告有留痕」+ 四原则（宁缺不编/存疑标注/勘误留痕/辅助非终审）+ 信源四级 + 核查三道关（查询关/把关关/报告关）+ 四标签处置（已证实/有争议/查无实据/不属实）+ 入库门槛四件套 + 三条边界（只核事实不核观点/公开资源有局限/辅助非终审）+ 人工终审四类关键项 + 幻觉与实战陷阱九条 + 落到制作流程的闸门图（skill 与专家包同标，方法论不得教 AI「缺数据就编一个填上」）。承接 v3.5.0 开放平台质量检测「事实辨别性」维度，把「不硬编」从原则落成可执行闸门。另：8.4.5 内置审计增列「事实核查」维度；出厂铭牌版本号修正（线上铭牌滞后于 frontmatter）；版本号 summary / description / 铭牌同步。源自小张 2026-09-14 明确要求，同步永久记忆第十三节 + 制作规范 v1.2 §六。
-
v3.6.0（2026-09-11）｜十一·B「技能包规范」补入目录层级两级硬限制（含校验口径：数「文件所在目录的层数」而非路径段数；扁平化撞车用文件名前缀解决；扁平后回查正文路径引用防空悬）+ 实测结论修正（display_name / display_name_en 由「建议填」改为实测必填，category 由「建议填」改为别写进 frontmatter）+ 打包卫生（剔除 config.json 自升级源）+ 第三个字符级杀手（纯标量 ASCII
:与撇号）+ 解析失败联系渠道。源自 2026-09-11 四技能实投两轮报错实战（缺 4 字段 → 目录层级超限）。同步审计 skill-audit v2.6.0 Step 3.8。 - v3.5.0（2026-09-10）｜新增「十一·B WorkBuddy 开放平台发布规范」：三平台选路对照（SkillHub / ima / 开放平台）与铁律「两边都要＝写两套产物，不是一个包改名双投」+ 资质分水岭（个人只发技能/专家/连接器，buddy 应用与硬件需企业认证）+ 质量检测四维（任务完成度/指令遵从性/事实辨别性/规则遵从性，含「规则要写成闸门而非建议」落地动作）+ 审核流程与 7 个工作日 + 「审核通过≠已上架」（连接器须运营代上架）+ 技能包结构（官方字段表，明确与自研五字段规范不是同一套）+ 专家包全规范（plugin.json 字段/三个硬数字：displayDescription 中文 40～50 字、tags 恰好 3、quickPrompts 恰好 3 且首条与 defaultInitPrompt 一致/头像 512×512 ≤500KB/15 类 categoryId/MCP 依赖声明）+ 连接器规范（MCP 与 CLI 不可混用/一连接器一个 Server/可用性建议 ≥99.9%/凭证红线）+ 解析失败官方处理路径 + 下架与迁移口径；另新增「九·B 开放平台提交前自检清单」（通用 10 项 + 技能 5 项 + 专家 9 项 + 提交后三件事）。源自 2026-09-10 WorkBuddy 开放平台官方文档四页 + 2026-09-02 官方上架 Q&A 十二条梳理。
- v3.4.0（2026-09-05）｜新增「8.12 总纲贯穿·价值观底盘」章节（与制造机第9条「价值观底盘」、审计 v2.5.0「总纲贯穿」并列）：延续一致·重叠≤10%红线/跨skill联动/合并可行性+必要性双判/IP统一/受众锚定普通人与底层劳动者·老人孩子优先/安全质量并重底层逻辑 11 点。源自小张 2026-09-05 总纲指示。同步制造机 v1.20.0 + 审计 v2.5.0。
- v3.2.0（2026-09-03）｜新增「十五、token 经济性纪律（省 token / 省积分）」：设计期工程纪律（references 按需加载/检索带 scope/长文先大纲/产物可复用/会话边界/自动化拆批）+ 使用期用户引导（省 token 八法·整体省钱六招）+ 与制造机第19条、审计 D 维度联动，冲 A 循环同过。源自知识库建设实战经验第八章。同步制造机 v1.19.0 + 审计 v2.3.0。
- v3.1.0（2026-08-27）｜「8.8 冲 A 循环」的冲 4.7 对照升级为 TRACE 版：补入平台官方五维评估链路（T 可信任度→R 可靠性→A 适用性→C 规范性→E 有效性）+ 自查项扩为五项（新增信任与本土化）；references/merged-skill-audit.md 同步刷新为 skill-audit v2.1.0（Step 3.6 升级为 TRACE 预检）。源自 SkillHub 平台官方 TRACE 评测体系文档。同步制造机 v1.18.0 + 审计 v2.1.0。
- v3.0.0（2026-08-27）｜三合一合并版：整体吸收 skill-audit v2.0.0（十维审计/ima 上架校验/对外发布去敏感检查，references 全量并入
references/merged-skill-audit-refs/）与 skill-lifecycle-playbook v1.9.0 完整内容（归档references/merged-skill-lifecycle-playbook.md）；新增「8.4.5 内置质量审计·直接执行」；displayName 改为「开发协作与 Skill 全生命周期手册（含质量审计）」；作者统一广东小张；原 skill-audit 与 skill-lifecycle-playbook 平台侧标注已并入。源自小张 2026-08-27 家族合并指令。 - v2.3.0（2026-08-27）｜「8.8 冲 A 循环」新增「冲 4.7 分对照」：A 级是作者侧质量、官方评价 ≥4.7 是平台侧口碑，两者都要达标；四项自查（可靠与容错三件套 / 目标用户明示 / 反模式 FAQ / 触发一句话命中）+ 拉取官方评价方法。源自 2026-08-27 SkillHub 全量 30 技能官方评价实测（仅 3 个 ≥4.7）。同步制造机 v1.17.0 + 审计 v2.0.0。
- v2.2.0（2026-08-27）｜新增「8.0 开发前置条件五问」入口闸门：用途/用户/场景/优势特色/积累，⑤硬约束「建库先于建技能」；建库要耐心；用户有需求先引导搜知识库/知识号（去敏感不写具体名）。源自小张 2026-08-27 明确要求。同步制造机 v1.16.0 + 审计 v1.9.0。
- v2.1.0（2026-08-27）｜新增「对外发布去敏感检查」章节（十一·A）：发布/重发前整包扫描（SKILL.md+README+references/**）必去清单（领导人职务/官方部门/文件文号/网址热线/个人库名与 kb_id/真实地名与映射表/案例细节/真实 IP 全名），概述异常重写须重点说用法与局限，重发流程（审查→去敏→简化→重写→bump→dry-run→发布）；自身去敏（作者署名统一为发布人设名）。源自 disaster-response-assistant 概述异常实战。同步审计 v1.8.0 + 制造机 v1.15.0。
- v2.0.0（2026-08-26）｜合并版：吸收 skill-lifecycle-playbook v1.5.0 全部内容（五步闭环/发布纪律/Step1–5/更名手术六件套/发布闸门/迭代三板斧/衔接边界/使用示例），references 四件并入本目录；去重 G0–G9、SkillHub/ima 发布规范、P1+P2（各保留一份）；触发用语口径统一 ≤5 条（原 lifecycle 的 ≤3 废弃）；displayName 改为「开发协作与 Skill 生命周期运营手册」。原 lifecycle 目录归档移除。源自小张 2026-08-26 明确要求二合一去重。
- v1.3.0（2026-08-26）｜①「触发用语 ≤3 条」放宽为 ≤5 条（小张明确要求）；②新增「小白类用户向数据抓取/导出 skill 硬标准」章节；③SkillHub 发布规范必过项补「小白类专项硬检查」。同步 skill-audit v1.5.1 + 制造机 v1.12.0。
- v1.2.0（2026-08-26）｜新增「ima 平台发布规范」章节（七字段/打包四查/内容三节/排查姿势）+ 通用规则「触发用语 ≤3 条」。源自 zsxq-topic-archive 上架 ima 失败复盘。同步制造机 v1.11.0 + 审计 v1.5.0。
- v1.1.0（2026-08-24）｜新增四块 skill 开发通用要求：①人机协作交互红线；②产出物可视化铁律；③零外链+供应链安全；④迭代节奏 P1+P2 一站式联推。源自小张明确要求固化。
- v1.0.0（2026-08-20）｜初始发布：六条 Prompt 速查模板 + 五条实操心法 + 强制闸门 + 发布前安全自检门 G0–G9 + SkillHub 发布规范。
