Skills 与快捷指令
工具与 MCP 解决了"AI 怎么用工具"的问题。这一页讲两套更轻量的能力扩展方式：
- Agent Skills：把"一组写好的说明文档 + 资源文件"打包成 AI 可以读取并按部就班执行的"专项技能"
- 快捷指令工具：把你的 iOS Shortcuts 暴露给 AI 当工具调用
它们不需要写代码，门槛比 MCP 低很多。
这两个东西分别解决什么
Agent Skills 解决"提示词工程"问题
如果你经常要让 AI 干同一类活——比如「按公司规范写一封邮件」「分析这组数据并出统计图」「按代码规范重构这段 Swift」——每次都把规则贴一次很烦。
Skill 包就是把这些"规则 + 模板 + 参考资料"打包成一个文件夹，里面有：
SKILL.md：核心说明文档（含名字、描述、何时使用、详细步骤）- 任意多个资源文件（代码模板、参考图、示例）
AI 在聊天时会看到「你有这些 Skill 可用」，需要时主动读取 SKILL.md 并按步骤执行。
快捷指令工具解决"接入 iOS 系统"问题
iOS Shortcuts 已经能干很多事——查手机电量、发短信、控智能家居、读日历、运行 Python（用 a-Shell 等）。
快捷指令工具就是把这些 Shortcut 包装成 AI 可调用的工具。AI 想做"看下我今天的日历"时，会调用对应的 Shortcut，结果回流给 AI 继续生成。
新手必读
Agent Skills
在哪里管
设置 → Agent Skills页面顶部有总开关「向模型暴露 Agent Skills（use_skill）」。
use_skill 是什么
ETOS 不会直接执行 Skill 包里的脚本或本地命令。它只把 SKILL.md 内容作为可读资料提供给 AI，AI 通过名为 use_skill 的工具来"读取"这个 Skill。SKILL.md 里写的"运行 X 命令"——只是给 AI 的指引，最终执行靠 AI 把请求转成普通文字回答或调用别的工具。
简单说：Skills 是"知识包"而不是"脚本包"。
四种导入方式
| 方式 | 适合 |
|---|---|
| 新增技能（粘贴 SKILL.md） | 你自己写好了一份 SKILL.md 想直接粘贴 |
| 从 GitHub 导入 | 别人在 GitHub 仓库里写了 Skill 包，填仓库 URL（支持 /tree/branch 和子目录路径） |
| 链接导入技能包 | 任何能直接下载的 SKILL.md 或 .zip 链接 |
| 从本地技能包导入 | 从 iOS「文件」App 选一个本地 .zip 包 |
SKILL.md 长什么样
SKILL.md 是一个带 YAML frontmatter 的 Markdown 文件，最小结构：
---
name: 标准邮件助手
description: 按公司规范写中英文邮件，包含开头敬语、签名、CC 规则
---
# 何时使用
用户要求"写一封邮件给 X"或"帮我回复这封邮件"时，使用本技能。
# 详细步骤
1. 询问用户：邮件目的 / 收件人语言 / 是否需要 CC
2. 按以下模板生成正文...
3. ...
# 模板
亲爱的 {收件人}，
...ETOS 解析时只关心 name 和 description——name 必须填且唯一，description 用来告诉 AI"这个技能解决什么"。
怎么用
技能导入后：
- 单项开关：进入「已安装技能」列表里的某条，「在聊天中启用该技能」打开
- AI 看到的会是：「你有 N 个 Skill 可用：邮件助手、代码规范、…」
- AI 觉得当前问题适合用某 Skill 时，会调
use_skill工具读那份SKILL.md，然后按里面的指引生成回答
技能文件管理
每个 Skill 包是一个目录，里面除 SKILL.md 外可以放任意多文件（图片、代码示例、配置模板等）。在 Skill 详情页可以：
- 看技能目录文件列表
- 新建 / 编辑 / 删除文件
快捷指令工具
在哪里管
设置 → 快捷指令工具集成页面有总开关「向模型暴露快捷指令工具」。
怎么把 Shortcut 接进来
ETOS 通过一个"桥接快捷指令"来调用你的所有 Shortcut。整体流程：
第一步：装官方桥接快捷指令
页面有「下载官方导入快捷指令」按钮。点击会让你装一个 ETOS 官方做好的 Shortcut（桥接器）到你的 iOS Shortcuts 库。
第二步：写自己的 Shortcut
去 iOS 自带的「快捷指令」App 自己做或下载现成的 Shortcut（比如「获取今日天气」「读取当前位置」）。Shortcut 必须满足：
- 接收文本输入（AI 给的参数）
- 输出文本结果（给 AI 看）
第三步：把 Shortcut 清单告诉 ETOS
「快捷指令工具集成」里有「从剪贴板导入清单」按钮。清单是一段 JSON / YAML 文本，列出"你想让 AI 用哪些 Shortcut，每个的名字 / 描述 / 参数"。
或者：「检测并运行导入快捷指令」会让 iOS 自动跑桥接 Shortcut 一次，由它把当前 Shortcuts 库里登记到 ETOS 的所有指令清单回灌。
运行模式
每个快捷指令工具有个运行模式字段，决定调用时走哪条路：
- 直连：用 URL Scheme 直接跳到目标 Shortcut（响应快，但跨 App 体验有跳转）
- 桥接：调用官方桥接 Shortcut，由它代理跳转（更稳，跨 App 体验略慢）
设置 → 快捷指令工具集成 → 「默认会按"直连 → 桥接"执行；若工具运行模式设为桥接，则按"桥接 → 直连"」
不熟悉的话留默认（直连优先）即可。
审批自动化
快捷指令工具的审批也走 工具与 MCP 里讲的那套，但额外有：
| 字段 | 作用 |
|---|---|
| 启用倒计时自动批准 | 弹审批气泡后，倒计时 N 秒没操作就自动允许 |
| 倒计时秒数 | 默认值可调整 |
| 已禁用自动批准工具 | 你可以指定某些工具绝对不走自动批准（必须手动） |
自动批准要慎用
如果你接的快捷指令里有"发短信""发邮件""控智能家居"这类有副作用的，强烈建议不要开启自动批准——AI 偶尔会执行你没明确同意的操作。
进阶选项
Skills 和工具的区别什么时候选谁
| 维度 | Agent Skills | MCP / 拓展工具 |
|---|---|---|
| 性质 | 知识包（文档 + 资源） | 代码/服务 |
| 写法 | 写 Markdown | 写代码或部署服务器 |
| 适合 | 流程类、规范类、模板类 | 实时数据、外部 API、文件操作 |
| 例子 | 邮件模板、代码规范、写作风格 | 查天气、读文件、调 GitHub |
经验：先看你要的功能是"AI 已经会做，只是要按你的规范"——那是 Skill；如果是"AI 根本不知道答案，需要去查"——那是工具/MCP。
Skill 包从 GitHub 长什么样
社区已经有很多公开的 Skill 包仓库。你可以直接用「从 GitHub 导入」拉它们。导入支持：
- 顶层目录：自动找
SKILL.md /tree/branch/path/to/skill/：指定分支和子目录- 整个仓库：自动遍历每个含 SKILL.md 的子目录批量导入
Shortcut 工具的 URL Scheme
如果你想从 iOS 外部触发 ETOS 的某个 Shortcut 工具，可以用 URL Scheme：
etos-llm-studio://shortcut-tool?name=工具名&input=输入文本具体协议格式参考拓展功能里的 URL Scheme 说明。
技能权限的"allowed-tools"
SKILL.md 的 frontmatter 里可以写 allowed-tools 字段——这是 Skill 作者的约定描述，ETOS 不会基于它真正去限制工具调用。它只是告诉 AI"按设计这个技能应该用这些工具"。
ETOS 本身只提供 use_skill 这一个读取能力，不会执行 Skill 里写的脚本或本地命令。