企业官网建设流程全解析

62个技能如何被精准触发？Wondel.ai Agent Skills的description触发词与渐进加载原理揭秘

【免费下载链接】skillsWondel.ai Agent Skills — Business, Marketing, UX & Coding Frameworks from Bestselling Books. 50 skills + 12 guided journeys for Claude Code, Codex, Cursor & other agentskills.io agents.项目地址: https://gitcode.com/gh_mirrors/skills25/skills

Wondel.ai Agent Skills 是一个面向 Claude Code、Codex、Cursor 等 AI 编程代理的开源技能库，收录 62 个基于商业、营销、UX 与编程领域畅销书方法论的专家技能。当你对 AI 说一句"用户注册后就不回来了"，它如何瞬间选对技能、又只加载当下用得到的内容？本文带你拆解它的两大核心机制：description 触发词设计与渐进加载（Progressive Loading）原理。

🧩 技能的基本结构：一个文件夹 = 一个技能

在 Wondel.ai Agent Skills 中，每个技能就是一个独立文件夹，核心是一份带 YAML 前置元数据（frontmatter）的 SKILL.md 文件，外加一个按需扩展的references/参考目录：

--- name: hooked-ux description: 'Design habit-forming product loops using the Hook Model (Trigger, Action, Variable Reward, Investment). Use when the user mentions "users aren't coming back", "habit formation", "engagement loops", "habit zone", or "the manipulation matrix"...' license: MIT metadata: author: wondelai version: "1.5.1" ---

上面是 hooked-ux/SKILL.md 的真实前置元数据。字段规范在 CLAUDE.md 中有明确约定：

项目文档说得直白：description 字段对技能发现至关重要——它应该包含关键词和触发短语，帮助 AI 把用户请求匹配到对应技能。

🔍 description 触发词的三层结构

打开任意一个技能文件，会发现 62 个技能的 description 几乎都遵循同一套"三层写法"，这也是精准触发的核心密码。

第 1 层：一句话功能定位——告诉 AI"我是谁"

description 的开头先用一句话说明技能做什么、方法论出自哪本书。例如 jobs-to-be-done/SKILL.md 以"Discover what customers truly need by analyzing the 'job' they hire your product to do"开篇。这一层负责语义层面的粗筛。

第 2 层：Use when——把"用户会说的话"写成触发短语

这是最精巧的一层。description 会列出大量带引号的用户原话作为触发词：

• 习惯设计类："users aren't coming back"、"habit formation"、"habit zone"（来自 hooked-ux/SKILL.md）
• 代码质量类："clean up this code"、"this function is too long"、"code smells"、"boy scout rule"（来自 clean-code/SKILL.md）
• 战略类："customer discovery"、"why customers churn"、"milkshake moment"（来自 jobs-to-be-done/SKILL.md）

注意触发词的设计细节：它不写抽象概念，而是模拟用户真实会说的口语化表达——包括抱怨句式（"用户注册后就不回来"）、领域黑话（"habit zone"）和经典比喻（"milkshake moment"）。你的提问命中任何一个短语，匹配度就显著上升。

第 3 层：For X, see Y——负向路由，防止 62 个技能"打架"

技能一多，最怕"张冠李戴"。每个 description 的结尾都会声明边界，把相似场景指给兄弟技能：

"For friction reduction and B=MAP, see improve-retention. For viral sharing, see contagious."

意思是：如果你想做摩擦缩减（B=MAP 模型），别用 hooked-ux，去找 improve-retention；想做病毒传播，找 contagious。12 个元技能更遵循严格的"五句公式"，其中第 4 句专门做负向触发路由——例如 create-business/SKILL.md 明确写道："一旦你的业务已有付费客户，不要再用它，请改用 grow-business 或 improve-business"。这套互斥路由让 62 个技能像分诊台一样各守其位。

⚡ 渐进加载原理：为什么只加载"现在用得上"的内容

62 个技能、每个技能 5~10 个参考文件，总量数百份 Markdown。如果每次对话全量塞进上下文，token 立刻爆炸。Wondel.ai Agent Skills 的答案是三级渐进加载：

L3 的精髓在于**行内指针（inline pointer）**模式。SKILL.md 正文不是把参考资料一股脑堆在文末，而是在"用得到的那一刻"就地埋一个条件指针。模板规定见 CLAUDE.md：

See references/file.md when <situation> — <what it adds>

实际写法示例（jobs-to-be-done/SKILL.md）：

See references/innovation-process.md when running an innovation project end-to-end — the job-hunting methodology, the job atlas, and fill-in statement templates.

翻译一下规则：只有当你"要完整跑一遍创新流程"时，才去读那篇 2000 多词的方法论长文；如果你只是想写一个 job statement，SKILL.md 正文已经足够。以 lean-startup/SKILL.md 为例，正文埋了 10 个这样的条件指针，分别指向 growth-engines.md 等深度文件——需要哪篇读哪篇，互不干扰。

这套机制的收益很直观：日常问答几乎零额外开销；深度任务只加载真正相关的章节；跨会话状态则由元技能写入项目docs/目录保存（见 docs/ARTIFACT-REGISTRY.md），关掉对话再打开也能无缝续跑。

🧭 触发之后：元技能如何编排整个旅程

12 个元技能（create / improve / grow × business / website / app，外加代码质量类 3 个）是"技能编排器"。触发后它不会自己即兴发挥，而是按 Journey Map 逐阶段调用具体技能：比如 create-business/SKILL.md 的旅程地图把 jobs-to-be-done → mom-test → design-sprint → lean-startup 等 10 个技能串成流水线，每个阶段产出docs/CUSTOMER.md、docs/OFFER.md等工件，全部记录在案。

🚀 实用指南：让技能"一次就触发对"

1️⃣ 用触发短语说话。对照目标技能的 description，把你的问题往触发词上靠。例如问"怎么让用户养成每天打开的习惯"（对应habit formation），比问"怎么做用户增长"更容易命中 hooked-ux。

2️⃣ 不确定就直接点名。每个技能的 README 详情区都给了示例提示词，如"Design a variable reward system for our fitness tracking app. Use hooked-ux skill."——显式点名是触发率 100% 的保底方案。

3️⃣ 按需安装，别贪多。通过插件市场整包安装：

/plugin marketplace add wondelai/skills /plugin install product-strategy@wondelai-skills # JTBD、Mom Test、Negotiation 等 /plugin install metaskills@wondelai-skills # 12 条引导式旅程

想要 92 个可直接复制的场景化提示词，按创始人 / 产品经理 / 市场 / 设计等角色分类整理在 EXAMPLES.md；完整技能目录与各技能的 Use when 清单见 README.md。

📌 小结：三个带走的设计精髓

• description 是技能的"门牌号"：功能定位 + 用户原话触发词 + 兄弟技能负向路由，三层结构让 62 个技能互不串扰；
• 渐进加载省的是上下文：常驻的只有轻量前置元数据，SKILL.md 在触发后加载，references 由行内条件指针按需唤起；
• 指针要"埋在使用点"：不在文末列清单，而在需要的那一行写清"何时读、读完多得到什么"。

理解了这套机制，你不仅能让 AI 更精准地触发技能，也能在为自己的 Agent 编写 SKILL.md 时照方抓药。

【免费下载链接】skillsWondel.ai Agent Skills — Business, Marketing, UX & Coding Frameworks from Bestselling Books. 50 skills + 12 guided journeys for Claude Code, Codex, Cursor & other agentskills.io agents.项目地址: https://gitcode.com/gh_mirrors/skills25/skills