差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
| 智能体二次开发:skill标准格式 [2026/07/23 11:55] – 张叶安 | 智能体二次开发:skill标准格式 [2026/07/23 12:01] (当前版本) – [3. 渐进式披露,控制 Token 成本] 张叶安 | ||
|---|---|---|---|
| 行 56: | 行 56: | ||
| - | Skill 的进阶目录结构 | + | ====== |
| 任务变得复杂时,可以把内容拆分到不同目录,而不是全部塞进 SKILL.md: | 任务变得复杂时,可以把内容拆分到不同目录,而不是全部塞进 SKILL.md: | ||
| - | text | + | < |
| my-skill/ | my-skill/ | ||
| ├── SKILL.md | ├── SKILL.md | ||
| 行 69: | 行 70: | ||
| └── assets/ | └── assets/ | ||
| └── template.json | └── template.json | ||
| + | </ | ||
| + | |||
| 每个目录的职责: | 每个目录的职责: | ||
| 行 79: | 行 82: | ||
| assets/ | assets/ | ||
| - | 设计 Skill 的核心原则 | + | ====== |
| - | 1. 精准的 description 决定触发率 | + | |
| + | |||
| + | ===== 1. 精准的 description 决定触发率 | ||
| + | |||
| description 是 AI 判断" | description 是 AI 判断" | ||
| - | text | + | < |
| ❌ 差的描述:" | ❌ 差的描述:" | ||
| ✅ 好的描述:" | ✅ 好的描述:" | ||
| + | |||
| + | </ | ||
| + | |||
| 口诀:动作 + 触发关键词 + 关键约束。 | 口诀:动作 + 触发关键词 + 关键约束。 | ||
| - | 2. 把稳定动作交给脚本 | + | ==== 2. 把稳定动作交给脚本 |
| + | |||
| 下面这些事不应该让 AI 每次" | 下面这些事不应该让 AI 每次" | ||
| 行 101: | 行 113: | ||
| 这些动作一旦写成脚本,每次结果一致,不会出现" | 这些动作一旦写成脚本,每次结果一致,不会出现" | ||
| - | 3. 渐进式披露,控制 Token 成本 | + | ==== 3. 渐进式披露,控制 Token 成本 |
| Skill 的加载是分层的: | Skill 的加载是分层的: | ||
| - | 层级 内容 加载时机 | + | |层级 |内容 |加载时机| |
| - | Level 1 name + description 始终驻留在上下文 | + | |Level 1 |name + description|始终驻留在上下文| |
| - | Level 2 SKILL.md 正文 Skill 被触发时加载 | + | |Level 2 |SKILL.md 正文|Skill被触发时加载| |
| - | Level 3 references/ | + | |Level 3 |references/ + scripts/|执行中按需读取| |
| 原则:Level 1 越精准越好,Level 2 越精简越好,Level 3 放心放(按需加载不占常驻空间)。 | 原则:Level 1 越精准越好,Level 2 越精简越好,Level 3 放心放(按需加载不占常驻空间)。 | ||
| - | 4. 职责单一 | + | ==== 4. 职责单一 |
| 每个 Skill 只做一件事。把" | 每个 Skill 只做一件事。把" | ||
| - | 快速上手:5 步设计法 | + | ==== 快速上手:5 步设计法 |
| 如果你手头有一个重复流程想做成 Skill,可以按这个步骤来: | 如果你手头有一个重复流程想做成 Skill,可以按这个步骤来: | ||
| 行 126: | 行 142: | ||
| 把 AI 留给真正需要判断的部分——价值判断、风格把控、归纳总结 | 把 AI 留给真正需要判断的部分——价值判断、风格把控、归纳总结 | ||
| - | 什么时候该写 Skill? | + | ==== 什么时候该写 Skill? |
| 一个简单的判断标准:同样的规则跟 AI 纠正了 3 次以上,就该写 Skill 了。 一次性的任务直接用提示词,别折腾。 | 一个简单的判断标准:同样的规则跟 AI 纠正了 3 次以上,就该写 Skill 了。 一次性的任务直接用提示词,别折腾。 | ||