酷友社 AI安装 Skills

Agent 教程中心

选择你的 Agent，安装酷友社 Skills

已经有 Agent，就直接找到对应教程；还没有 Agent，就先安装 KAI，再用软件市场逐个安装和验证其他 Agent。

选择我的 Agent 用 KAI 安装 Agent

还没有合适的 Agent

用 KAI 安装多个 Agent，每次都验收到可用

KAI 软件市场负责让安装容易开始；标准流程失败时，再由 AI 根据日志诊断。不同 Agent 应逐个安装、逐个验证。

先安装 KAI
  1. 01

    安装并启动 KAI

    选择当前系统的 KAI 版本，先确认客户端能够正常启动。

  2. 02

    打开 Agent 软件市场

    查看当前版本已经上架的 Agent，不把规划中的条目当成已发布。

  3. 03

    逐个选择 Agent

    先完成一个 Agent 的安装和验收，再继续安装下一个，避免依赖和端口问题混在一起。

  4. 04

    执行标准安装

    KAI 准备下载、目录、依赖与启动方式，并在修改系统前说明影响。

  5. 05

    失败时由 AI 接管

    读取日志，判断网络、权限、依赖或配置问题，再提出修复方案。

  6. 06

    安装 Skills 并验证

    按照本页对应教程安装 Skills，重新进入会话并完成第一个只读任务。

软件市场条目和一键安装能力以当前 KAI 客户端为准。尚未上架或尚未验证的 Agent，会在下面明确标为“适配中”。

01

KAI

还没有 Agent 时的轻量起点。KAI 使用自身托管的 Skills 与 System Pack，并能继续帮助你安装其他软件和 Agent。

KAI 内置支持
用 KAI 安装

KAI 不需要安装自己。先从下载页选择当前系统的版本，完成启动后，再进入软件市场选择其他 Agent。

Skills 目录由 KAI 托管，不使用第三方 Agent 的 generic 安装目录

安装酷友社 Skills

先预演，再确认写入。示例只安装软件管理 Skill，不会一次安装全部平台能力。

在 KAI 中检查并准备能力请检查当前 KAI 是否已经提供 kai-software；如果没有，先说明可用的受管安装方式、来源和验证方法，不要直接修改文件。

安装后怎样验证

目录中出现文件不等于 Agent 已经会用，至少完成以下检查。

  1. KAI 可以列出当前可用的业务 Skills 或系统能力
  2. 执行任务前能够识别目标系统，而不是把控制端当成目标设备
  3. 安装软件后继续检查版本、进程、端口或页面
适用系统

Windows · macOS · Docker · iStoreOS

当前限制

KAI 的内置 Skills、来源锁和目标 Transport 是独立流程，不应套用第三方 Agent 的 remote-control preset。客户端功能和软件市场上架情况以当前发布版本为准。

02

Codex

适合代码和终端任务。kai-skills 安装器已经覆盖 Codex 的默认 Skills 目录和发现流程。

已验证
用 KAI 安装

在 KAI 软件市场中选择 Codex。标准安装完成后，确认 Codex 能启动并访问工作目录，再按下面的命令安装 Skills。

Skills 目录$CODEX_HOME/skills，未设置时为 ~/.codex/skills

安装酷友社 Skills

先预演，再确认写入。示例只安装软件管理 Skill，不会一次安装全部平台能力。

先克隆官方仓库git clone https://github.com/linkease/kai-skills.git && cd kai-skills
预演单个业务 Skillsh install.sh --skill kai-software --consumer codex --dry-run
确认预演结果后安装sh install.sh --skill kai-software --consumer codex

安装后怎样验证

目录中出现文件不等于 Agent 已经会用，至少完成以下检查。

  1. 预演结果显示 consumer 为 codex，并列出目标目录和版本
  2. 目标目录中存在 kai-software/SKILL.md
  3. 重新打开会话后，Codex 能发现 kai-software 并说明适用任务
适用系统

Windows · macOS · Linux

当前限制

已验证的是 Skills 的安装、目录发现和加载结构，不代表所有设备、软件和网络环境都已完成真实安装验收。

03

OpenCode

支持标准 Skill 文件的开源 Agent。安装器已经覆盖 OpenCode 的默认配置目录和 Skill 解析。

已验证
用 KAI 安装

在 KAI 软件市场中选择 OpenCode。完成标准安装并确认 OpenCode 可以启动后，再安装所需的酷友社 Skills。

Skills 目录$XDG_CONFIG_HOME/opencode/skills，默认是 ~/.config/opencode/skills

安装酷友社 Skills

先预演，再确认写入。示例只安装软件管理 Skill，不会一次安装全部平台能力。

先克隆官方仓库git clone https://github.com/linkease/kai-skills.git && cd kai-skills
预演单个业务 Skillsh install.sh --skill kai-software --consumer opencode --dry-run
确认预演结果后安装sh install.sh --skill kai-software --consumer opencode

安装后怎样验证

目录中出现文件不等于 Agent 已经会用，至少完成以下检查。

  1. 预演结果显示 consumer 为 opencode，并列出目标目录和版本
  2. 目标目录中存在 kai-software/SKILL.md
  3. 重新打开会话后，OpenCode 能解析 Skill 名称、描述和执行资源
适用系统

Windows · macOS · Linux

当前限制

已验证的是安装器与实际 Skill 解析结构；模型调用质量、目标设备连接和具体软件安装仍需要单独验收。

04

WorkBuddy

计划通过标准 SKILL.md 目录接入。当前先识别它实际扫描的目录，再使用通用安装模式预演。

适配中
用 KAI 安装

在 KAI 软件市场中查看 WorkBuddy 是否已上架。若当前版本尚未提供，请不要把规划能力当成已经发布。

Skills 目录尚未验证固定目录，必须先由 WorkBuddy 返回实际扫描路径

安装酷友社 Skills

先预演，再确认写入。示例只安装软件管理 Skill，不会一次安装全部平台能力。

先让 Agent 只读确认目录请先告诉我你实际扫描的 Skills 目录，并确认能够发现标准 SKILL.md。不要安装或修改文件，等我确认目录后再继续。
获得真实目录后预演sh install.sh --skill kai-software --consumer generic --target-skills /path/to/agent/skills --dry-run

安装后怎样验证

目录中出现文件不等于 Agent 已经会用，至少完成以下检查。

  1. WorkBuddy 明确返回其实际扫描的 Skills 目录
  2. dry-run 没有写入文件，并显示正确目标目录
  3. 安装后 WorkBuddy 能发现 kai-software/SKILL.md，再进行第一个只读任务
适用系统

以当前客户端为准

当前限制

尚未完成 WorkBuddy 专用目录、加载器和真实客户端验收。当前教程是通用兼容路径，不应标记为已验证。

05

DSH

计划通过标准 SKILL.md 目录接入。当前使用通用安装器，但必须先确认 DSH 的真实 Skills 搜索路径。

适配中
用 KAI 安装

在 KAI 软件市场中查看 DSH 是否已上架。若没有可用条目，页面只说明目标流程，不声称已经支持一键安装。

Skills 目录尚未验证固定目录，必须先由 DSH 返回实际扫描路径

安装酷友社 Skills

先预演，再确认写入。示例只安装软件管理 Skill，不会一次安装全部平台能力。

先让 Agent 只读确认目录请先告诉我你实际扫描的 Skills 目录，并确认能够发现标准 SKILL.md。不要安装或修改文件，等我确认目录后再继续。
获得真实目录后预演sh install.sh --skill kai-software --consumer generic --target-skills /path/to/agent/skills --dry-run

安装后怎样验证

目录中出现文件不等于 Agent 已经会用，至少完成以下检查。

  1. DSH 明确返回其实际扫描的 Skills 目录
  2. dry-run 没有写入文件，并显示正确目标目录
  3. 安装后 DSH 能发现 kai-software/SKILL.md，再进行第一个只读任务