面向 AI 辅助阅读的文档

主路径

1. oo-cli

当你希望 Agent 调用真实 API 和可复用能力时，从 oo-cli 开始。

• 适合 Codex、Claude Code、终端 Agent 和其他本地 Agent 宿主
• 让 Agent 调用已连接 App 的工具、package、Skill 和受管自定义工具
• 当现成 App、工具、package 或 Skill 已经够用时，这是最短路径

2. App、工具和授权

用 App 和工具区分“人连接什么”和“Agent 调用什么”。

• App 是连接到 OOMOL 的产品或服务，例如 Gmail、Slack、GitHub、Notion、Linear、文件、数据库或模型提供方
• 工具是 Agent 通过 OOMOL 调用的具体动作
• OOMOL 负责管理账号访问、权限、调用量和执行记录，Agent 不需要拿到原始账号凭据

3. Skills

当任务不再是一次性的 API 调用，而是一套可重复的工具使用方法时，使用 Skill。

• 保存该调用哪些工具、带上什么上下文、遵守什么约束，以及如何检查结果
• 把 Gmail、Notion、GitHub、Slack、Linear 等工具的稳定用法变成 Agent 可复用说明
• 避免 Agent 每次遇到类似任务时重新摸索同一套工具使用方式

文档如何使用

• App 与工具：如果你需要明确已连接产品和 Agent 可调用能力的命名模型，先看这里
• oo-cli：如果你想让 Agent 调用已连接 App 的工具、package、Skill 和受管自定义工具，就从这里开始
• oo-cli 命令参考：当你需要准确命令、参数和行为说明时，看这里
• Support：如果你需要发布、社区和相关运维信息，就看这里

用户路径与产品层次

graph TB
    User["用户 / Agent<br/>想使用工具"]

    subgraph UserPath["你会直接使用的入口"]
        Community["社区 / 目录<br/>发现 package 和示例"]
        CLI["oo-cli<br/>搜索、查看并调用工具"]
        Apps["已连接 App<br/>批准账号和动作"]
        Skills["Skills<br/>可复用的工具使用方法"]
        Records["记录<br/>权限、用量、文件和日志"]
    end

    User -->|"找现成能力"| Community
    User -->|"在终端或 Agent 中调用"| CLI
    Community -->|"找到 package"| CLI
    CLI -->|"使用已批准访问"| Apps
    Apps -->|"运行工具"| Records
    Records -->|"稳定方法"| Skills
    Skills -->|"下次复用"| CLI
    Records -->|"任务完成"| Done["任务完成"]

• 想找现成能力时，先去社区或目录发现 package，再用 oo-cli 搜索、查看并调用已连接 App 的工具、package 和 Skill。
• 当一套工具使用方式变得稳定时，把它固化成 Skill，让 Agent 复用同样的说明、约束、检查方式和结果格式。
• 当你的 AI 助手需要准确 CLI 语法，而不是概念解释时，直接查看命令参考。