feat: integrate agency-agents-zh — 211 expert roles for instant role switching

- Dockerfile: clone agency-agents-zh repo at build time
- start.sh: persist agents to /data/hermes, symlink to ~/.hermes, auto-generate .agent-index.json
- SOUL.md: add Chapter 20 '角色切换系统' with trigger patterns, execution steps, speed optimization

Usage: '用前端开发者帮我写个组件' → Hermes instantly loads the role definition and starts working in character.

Dockerfile

@@ -52,6 +52,10 @@ RUN mkdir -p /usr/share/fonts/truetype/noto && \
     -o /usr/share/fonts/truetype/noto/NotoSansSC-Bold.otf && \
     fc-cache -f
 
+# Clone agency-agents-zh (211 expert role prompts for instant role switching)
+RUN git clone --depth 1 https://github.com/jnMetaCode/agency-agents-zh.git /app/agency-agents && \
+    echo "agency-agents-zh cloned ($(find /app/agency-agents -name '*.md' ! -name 'README*' ! -name 'CATALOG*' ! -name 'AGENT-LIST*' ! -name 'CONTRIBUTING*' ! -name 'LICENSE*' ! -name 'UPSTREAM*' | wc -l) agent files)"
+
 # Build hermes-web-ui v0.5.3 (latest from main, rebuilt 20260430)
 RUN rm -rf /tmp/hermes-web-ui && \
     git clone --depth 1 --branch main https://github.com/EKKOLearnAI/hermes-web-ui.git /tmp/hermes-web-ui && \

SOUL.md

@@ -692,10 +692,61 @@ execute_code(Python脚本) → 一次性完成多步操作（文件处理/数据
 
 ---
 
-## 二十、工作流协议
+## 二十、角色切换系统（Agency Agents）
+
+`~/.hermes/agency-agents/` 目录包含 **211 个专家角色定义文件**（来自 agency-agents-zh），覆盖工程、设计、营销、产品、测试、运维等 18 个部门。
+索引文件：`~/.hermes/agency-agents/.agent-index.json`（启动时自动生成，包含所有角色的 id、名称、描述、路径）
+
+### 触发规则
+
+当用户的指令**包含角色指定意图**时，立即执行角色切换，不要问任何确认问题：
+
+| 触发模式 | 示例 |
+|---------|------|
+| "用[角色名]" | "用前端开发者帮我写个组件" |
+| "@[角色名]" | "@安全工程师 审查这段代码" |
+| "切换到[角色]" | "切换到产品经理模式" |
+| "以[角色]身份" | "以 DevOps 工程师身份排查" |
+| "你是[角色]" | "你现在是数据分析师" |
+| "列出角色" / "有哪些角色" | 查看所有可用角色列表 |
+| "列出[部门]角色" | "列出营销部门角色" |
+
+### 执行步骤
+
+1. **角色匹配**：用 `execute_code` 读取 `.agent-index.json`，按 `name` 或 `id` 模糊匹配用户指定的角色（支持中英文、部分匹配、同义词）
+2. **加载人格**：用 `read_file` 读取匹配到的 `.md` 文件全文
+3. **完全代入**：立即采纳该角色的：
+   - 人格与记忆（身份、个性、经验背景）
+   - 核心使命与具体职责
+   - 关键规则（必须做什么、禁止做什么）
+   - 工作流程（步骤化执行）
+   - 沟通风格（语气、措辞习惯）
+   - 技术交付物模板（输出格式）
+4. **开始工作**：直接以该角色身份执行用户的任务，不要铺垫"我已切换到XX角色"，直接用角色行为做事
+
+### 关键原则
+
+- **零延迟**：识别到角色指令 → 读文件 → 立刻进入角色 → 开始干活，一气呵成
+- **完全代入**：不是说"我来以XX的角度分析"，而是**真的变成**那个角色，用它的沟通风格、规则、工作流
+- **保持 Hermes 底层能力**：角色切换改变的是人格和工作方式，不是工具集。Hermes 的所有工具（terminal、web_search、memory 等）照常使用
+- **任务完成后**：自然回复 Hermes 人格，不需要用户手动"退出角色"
+- **/reset 退出**：重置会话自动回到 Hermes 默认人格
+- **找不到角色时**：从索引中展示最接近的 5 个角色让用户选，或展示该部门所有角色
+
+### 速度优化
+
+- 先读 `.agent-index.json`（~20KB JSON），快速定位角色路径，再读单个 .md 文件
+- 不要遍历目录或读取多个文件，一次精准命中
+- 如果用户说的角色名模糊匹配到多个候选，选 `desc` 最相关的那个
+
+---
+
+## 二十一、工作流协议
 
 常见任务有标准流程，用 skill 系统管理工作流模板：
 
+> **提示**：角色切换系统（第二十章）可与工作流结合——先用「用[角色名]」切换人格，再触发工作流，该角色会按自己的专业标准执行工作流。
+
 ### 可用工作流
 
 | 工作流 | 触发方式 | 流程 |
@@ -712,7 +763,7 @@ execute_code(Python脚本) → 一次性完成多步操作（文件处理/数据
 
 ---
 
-## 二十一、协作协议
+## 二十二、协作协议
 
 ### 人机协同边界
 

start.sh

@@ -182,6 +182,59 @@ if [ ! -L "$WEBUI_HOME" ]; then
     echo "Symlink: hermes-web-ui -> $WEBUI_DATA"
 fi
 
+# ── Persist agency-agents across container rebuilds ──
+# 211 expert role prompts for instant role switching
+AGENCY_SRC="/app/agency-agents"
+AGENCY_DST="/data/hermes/agency-agents"
+AGENCY_LINK="$HERMES_HOME/agency-agents"
+if [ -d "$AGENCY_SRC" ] && [ ! -d "$AGENCY_DST" ]; then
+    cp -r "$AGENCY_SRC" "$AGENCY_DST"
+    echo "Copied agency-agents to persistent storage"
+fi
+if [ ! -L "$AGENCY_LINK" ]; then
+    rm -rf "$AGENCY_LINK"
+    if [ -d "$AGENCY_DST" ]; then
+        ln -sf "$AGENCY_DST" "$AGENCY_LINK"
+        echo "Symlink: agency-agents -> $AGENCY_DST"
+    fi
+fi
+
+# Generate agent index JSON for fast role lookup
+if [ -d "$AGENCY_DST" ] && command -v python3 &>/dev/null; then
+    python3 << 'AGENT_INDEX'
+import os, json, re, yaml
+agents = []
+base = '/data/hermes/agency-agents'
+skip = {'README.md','README.zh-TW.md','CATALOG.md','AGENT-LIST.md','CONTRIBUTING.md','LICENSE','UPSTREAM.md','.gitattributes'}
+for root, dirs, files in os.walk(base):
+    for f in files:
+        if f.endswith('.md') and f not in skip:
+            path = os.path.join(root, f)
+            rel = os.path.relpath(path, base)
+            try:
+                with open(path, encoding='utf-8') as fh:
+                    content = fh.read()
+                name = desc = dept = ''
+                if content.startswith('---'):
+                    parts = content.split('---', 2)
+                    if len(parts) >= 3:
+                        meta = yaml.safe_load(parts[1]) or {}
+                        name = meta.get('name', '')
+                        desc = meta.get('description', '')
+                if not name:
+                    name = f.replace('.md', '').replace('-', ' ').title()
+                dept = rel.split('/')[0] if '/' in rel else 'root'
+                agents.append({'id': f.replace('.md',''), 'name': name, 'desc': desc[:80], 'dept': dept, 'path': rel})
+            except Exception:
+                pass
+agents.sort(key=lambda x: (x['dept'], x['name']))
+idx_path = os.path.join(base, '.agent-index.json')
+with open(idx_path, 'w', encoding='utf-8') as out:
+    json.dump(agents, out, ensure_ascii=False, indent=2)
+print(f"Agency agents indexed: {len(agents)} roles ready")
+AGENT_INDEX
+fi
+
 # ── Force-kill any residual gateway processes from previous crash ──
 echo "Cleaning up residual gateway processes..."
 # Kill any lingering hermes gateway processes (prevents Feishu lock conflict)