uniTerm Skills 技能与命令模板：打造可复用、可自沉淀的 AI 工作流
uniTerm Skills 技能与命令模板：打造可复用、可自沉淀的 AI 工作流
uniTerm 是一款覆盖 SSH、RDP、SFTP、数据库、Kubernetes 等 30+ 协议的 All-in-one 终端，其内置 AI Agent 不仅能自主执行多轮 Shell 命令，还支持「Skills 技能」与「命令模板」，把常用排查流程沉淀为可复用的 SOP，让 AI 工作流可积累、可共享。🛠️
什么是技能与命令模板？
在 uniTerm 里，两类"可复用资产"承担不同角色：
| 类型 | 本质 | 触发方式 |
|---|---|---|
| 技能（Skills） | 可复用的命令行工作流 / SOP | AI 自主调用，或手动输入 /名称 |
| 命令（Commands） | 带参数占位的 Prompt 模板 | 在对话中输入 /名称 显式触发 |
简单来说：技能是"教 AI 怎么做"的说明书，命令是"一句话唤起一段提示词"的快捷键。
技能如何被 AI 自主调用？
uniTerm 的技能采用「目录式」存储：每个技能是一个 skills/<名称>/SKILL.md 文件（见 backend/store/skills_store.go），可附带 references/ 参考资料与 scripts/ 脚本目录。其工作机制分三步：
- 索引注入 — 所有已启用的技能（名称 + 描述）会作为轻量索引写入 AI 的系统提示词，模型由此"知道"自己会哪些技能，相关实现见 frontend/src/services/agent.ts
- 按需加载 — 当 AI 判断当前任务匹配某个技能时，调用
use_skill工具读取该技能的完整正文再行动，而不是把全部内容塞进上下文 - 按步骤执行 — AI 严格按技能中的步骤运行命令、观察输出、迭代调整，全程受执行模式管控
你只需在 AI 输入框输入 /，即可从下拉列表中手动插入某个技能，如 /codemap 立即让 AI 按该技能的排查流程执行。
核心亮点：AI 能自己"沉淀"新技能
这是 Skills 最独特的设计——技能库会随着使用自动生长。🌱
当 AI 在一次协作中摸索出一套行之有效的排查流程后，它可以直接调用 save_skill 工具，把流程整理成新的 SKILL.md 保存下来（保存逻辑见 frontend/src/stores/skillStore.ts）。此后 AI 会在技能索引中识别到它，避免重复造轮子，下次同类任务可直接复用。
典型场景：你让 AI 排查"某服务日志暴涨"，几轮命令后定位出 du + lsof 组合拳最有效——让 AI 顺手 save_skill，下次磁盘告警一句话就能复现整套排查。
手动创建与管理技能：5 步上手
进入 设置 → 技能与命令（Skills & Commands）面板，即可统一管理两类资产：
创建步骤：
- 点击「+ 新建 / 导入」，填写名称（kebab-case，如
disk-check）、描述与指令正文；新建对话框内置了一份磁盘排查示例模板，照着改即可 - 正文建议按
## Purpose/## Steps/## Notes三段组织，步骤中给出具体命令（模板参考 frontend/src/components/SkillCreateDialog.vue） - 也可以直接拖入
.md/.zip/.skill文件导入，支持带 frontmatter 的SKILL.md，描述会自动解析填充 - 用开关控制技能启用/停用；点击锁形图标可锁定，防止 AI 或自己误改误删
- 点击技能卡片上的路径可直接在文件管理器中打开技能目录，方便手动维护脚本
命令模板的管理与技能一致，额外支持 $ARGUMENTS 参数占位符：如 /release [env] [service] 调用时，参数会填入模板对应位置，实现"一句话参数化提示词"。
安全与同步：放心使用的前提
安全提示 ⚠️：技能会驱动 AI 执行真实终端命令，务必配合 AI 执行模式 使用——默认「高危指令确认」下，rm、sudo 等高危命令仍需逐条确认。
跨设备同步：uniTerm 的云同步支持将整个技能库打包同步（SKILL.md + references/ + scripts/ 与启用/锁定偏好一起，单文件上限 256KB、整包上限 4MB）。同步不传播删除——在另一台设备删除技能不会影响本机，手拷进目录的技能也绝不会被同步流程误删；随应用分发的系统技能（.system）不参与同步。详见 docs/guide/zh/features/sync.md。
总结
- 技能 = 可复用的命令行 SOP，AI 能自主匹配调用，无需手动触发
- 命令 = 参数化 Prompt 模板，用
/名称一键唤起 - AI 可自沉淀：
save_skill让技能库随使用自动生长，这是最核心的差异化能力 - 管理、锁定、导入、云同步一应俱全，适合把团队排查经验固化为可共享资产
把每次踩坑总结的技能存下来，下次交给 AI 自动执行——这正是 uniTerm 打造"越用越聪明"的 AI 工作流的方式。✨