自定义工作流(Skill)
自定义工作流是教 AI「按你的规矩做事」的方式。它不需要写代码——就是一份用自然语言写的说明书,告诉 AI 在某类任务上该走什么流程、注意什么、输出成什么样。
你可以把它理解为:给 AI 写一份"岗位说明书",让它在你常做的事情上更专业。
提示
工作流不定义新功能,也不添加新工具。工具是"能做什么",工作流是"怎么做更好"。如果你的需求要调用 Nephele 没有的外部能力,那不是工作流能解决的。
最快的路:内置编辑器
不用碰任何文件。打开 工具箱 →「自定义工作流」(设置页也有入口):
- 左边是你的工作流列表,下面还有 Nephele 的内置流程——可以整份复制过来,在它的基础上改
- 右边是编辑器:一句话描述、搜索别名、正文,三样填完就行
保存即生效,不用重启。回到对话框,输入 / 加上工作流的名字,它就会在这轮对话里生效。
创建时起的名字会成为调用名:比如建了一个叫 commission-quote 的工作流,之后在对话框打 /commission-quote 就能用。
怎么触发:/ 点名调用
你的工作流只在你点名时生效:在输入框打 /,从弹出的列表里选(或直接输全名)。
早期版本会根据你说的话自动匹配关键词、自动注入工作流——这个机制已经取消了:自动触发要么误伤(一个宽泛的词让工作流在不相关的对话里生效),要么永远触发不了(词写窄了)。点名调用让"这轮到底用没用我的工作流"变成一件确定的事。
所以 frontmatter 里的 keywords 现在是搜索别名:打 /报价 能搜到 commission-quote,仅此而已。写你自己记得住的词。
技巧
Nephele 的内置技能(找参考、鉴赏、溯源这些)不受影响——它们仍会在相关任务里自动加载,AI 也能自己按需调取。点名机制只针对你自定义的部分。
正文写什么
正文是给 AI 看的,Markdown 随意组织。有用的写法:
- 分步骤工作流——先做什么、再做什么
- 决策规则——什么情况下走哪条路
- 输出模板——结果要怎么组织、报告用什么格式
- 禁止事项——不要做什么(AI 和人一样,明说比暗示有效)
写的时候要精炼:正文上限 18000 字符,超出会被截断(编辑器里能看到每个工作流的字数)。规则贵精不贵多——如果 AI 没按预期执行,先试着删减到最核心的几条。
手写文件(进阶)
喜欢用自己的编辑器?工作流本体就是一个 Markdown 文件,存放在:
~/.nephele_workshop/skills/
└── my-skill/
└── SKILL.md
首次打开「自定义工作流」面板时,这个目录下会出现一个 _模板/ 文件夹,里面有份带说明的模板。复制整个文件夹、改名(去掉开头的 _)、编辑,然后回面板点「重新扫描」即可。
SKILL.md 的开头是三条短横线包裹的信息区:
---
name: my-skill-name
description: "一句话说明这个工作流做什么"
keywords: [别名1, 别名2]
---| 字段 | 必填 | 说明 |
|---|---|---|
| name | 是 | 调用名,/name 就是它;与内置技能同名会覆盖内置版本 |
| description | 是 | 一句话描述,显示在 / 列表里,也帮 AI 理解用途 |
| keywords | 否 | / 弹层里的搜索别名 |
几条实用规则:
_或.开头的文件夹不会被加载——想临时禁用某个工作流,给文件夹名加个_前缀即可- 编码不用操心——记事本存的"ANSI"(GBK)、带 BOM 的 UTF-8 都能正确读取
- 解析失败不会静默——frontmatter 写错了,面板里会列出具体哪个文件、错在哪
注意
想修改内置技能(比如 find-references)的流程:复制它的 SKILL.md 到你的目录下同名覆盖,不要直接编辑安装目录里的文件——软件更新时会被还原,还可能导致增量更新失败。
管理与排查
- 总开关:设置页有「自定义工作流」总开关。如果 AI 行为变得奇怪,先关掉它排除自定义内容的影响,比逐条排查快得多
- 有没有生效:保存后在对话框打
/,列表里出现就是装上了;这轮对话有没有用它,看你有没有点名 - 不按预期执行:多数时候是正文太长或规则互相打架。删减到最核心的 3-5 条规则再试
什么时候写工作流,什么时候需要新功能
| 场景 | 写工作流 | 需要新功能 |
|---|---|---|
| 教 AI 在特定平台搜索的最佳实践 | ✓ | |
| 定义输出格式和报告模板 | ✓ | |
| 给 AI 设定决策逻辑和判断标准 | ✓ | |
| 需要调用外部 API 获取数据 | ✓ | |
| 需要新的界面交互 | ✓ |
简单说:策略写工作流,能力靠功能。后者欢迎到社群里提需求。