talents - SkillTalent 对接海量 Claude Agent Skills

在 Solon AI 生态中，SkillTalent 是一个基于 Pool-Manager（挂载池管理）模型的 CLI 综合技能组件。它深度对齐了 Claude Code 的执行协议，使您可以直接复用海量的开源 AI 技能插件，快速打造一个类似于 Claude Code CLI 的智能终端应用。

SkillTalent 由三个核心 Talent 组成，可以独立使用或组合使用：

• TerminalTalent：充当 Agent 的"手"和"眼"，负责文件操作（ls, read, write, edit）和命令执行（bash）。
• SkillTalent：负责解析挂载池中的 SKILL.md，为 Agent 提供领域专家的指令指引。
• TodoTalent：提供复杂任务的拆解、进度跟踪及计划修订能力。

相关依赖包：solon-ai-skill-cli

1、什么是 SkillTalent？能干什么？

SkillTalent 是一个 AI 技能管理器。它基于底层的 MountManager（挂载池管理器），自动扫描挂载目录中包含 SKILL.md 的子目录，将其识别为一个个独立的技能单元，并为 Agent 提供发现、搜索和加载能力。

它能干什么？

• 技能发现：自动扫描挂载池中的技能目录（含 SKILL.md 的目录），提取名称和描述，构建技能索引。
• 三阶段自适应模式：根据技能数量自动切换交互模式 —— 少量时展示完整摘要，中等规模仅展示路径索引，大量时强制搜索定位。
• 技能检索：支持多关键字搜索，快速在海量技能库中找到匹配项。
• 技能加载：读取指定技能的 SKILL.md 详细说明书，同时列出该技能目录下的可用文件及逻辑路径映射。
• 热刷新：支持增量刷新指定挂载点或全量刷新所有挂载点的技能列表。

三阶段自适应模式

SkillTalent 内置了两个阈值参数（listThreshold 和 searchThreshold），根据当前技能库规模自动选择最优的交互策略：

这种设计确保了在少量技能时不暴露多余工具干扰 Agent，在大量技能时又提供了足够的检索能力。

2、快速开始

第一步：准备技能包

在使用 SkillTalent 之前，您需要下载一批符合 Claude Code 规范的技能插件。这些插件目录中通常包含一个 SKILL.md 文件，用于描述工具的用法。

• 推荐资源：https://github.com/zrt-ai-lab/opencode-skills 开源仓库 您可以将其克隆到本地目录。

第二步：创建挂载管理器

MountManager 是整个技能体系的基础设施。它负责管理工作区路径、注册挂载点，并将逻辑路径（如 @skills）解析为物理路径。

// 创建挂载管理器，指定工作区目录
MountManager mountManager = new MountManager("/WORK/my_project");

// 注册技能挂载点（类型为 SKILLS）
// 支持路径语法："./"（工作区相对）、"~/"（用户目录相对）、绝对路径
mountManager.register(MountDir.builder()
        .alias("@skills")
        .type(MountType.SKILLS)
        .path("/path/to/opencode-skills")
        .build());

第三步：集成到 Agent

通过 TerminalTalent 和 SkillTalent 组装完整的 CLI 能力，并配置 ReActAgent。

// 创建 TerminalTalent（提供 ls, read, write, edit, bash 等文件和命令工具）
TerminalTalent terminalTalent = new TerminalTalent(mountManager);
terminalTalent.setSandboxEnabled(true); // 默认已启用沙盒模式

// 创建 SkillTalent（提供技能发现、搜索和加载工具）
SkillTalent skillTalent = new SkillTalent(mountManager);

// 创建 TodoTalent（提供任务进度跟踪）
TodoTalent todoTalent = new TodoTalent();

ReActAgent agent = ReActAgent.of(LlmUtil.getChatModel())
        .name("SolonCodeAgent")
        .defaultTalentAdd(terminalTalent)  // 注入终端能力
        .defaultTalentAdd(skillTalent)     // 注入技能管理能力
        .defaultTalentAdd(todoTalent)      // 注入任务追踪能力
        .maxTurns(30)
        .autoRethink(true)
        .build();

// 发起任务：Agent 会自动 ls 目录，阅读代码，并根据需要调用 bash 执行指令
agent.prompt("帮我把当前目录下的所有 .wav 文件转换成 .mp3");

3、标准工具映射说明

TerminalTalent 内置工具

Agent 会根据上下文自动选择以下工具：

TerminalTalent 异步会话工具（可选启用）

通过 terminalTalent.setBashAsyncEnabled(true) 启用后，额外提供以下工具，用于处理长时间运行的命令：

SkillTalent 内置工具

TodoTalent 内置工具

4、挂载管理体系

MountManager 核心概念

MountManager 是 SkillTalent 的基础设施，管理着逻辑路径到物理路径的映射关系：

多技能池挂载

支持注册多个不同类型的挂载点，实现资源隔离：

MountManager mountManager = new MountManager("/WORK/my_project");

// 技能类挂载（只读）
mountManager.register(MountDir.builder()
        .alias("@media")
        .type(MountType.SKILLS)
        .path("/path/to/ffmpeg-skills")
        .build());

// 另一个技能挂载
mountManager.register(MountDir.builder()
        .alias("@ops")
        .type(MountType.SKILLS)
        .path("/path/to/deploy-scripts")
        .build());

// 代理类挂载
mountManager.register(MountDir.builder()
        .alias("@agents")
        .type(MountType.AGENTS)
        .path("/path/to/agent-configs")
        .build());

Agent 在执行时，可以通过逻辑路径（如 @media/extract_audio.sh）安全地访问这些资源。

挂载点操作

// 移除挂载（同时清理关联的技能缓存）
mountManager.remove("@ops");

// 增量刷新指定挂载点
mountManager.refresh("@media");

// 全量刷新所有挂载点
mountManager.refresh();

// 查询挂载下的技能列表
List<SkillDir> skills = mountManager.getSkillsByMount("@media");

// 路径解析
Path realPath = mountManager.resolve(workDir, "@media/scripts/convert.sh");

TerminalTalentProxy 精细化工具控制

如果不需要暴露 TerminalTalent 的全部工具，可以使用 TerminalTalentProxy 进行按需筛选：

TerminalTalent terminalTalent = new TerminalTalent(mountManager);

// 创建代理，仅暴露指定工具
TerminalTalentProxy proxy = new TerminalTalentProxy(terminalTalent);
proxy.addTools("read", "grep", "glob", "ls");

// 将代理注册到 Agent（而非原始 TerminalTalent）
agent.defaultTalentAdd(proxy);

5、沙盒模式

沙盒模式是 TerminalTalent 的核心安全机制，默认启用。启用后，Agent 的所有文件和命令操作都受到严格约束。

沙盒层级

TerminalTalent 提供了从轻量到严格的逐级安全防护：

沙盒关键行为

• 路径约束：沙盒模式下只能使用相对路径（如 src/app.java）或逻辑路径（如 @skills/tool.sh），严禁使用绝对路径。
• 符号链接防护：会解析真实路径，防止通过符号链接越界。
• 强制拒绝清单：即使在开放模式下，也禁止写入 .gitconfig、.bashrc、.mcp.json 等敏感配置文件及 .git/hooks、.vscode、.idea 等敏感目录。
• 自动忽略目录：ls、grep、glob 等工具会自动忽略 .git、node_modules、target、build、.idea 等干扰目录。

// 基础沙盒配置
terminalTalent.setSandboxEnabled(true);
terminalTalent.setSandboxAllowUserHome(false); // 禁止 ~ 路径

// 高级沙盒配置（OS 内核级隔离 + 文件系统策略）
terminalTalent.setSandboxSystemRestrict(true);
terminalTalent.setSandboxConfig(SandboxRuntimeConfig.builder()
        .filesystem(FilesystemConfig.builder()
                .allowWrite(Arrays.asList("./src", "./config"))
                .denyRead(Arrays.asList("./secrets"))
                .build())
        .build());

6、TerminalTalent 环境自适应

TerminalTalent 在初始化时会自动探测运行环境并适配：

• Shell 类型：自动识别 Unix Shell（bash/sh）、Windows CMD、Windows PowerShell，使用对应的命令执行方式和环境变量语法（$VAR / %VAR% / $env:VAR）。
• 运行时探测：自动探测系统中的 Python（python3/python）和 Node.js（node/nodejs）命令，并作为 $PYTHON 和 $NODE 环境变量注入到 bash 执行环境中。
• 跨平台路径处理：自动处理 Windows 和 Unix 的路径分隔符差异。