功能描述

集成178+ AI专家角色，支持中文调用、分类浏览、关键词搜索及智能匹配，助你快速找到并使用各领域专家解决问题。

使用说明 (SKILL.md)

专家工具箱 (Expert Toolkit)

Name: 专家工具箱
Author: catkid010520

集成 agency-agents 项目的 178+ AI专家角色（来自 msitarzewski/agency-agents，原 agency-orchestrator 官方迁移），让你随时召唤不同领域的AI专家帮你解决问题。

📋 功能概览

功能	说明	使用示例
直接调用	通过专家名直接调用专家	`/expert 产品经理帮我分析这个需求`
列出分类	查看所有专家分类	`/expert categories`
列出分类下专家	查看某个分类下所有专家	`/expert list 技术`
搜索专家	按关键词搜索专家	`/expert search 代码`
智能匹配	根据你的需求自动匹配最合适的专家	`/expert @expert 帮我做代码审查`

🚀 快速开始

1. 安装

解压 expert-toolkit.zip 到你的 skills 目录
确保已经导入了专家角色文件到 knowledge/agency-orchestrator/roles/ 目录
完成，直接使用！

2. 使用方式

专家工具箱支持三种调用方式，满足不同场景：

方式一：直接调用已知专家

如果你知道专家名字，直接调用：

/expert {专家名} {你的问题}

支持：

中文名称（需要配置映射，常用专家已内置）
英文ID（原始ID，一定可用）
中文模糊匹配（输入"代码"能匹配"代码审查员"）

示例：

/expert 产品经理 帮我分析这个用户需求，给出产品规划建议

/expert engineering-code-reviewer 帮我检查这段Python代码，找出问题

方式二：搜索/浏览专家

如果你不确定有哪些专家，可以先搜索浏览：

1️⃣ 查看所有分类：

/expert categories

返回所有分类，显示中文名称 + 专家数量。

2️⃣ 查看分类下所有专家：

/expert list {分类名}

支持中文分类名：

/expert list 技术
/expert list 产品
/expert list 测试

3️⃣ 搜索专家：

/expert search {关键词}

支持中文关键词、英文关键词，会搜索：

专家ID
专家中文名
分类名称
中文映射表（支持简写匹配）

示例：

/expert search 代码
/expert search manager
/expert search 财务

方式三：智能自动匹配（推荐！）

只需要说清楚你的需求，专家工具箱会自动匹配最合适的专家：

/expert @expert {你的需求描述}

示例：

/expert @expert 帮我做代码审查，看看这段代码有什么问题

/expert @expert 帮我做财务分析，评估这个项目投资回报率

/expert @expert 帮我做产品需求分析，画出用户故事地图

原理： 根据内置关键词映射，匹配最相关的专家，返回所有匹配结果。

🌍 中文支持说明

专家工具箱对中文用户做了完整优化：

中文分类映射

所有常用分类都有中文映射，你可以直接用中文：

中文	英文	专家数量
产品	product	5
设计	design	8
技术	engineering	29
财务	finance	5
游戏	game-development	5
市场	marketing	30
营销	paid-media	7
项目	project-management	6
销售	sales	8
战略	strategy	3
客服	support	6
测试	testing	8
数据	data	-

中文专家名称调用

常用专家已经配置了中文→英文映射，可以直接用中文调用：

示例：

产品经理 → product-product-manager
代码审查员 → engineering-code-reviewer
架构师 → engineering-software-architect

逐步完善中，常用专家会陆续添加映射。

⚙️ 配置文件说明

配置文件都在 config/ 目录下：

文件	作用
`chinese_translate.json`	中文名称 → 专家ID映射，方便直接中文调用
`keyword_mapping.json`	关键词 → 专家ID列表映射，用于智能自动匹配

添加自定义中文映射

编辑 config/chinese_translate.json：

{
  "产品经理": "product-product-manager",
  "代码审查员": "engineering-code-reviewer",
  "你的自定义名称": "expert-id"
}

添加自定义关键词映射

编辑 config/keyword_mapping.json：

{
  "代码审查": ["engineering-code-reviewer"],
  "需求分析": ["product-product-manager", "product-product-trend-researcher"],
  "你的关键词": ["expert-id-1", "expert-id-2"]
}

📊 专家分类统计

当前版本：

总专家数： 178
总分分类： 18

详细：

分类	中文	专家数
academic	-	5
design	设计	8
engineering	技术	29
examples	-	6
finance	财务	5
game-development	游戏	5
integrations	-	1
marketing	市场	30
paid-media	营销	7
product	产品	5
project-management	项目	6
sales	销售	8
scripts	-	0
spatial-computing	-	6
specialized	-	41
strategy	战略	3
support	客服	6
testing	测试	8

🔒 安全说明

专家工具箱完全安全：

❌ 不执行任何用户输入代码
❌ 不写入任何文件（仅读取专家角色markdown）
❌ 不发起任何网络请求
✅ 所有专家角色文件都存储在本地，不向外传输

🎯 设计原则

不重复存储：专家角色存放在 knowledge/agency-orchestrator/ 复用原项目，skill只提供调用层
多种使用方式并存：直接调用/搜索/自动匹配，满足不同场景
中文优先：完整的中文分类、中文搜索、中文调用体验
高性能：启动建立O(1)索引，所有查询都是瞬间完成
优雅降级：配置文件损坏/文件读取失败都有警告，不崩溃

📝 更新日志

2026-04-17 v1.1.0

✅ 同步最新 msitarzewski/agency-agents 仓库
✅ 新增 marketing 分类，新增 30 位市场营销领域专家（抖音/小红书/知乎/直播电商等专家都有了）
✅ 添加中文分类映射：市场 / 市场营销 → marketing
✅ 现在总计 18 个分类，178 位专家

2026-04-17 v1.0.0

✅ 完成基础功能开发
✅ 支持列出分类、列出专家、搜索专家、直接调用、自动匹配
✅ 完整中文支持
✅ 所有测试通过，零已知bug
✅ 正式发布

🙏 致谢

专家角色来自 agency-agents 项目（原 agency-orchestrator 官方迁移），感谢原作者
适配到 OpenClaw by 萌面大侠🦐

📄 License

Apache-2.0 (和原项目一致)

安全使用建议

This skill is coherent with its description: it loads local 'expert' markdown files, indexes and matches them, and returns text. Before installing or using it: 1) Verify the expert-role files you place under the roles directory come from trusted sources (prompts can contain instructions or sensitive content). 2) Avoid setting EXPERT_TOOLKIT_ROLES_ROOT to system or sensitive directories (that would let the skill read unrelated files). 3) If you expect the skill to call external services, inspect the remaining parts of scripts/expert_toolkit.py for network calls — the inspected portions show only file reads/formatting. 4) If you will use third-party role packs (e.g., from GitHub), scan them for prompts that ask for secrets or to contact external endpoints before adding them to your roles folder.

功能分析

Type: OpenClaw Skill Name: expert-toolkit Version: 1.1.1 The 'expert-toolkit' skill is a prompt management utility designed to load and apply various 'AI expert' personas from local markdown files. The core logic in `scripts/expert_toolkit.py` involves indexing and searching through a specific directory (~/.openclaw/workspace/knowledge/agency-orchestrator/roles) to retrieve system prompts. The code lacks network access, file-writing capabilities, or dangerous execution sinks (like eval or subprocess). It functions entirely as a local librarian for prompt templates, aligning perfectly with its stated purpose in `SKILL.md`.

能力评估

✓ Purpose & Capability

Name/description (Expert Toolkit for browsing and invoking local expert-role prompts) matches what the package contains: config mapping files, search/matching code, and routines to load markdown role files. There are no unexpected credentials, binaries, or install steps.

ℹ Instruction Scope

SKILL.md instructs only local usage (read role markdowns, search/match, return text). The code reads config/ and a roles directory and returns formatted results. Note: the library will read any markdown files under the configured roles root (default ~/.openclaw/workspace/knowledge/agency-orchestrator/roles), and an environment variable (EXPERT_TOOLKIT_ROLES_ROOT) can override that path — so the skill will read whatever is placed in that directory. The skill claims it does not execute user code or make network requests; the visible code implements read-only loading/formatting of role markdowns and does not show execution or outbound network calls in the inspected portions.

✓ Install Mechanism

No install spec — instruction-only with packaged Python scripts and config files. Nothing is downloaded or executed during install; no archives or remote installers are used.

ℹ Credentials

The skill requests no credentials and has no required environment variables. It does honor EXPERT_TOOLKIT_ROLES_ROOT to override the roles directory — this is reasonable for flexibility but means a user or process could point it at an arbitrary path, allowing the skill to read files outside the default workspace. That behavior is explainable by the skill's purpose but worth noting.

✓ Persistence & Privilege

No elevated privileges requested. always is false; the skill does not claim to persist or modify other skills or system settings. It reads local files and config only within its own scope.

版本历史

v1.1.1

集成 agency-agents 项目的 178+ AI专家角色（来自 msitarzewski/agency-agents），中文完整适配，开箱即用！随时召唤产品经理、架构师、营销专家、数据分析师等不同领域专家帮你解决问题。支持直接调用、分类浏览、关键词搜索、智能匹配多种方式。

v1.1.0

完整适配 OpenClaw，集成 178+ 专家角色来自 msitarzewski/agency-agents，感谢原作者。完整中文支持，五种调用方式：直接调用/分类浏览/搜索/智能匹配。

元数据

Slug expert-toolkit

版本 1.1.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题

专家工具箱是什么？

集成178+ AI专家角色，支持中文调用、分类浏览、关键词搜索及智能匹配，助你快速找到并使用各领域专家解决问题。它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 93 次。

如何安装专家工具箱？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install expert-toolkit」即可一键安装，无需额外配置。

专家工具箱是免费的吗？

是的，专家工具箱完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

专家工具箱支持哪些平台？

专家工具箱跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了专家工具箱？

由 catkid010520（@catkid010520）开发并维护，当前版本 v1.1.1。

专家工具箱