技能系统
技能是旗鱼扩展 AI 能力的机制。每个技能是一组专用的工具和提示词，让 AI 能够完成特定领域的任务——就像给 AI 装上了「专业模块」。
内置技能
旗鱼自带了多个内置技能，覆盖办公、运维和协作场景：
| 技能 | 功能 | 需要配置 |
|---|---|---|
| Word 文档 | 创建和编辑 .docx 文档 | 否 |
| Excel 表格 | 读写 .xlsx 文件 | 否 |
| PDF 处理 | 读取和分析 PDF 文档内容 | 否 |
| 浏览器 | 网页浏览、截图、表单填写等自动化操作 | 否 |
| 邮件收发 | 查看、发送、回复邮件 | 需配置邮箱 |
| 日历待办 | 查看日程、创建事件、设置提醒 | 需配置日历 |
| 飞书 | 操作飞书多维表格、云文档、日历等 | 需配置飞书应用 |
| 钉钉 | 操作钉钉日历、待办、审批流程等 | 需配置钉钉应用 |
| 企业微信 | 操作企微通讯录、日程、审批等 | 需配置企微应用 |
| 觉醒模式 | 创建和管理自动化关切（Watch） | 否 |
| 性格定制 | 自定义 AI 的说话风格和人格特征 | 否 |
| 技能创建器 | 让 AI 自己编写新技能 | 否 |
内置技能无需安装，标记「需要配置」的技能需要在设置中填入对应的账号信息才能使用。
技能是怎么工作的
自动加载
你不需要手动激活技能。旗鱼会根据你的需求自动判断需要哪些技能并加载：
| 你说的话 | 自动加载的技能 |
|---|---|
| 「帮我写一份报告」 | Word 文档技能 |
| 「看看有没有新邮件」 | 邮件收发技能 |
| 「打开百度搜索一下」 | 浏览器技能 |
| 「今天有什么日程」 | 日历待办技能 |
| 「每天早上 9 点检查服务器」 | 觉醒模式技能 |
技能的组成
每个技能本质上是一个 Markdown 文件（SKILL.md），内容包含：
- 角色定义：AI 使用该技能时的身份和行为准则
- 工具描述：该技能提供的工具函数及其参数定义（Function Calling 格式）
- 使用示例：典型场景和对话示例，帮助 AI 理解如何使用工具
- 注意事项：使用限制、最佳实践等
实际执行流程
以「邮件技能」为例：
- 你说：「帮我给 team@company.com 发一封会议通知」
- 旗鱼检测到这是邮件相关需求，加载邮件技能
- AI 获得
send_email等工具的使用能力 - AI 调用
send_email工具，传入收件人、主题、正文 - 旗鱼的邮件服务实际执行发送操作
- AI 汇报发送结果
技能市场
社区贡献的技能可以通过技能市场安装：
浏览和安装
- 打开 设置 → 技能管理 → 技能市场
- 浏览可用技能，每个技能都有说明和示例截图
- 点击「安装」即可
也可以在官网的 技能市场 页面浏览所有可用技能。
通过 CLI 安装
使用命令行安装技能：
npm run sft -- skill:install <skill-name>
查看已安装技能：
npm run sft -- skill:list
管理已安装技能
在 设置 → 技能管理 中可以：
- 查看已安装技能列表和描述
- 卸载不需要的技能
- 查看技能内容（SKILL.md 源文件，了解技能的具体能力）
- 更新：重新安装以获取最新版本
自定义技能
让 AI 帮你创建
旗鱼内置了「技能创建器」，你可以让 AI 帮你编写新技能：
帮我创建一个技能，可以查询 Jira 上我的待办事项
AI 会根据你的需求生成 SKILL.md 文件，你确认后就可以使用。
手动创建
如果你熟悉 Markdown 和 Function Calling 格式，也可以手动创建技能文件。基本结构：
# 技能名称
## 角色
你是一个 XXX 助手...
## 工具
### tool_name
描述：做什么的
参数：
- param1 (string): 参数说明
贡献技能
如果你创建了实用的技能，欢迎分享给社区：
- 编写 SKILL.md 文件，定义技能的功能和工具
- 测试确认技能正常工作
- 在 GitHub 仓库 提交 Pull Request
- 审核通过后会出现在技能市场中
好的技能应该：
- 解决一个明确的问题场景
- 有清晰的工具定义和使用示例
- 包含错误处理和边界情况说明