技能工坊 · Skill 全流程制造机（skill-methodology）

作者从 2026年5月 到 8月，用两个月把 skill 从 1 个做到 110 个，走了完整一圈：萌芽 → 爆发 → 体系化 → 精细化。本 skill 把这圈经历沉淀成可复用的方法论——什么时候该建、怎么设计、怎么用、怎么维护。

> v1.21 更新：新增第七章「Skill 上新推介」——为已上架 skill 产出介绍卡 + 群公告双件套；本工坊更名「Skill 全流程制造机」。

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

• 输入格式：你的创作问题，如「这个值不值得做成 skill」「帮我设计一个 XX skill」。
• 调用方式：判断门→架构→设计→使用→维护全链指导；可参考工作流示例。
• 纠错兜底：方法论基于作者实战经验，非唯一标准；具体场景灵活调整。

English Overview

Skill Methodology is the author's battle-tested approach to creating skills, grown from building 1 to 110 of them. It answers: should this be a skill at all? How to design, use and maintain it? A four-question quick filter, a six-dimension evaluation, and a five-field contract card keep you from building skills just for the sake of building. It also ships a launch kit: turn a published skill into a self-contained showcase card plus a short group announcement, based strictly on verified facts.

核心原则（七句话，全部方法论的根）

1. 痛点驱动，不是数量驱动——先有反复出现的需求，才配有一个 skill。备件验收的痛点生出了移动工具需求，新闻困惑生出了影响映射器，不是先有 skill 再找用途。
2. 先建库，再建技能——知识库是地基。5月2日先把公众号文章导入知识库做「数字分身」，之后每一个写作 skill 才有素材可依。素材地基不稳，skill 是空中楼阁。
3. 流程先跑通，再沉淀——被验证过的流程才值得固化。工厂日记 skill 来自一次完整跑通的「素材→点评→成文→终稿」会话，不是凭空设计的。
4. 能复用就共享，能克制就别建——公共模块抽到共享层只维护一份（gzh-writing-core / xiaozhang-conventions）；一次性的、纯问答的、平台已有的、兴趣化石，都不建。
5. skill 是启发器，不是替代品——skill 封装的是可文字化的显性知识和重复流程，它是对大模型的「启发」，不是人的替身。核心依赖个人判断、难以言传的默会知识（tacit knowledge）的部分，skill 学不会也无能替代。如果一个岗位不需要什么默会知识，任何人学了显性流程都能替代——那真正该焦虑的不是 AI，是自己没有护城河。牢记：关键决策节点必须留给人。
6. 先定型，再填能力——每个 skill 开发前先填一张五字段契约卡（能力边界/输入示例/输出格式/安全边界/触发词），再写流程。契约卡填不清，说明需求没想透——拿输入示例直接发给助手试一下，一次跑不通就回去重填。（模板见 references/design-contract.md，v1.2 新增）
7. 护城河在领域知识封装，不在 skill 数量——最值钱的 skill 是把个人领域积累（产业工人父亲知识：育儿、亲子沟通、工人权益、倒班管理、低成本陪娃）封装成「一句话调用、带来源输出」的能力（对标启信慧眼/购物管家）。元技能闭环（找→审→装→造）比单点技能数量更能形成壁垒——别人只给工具，你给「找→审→装→造」的闭环。
8. 出厂审计与大众适配（v1.7 新增）——开发完成不是结束，是发布前的开始：过四查（合规/重复/门槛/能量，见 skill-audit v1.1），做三件事（大白话降门槛、温和化争议表述、写清与相关 skill 的边界分工）。skill 面向大众的价值不在术语多专业，而在普通人 5 分钟能用起来、用起来有正面能量、点到为止不越界。记住 skill 是被动触发的工具，不是主动推送的 app——设计时想清楚「用户在什么场景下会主动来问」，重点服务有智能手机/电脑、会主动提问的人群。

零、开发前置条件：想清楚五件事（v1.16.0 新增）

> 动手造 skill 之前，先回答五个问题。五个没想清楚，就别动手——这是判断门（一、）之前的更前置关卡。五问本质是「需求澄清」，比四问快筛更早，是避免「为建而建」的第一道闸。

⑤ 积累的第一抓手：先建库，再建技能（硬约束）。 知识库是 skill 的地基——把 ima 知识库建好、整理好，是开发任何 skill 的第一步。正确顺序：建库 → 梳理总结（沉淀可复用素材）→ 再封装成 skill。地基不稳，skill 就是空中楼阁；没有素材积累硬造，出来的只能是空壳。本制造机核心原则第 2 条「先建库，再建技能」即此意——2026年5月初先把公众号文章导入知识库做「数字分身」，之后每个写作 skill 才有素材可依。

⑤-a 建库要耐心，急不得。 知识库是慢功夫——公众号文章、工作经历、领域沉淀要持续导入、持续整理，不是一次性倒进去就完事。地基是一点点夯实的，别指望三天攒出护城河；耐心沉淀，skill 才有真东西可调用。

⑤-b 知识库也是「服务台」：用户有需求，先引导去搜。 知识库 / 知识号（作者已沉淀内容的公开载体）既是 skill 的「燃料库」，也是直接服务来问者的入口——当用户提出相关需求时，先引导其去搜你的知识库与知识号，让已有沉淀先发挥作用，再判断要不要新做 skill。（对外发布时按去敏感规范统一用发布人设名，不写具体公众号 / 知识号名称）

一、判断门：建不建？

先找先审（元技能链前置，建之前第一步）：走「找→审→装→造」链——① 找：先在自家库 + 平台 + 外部技能市场（如 SkillHub）搜现成的，能装不造；② 审：第三方技能一律先审后装（权限清单 + 风险点，见 references/design-contract.md）；③ 装：现成够用就装，别重复造轮子；④ 造：确无现成且过了判断门，才自己造。查重范围不止自家库，还包括外部技能市场——很多人造了个轮子，只因没搜过外面。（v1.2 新增）

约束前置（接触需求后第一件事，不要在约束不清的情况下判断）：

对照三问明确边界：① 零成本约束——免费工具 + 已有资源能做吗？如需付费或外部 API，记入「黄灯」；② 时间约束——适配碎片化日程吗？核心任务能拆成 15–30 分钟原子动作吗？如需要整块大段时间，标记「高风险」；③ 安全合规约束——涉及内部数据 / 涉密信息 / 安全红线吗？但凡涉及，不建。——这是数字人格说明书定下的铁律：从最迫切的小痛点切入，先明确约束，再做弹性分步执行。

四问快筛（任一不过关 → 不建，理由记一句存档）：

> 默会知识特别提醒（针对 Q2 的深化）：Q2 问的是「对话能不能做」，但更深层的问题是——这个流程的核心，依赖的是可文字化的显性知识（操作步骤、规则、模板），还是依赖个人判断的默会知识（只能靠经验、难以言传的部分）？skill 能封装的只有显性知识；如果 50% 以上核心价值来自默会知识，skill 做出来也只是空壳——产出「像模像样但差得远」的东西。参考判例见 references/decision-gate.md 默会知识维。

六维评估（四问过了，再打分；全绿才开建）：

判决：全绿 → 开建；有黄灯 → 先补短板再建；有红灯 → 不建。

> 反例库与详细判断话术见 references/decision-gate.md——里面记着真实踩过的坑。同类 skill 的边界划定参考见 references/boundary-guide.md（查重三步法 + 6 个真实案例）。建前先定位 skill 类型，不同类型判断标准有微妙偏移，见 references/skill-type-taxonomy.md。

二、架构选择：放哪层？

建之前先定归属，避免重复造轮子：

规则：改通用规则只改共享层一处，所有引用方同时受益；发现 skill 里出现与共享层重复的内容 → 删除并改为引用。

> 不同 skill 类型（写作/工具/分析/互动/转换/元技能）的设计重点和常见坑各不相同，建之前先按 references/skill-type-taxonomy.md 定位类型，用对模板。

三、设计规范：怎么建？

> 三线自查（v1.4 新增）——设计任何 skill 前的总纲：源自公众号诊断助手四版本演进（v2→v3→星友版→号脉诊断）的方法论提炼。动手前先过三线，确保考虑周全、产出丰富：
> - ① 个性化（人性化线，源自星友版）——让 skill 懂人：防御性设计（预设用户会怎么用、怎么问、在什么状态下来——困惑/焦虑/忙，提前接住）、情绪感知（理解用户状态，匹配语气与节奏）、门槛适配（材料不足/场景不完整也能给出可用产出，而不是直接拒绝）、执行脚手架（不只给结论，给「下一步具体能做什么」）、复诊机制（用完能回来续：迭代、再问）。
> - ② 工程化（工程化线，源自号脉诊断）——让 skill 靠谱：输出规范外部化（规范写进 references，不靠临场发挥）、发表前校验（铭牌/脱敏/信源自查清单）、双格式交付（MD 全文 + HTML 可视化，手机可看）、触发词完整（第一句做什么 + 触发短语 + 不适用边界）、CHANGELOG 版本可追溯。
> - ③ 能力提升（能力扩展线，源自 v2→v3）——让 skill 变强：单功能→多模式（1 种服务模式扩展到 5 种：诊断/对比/学习/视角/深度剖析）、深度分层（浅到深的能力档位）、材料门槛弹性（分级适配）；吸收合并须名实相符——声称并入的能力必须逐项验证（教训：号脉诊断声称合并星友版防御设计，正文实际未并入，名实不符）。
>
> 应用时机：设计阶段三线自查 + 契约卡；交付阶段双格式 + 校验 + 脱敏；迭代阶段按线逐条升级、合并时逐项验证。

0. 契约卡先行（v1.2 新增）：开发前先填五字段契约卡（能力边界/输入示例/输出格式/安全边界/触发词），模板见 references/design-contract.md。填不清 → 需求没想透，先回去想。输出格式字段同时考虑双形态：零外链 HTML 展示版（手机可看）+ 可编辑 docx/pptx 交付版（正式交付）。
1. 流程 Step 化：每步写清楚「输入 / 处理规则 / 输出」，像写技术方案一样写 skill。用 Phase/Step 编号，标题串起来就是操作链。
2. 输入校验第一道闸门：skill 的第一步永远是检查输入是否齐备（如：新闻映射器缺新闻源/个人画像不启动）。缺 → 追问补齐；用户说没有 → 继续但输出末尾标注局限性。
3. 确认门机制：长流程在关键节点（结构构思、方案定稿）先把方向简述给用户确认——「我想从 XX 写起，落到 XX，对不对？」——避免方向错了全文返工。
4. 触发词设计：description 必须完整——第一句说做什么，中间列具体触发短语和意图关键词，最后说不适用边界。空 description = 触发失效（高考系列 7 个 skill 曾因此成隐患）。触发用语收敛（v1.12.0 调整，源自 zsxq-topic-archive 上架 ima 失败复盘 + 小张 2026-08-26 明确要求，由 ≤3 放宽为 ≤5）：触发指令实例 / 触发用语（铭牌「触发指令实例」清单 + description 触发短语）一律 ≤5 条，选最高频、最口语化的典型说法，不堆砌同义说法——过多触发语既稀释触发精度，也常在平台上架内容审核时显得像广告堆词。配套每个 skill 写 1–2 句「可直接复制使用」的任务句（即契约卡的输入示例）——口语化、真实场景，用户拿来就能用（借鉴 WorkBuddy 清单文的「你可以这样用」引用块，v1.2 补）。
5. 质量自查（创建/修改后必做，见 references/design-spec.md 完整清单）：
   - frontmatter：name 为 kebab-case ≤64 字符；description 含触发条件 + 不适用边界
   - SKILL.md ≤400 行；超长内容拆 references/
   - 无 [TODO 占位符残留
   - 至少 2 个工作流示例（覆盖典型场景）
   - 长流程有确认门
   - 【v1.1 新增】信源完整性核对：依赖外部权威信息（法规/榜单/清单/统计/官方类案）的 skill，出厂前必走——版本对齐、原文逐字、编号一致、多源交叉、时间戳。反例参考 design-spec.md「五-13」反诈识别器 v1.0 的三个漏检案例。
6. 长内容拆 references/：SKILL.md 只留主线流程，详细清单、模板、话术放 references/ 按需加载。
7. 个人印记：写作类风格、不说教底线、脱敏规则——写作类放 style.md（共享），非写作类引用 conventions，不各自复制。
8. 数据结构与规则显式化（v1.3 新增）：工具/效率类 skill 在契约卡之后、写流程之前，先 ① 显式定义数据字段模板（如 FocusFlow 任务字段：title/domain/priority/due/focus_units[]）；② 把业务规则写死进 skill（分诊启发式、排序规则），不靠模型临场发挥。关键纪律：每个可执行单元必须有「完成边界」（验收标准）——禁止「推进一下」「优化一下」这类无法验收的动作；任务模糊先补「澄清任务边界」单元。详见 references/design-contract.md。
9. 出厂审计与发布标准（v1.7 新增，源自 know-thyself 全流程实践）：开发完成后的发布前四步——
   ① 过四查（用 skill-audit v1.1）：G合规与侵权（原创/引用/争议表述温和化）/ H重复与冲突（库内查重+边界分工声明）/ I受众与门槛（大白话翻译表+三档上手路径+速览版优先）/ J价值观与能量（正面能量+点到为止+说教检查+用户自主权声明）
   ② 降门槛三件套：大白话翻译表（术语→人话）、适合谁·三档上手（5分钟入门/10分钟进阶/15分钟高阶）、默认先给速览版
   ③ 温和化检查：制造焦虑的表述补积极出口（「边界客观，但你能做的是……」）；审判感表述加引导语（「帮你看清，不是审判你」）
   ④ 开源打包：脱敏复查（grep 敏感词）+ README（含免责声明+作者=开源贡献者）+ zip 打包
   参考判例：know-thyself v1.0→v1.4（双用途定位→材料驱动→出厂审计降门槛），完整过程即本标准的来源。
10. frontmatter 五字段（v1.8 新增）+ ima 七字段（v1.8.2 补充）+ 打包合规（v1.11.0 补充）：所有 skill 的 SKILL.md frontmatter，除 name/description 外，必须包含五字段：slug（短横线小写标识符，如 hello-skillhub-zhangsan）、displayName（展示名）、version（语义化版本，如 1.0.0）、summary（一句话简介）、license（开源许可证，如 MIT）。字段缺失或取值无法确定时（尤其 slug/displayName/license），必须先问用户决策再定，不擅自填写——这是对外发布的前置条件，防开源后标识冲突与许可争议。ima SKILL 平台上架硬校验七字段：ima 平台除五字段外硬性要求 name（与 slug 同值，表单「名称」栏数据源）与 description（平台自动生成「使用说明」的数据源），缺则校验不通过；SkillHub 平台五字段即可——不同平台字段要求不同，发布前先确认目标平台规格（2026-08-24 台风/反诈/选型参谋三技能上架 ima 反复报错实战教训，详见 skill-audit v1.3.2）。打包合规（2026-08-26 zsxq-topic-archive 上架 ima 失败复盘固化）：① 包内禁止夹带平台发布产物——SkillHub 发布过的目录会残留 _meta.json（含 ownerId/publishedAt 等平台元数据），直接拿同款 zip 传 ima 会被当冗余文件处理，发布前删净；② 正文中文语境禁用 ASCII 双引号 "——除代码块/命令行参数（如 --params '{"count":30}'）外，正文一律用中文引号「」或“”，避免渲染歧义与审核误判；③ 文件名全部纯 ASCII；④ 上传前用脚本复核 frontmatter 可 yaml.safe_load。
11. 零外链与供应链安全（v1.8.1 新增，2026-08-24 固化）：① 零外链——自建 HTML / 工具 / skill 引用默认零外链（不引入任何外部库 / CDN，除 CDN 白名单明确放行）；交付的 HTML 报告内联 CSS/JS/SVG，双击即开，不依赖网络。② 供应链先审后装——安装任何第三方 skill / CLI / 依赖，先审计脚本与源码（拒绝直接 curl | bash / irm | iex），验证签名/校验、关闭自升级与 telemetry 上报后再装；第三方技能一律走「找→审→装→造」链的「审」环节（见判断门前置）。这两条作为 skill 从开发到发布的全程通用约束，非仅发布环节。
12. 小步单点迭代铁律（v1.9.0 新增，源自 renjing 实战）：每个 skill 的版本迭代遵循「单点突破」——① 每版只加 1 个聚焦能力点（如 v1.5 证据金字塔 / v1.11 红线 / v1.15 笔记导入），不一次性大改，每版可独立验证；② 版本号严格递增（语义化 v主.次.修，+0.0.1 或 +0.1.0，不跳号），frontmatter version 与铭牌同步；③ CHANGELOG 每条 ≤20 字且写明设计来源（「设计来源：<哪份报告/需求/灵感>」），SKILL.md 顶部标注「每版 ≤20 字，简洁可追溯」；④ 更名单独成版（改 displayName 单独成版并在记忆登记）。与「P1+P2 一站式联推」不冲突：单点指独立能力增量的粒度，P1+P2 指关联增强一起发。源自 renjing（以人为镜）v1.0.0→v1.15.1 一日 16 版实战，经本制造机 v1.9.0 固化。
13. 验收清单前置 + 证据分层（v1.9.0 新增，源自 renjing 实战）：① 验收清单前置——用本制造机造出的每个 skill，在新建/重构/升级交付前必过 references/acceptance-checklist.md 的 16 项清单，逐项打勾，不过不交（与 design-spec.md 质量自查互补：本清单偏版本交付兜底，design-spec 偏结构质量）；② 证据分层纪律——任何涉及外部资料/信源/他人内容的分析类 skill，出厂前必走 references/evidence-layering.md：证据金字塔 L1 本人发声 > L2 本人整理 > L3 旁人记述（仅旁证），主要结论以 L1 为准、L3 必标注，资料有多少分析多少、不编造不硬挖。源自 renjing v1.0.0→v1.15.1 实战，经本制造机 v1.9.0 固化。
14. 发布闸门：审计通过≠可发布（v1.9.1 新增，源自小张 2026-08-25 要求）：skill-audit 审计通过只是「及格线」，不是发布许可。发布前还须额外闯过三道硬前置，任一不达标就回炉继续迭代，绝不审计一过就发：① 多轮迭代——同一 skill 至少经过数版打磨（按第 12 条单点迭代节奏），非一次成型即发；② 实测跑通——用真实输入跑 1–2 个完整用例，输出可用、无报错、边界正确（红线命中按 Phase 0 拒绝、降级路径生效）；③ 元数据打磨——displayName / summary / description 标题简介经推敲，第一眼说清「价值 + 边界」，不凑合。三道全过才走发布流程（第 9 条四步 + --dry-run 预检）。源自小张 2026-08-25 明确要求：光审计不发布，要多迭代几次、测试跑通、打磨简介标题之后才能发布。
15. 技能族治理：建 / 更名 / 分裂前先解耦（v1.10.0 新增，源自 2026-08-25 三技能解耦实战）——同一引擎 / 同一对象 / 同一场景的技能构成「技能族」，族内必须互不相同而非互补或互有侧重：
    - ① 同族识别：新建 / 更名前先盘点同族（同引擎马甲 / 同对象 / 同场景），用「对象 + 问题」四问定位——对象是行业还是人？回答哪类问题？输入输出是什么？触发词是什么？四问答不出区分的，说明不该分裂；
    - ② 更名手术六件套：更名 = ① 定位解耦声明 → ② displayName/slug 更新 → ③ 目录名对齐 slug → ④ 正文引擎按新定位重定向 → ⑤ 触发词分流（族内一意图一命中，不适用边界注明「XX类问题归XX技能」）→ ⑥ 旧 slug 平台下线。六件缺一即残留；
    - ③ 名实一致：summary/description 声明的能力必须与正文实际能力一致——声明「行业情报」正文就做行业情报，不写做不到的；
    - ④ 版本继承：同源分裂时新技能版本号从母体继承（不重复 / 不倒挂 / 不跳回旧号），CHANGELOG 标注血缘（如「自 XX v2.0.0 分裂」）。
    - 参考判例：2026-08-25 千行百业图鉴 / 以人为镜 / 职业思维拆解器三技能同源解耦——一引擎三马甲（正文几乎相同、仅定位声明不同、触发词撞车），解耦为：图鉴 = 行业情报 + 职业思维解读、以人为镜 = 全人解读、拆解器删除；图鉴更名后旧 slug mindset-extractor 未下线即「更名残留」实例。
16. 小白类用户向数据抓取/导出 skill 硬标准（v1.12.0 新增，2026-08-26 固化）：凡做用户向、小白类、帮用户处理工作软件抓取数据/导出 的 skill（豆瓣归档 / 社区平台导出 / 网盘盘点等），默认按统一硬标准执行——①集中式「坑清单」（单列一章，罗列平台/工具最易翻车的真实坑，不散落）；②「小白用户指导（第一次用也能跑通）」（单列一章：零基础启动清单 + 卡点自救话术 + 术语速查）；③出厂铭牌含「触发指令实例」+「数据/经验来源」（≤5 条高频触发句 + 真实来源标注）；④确认门 / 隐私脱敏 / 耐心红线 / 边界 / CHANGELOG 五件套齐备。范本：zsxq-topic-archive（SkillHub 已发）；已落地：douban-archive v1.4.4 / netdisk-audit v1.1.0。
17. 对外发布去敏感检查（v1.15.0 新增，2026-08-27 固化，任何 skill 发布/重发前必过）：凡要上架 / 重发 / 概述异常的 skill，制造完成后整包扫描（SKILL.md + README.md + references/ 全部 .md），命中即去敏后再发——① 必去清单：领导人姓名职务 / 官方部门名（各类部委与专项机构 → 泛化「主管部门/官方渠道」）/ 官方文件全名与文号 / 官方网址与热线（政府域名、官方热线 → 泛化「官方门户/官方热线」）/ 个人知识库名与 kb_id（场景库名、政策库名等 → 中性化「融合多方公开资料与实战经验」）/ 真实地名与脱敏映射表（发布包剔除映射文件）/ 具体案例细节（台风名、事件地名 → 泛化）/ 真实 IP 全名（→ 统一发布人设名「海边小张」）；② 概述（description/summary）规范：概述异常/丢失时重写——重点说用法和用途 + 说清局限性（不替代/不预测/不编造、依赖联网、地域精度、启发式非专业等），不引领导人/部门；③ 重发流程：审查 → 去敏 → 简化省略 → 按本地存档重写 → 版本 bump（习惯 minor+1）→ --dry-run 预检 → 发布 → 等审核（pending→listed）；④ 全量体检**：定期拉本人线上清单（dashboard API），本地全量扫敏感词，有问题的逐个修复重发。源自 2026-08-27 disaster-response-assistant 概述异常实战，与永久记忆「对外发布去敏感规范」、skill-audit v1.8.0「A+++++」对齐。

18. TRACE 官方评测体系创作约束（v1.18.0 升级，2026-08-27 固化，创作期就按平台评分标准写）：SkillHub 平台官方以 TRACE 评测体系评价已上架 skill（T 可信任度 / R 可靠性 / A 适用性 / C 规范性 / E 有效性，5 分制，目标 ≥4.7）。TRACE 是一条评估链路：Trust 解决「能不能放心用」→ Reliability 解决「能不能稳定用」→ Adaptability 解决「该不该在这个场景用」→ Convention 解决「能不能被理解、维护和复用」→ Effectiveness 回到「用了以后问题是否真的解决」。设计阶段就要把失分点写掉，别等发布后被平台扣分再返工——五维 15 子项与好坏范例见 skill-audit v2.1.0「Step 3.6」；创作期强制落实四项最高杠杆（全库 30 技能实测结论）：
    - ① 可靠与容错三件套（R 可靠性 errorHandling/stability 失分主因）：SKILL.md 必须含「输入格式说明」（用户该发什么：文字/链接/照片/文件？）、「调用方式说明」（多轮对话/文件上传/API 是否支持？）、「纠错兜底」（输入模糊/矛盾/模型跑偏时怎么拉回？）——契约卡输入示例字段同时补这三种说明；
    - ② 目标用户明示「给谁用」（A 适用性核心）：description/summary 第一段必须点名目标人群（「面向 0-12 岁孩子的家长」「给大一到大四学生」「帮家有长辈的子女」），禁止「给所有人/老少皆宜/适合任何人」式过宽表述——客户读到第一段就该对号入座；
    - ③ 反模式 FAQ（C 规范性 antiPatternFaq 全库最低 4.10）：单列「常见坑 / 别做什么 / 典型误用」清单节，与小白类硬标准的坑清单同源合并；
    - ④ 触发方式「一句话能命中」（A 适用性 trigger 子项 4.59）：description 触发短语给 3-5 条最高频口语说法 + 正文给 1-2 条「可直接复制」任务句；触发词 ≤5 条（第 4 条规则，勿堆砌）。
    - ⑤ 信任与本土化（T 信任 domestic 4.94）：默认中文交互、不依赖海外 API、不做与任务无关的高权限请求；安全红线由平台硬扫描兜底，但创作期就避免嵌无关文件。
    - 判定基线：五维子项均值（全库实测）——boundary 4.73 / trigger 4.59 / antiPatternFaq 4.10 / docQuality 4.39 / progressive 4.50 / structure 4.69 / accuracy 4.68 / completeness 4.67 / creativity 4.65 / usability 4.56 / errorHandling 4.11 / func 4.64 / stability 4.16 / domestic 4.94 / scan 5.00；任何子项预期 <4.5 即发布前必修。

19. token 经济性（省 token / 省积分，2026-09-03 新增，源自知识库建设实战经验第八章）：skill 的设计与产出都要替用户省 token、省积分——这是「零成本」协作铁律在 AI 用量上的延伸。设计期就要落实工程纪律，使用期还要教会用户怎么用才省：
    - 设计期（让 skill 本身省）：① references 按需拆分加载（SKILL.md 只留主线，长清单/模板/话术进 references/ 免占上下文）；② 检索带 scope（知识库查询显式限定文件夹/标签，不整库扫）；③ 长文先出大纲/摘要再深入（大文件用 get_outline 替代 get_content，>1MB 易 -32603 i/o timeout）；④ 产物可复用（AI 产出存回知识库/文件，下次直接调用不重生成）；⑤ 会话边界清晰（一事一对话，旧上下文不滞留）。
    - 使用期（教用户省）：在 skill 使用说明/引导里提示——先想后问一次问清（背景+任务+要求）、限制输出长度（100字内/只列3点/表格）、少喂精喂（一次1-2篇最相关，先摘要）、用编号定位（「看03文件夹第2篇」）、复用已有成果、打包处理（批量一次跑）。口诀：资料少喂精喂 · 问题一次问清 · 输出限长 · 库存瘦身。
    - 整体省钱六招（用户侧）：先用免费额度 / 订阅前算账（月费÷次数=每次成本）/ 能搜不调AI（搜索引擎免费）/ 知识库替你省钱 / 轻活用小模型 / 打包处理。
    - 平台级省额度技巧（工具侧）：自动化任务注意 API 每日额度上限、拆批按天跑、防僵尸进程烧额度；精准检索替代全文读取；Python 依赖隔离到托管运行环境。

四、使用规范：怎么用？

• 触发即加载：description 里的触发词是入口。设计时想清楚「用户会怎么说」，用词贴近真实口语。
• 任务句配齐（v1.2 新增）：每个 skill 至少 1–2 句可直接复制使用的任务句（契约卡输入示例），降低行动门槛——用户不琢磨「怎么问」，拿来就发。
• 分层输出：按场景选档位——对话速览（轻量）、HTML 报告（重交付）、精美卡片（手机可看）。默认先给速览，用户要深度再升级。
• 有用性校验四问（每次产出前自问）：读者/用户读了能得到什么？有具体可操作的吗？接地气吗？说不清用处就回改再输出。
• 脱敏实时校验：涉及作者个人经历/工作信息时，按 xiaozhang-conventions 脱敏规则执行（地理、行业、个人信息三级保护）。
• 触发场景配置：常用 skill 可配置进特定知识库场景（如新闻映射器配置进某个场景知识库），也可写进 agent_md/soul_md 让对话中自动识别意图——即使用户没明说，表现出意图就主动问一句。

五、维护规范：怎么活？

一个 skill 有完整生命周期——构思→创建→注册→首次使用→迭代→日常使用→闲置→废弃。每个阶段的关注点和操作不同，见 references/lifecycle.md。

节律

• 每月一次技能审计（或新 skill 积累 5+ 个时触发一次）
• 每次重注册后复检脱敏与内容——ima_skill_create 可能还原旧副本（曾还原出含真实地名的版本，且实测 v1.2 升级时文件被还原回 v1.1），重注册后必须复核文件内容是否保持最新，再按脱敏校验流程复核

审计清单（按序执行）

1. 分类统计：工作/写作/育儿/高考/个人成长/娱乐六大类，看结构是否失衡
2. 冗余检测：同名 / 同功能 / 同载体（公众号诊断 4 个、养老 2 个、微信读书 2 个的教训）
3. 空描述检测：description 为空 → 触发失效，立即补全
4. 缺失分析：最近痛点爆发但库里没有对应物 → 优先建（备件验收、移动工具当年就是这么补上的）
5. 闲置识别：识别「兴趣化石」——某阶段兴趣的产物，占位置增匹配噪音 → 标记或归档，不占活跃位
6. 咬合度检查：对照三个维度的真实需求——职业发展（提效/考核/晋升）、家庭生活（育儿/养老/陪伴）、个人价值（写作/IP/成长）——看技能库是否偏科、是否有 skill 已经跟当前人生阶段脱节了。技能库不是目的，是手段；手段脱离目的 → 该裁就裁。

清理原则

• 备份再删（先复制到备份目录或确认无引用）
• 一组冗余留最强：留最新版 / 最完整 / 最常用，其余删或归档
• 合并优于删除：功能重叠但各有差异化能力 → 合并保留差异化
• 垃圾残留随手清：__MACOSX 类压缩残留目录直接删

六、开发协作协议（六步五法，v1.5 新增）

适用范围：与 AI 一起开发软件/网页/SKILL 等工具时，全流程必须遵循的协作铁律。原文见 references/collaboration-protocol.md（与 agent_md §10 同源同步）。

六大高频 Prompt 速查模板：

五条实操心法：① 🚩需求讲清楚（模糊需求最容易翻车，不要让 AI 猜）② 先沟通，后动手（先确认规划，再进入执行）③ 🚩拆小步，走一步验一步（一次只做一小段，做完再继续）④ 看不懂就问（所有技术词汇都可以要求 AI 用大白话解释）⑤ 流程写下来（文档化流程是 Agent 最好的执行说明书）。

人机协作交互红线（v1.8.1 新增，2026-08-24 固化）：与用户协作开发任何 skill / 网页 / 工具时，默认遵守其交互偏好——① 多方案 A/B/C 快速拍板 + 指定推荐项：给选项默认列 A/B/C 三选一，主动标出推荐项（如「推荐 A」），让用户快速拍板，不绕圈、不堆开放式问题；② 中文回复 + 结构化表格 + 明确风险/审计结论：分析类、规划类、复盘类产出用中文、用结构化表格，并明确给出风险判断或审计结论（A/B/C/D 或红黄绿）；③ UI 标签中文显示：即便界面是 English，主题 / 栏目 / 频道 / 按钮等 UI 标签也保持中文显示；④ 不展示思考过程：除非用户主动问「你怎么想的 / 为什么」，否则直接交付成品（图/文件/结论），把互动体验交给产物本身，少铺垫、少自报步骤。

迭代节奏：P1+P2 一站式联推（v1.8.1 新增，2026-08-24 固化）：用户的迭代偏好——倾向 P1（核心）+ P2（增强）一次性联推，避免分阶段确认拖慢节奏；多方案（A/B/C/D 或上中下三策）快速拍板并主动指定推荐项。落进协作节奏：能一站式联推的关联改动（如补五字段 + 写记忆 + 更新多 skill）不分两轮来回；但对外动作（发布/提交）与破坏性操作（删/覆盖/批量改）仍必须先确认（不与此偏好冲突）；心法③「拆小步走一步验一步」聚焦开发执行内部的原子动作，与「对外发布前确认」不矛盾。

执行流水线：①需求收束（等确认）→ ②拆真源文档（做什么/不做什么/怎么验收）→ ③开工框定（只做当前子阶段）→ 执行 → ④阶段验收三问（汇报等确认）→ ⑤守底线检查（动基盘前必查）→ 下一子阶段（回到③，严禁跳步）→ 完成 → ⑥大白话总结。

任务判断：乔哈里视窗四象限（v1.6 新增，AI 适配版）

实战经验要点（v1.6 新增）

• 算法转说明书：复杂领域算法拆成逐步骤详细说明书喂给 AI → 分步生成代码逐步验证 → 🚩人发现 bug 后明确提示错误方向，配合 AI 共同调试（耗时最长阶段）。
• 复杂工程（piagent 审查项目）：Word 预处理防中文乱码、长文档截断拆分防上下文溢出、智能体流程全程可见可追踪、证据不足自动返回重新检索；piagent 可为老旧系统扩展智能体能力，自定义装载技能组件，兼具自主规划与稳定可控。
• 通用经验四条：需求文档先行 + AI 先出计划确认一致 / 代码模块化拆解分模块开发 / AI 自审计防偏差放大 / 重复标准化交 AI、复杂高风险人工兜底，一步一验证。

七、Skill 上新推介：介绍卡 + 群公告（v1.21.0 新增）

为已上架（或待推广）的 skill 产出「上新双件套」——一张可视化介绍卡 + 一段可直接发群的公告文案。最高纪律：内容以实际为准，不编造。

Step 1 · 信息采集与核对（先对后写）
- 首选抓取 SkillHub 线上页，取 displayName / slug / 版本号 / 简介原文；本地 SKILL.md 只作备用（线上版本可能更新）；
- 名称、版本、功能点逐项与实际对齐；发现线上标题与实际不符（如更名后未重发），主动提醒用户改 frontmatter displayName 后重发；
- 用户给了参考图时，仿版式不抄内容——版式学它，信息用核实过的。

Step 2 · 介绍卡（自包含 HTML）
- 零外链单文件：内联 CSS，不引外部库/CDN，双击即开；浅色背景 + 深色文字，UI 标签全中文；
- 版式骨架见 launch-card-template.html：渐变大标题 + 日期徽章 + 右侧上架胶囊 → 双卡（编号 / 名称 / 英文副标 / 标签行 / 简介加粗要点 / 灵感黄框 / 地址行）→ 底部「一看懂差异」对比条；
- 「灵感来自」句要与技能定位对得上，交付前请用户确认——灵感句是唯一允许的软性文案，其余必须硬核实。

Step 3 · 群公告文案
- 固定开头：「各位群友，今日上新 / 继续上新 N 个 SKILL，均为开源版本，欢迎试用~」
- 条目格式：名称 —— 一句话核心功能：具体列举，落点一句 🔗 地址 （灵感来自具体场景）；每条 ≤2 行，落点句要能被转述（如「结论一句话能转给家人」）；
- 交付时附核对说明：哪些字段取自线上、哪些是软性表述，不合适用户直接改。

边界：本流程只产出介绍物料，不代替 skill-audit 审计与发布流程；未经用户确认不发群、不发布。

工作流示例

示例 1：从痛点/跑通流程 → 新建 skill

备件验收反复录入几十项设备信息 → 判断门四问全过（反复出现/对话做不了/库中无/长期刚需）→ 六维全绿 → 立项：先建需求文档（知识库地基）→ 设计 Step 化流程 → 质量自查 → 注册 → 复检脱敏。同理可套：工厂日记闭环、新闻影响映射、品味诊断师。

示例 2：从使用反馈 → 迭代 skill

时光机·人生录像带发布后实际体验 → 反馈「玩法单调/怕扒隐私」 → 升级六大玩法引擎 + 隐私友好模式 + 交付物升级「时光卡」+ 攒卡解锁机制 → 自查 → 重注册 → 复检脱敏。同理可套：taste-profiler 加亲子模式、gzh-visual-reader 从 PPT 转向 HTML 精读页。

示例 3：从管理方法 → 效率类 skill（FocusFlow 五步法，v1.3 新增）

腾讯员工从「待办太多、下一步太模糊」的痛点出发：① 定义数据结构（任务字段模板）→ ② AI 任务分诊（拆专注单元，每个单元必须有完成边界）→ ③ 规则排序（优先级 > 截止 > 耗时 > 创建）→ ④ 日报周报持续优化 → ⑤ 生成 Skill 安装使用。核心启示：效率类 skill 的价值是「减少开始前的犹豫」——把分诊/排序这类反复脑内判断交给规则，人只负责执行；多记录过程（能量/专注/中断）而不只记录结果。同理可套：备件验收、倒班排程、育儿日程。

输出格式要求（强制）

本 skill 的所有产出至少提供以下两种格式：

1. Markdown 文件（.md）：结构化、可编辑、可版本管理
2. 可视化 HTML 报告（.html）：蓝调/圆角卡/风险色条可视化（参考 xiaozhang-conventions/references/delivery-html.md），移动端响应式

文件命名约定：
- Markdown：/sandbox/workspace/outputs/<skill名>/YYYYMMDD_<标题>.md
- HTML：/sandbox/workspace/outputs/<skill名>/YYYYMMDD_<标题>.html

补充规则：
- 若用户明确要求 PDF，用 libreoffice --headless --convert-to pdf 转换 HTML 后提供
- 长报告同时提供 Markdown 全文 + HTML 精读卡片
- 写作/文章类：成稿直接输出 Markdown + 渲染成 HTML
- 工具/检索/咨询类：除核心产出外，附一份「本次成果速览」HTML 卡片
- 发表前过一遍有用性校验（参考 xiaozhang-conventions/references/usefulness-check.md）

隐私脱敏与保护硬规则 v2.0-20260728

生效日期：2026-07-28，取代此前所有隐私相关规则，适用范围为本空间所有Skill/知识库/笔记/记忆及对话处理流程。

使用本技能时，若用户透露以下各类信息，即使用户直接陈述，也绝不记录到任何持久化存储中，应当直接忽略、不追问、不确认、不重复：

零、地理与行业脱敏（硬性规则）

• 禁令：不可在内容或输出中还原真实地名与行业字样
• 本规则与下文个人信息三级保护规则并列执行，优先级相同

一、受保护属性（①类，永不记录）

种族、宗教、性取向、性别认同、移民身份、残障、工会会员

二、敏感信息（②类，永不记录）

②-0 基础类：政治倾向、性经历、受虐史、财务细节、健康数据、犯罪史、心理画像
②-1 家庭与社会脆弱性：家庭成员重大疾病史/遗传病史、未成年子女就读学校全称及班级、紧急联系人姓名+关系+手机号（三项同现即触发）、低保/扶贫/残疾人补贴领取记录
②-2 劳动与收入细节：工资条照片/银行流水截图/考勤打卡记录、工伤保险/意外保险理赔详情、土地承包权/宅基地使用权属证明编号

三、可识别信息（③类，永不记录）

③-0 基础类：身份证号、驾照、护照、信用卡、银行账号、实时位置、出生日期、手机号码、常用电子邮箱
③-1 生物特征与物理标识（三项独立触发）：人脸识别底图/指纹纹路/声纹/虹膜扫描数据、血型/基因序列片段/基因检测结论、车辆号牌
③-2 地址与活动轨迹：家庭住宅详细地址（精确至门牌号/楼层/栋号）、日常通行规律、常用收货地址
③-3 证件与账户扩展：职业资格证书编号、学生学籍号/准考证号、低保户/贫困户/残疾证编号、社交平台唯一ID+真实姓名组合

四、运行时输入检测与判定（硬性补充规则）

• 4.1 检测与拦截：对话/上传/记录时主动检测，命中则拒绝记录，不追问不确认不重复。可调用 privacy_detect.check_text() 辅助
• 4.2 组合触发：非敏感字段≥2项同现视为敏感
• 4.3 未成年人专项：未满18岁自动上调一级（③→②，②→①）
• 4.4 老人专项：65岁以上用药/活动规律默认②类
• 4.5 等级冲突处理：上调后与原分类冲突时以更严格等级为准

五、版本与生效声明

• 版本号：v2.0-20260728 | 生效日期：2026-07-28 | 替代声明：取代此前所有版本隐私相关规则

> 完整检测规则详见 xiaozhang-conventions/scripts/privacy_detect.py 和 references/desensitization.md。

出厂铭牌

免责声明

本 skill 是方法论层面的指导框架,不保证按其流程创建的每个 skill 都能达成预期效果。skill 创作是高度个性化的工作,具体应用时需结合使用者的具体领域、技术能力、资源条件灵活调整。如有疑问或冲突,以 references/ 下各专项文档为准。

作者与联系

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

更新日志（CHANGELOG）

• v1.21.0（2026-09-07）｜displayName 更名「技能工坊 · Skill 全流程制造机」（slug 不变）；新增第七章「Skill 上新推介」——介绍卡 + 群公告双件套（模板 launch-card-template.html），最高纪律「内容以实际为准，不编造」。设计来源：2026-09-07 广东小张的Skill百宝箱 + AI 需求全案参谋上新实战。

• v1.20.0（2026-09-05）｜核心原则新增第 9 条「价值观底盘」：IP 统一（海边小张）/ 受众锚定（普通人与底层劳动者、老人孩子权益安全健康优先）/ 延续一致·功能重叠≤10% 红线 / 跨 skill 联动与配套推荐 / 合并可行性+必要性双判 / 安全质量并重（一线运维底层逻辑贯穿：预防为主·纵深防御·风险常在不侥幸·安全第一·识别→预警→预案→响应快动手慢·有疑问澄清核实·追求卓越·外部经验反馈·代入自检）。源自小张 2026-09-05 总纲指示，同步进用户级 MEMORY.md。

• v1.19.0（2026-09-03）｜新增第 19 条「token 经济性（省 token / 省积分）」设计规约：设计期五条工程纪律（references 按需加载 / 检索带 scope / 长文先大纲 / 产物可复用 / 会话边界）+ 使用期用户引导（省 token 八法·整体省钱六招·平台级省额度技巧），口诀「资料少喂精喂·问题一次问清·输出限长·库存瘦身」。源自知识库建设实战经验第八章。同步开发手册 v3.2.0 + 审计 v2.3.0。

• v1.18.0（2026-08-27）｜设计规范第 18 条升级为「TRACE 官方评测体系创作约束」——按平台官方五维（T 可信任度/R 可靠性/A 适用性/C 规范性/E 有效性）评估链路创作，四杠杆扩为五项（新增信任与本土化），15 子项基线保留。源自 SkillHub 平台官方 TRACE 评测体系文档。同步审计 v2.1.0 + 开发手册 v3.1.0。
• v1.17.0（2026-08-27）｜设计规范新增第 18 条「SkillHub 官方评价五维创作约束」——创作期就按平台评分标准写（可靠与容错三件套 / 目标用户明示「给谁用」/ 反模式 FAQ / 触发一句话能命中），附 15 子项实测基线。源自 2026-08-27 SkillHub 全量 30 技能官方评价实测（仅 3 个 ≥4.7）。同步审计 v2.0.0 + 开发手册 v2.3.0。
• v1.16.0（2026-08-27）｜新增「零、开发前置条件：想清楚五件事」章节（判断门更前置关卡）：五问（用途/用户/场景/优势特色/积累）需求澄清表；⑤积累硬约束「先建库再建技能」（ima 知识库为第一步）；⑤-a 建库要耐心；⑤-b 用户有需求先引导搜知识库/知识号（对外去敏感不写具体名）。源自小张 2026-08-27 明确要求。同步审计 v1.9.0 + 开发手册 v2.2.0。
• v1.12.0（2026-08-26）｜①「触发用语 ≤3 条」规则放宽为 ≤5 条（小张 2026-08-26 明确要求，对齐 douban-archive v1.4.4 / netdisk-audit v1.1.0 已写的 5 条触发实例）；②设计规范新增第 16 条「小白类用户向数据抓取/导出 skill 硬标准」——此类 skill 强制含「集中式坑清单 + 小白用户指导 + 出厂铭牌(触发指令实例≤5+数据经验来源) + 确认门/隐私/边界/CHANGELOG 五件套」。源自小张 2026-08-26 明确要求固化统一标准。同步开发手册 v1.3.0 + 审计 v1.5.1。

• v1.11.0（2026-08-26）｜①触发词设计新增「触发用语 ≤3 条」收敛规则（铭牌触发指令实例 + description 触发短语一律 ≤3 条，源自 zsxq-topic-archive 上架失败复盘 + 小张 2026-08-26 明确要求）；②第 10 条 frontmatter 补「打包合规」四查（删平台产物 _meta.json、正文中文语境禁 ASCII 引号、文件名纯 ASCII、yaml.safe_load 复核，源自 2026-08-26 ima 上架实战：缺 name 字段 + 夹带 _meta.json + ASCII 引号三连挂）。同步 skill-audit v1.5.0 + skill-dev-playbook v1.2.0 + skill-lifecycle-playbook v1.5.0。

• v1.10.0（2026-08-25）｜设计规范新增第 15 条「技能族治理」——同族技能建/更名/分裂前先解耦（对象+问题四问定位、更名手术六件套、名实一致、版本继承），族内互不相同而非互补。源自 2026-08-25 图鉴/以人为镜/拆解器三技能同源解耦实战（一引擎三马甲 + 更名残留教训）。同步 skill-audit v1.4.0（H 维度扩展）+ skill-lifecycle-playbook v1.4.0（Step 3.5 更名专项）。

• v1.9.1（2026-08-25）｜新增第 14 条「发布闸门：审计通过≠可发布」——审计只是及格线，发布前须多轮迭代 + 实测跑通 + 元数据打磨（标题简介），三项任一不达标不发布。源自小张 2026-08-25 要求。

• v1.9.0（2026-08-25）｜吸收 renjing（以人为镜）v1.0.0→v1.15.1 一日 16 版实战范式，固化「迭代三板斧」为通用纪律：① 设计规范新增第 12 条「小步单点迭代铁律」（每版 1 能力点 / 版本递增 / CHANGELOG≤20 字 / 更名成版）；② 新增第 13 条「验收清单前置 + 证据分层」（每个 skill 交付前必过 16 项验收清单、分析类必走证据金字塔 L1>L2>L3）；③ 新增 references/acceptance-checklist.md（16 项清单）+ references/evidence-layering.md（证据金字塔）。自此制造机造出的每个 skill 自动带这三板斧。源自小张 2026-08-25 明确要求同步进制造机。

• v1.8.2（2026-08-24）｜设计规范第 10 条「frontmatter 五字段」补充 ima 七字段说明：ima SKILL 平台硬校验 name（与 slug 同值）+ description（自动生成「使用说明」的数据源），缺则校验不通过；SkillHub 五字段即可，发布前先确认目标平台规格。源自台风/反诈/选型参谋三技能上架 ima 反复报错实战教训（与 skill-audit v1.3.2 对齐）。

• v1.8.1（2026-08-24）｜固化 skill 开发通用要求，与 SOUL.md 2.1.1/2.2/2.5/2.6 对齐：① 设计规范新增第 11 条「零外链与供应链安全」——零外链硬约束（自建 HTML/工具不引外部库/CDN）+ 供应链先审后装（拒 curl|bash/irm|iex、关自升级与 telemetry），作为开发到发布全程约束；② 开发协作协议新增「人机协作交互红线」（A/B/C 快速拍板+推荐项、中文结构化表格+风险结论、UI 中文标签、不展示思考过程）+「迭代节奏 P1+P2 一站式联推」（对外/破坏性动作仍先确认）；③ 修正出厂铭牌滞后版本号（v1.6→v1.8.1）。源自小张 2026-08-24 明确要求固化。

• v1.6（2026-08-20）｜开发协作协议扩展：① 新增「乔哈里视窗四象限（AI 适配版）」任务判断法（务实区/潜在区/盲区/开发区——盲区必须设计验证实验防幻觉，开发区写详细说明书教会 AI）；② 新增实战经验三块：算法转步骤说明书 + 人机协同调试（计算工具项目：多几何建模/活度剂量率双维迭代/秒出结果）、piagent 复杂工程经验（招投标审查：Word 预处理防乱码/长文档截断拆分/流程可见可追踪/证据不足自动回溯重检/为老旧系统扩展智能体能力，主角为 piagent 非 AutoGen）、AI 开发通用经验四条（需求文档先行+计划确认/模块化拆解/AI 自审计/人机协作分工）。来源：2026-08-20 作者两个项目实践总结（计算工具 + piagent 质保招投标审查）。三处同步：本地源已更新 / 平台已注册（id 7491156187283901）/ 知识库副本 + agent_md §10 已补充。references/collaboration-protocol.md 由 4 章扩为 8 章。

• v1.5（2026-08-20）｜新增「开发协作协议（六步五法）」章节 + references/collaboration-protocol.md：六大高频 Prompt 速查模板（需求收束/拆真源文档/开工框定/阶段验收三问/守底线检查/大白话追问）+ 五条实操心法（需求讲清楚/先沟通后动手/拆小步走一步验一步/看不懂就问/流程写下来），适用范围为与 AI 一起开发软件/网页/SKILL 等工具的全流程。来源：2026-08-20 作者口述的协作铁律。与 agent_md §10 同源同步。同步出厂铭牌 + CHANGELOG。

• v1.7（2026-08-23）｜吸收 know-thyself 从0到1全流程实践（开发→合规审计→降门槛→温和化→边界分工→开源打包）：① 核心原则新增第 8 条「出厂审计与大众适配」；② 设计规范新增第 9 条「出厂审计与发布标准」四步（过四查/降门槛三件套/温和化检查/开源打包）；③ 说明 skill 是被动触发工具，设计时想清楚用户主动提问场景，重点服务有智能手机/电脑人群。来源：know-thyself v1.0→v1.4 开发审计全程（2026-08-23 会话）。同步 skill-audit v1.1 四查扩展审计。

• v1.4（2026-08-19）｜设计规范新增「三线自查」总纲（设计任何 skill 前的三线框架，源自公众号诊断助手四版本演进 v2→v3→星友版→号脉诊断的方法论提炼）：① 个性化（人性化线，源自星友版）——让 skill 懂人：防御性设计/情绪感知/门槛适配/执行脚手架/复诊机制；② 工程化（工程化线，源自号脉诊断）——让 skill 靠谱：输出规范外部化/发表前校验/双格式交付/触发词完整/CHANGELOG 可追溯；③ 能力提升（能力扩展线，源自 v2→v3）——让 skill 变强：单功能→多模式/深度分层/门槛弹性/吸收合并须名实相符（号脉诊断曾声称合并星友版防御设计但正文未并入的教训）。应用时机：设计阶段三线自查+契约卡；交付阶段双格式+校验+脱敏；迭代阶段按线升级、合并逐项验证。来源：公众号诊断助手（号脉诊断）四版本族谱对比分析（2026-08 会话）。同步出厂铭牌 + CHANGELOG + agent_md 三线自查框架。

• v1.3（2026-08-17）｜吸收「WorkBuddy 上班族入门指南」知识库 Skill 相关部分：① 设计规范新增第 8 条「数据结构与规则显式化」（工具/效率类 skill 先定义数据字段模板 + 写死业务规则，可执行单元必须有完成边界，禁止不可验收动作）；② 架构选择新增「知识库伴生型」场景（skill 挂知识库旁当导航员，kb_id 写进 skill，引用篇章 search+fetch 查证）；③ 工作流示例新增示例 3（FocusFlow 五步法：定义数据结构→任务分诊→规则排序→日报优化→生成 Skill）；④ capability-form.md 新增第 8 种能力形态「知识库伴生」+ 元技能形态补平台侧实证（find-skills/skill-scanner/self-improvement 对应找审装造+经验沉淀）；⑤ design-contract.md 新增「数据结构与规则显式化」章节；⑥ design-spec.md 自查清单加第 15 项。来源：FocusFlow 事务台源码（SKILL.md）、《「腾讯员工实践」手把手教你用 WorkBuddy 打造懂你的智能秘书》、workbuddy-onboarding 源码（SKILL-v1.3.md）、《WorkBuddy_职场提效应用实战》PDF。同步出厂铭牌 + CHANGELOG。

• v1.2（2026-08-17）｜借鉴 WorkBuddy Skill 能力设计（知识库《Skill能力设计借鉴.html》）：① 新增 references/capability-form.md（能力形态七类：浏览器自动化/文档底盘/演示三态/视频生成/前端落地/元技能/专业数据服务，与内容类型六类双维度定位）；② 新增 references/design-contract.md（五字段契约卡：能力边界/输入示例/输出格式/安全边界/触发词 + 知识封装范式 + 双形态输出 + 权限清单前置）；③ 核心原则 5 条扩为 7 条（加「先定型再填能力」「护城河在领域知识封装」）；④ 判断门加「找→审→装→造」元技能链前置（查重范围扩至外部技能市场）；⑤ 设计规范加第 0 步契约卡先行；⑥ 触发词设计补任务句要求、使用规范补任务句配齐；⑦ design-spec.md 自查清单加契约卡检查项；⑧ skill-type-taxonomy.md 补双维度定位说明。同步出厂铭牌 + CHANGELOG。

• v1.1（2026-08-10）｜新增「信源完整性核对」第 13 项自查清单（design-spec.md「五-13」+ lifecycle.md 同步）；新增内容：版本/批次对齐、原文逐字核对、编号/顺序一致、多源交叉、时间戳 5 个子项。反例教训：2026-08-10 反诈识别器 v1.0 出厂时漏检了 3 件事——编号跳号（漏 4）、四个新手法内容太薄、占比数据陈旧（21.8% 应为 25%）。SKILL.md 第 5 项质量自查加引用提示；同步出厂铭牌 + CHANGELOG。

• v1.0（2026-05-?）｜初始发布：核心原则 5 条、判断门四问、七维评估、架构三层、设计规范 5 步、12 项自查、月度审计 6 项、工作流示例 2 个。