Orbital 自进化技能系统入门:SKILL.md工作流沉淀让Agent越用越聪明
Orbital 自进化技能系统入门:SKILL.md工作流沉淀让Agent越用越聪明
在 Orbital 自进化技能系统中,Agent 不只是执行任务,还会把成功完成的多步工作流沉淀为 SKILL.md 技能文件,并在下次遇到类似任务前主动查阅,实现"越用越聪明"。这篇文章带你快速看懂 Orbital 的 SKILL.md 工作流是如何运转的。
什么是 Orbital 的技能系统 🧠
Orbital 是一个 AI Agent 操作系统,它的理念是:"Context is yours. Agents are replaceable."(上下文归你所有,Agent 随时可换)。技能系统是它"自我进化"的核心机制之一:
- 技能 = 一个文件夹 + 一份 SKILL.md,存放在项目工作区的
orbital/skills/{技能名}/SKILL.md - 沉淀:Agent 完成一个 3 步以上、且可能重复的任务后,会主动询问"要不要把它保存为可复用技能?"
- 召回:每次开始多步任务前,Agent 会扫描技能列表,发现匹配的技能就强制先读取其 SKILL.md,再按其步骤执行
技能会在项目设置的 Skills 区域展示,Agent 自己沉淀的技能也会和内置技能一起出现在这里。
四个内置默认技能
新建项目时,Orbital 会自动安装 4 个内置技能(位于 agent_os/default_skills/),它们本身就是"好技能"的范例:
| 内置技能 | 作用 | 说明文档 |
|---|---|---|
| Task Planning | 按任务复杂度匹配规划力度,先查技能再动手 | task-planning/SKILL.md |
| Process Capture | 把成功多步工作流沉淀为可复用技能 | process-capture/SKILL.md |
| Learning Capture | 把纠错、报错恢复、意外发现记入 LESSONS.md | learning-capture/SKILL.md |
| Efficient Execution | 用最简单的工具完成任务,减少 token 浪费 | efficient-execution/SKILL.md |
安装逻辑在 agent_os/daemon_v2/default_skills_installer.py 中:只新增、不覆盖,你删掉的默认技能在守护进程重启后也不会"复活"。
一份 SKILL.md 长什么样 📄
Orbital 对技能格式有明确的约定(见 Process Capture 规范),核心是先触发条件、后执行步骤:
# 任务名称
一句话描述这个技能做什么。
## When to Use
<1-3 条触发条件>
## Steps
1. <动作> — <用什么工具、关键参数>
2. <动作> — <工具和关键参数>
## Inputs
- <变量>: <描述和默认值>
## Outputs
- <产物>: <存放位置>
## Anti-patterns
- <什么不要做>
几条值得记住的约束:
- 每个技能不超过 80 行,太复杂的流程拆成子技能
- 用
{占位符}代替硬编码路径,保证可复用 - 用 RFC 2119 关键词(MUST / SHOULD / MAY)标明哪些步骤是必须的
- 已有相似技能时更新而非新建,避免重复
Agent 是怎么"越用越聪明"的 🔄
整个闭环由三部分组成:
1️⃣ 沉淀(写) — 完成任务后触发。当任务满足"3 个以上步骤 + 大概率会重复 + 没有现有技能覆盖"时,Agent 会提议保存为 skills/{任务名}/SKILL.md;在完全自主模式下会直接创建。
2️⃣ 加载(读) — SkillLoader 扫描工作区里所有 skills/*/SKILL.md,解析出名称和描述;提示词构建器 会把技能清单注入系统提示词,并附带一条强约束:"匹配到技能就必须先 read 它的 SKILL.md 再动手,跳过它等于重复系统已经解决过的错误。"
3️⃣ 记忆(配套) — 技能管"怎么做",Layer-1 记忆文件管"经历过什么"。LESSONS.md 记录纠错与踩坑教训,DECISIONS.md 记录决策原因,每次会话开始都会注入上下文,让冷启动的 Agent 也能"接得上"。
项目工作区的完整目录结构如下,技能就住在 orbital/skills/ 里:
在设置中管理技能 ⚙️
除了让 Agent 自己沉淀,你也可以主动管理技能:
- 查看:项目设置 → Skills,列出全部技能
- 删除:不再需要的技能可直接删除(Agent 运行中时不允许删除,API 见 agents_v2.py)
- 导入:支持上传
.md或包含 SKILL.md 的.zip包,把别的项目的技能"移植"过来
上手建议:三步用好 SKILL.md
- 别删内置技能——Task Planning 和 Process Capture 是"教 Agent 学会自我沉淀"的关键
- 对重复性工作流说一次"存下来"——比如周报生成、发布流程,第一次多花的 30 秒能省下以后所有会话的摸索时间
- 定期回看 LESSONS.md——那是 Agent 的"错题本",也是你了解它踩了什么坑的窗口
Orbital 的这套技能系统,本质上把 Agent 的"工作记忆"变成了可版本化、可迁移、可编辑的文件资产。Agent 会换,但你在 orbital/skills/ 里沉淀下来的流程知识,一直是你自己的。


