智能体二次开发:skill标准格式

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
智能体二次开发:skill标准格式 [2026/07/23 11:57] 张叶安智能体二次开发:skill标准格式 [2026/07/23 12:01] (当前版本) – [3. 渐进式披露,控制 Token 成本] 张叶安
行 82: 行 82:
 assets/:放图片、模板文件等静态资源 assets/:放图片、模板文件等静态资源
  
-设计 Skill 的核心原则 +====== 设计 Skill 的核心原则 ====== 
-1. 精准的 description 决定触发率+ 
 + 
 +===== 1. 精准的 description 决定触发率 ===== 
 + 
 description 是 AI 判断"什么时候用这个 Skill"的唯一入口。写得越具体,触发越准。 description 是 AI 判断"什么时候用这个 Skill"的唯一入口。写得越具体,触发越准。
  
-text+<code>
 ❌ 差的描述:"翻译相关" ❌ 差的描述:"翻译相关"
 ✅ 好的描述:"将中文内容翻译成英文。当用户说'翻译'、'translate'或要求把中文转成英文时使用,保留专业术语和原有的语气。" ✅ 好的描述:"将中文内容翻译成英文。当用户说'翻译'、'translate'或要求把中文转成英文时使用,保留专业术语和原有的语气。"
 +
 +</code>
 +
 口诀:动作 + 触发关键词 + 关键约束。 口诀:动作 + 触发关键词 + 关键约束。
  
-2. 把稳定动作交给脚本+==== 2. 把稳定动作交给脚本 ==== 
 + 
 下面这些事不应该让 AI 每次"临场发挥" 下面这些事不应该让 AI 每次"临场发挥"
  
行 104: 行 113:
 这些动作一旦写成脚本,每次结果一致,不会出现"这次漏一条、下次排序变了"的问题。AI 的价值在判断价值、归纳总结、风格把控这些语义层面。 这些动作一旦写成脚本,每次结果一致,不会出现"这次漏一条、下次排序变了"的问题。AI 的价值在判断价值、归纳总结、风格把控这些语义层面。
  
-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/ + scripts/ 执行中按需读取+|Level 3 |references/ + scripts/|执行中按需读取
 原则:Level 1 越精准越好,Level 2 越精简越好,Level 3 放心放(按需加载不占常驻空间)。 原则:Level 1 越精准越好,Level 2 越精简越好,Level 3 放心放(按需加载不占常驻空间)。
  
-4. 职责单一+==== 4. 职责单一 ==== 
 每个 Skill 只做一件事。把"运行测试 + 更新状态 + 发通知"塞进一个 Skill,AI 容易搞混,触发也容易错。 每个 Skill 只做一件事。把"运行测试 + 更新状态 + 发通知"塞进一个 Skill,AI 容易搞混,触发也容易错。
  
-快速上手:5 步设计法+==== 快速上手:5 步设计法 ==== 
 如果你手头有一个重复流程想做成 Skill,可以按这个步骤来: 如果你手头有一个重复流程想做成 Skill,可以按这个步骤来:
  
行 129: 行 142:
 把 AI 留给真正需要判断的部分——价值判断、风格把控、归纳总结 把 AI 留给真正需要判断的部分——价值判断、风格把控、归纳总结
  
-什么时候该写 Skill?+==== 什么时候该写 Skill? ==== 
 一个简单的判断标准:同样的规则跟 AI 纠正了 3 次以上,就该写 Skill 了。 一次性的任务直接用提示词,别折腾。 一个简单的判断标准:同样的规则跟 AI 纠正了 3 次以上,就该写 Skill 了。 一次性的任务直接用提示词,别折腾。
  
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 智能体二次开发/skill标准格式.1784779043.txt.gz
  • 最后更改: 2026/07/23 11:57
  • 张叶安