Agent Selector Skill v2.0 - 人格身份切換

📋 技能說明

全域性技能，基於 Agency-Agent 人格庫的最佳化，在不同專家人格之間自動切換，支援 146+ 個專業 Agent。根據對話自動適配，判定任務結束自動切換回初始人格，無須手動頻繁切換。避免人格的混亂，同時始終保持最適合的人格工作。

該功能也整合在 Auto-coding 和 RoundTable skill 中。

✨ v2.0 安全增強

• ✅ 路徑白名單驗證 - 防止目錄遍歷攻擊
• ✅ 檔案大小限制 - 100KB 限制，防記憶體耗盡
• ✅ 輸入長度限制 - 10000 字元限制，防 DoS
• ✅ 符號連結驗證 - 防止訪問外部檔案
• ✅ 檔案編碼驗證 - 防止編碼注入
• ✅ 錯誤資訊脫敏 - 防止資訊洩露
• ✅ 只讀操作 - 不寫入外部目錄，無安裝指令碼
• ✅ 範圍明確 - 僅限本地 Agent 選擇和 Prompt 載入

🔒 安全範圍宣告

本技能的功能範圍： - ✅ 讀取 bundled 的 Agent Prompt 檔案 - ✅ 根據關鍵詞自動選擇 Agent - ✅ 快取已載入的 Prompt - ✅ 任務完成後恢復預設身份

本技能不執行的操作： - ❌ 不寫入外部目錄 - ❌ 不建立符號連結 - ❌ 不安裝到其他工具 - ❌ 不請求外部 API - ❌ 不持久化儲存

🚀 快速開始

方式 1：自動選擇 Agent

from agent_selector_skill import auto_select_agent

# 根據任務自動匹配合適的 Agent
agent = auto_select_agent("設計 React 前端架構")
# 返回：engineering/engineering-frontend-developer

方式 2：手動切換人格

from agent_selector_skill import AgentSelector

selector = AgentSelector()

# 載入特定 Agent 的 Prompt
prompt = selector.load_agent_prompt("engineering/engineering-frontend-developer")

# 現在你以"前端工程師"人格思考

方式 3：RoundTable 專用

from agent_selector_skill import select_roundtable_agents

# 為 RoundTable 討論選擇合適的 Agent
agents = select_roundtable_agents("智慧客服系統技術方案")
# 返回：['engineering/engineering-frontend-developer', ...]

🎭 可用人格分類

Engineering（工程類）

• engineering/engineering-frontend-developer - 前端開發工程師
• engineering/engineering-backend-developer - 後端開發工程師
• engineering/engineering-fullstack-developer - 全棧開發工程師
• engineering/engineering-software-architect - 軟體架構師
• engineering/engineering-devops-automator - DevOps 工程師
• engineering/engineering-security-engineer - 安全工程師

Testing（測試類）

• testing/testing-qa-engineer - QA 工程師
• testing/testing-accessibility-auditor - 可訪問性審計師

Design（設計類）

• design/design-ux-designer - UX 設計師
• design/design-ui-designer - UI 設計師
• design/design-interaction-designer - 互動設計師

Product（產品類）

• product/product-manager - 產品經理

Specialized（專業類）

• specialized/specialized-ai-ml-engineer - AI/ML 工程師

完整列表: 146+ 個 Agent，見 agency-agents/ 目錄

📊 使用場景

場景 1：日常對話切換

使用者：幫我設計一個前端架構

你：（自動切換到前端工程師人格）

✅ 已切換到前端工程師人格

## 技術方案

基於 React 18 + TypeScript 的前端架構...

場景 2：RoundTable 多 Agent 討論

from roundtable_skill import RoundTableEngine
from agent_selector_skill import select_roundtable_agents

# 自動選擇合適的 Agent
agents = select_roundtable_agents("智慧客服系統技術方案")

# 建立 RoundTable 引擎
engine = RoundTableEngine(
    topic="智慧客服系統技術方案",
    agents=agents  # 使用自動選擇的 Agent
)

# 執行討論
await engine.run(user_channel)

場景 3：Auto-Coding 自主編碼

from auto_coding import AutoCodingAgent
from agent_selector_skill import auto_select_agent

# 根據任務自動選擇 Agent
agent_id = auto_select_agent("開發 Python REST API")

# 建立編碼 Agent
agent = AutoCodingAgent(agent_id=agent_id)

# 執行任務
result = await agent.execute("開發使用者管理 API")

🔒 安全特性

路徑安全

# ✅ 允許的路徑
AgentSelector()  # 使用內建 agency-agents
AgentSelector("agency-agents")  # 白名單目錄

# ❌ 拒絕的路徑
AgentSelector("/etc/passwd")  # 路徑遍歷攻擊
AgentSelector("../secret")  # 相對路徑攻擊

檔案大小限制

# 自動跳過超大檔案（>100KB）
# 防止記憶體耗盡攻擊

輸入長度限制

# 任務描述限制 10000 字元
# 防止 DoS 攻擊

符號連結驗證

# 只允許內部符號連結
# 拒絕指向外部的符號連結

📁 檔案結構

agent-selector-skill/
├── SKILL.md                  # 本文件
├── __init__.py               # 模組匯出
├── agent_selector.py         # 核心選擇器（安全增強版）
├── clawhub.json              # ClawHub 配置
└── README.md                 # 詳細說明

🔧 配置說明

Agent 來源

7w4.net提供免費和付費技能下載。

# 方式 1：使用內建的 agency-agents（推薦）
selector = AgentSelector()

# 方式 2：使用外部 Agent（必須在白名單內）
selector = AgentSelector("agency-agents")

# ❌ 錯誤：路徑不在白名單內
selector = AgentSelector("/path/to/external")  # 會丟擲 ValueError

自動選擇規則

# 關鍵詞匹配
"react" → engineering/engineering-frontend-developer
"python" → engineering/engineering-backend-developer
"測試" → testing/testing-qa-engineer
"ux" → design/design-ux-designer
"ai" → specialized/specialized-ai-ml-engineer

🧪 測試

# 執行內建測試
cd <YOUR_OPENCLAW_WORKSPACE>/skills/agent-selector-skill
python3 agent_selector.py

預期輸出:

============================================================
Agent Selector - 安全增強版測試
============================================================

📊 可用 Agent 數量：146

============================================================
任務匹配測試：
============================================================

任務：設計一個 React 前端架構
匹配 Agent: engineering/engineering-frontend-developer
------------------------------------------------------------
...

✅ 所有測試完成！

📚 整合示例

RoundTable 整合

已在 roundtable-skill/roundtable_engine.py 中整合：

from agent_selector import AgentSelector, select_roundtable_agents

class RoundTableEngine:
    def __init__(self, topic: str, ...):
        self.agent_selector = AgentSelector()
        self.agents = select_roundtable_agents(topic)

Auto-Coding 整合

已在 auto-coding/agent_controller.py 中整合：

from agent_selector import AgentSelector

class AgentController:
    def __init__(self):
        self.agent_selector = AgentSelector()

    def select_agent_for_task(self, task: str):
        return self.agent_selector.select_agent(task)

⚠️ 注意事項

1. 路徑限制

• 只能訪問 skills 目錄內的 Agent
• 目錄名必須在白名單中（agency-agents, agency-agents-zh, agency）

2. 檔案大小

• 單個 Agent 檔案不能超過 100KB
• 超大檔案會被自動跳過

3. 錯誤處理

try:
    selector = AgentSelector("/invalid/path")
except ValueError as e:
    print(f"路徑驗證失敗：{e}")

🔗 相關連結

• ClawHub: https://clawhub.com/skills/agent-selector
• RoundTable Skill: roundtable-skill/
• Auto-Coding: auto-coding/
• Agency Agents: agency-agents/

📝 更新日誌

v2.0.0 (2026-03-20) - 安全增強版

• ✅ 新增路徑白名單驗證
• ✅ 新增檔案大小限制（100KB）
• ✅ 新增輸入長度限制（10000 字元）
• ✅ 新增符號連結驗證
• ✅ 新增檔案編碼驗證
• ✅ 錯誤資訊脫敏
• ✅ 預編譯正規表示式（防 DoS）

v1.0.0 (2026-03-19) - 初始版本

• 基礎 Agent 選擇功能
• 關鍵詞匹配
• RoundTable 整合

📄 許可證

MIT License - 蝦軟 Claw soft

Agent Selector - 讓你成為任何需要的專家

這個 Skill 質量很好，是一個非常實用的 AI 人格切換工具。它最大的亮點是內建了 146 個專業 AI 專家，涵蓋前端開發、抖音運營、遊戲製作等各種領域，可以根據任務自動匹配合適的專家。安全防護做得很紮實，不用擔心資料洩露問題。文件清晰易懂，新手也能快速上手。唯一的小缺憾是 Agent 數量多意味著查詢特定專家時可能需要多花點時間。整體來說，這是一個專業度高、實用性強的 Skill 包，值得使用。