这篇是 AIHELPU Skills系列的触发机制篇。前面我们已经讲过 Skill 是什么、怎么安装、文件夹里有什么。这一篇专门解决一个最常见的问题：
| 我明明安装了 Skill，为什么 AI 从来不自动调用？ |
|---|
答案通常不在安装步骤，而在 Skill 的“入口信号”写得不够清楚。
先搞懂：Skill 是怎么被 AI 发现的
到 2026 年，OpenAI ChatGPT/Codex、Claude Agent Skills 以及通用 Agent Skills 规范，都在采用类似的思路：Skill 不是一次性把所有内容塞进上下文，而是分层加载。
可以把它理解成三层：
| 第一层：name + description | AI 先看到每个 Skill 的名字和简介，用它判断是否相关。 | 第二层：完整 SKILL.md | AI 判断某个 Skill 相关后，再读取完整说明、流程、输出规范。 | 第三层：references / scripts / assets | 只有任务需要时，才继续读取资料、运行脚本或使用模板素材。 |
|---|
所以，Skill 自动触发的第一关不是正文写得多漂亮，而是 `description` 能不能被正确匹配。
官方文档也把这个逻辑说得很明确：ChatGPT 和 Codex 会先读取每个 Skill 的 `name` 和 `description`，当任务和 `description` 匹配时，才可能隐式调用对应 Skill。也就是说，`description` 不是写给用户看的广告词，而是写给 AI 用的路由规则。
为什么 description 是触发核心
很多新手写 Skill，会把大量精力放在正文：
| 执行步骤写了 20 条 | 输出规范写了 5 层 | 参考资料整理了 10 个文件 |
|---|
但 frontmatter 里只写一句：
| description: 帮助提升工作效率。 |
|---|
这就像你在论坛发帖，标题叫“一个很有用的东西”。它可能真的有用，但别人不知道什么时候该点进去。
对 AI 来说也是一样。它要在一堆 Skill 里判断：用户这句话是不是该调用你。如果你的描述太空、太泛、太像宣传语，它就很难命中。
更好的写法应该包含三件事：
| 1. 这个 Skill 具体做什么 | 2. 用户在什么场景下需要它 | 3. 用户可能会用哪些词表达这个需求 |
|---|
自动触发的两种方式：显式调用和隐式调用
在 ChatGPT/Codex 里，Skill 通常有两种调用方式。
第一种是显式调用。你直接点选或提到某个 Skill，例如在 ChatGPT 里用 `@` 选择 Skill，或在 Codex CLI / IDE 扩展里用 `/skills`、`$skill-name` 这类方式点名。
第二种是隐式调用。你不点名 Skill，只描述任务，AI 自己判断是否该用。
| 显式调用：用户说“用这个 Skill” | 隐式调用：AI 判断“这个任务像这个 Skill 能处理的事” |
|---|
绝大多数“为什么不自动调用”的问题，都发生在第二种场景里。
如果你只是手动点名，它当然会尝试用。但真正好用的 Skill，应该能在用户自然表达需求时被识别出来。
Skill 不触发的 7 个常见原因
1. description 写得太泛
坏例子：
| description: 帮助用户写文章、整理内容、提升效率。 |
|---|
这类描述看似覆盖面很大，实际没有边界。AI 很难判断它适合论坛帖、公众号、日报、论文，还是产品文档。
改成：
| description: 整理 AIHELPU 论坛 Skill 工坊帖子。用户要求检查标题、分类、标签、母帖回链、上一篇/下一篇索引、参考资料或 Markdown 排版时使用。 |
|---|
这样 AI 能看到具体任务词：论坛、Skill 工坊、标题、分类、标签、母帖回链、Markdown 排版。
2. description 写得太像人类简介
坏例子：
| description: 一个资深 AI 内容运营编辑，擅长生产高质量内容。 |
|---|
这句话像角色设定，不像触发条件。AI 不知道什么时候该用它。
改成：
| description: 将 AI 工具、Agent、Skill、MCP 相关文章改写为适合 AIHELPU 论坛发布的中文帖子。用户要求润色、翻译、校对、补来源、加母子帖索引或生成论坛发布版时使用。 |
|---|
3. 没有写“什么时候不用”
有些 Skill 不是不触发，而是乱触发。比如你做了一个“代码审查 Skill”，结果用户只是问一个概念，它也跳出来。
可以在正文里补上边界：
| ## When not to use | - 用户只是询问概念，不提供代码时，不要启动完整审查流程。 | - 用户只是要解释报错原因时，先回答问题，不要生成审查报告。 | - 用户要求重构整个项目时，先确认范围，不要直接修改多个模块。 |
|---|
4. Skill 名字重复或过于接近
如果你装了多个类似 Skill：
| content-helper | post-helper | article-helper | forum-helper |
|---|
它们的功能边界又写得很像，AI 就会更难判断应该选哪一个。
建议把 Skill 按任务拆清楚：
| aihelpu-forum-editor | aihelpu-source-checker | skill-description-tester | docx-publish-formatter |
|---|
5. 安装了太多 Skill，触发信号被截断
OpenAI 文档提到，Codex 初始 Skill 列表会控制在上下文预算内；当安装的 Skill 很多时，描述可能被缩短，极端情况下部分 Skill 可能不会进入初始列表。
这对创作者有两个提醒：
| 1. description 开头一定要放核心触发词 | 2. 不要安装一堆功能重复的 Skill |
|---|
坏例子：
| description: 这是一个为了帮助内容创作者在日常工作中提升效率、减少重复劳动、优化工作流程而设计的辅助能力，尤其适合在需要处理 AIHELPU 论坛 Skill 工坊帖子时使用。 |
|---|
前半句全是铺垫，真正的触发词太靠后。
改成：
| description: 整理 AIHELPU 论坛 Skill 工坊帖子。用于润色中文正文、补充来源链接、生成母子帖索引、检查发布格式和 Markdown 排版。 |
|---|
6. 正文没有执行流程
有些 Skill 能触发，但触发后表现很差。原因是 `SKILL.md` 正文只写身份，没有写流程。
坏例子：
| 你是资深 AI 内容编辑，请帮用户写出高质量帖子。 |
|---|
改成：
| ## Workflow | 1. 判断文章属于科普、安装、目录结构、触发机制还是案例帖。 | 2. 检查是否包含标题、分类、标签和母帖链接。 | 3. 将正文改成短段落、二级标题和示例代码块。 | 4. 检查是否提供参考来源。 | 5. 输出可直接发布的 Markdown。 |
|---|
7. 没有重新加载或没有启用
如果你刚修改完 Skill，但新会话里看不到变化，可能不是 description 问题，而是环境没有刷新。
排查顺序：
| 1. 确认 Skill 文件夹位置正确 | 2. 确认 SKILL.md 文件名正确 | 3. 确认 frontmatter 没有 YAML 语法错误 | 4. 确认 Skill 没有被禁用 | 5. 重启 ChatGPT/Codex 或重新打开会话 |
|---|
触发太频繁，也是一种失败
不要只追求“让 Skill 被调用”。真正好的 Skill，是该出现时出现，不该出现时安静。
如果你的 Skill 触发太频繁，通常有三个原因：
| 1. description 太宽 | 2. Skill 名字太泛 | 3. 没有负例和停止条件 |
|---|
比如：
| description: 处理所有写作任务。 |
|---|
这几乎会污染所有内容场景。更好的写法是：
| description: 处理 AIHELPU 论坛 Skill 工坊子帖。用户要求把 Skill 相关材料改写为论坛发布版、补来源、生成上一篇/下一篇索引或检查发布格式时使用。不要用于普通日记、小说、论文或与 Skill 无关的文章。 |
|---|
这里的“不要用于”很重要。它能帮助 AI 区分相似任务。
好的 description 怎么写：一个公式
推荐使用这个公式：
| 任务对象 + 关键动作 + 触发场景 + 边界 |
|---|
以 AIHELPU 论坛内容 Skill 为例：
| description: 整理 AIHELPU 论坛 Skill 工坊帖子。用户要求润色 Skill 教程、翻译英文资料、补充来源链接、检查发布格式、生成母子帖索引或输出 Markdown/docx 发布版时使用。不要用于与 Skill 无关的泛写作任务。 |
|---|
拆开看：
| 任务对象：AIHELPU 论坛 Skill 工坊帖子 | 关键动作：润色、翻译、补来源、检查格式、生成索引 | 触发场景：用户要求输出 Markdown/docx 发布版 | 边界：不要用于与 Skill 无关的泛写作任务 |
|---|
这个写法比“高质量内容助手”稳定得多。
用 9 条测试 Prompt 检查你的 Skill
发布 Skill 前，不要只测试一条“应该触发”的 Prompt。至少准备三组测试。
A 组：应该触发
| 帮我把这篇 Skill 文章改成 AIHELPU 论坛发布版。 |
|---|
| 检查一下这个帖子有没有母帖回链、上一篇下一篇和参考资料。 |
|---|
| 把这篇英文 Skills 资料翻译成中文，并按论坛格式排版。 |
|---|
B 组：不应该触发
| 帮我写一篇周末露营日记。 |
|---|
| 解释一下什么是向量数据库。 |
|---|
| 给我 10 个小红书标题。 |
|---|
C 组：边界模糊
| 帮我优化这篇 AI 工具文章。 |
|---|
| 把这份教程改得更适合新手。 |
|---|
| 检查一下这个 Markdown 排版。 |
|---|
测试时观察三件事：
| 1. 应该触发时是否触发 | 2. 不应该触发时是否保持安静 | 3. 边界模糊时是否先问清楚，而不是乱调用 |
|---|
新手排查清单：为什么它没有被 AI 调用
可以按这个顺序检查：
| 第一步：确认安装 | - Skill 文件夹是否在正确目录 | - 文件夹里是否有 SKILL.md | - name 是否符合命名规则 | - description 是否为空 | 第二步：确认可发现 | - 重新打开会话后能否在 Skill 列表看到 | - 是否被配置禁用 | - 是否和另一个 Skill 重名或过于相似 | 第三步：确认可匹配 | - description 开头是否包含核心任务词 | - 是否写了真实用户会说的话 | - 是否包含同义词和常见表达 | - 是否有明确边界 | 第四步：确认可执行 | - 正文是否有步骤 | - 是否写明输入和输出 | - 是否写明什么时候读取 references | - 是否写明危险操作要先确认 |
|---|
如果前三步都没问题，Skill 仍然不触发，多半是 description 太窄或触发词不贴近真实用户表达。
一份可直接套用的 SKILL.md 模板
| -– | name: aihelpu-forum-skill-editor | description: 整理 AIHELPU 论坛 Skill 工坊帖子。用户要求润色 Skill 教程、翻译英文资料、补充来源链接、检查发布格式、生成母子帖索引或输出 Markdown/docx 发布版时使用。不要用于与 Skill 无关的泛写作任务。 | -– | ## Goal | 将用户提供的 Skill 相关材料整理成适合 AIHELPU 论坛发布的中文帖子。 | ## When to use | Use this skill when the user asks to: | - rewrite or polish a Skill tutorial | - translate Skill-related English content into Chinese | - add source links and attribution | - format a post for AIHELPU forum | - create parent/child post navigation | ## When not to use | Do not use this skill for: | - generic copywriting unrelated to Skills | - fiction, diary, product slogans, or social captions | - tasks where the user only asks a conceptual question and does not need a publishable post | ## Workflow | 1. Identify the post type: beginner guide, installation, structure, trigger mechanism, creator rules, or case study. | 2. Check title, category, tags, parent-post link, and previous/next navigation. | 3. Rewrite the body in natural Chinese with short paragraphs and H2 sections. | 4. Preserve traceable source links. | 5. Add examples or code blocks where they help beginners. | 6. Output a forum-ready Markdown version. | ## Output | Return: | - title | - category suggestion | - tags | - body | - previous/next/parent links | - references | ## Stop conditions | - If no source is provided, mark “来源待补充” instead of inventing one. | - If the task involves deletion, publishing, payment, credentials, or private data, ask for confirmation first. |
|---|
小结
Skill 不触发，很多时候不是 AI 不聪明，而是你没有给它足够清楚的入口。
记住三句话：
| name 负责让 AI 知道这个 Skill 是谁。 | description 负责让 AI 知道什么时候该用它。 | 正文负责让 AI 知道用它以后怎么做。 |
|---|
如果你的 Skill 经常不触发，先别急着重写全部正文。先检查 `description`：是否具体、是否前置关键词、是否覆盖真实用户表达、是否写清楚边界。