MuseAI-Skills Skill 技能

技能简介

MuseAI-Skills 是一份 Muse AI（muse.ai）个人 AI Agent 运行环境的技能文档存档，包含 68 个独立 SKILL.md 文件（加上 4 个符号链接别名），覆盖研究、文档、办公、旅行、邮件等多个领域。这些技能文件详细描述了何时触发、如何分流任务、使用哪些工具、怎样处理授权与失败，以及如何验收交付物，是研究 AI Agent 工作流设计的珍贵参考样本。

核心能力

1. 72 个技能文件全景覆盖：包含 wide-research（多输入并行研究）、skill-creator（技能创建规范）、goals（目标管理）、gmail（邮件处理）、booking（实时预订）、artifacts（文档生成）等完整技能体系。
2. 工作流设计范本：每个技能都包含触发条件、任务分流逻辑、工具调用约束、授权 manifest 和交付验收标准，是构建自有 Agent 技能体系的绝佳参考。
3. 配套评测场景：部分技能（如 booking、duffel、opentable）附带了评测场景（eval 目录），可用于验证技能执行效果。
4. 多领域覆盖：从通用研究到具体垂直场景（旅行规划、餐厅预订、航班追踪），从内容生成到数据分析，技能库完整度高。
5. 权限 manifest 规范：gmail、google-calendar、duffel、opentable 等技能包含 manifest.yaml，明确列出每个工具的权限边界。
6. 跨记忆与状态管理：forget 技能专门处理 Agent 记忆清理和衍生状态同步，是高级 Agent 架构设计的重要参考。

安装配置

1. 研究用途（推荐）：直接 clone 仓库到本地，在 skills/ 目录下阅读感兴趣的技能文件，无需安装任何运行时环境。
2. 技能参考导入：挑选你需要的技能文件，复制到你的 Agent 的 skills/ 目录，参照其格式和结构创建自己的技能。
3. 运行环境快照参考：如果你是 AI Agent 开发者，可以参考仓库存档的 Linux x86-64 运行环境脚本和依赖配置。

使用步骤

1. 阅读技能目录：从仓库 README 的技能分类表中，找到与你需求最相关的技能（如 wide-research、travel-planning、artifacts/document）。
2. 精读 SKILL.md：每个技能目录下都有一个 SKILL.md 文件，包含完整的触发条件、指令模板、工具列表和输出规范。
3. 参考评测场景：部分技能在 eval/ 目录下有测试用例，可以帮助你理解技能的预期行为和验收标准。
4. 提取工作流设计：注意每个技能如何定义触发条件、如何分流任务（协调者 vs worker）、如何处理失败和部分成功。
5. 借鉴到自有技能：按照 skill-creator 技能的规范，创建或修改自己的技能文件，参考 manifest.yaml 格式定义工具权限。
6. 验证与迭代：将参考技能部署到你的 Agent 环境，参照 eval 场景测试效果并迭代改进。

适用场景

1. 构建自有 Agent 技能体系：参考 skill-creator 技能的规范，从零设计高质量的技能文件结构。
2. 研究多 Agent 协作模式：wide-research、goals、forget 等技能展示了协调者-工人架构和记忆管理的最佳实践。
3. 实现垂直领域工具调用：booking、duffel、opentable、flightaware 等技能展示了如何将外部 API 封装为 Agent 工具。
4. 文档与内容生成流程：artifacts/document、artifacts/markdown、artifacts/pdf 等技能覆盖了从文档生成到交付验收的完整流程。
5. 旅行与生活方式 Agent：travel-planning 和 booking 技能的组合展示了如何构建一个完整的旅行助手。

适用人群

1. AI Agent 开发者：需要构建高质量技能库或参考业界已有技能设计范式的工程师。
2. Agent 架构师：研究多 Agent 协作、记忆管理、任务分流等高级架构设计。
3. AI 产品经理：了解 AI Agent 的能力边界和技能设计思路，为产品规划提供参考。
4. AI 工具研究者：对 Muse AI（muse.ai）产品的工作原理和技能体系感兴趣的研究者。

工作原理

MuseAI-Skills 存档的技能遵循统一的 SKILL.md 格式，包含 YAML frontmatter（定义名称、描述、触发词、兼容性）和 Markdown 正文（编号指令、规则、输出格式）。协调者技能（如 wide-research）通过定义统一的输出字段和覆盖率报告机制，让多个并行 worker 的结果可以汇聚；工具类技能（如 gmail）则通过 manifest.yaml 定义每个 API 调用的权限边界，确保执行安全。

官方链接

• GitHub：https://github.com/win4r/MuseAI-Skills
• Muse AI 官网：https://muse.ai
• 技能目录（中文分析报告）：https://github.com/win4r/MuseAI-Skills/blob/main/PROJECT_ANALYSIS.md