跳到正文
Nephele Workshop使用文档

输入功能名称或关键词,例如「参考图」「付费」。

官网
自定义工作流

自定义工作流(Skill)

自定义工作流是教 AI「按你的规矩做事」的方式。它不需要写代码——就是一份用自然语言写的说明书,告诉 AI 在某类任务上该走什么流程、注意什么、输出成什么样。

你可以把它理解为:给 AI 写一份"岗位说明书",让它在你常做的事情上更专业。

提示

工作流不定义新功能,也不添加新工具。工具是"能做什么",工作流是"怎么做更好"。如果你的需求要调用 Nephele 没有的外部能力,那不是工作流能解决的。


最快的路:内置编辑器

不用碰任何文件。打开 工具箱 →「自定义工作流」(设置页也有入口):

  • 左边是你的工作流列表,下面还有 Nephele 的内置流程——可以整份复制过来,在它的基础上改
  • 右边是编辑器:一句话描述、搜索别名、正文,三样填完就行

保存即生效,不用重启。回到对话框,输入 / 加上工作流的名字,它就会在这轮对话里生效。

创建时起的名字会成为调用名:比如建了一个叫 commission-quote 的工作流,之后在对话框打 /commission-quote 就能用。


怎么触发:/ 点名调用

你的工作流只在你点名时生效:在输入框打 /,从弹出的列表里选(或直接输全名)。

早期版本会根据你说的话自动匹配关键词、自动注入工作流——这个机制已经取消了:自动触发要么误伤(一个宽泛的词让工作流在不相关的对话里生效),要么永远触发不了(词写窄了)。点名调用让"这轮到底用没用我的工作流"变成一件确定的事。

所以 frontmatter 里的 keywords 现在是搜索别名:打 /报价 能搜到 commission-quote,仅此而已。写你自己记得住的词。

技巧

Nephele 的内置技能(找参考、鉴赏、溯源这些)不受影响——它们仍会在相关任务里自动加载,AI 也能自己按需调取。点名机制只针对你自定义的部分。


正文写什么

正文是给 AI 看的,Markdown 随意组织。有用的写法:

  • 分步骤工作流——先做什么、再做什么
  • 决策规则——什么情况下走哪条路
  • 输出模板——结果要怎么组织、报告用什么格式
  • 禁止事项——不要做什么(AI 和人一样,明说比暗示有效)

写的时候要精炼:正文上限 18000 字符,超出会被截断(编辑器里能看到每个工作流的字数)。规则贵精不贵多——如果 AI 没按预期执行,先试着删减到最核心的几条。


手写文件(进阶)

喜欢用自己的编辑器?工作流本体就是一个 Markdown 文件,存放在:

text
~/.nephele_workshop/skills/
└── my-skill/
    └── SKILL.md

首次打开「自定义工作流」面板时,这个目录下会出现一个 _模板/ 文件夹,里面有份带说明的模板。复制整个文件夹、改名(去掉开头的 _)、编辑,然后回面板点「重新扫描」即可。

SKILL.md 的开头是三条短横线包裹的信息区:

yaml
---
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 获取数据
需要新的界面交互

简单说:策略写工作流,能力靠功能。后者欢迎到社群里提需求。