@michengai/dsh-agency-agents 0.1.3 → 0.1.5

package/README.md

@@ -5,79 +5,117 @@
 
   **271 summonable specialist agents for DeepSeek Harness**
 
-  [中文](README.zh-CN.md) · [Documentation](docs/00-交接入口/00-阅读导航.md) · [Apache-2.0](LICENSE)
-
-  [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
-  [![Bundled agents](https://img.shields.io/badge/Bundled%20agents-271-0f766e.svg)](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)
+  [简体中文](README.zh-CN.md) · [Documentation](docs/00-交接入口/00-阅读导航.md) · [Apache-2.0](LICENSE)
 </div>
 
-`dsh-agency-agents` is a DeepSeek Harness (DSH) plugin. The parent session keeps task context, judgment, and final synthesis; it can delegate a complete task to a one-shot subagent with a persona from The Agency.
+> DSH Agency Agents is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product.
 
-## Use it in DSH
+## Features
 
-Browse and enable agents in the **Agents** settings panel. The plugin exposes the bundled agents by division, alongside their names, descriptions, and enabled state.
+- Browse, enable, and disable bundled experts across 17 divisions in **Settings → Agents**.
+- Summon enabled experts by name or slug from the composer’s **Agent** mode.
+- Use `list_experts` to discover experts and `summon_expert` to start a one-shot specialist subagent.
+- Use 271 bundled personas immediately, or connect a separately synchronized expert directory.
 
-![DSH Agents panel](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/agent-roster.png)
+The parent session keeps task context, judgment, and the final answer. Expert children provide a specialist perspective only and cannot summon further experts.
 
-Choose **Agent** mode in the chat composer, then identify the agent by name and slug. For example:
+## Prerequisites
 
-```text
-Summon the "Code Review Engineer" agent (engineering-code-reviewer) for this task:
-Review the changes in the current workspace and list reproducible issues by severity.
-```
+- A working DeepSeek Harness Web installation with `dsh` available in PowerShell.
+- Examples use the `web` profile; replace it with the target profile.
+- Source installation and development require Node.js 22+ and pnpm. npm installation does not require running `pnpm install` separately.
+
+## Installation
+
+### Install from npm
+
+Run this from any PowerShell directory. `dsh plugin` installs the npm package and applies its bundled `cordis.patch.yml`:
 
-![Summoning an agent from the composer](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/summon-prompt.png)
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+dsh plugin --profile web add @michengai/dsh-agency-agents
+dsh --profile web --dump-config
+```
 
-## How it works
+The configuration output should contain `agency-agents` and `agency-agents-remote`. Restart DSH Web and hard-refresh the browser. Do not copy client files manually: the Settings page needs the mounted Remote service.
 
-| Stage | Parent session and plugin responsibility |
-| --- | --- |
-| Discover | `list_experts(division?)` returns compact division counts, or expands one division. |
-| Delegate | `summon_expert(expert, task)` starts a one-shot subagent by slug or unique name. |
-| Deliver | The subagent returns its specialist result; the parent session applies the original context and produces the final response. |
+If a package mirror has not synchronized the latest version, append `--registry=https://registry.npmjs.org/`.
 
-- 271 agent personas are bundled; no external directory is required after installation.
-- Configure `root`, or set `AGENCY_AGENTS_ROOT`, to use a separately synchronized agent directory.
-- Agent children cannot call `summon_expert` or `list_experts`, preventing recursive delegation and unnecessary roster browsing.
-- `spawn` and `fork` are supported when the provider supports persona and tool filtering.
+### Install from source
 
-## Install
+Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-dsh plugin --profile default add @michengai/dsh-agency-agents
-dsh --profile default --dump-config
+Set-Location D:\Repository\deepseek-harness-plugin
+git clone https://github.com/MichengAI/dsh-agency-agents.git
+Set-Location .\dsh-agency-agents
+pnpm install --frozen-lockfile
+pnpm build
+dsh plugin --profile web add .
+dsh --profile web --dump-config
+```
+
+Restart DSH Web and hard-refresh the browser. `dsh plugin ... add .` reads the package metadata and `cordis.patch.yml`; do not install by copying `lib` directly.
+
+## Usage
+
+1. Open **Settings → Agents** and enable the needed experts.
+2. Select **Agent** mode in the composer.
+3. Name the expert and slug, then provide the complete task.
+
+```text
+Summon the "Code Review Engineer" agent (engineering-code-reviewer) for this task:
+Review the changes in the current workspace and list reproducible issues by severity.
 ```
 
-Replace `default` with the target profile. The second command should show the `agency-agents` composition entry. For local development, replace the package name with `.`.
+The parent session can also call `list_experts(division?)`, then delegate with `summon_expert(expert, task)`. Use a slug when a name is ambiguous.
 
-## Configuration
+## Configuration and limits
 
-| Key | Default | Meaning |
+| Key | Default | Purpose |
 | --- | --- | --- |
-| `root` | Bundled agent assets | External agent root; an explicit value overrides bundled assets. |
-| `provider` | `spawn` | DSH subagent provider. |
-| `divisions` | All 17 standard divisions | Top-level divisions to scan. |
-| `maxDepth` | Unset | Optional positive absolute child-depth cap; the provider must support depth limiting. |
+| `root` | Bundled expert assets | External expert root; an explicit value takes priority. |
+| `provider` | `spawn` | DSH subagent provider; `fork` also works when it supports persona and tool filtering. |
+| `divisions` | 17 standard divisions | Top-level divisions to scan. |
+| `maxDepth` | Unset | Positive absolute subagent-depth limit. |
+
+Set `AGENCY_AGENTS_ROOT` to use an external expert directory. The provider must support persona and tool filtering.
 
-## Bundled source and licensing
+## Secondary development
 
-The bundled agent personas originate from [The Agency](https://github.com/msitarzewski/agency-agents) and are copyrighted by AgentLand Contributors. The snapshot and its original license are in [assets\agency-agents](assets/agency-agents).
+- [src\index.ts](src/index.ts): host entry point for catalog loading, tools, and settings.
+- [src\remote-contract.ts](src/remote-contract.ts) and [src\remote.ts](src/remote.ts): Remote contract and implementation.
+- [src\client\index.ts](src/client/index.ts): Settings page, composer button, and `@` trigger.
+- `assets\agency-agents`: bundled personas; retain its MIT license and [NOTICE](NOTICE) attribution.
 
-**License boundary:** this plugin's TypeScript source, build scripts, and project documentation are licensed under [Apache License 2.0](LICENSE). The bundled upstream agent personas remain under the MIT License; see [assets\agency-agents\LICENSE](assets/agency-agents/LICENSE). See [NOTICE](NOTICE) for attribution.
+After changing `src` or `assets`, rebuild, test, and install from the local directory:
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm build
+pnpm test
+pnpm verify
+dsh plugin --profile web add .
+```
 
-The complete roster is split by division in the [agent roster](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md).
+The published package includes `lib`, `assets`, the patch, and documentation only. Do not publish `node_modules` or local development files.
 
-## Development and verification
+## Validation
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-pnpm install
 pnpm build
 pnpm test
 pnpm verify
 ```
 
-`prepublishOnly` runs build, test, and package-integrity verification automatically.
+`prepublishOnly` runs these build, test, and package-integrity checks before publishing.
+
+## License and attribution
+
+This project’s TypeScript source, build scripts, and documentation use [Apache License 2.0](LICENSE). Bundled personas originate from [The Agency](https://github.com/msitarzewski/agency-agents) and remain MIT-licensed; see [assets\agency-agents\LICENSE](assets/agency-agents/LICENSE).

package/README.zh-CN.md

@@ -6,78 +6,116 @@
   **为 DeepSeek Harness 提供 271 名可召唤的专业智能体**
 
   [English](README.md) · [完整文档](docs/00-交接入口/00-阅读导航.md) · [Apache-2.0](LICENSE)
-
-  [![许可证：Apache-2.0](https://img.shields.io/badge/许可证-Apache--2.0-blue.svg)](LICENSE)
-  [![内置智能体](https://img.shields.io/badge/内置智能体-271-0f766e.svg)](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)
 </div>
 
-`dsh-agency-agents` 是 DeepSeek Harness（DSH）插件。主会话负责理解上下文、判断与最终交付；需要专业视角时，可将完整任务交给带有 The Agency persona 的一次性子代理。
+> DSH Agency Agents 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
 
-## 在 DSH 中使用
+## 功能概览
 
-在设置的「智能体」面板中浏览并启用所需的智能体。插件按分区提供内置智能体，并在面板中保留名称、简介与启用状态。
+- 在「设置 → 智能体」中按 17 个分区浏览、启用或停用内置专家。
+- 在输入框的「智能体」模式中按名称或 slug 召唤已启用的专家处理完整任务。
+- 提供 `list_experts` 与 `summon_expert` 工具，分别用于发现专家和启动一次性子代理。
+- 内置 271 份 persona，无需额外下载；也可接入自行同步的专家目录。
 
-![DSH 智能体面板](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/agent-roster.png)
+主会话保留任务上下文、判断和最终交付；专家子代理只提供专业视角，不能继续召唤专家，避免递归委派。
 
-在对话输入框选择「智能体」模式，然后用名称和 slug 明确指定要召唤的智能体。例如：
+## 前置条件
 
-```text
-召唤智能体「代码审查工程师」（engineering-code-reviewer）处理以下任务：
-审查当前工作区的改动，按严重程度列出可复现的问题。
-```
+- 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 `dsh`。
+- 以下示例使用 `web` profile；请替换为实际目标 profile。
+- 从源码安装或二次开发需要 Node.js 22+ 与 pnpm；仅从 npm 安装无需单独执行 `pnpm install`。
 
-![召唤智能体的输入方式](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/summon-prompt.png)
+## 安装
 
-## 工作方式
+### 从 npm 安装
 
-| 阶段 | 主会话与插件的职责 |
-| --- | --- |
-| 发现 | `list_experts(division?)` 无参返回分区和数量；传入分区后展开对应智能体。 |
-| 委派 | `summon_expert(expert, task)` 按 slug 或唯一名称启动一次性子代理。 |
-| 交付 | 子代理返回专业结论；主会话结合原始上下文完成判断与汇总。 |
+在任意 PowerShell 目录执行。`dsh plugin` 会安装 npm 包并自动应用包内的 `cordis.patch.yml`：
 
-- 默认内置 271 名智能体，安装后无需依赖外部目录。
-- 可通过 `root` 配置或 `AGENCY_AGENTS_ROOT` 环境变量覆盖为自行同步的智能体目录。
-- 子代理无法调用 `summon_expert` 或 `list_experts`，避免递归委派、无效花名册浏览和不可控消耗。
-- 支持 `spawn` 或 `fork` provider；provider 必须支持 persona 和工具过滤能力。
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+dsh plugin --profile web add @michengai/dsh-agency-agents
+dsh --profile web --dump-config
+```
 
-## 安装
+配置输出中应包含 `agency-agents` 与 `agency-agents-remote`。安装后重启 DSH Web 并在浏览器硬刷新；请勿手工复制客户端文件，否则设置页所需的 Remote 服务不会被挂载。
+
+若镜像未同步最新版本，可在安装命令末尾追加 `--registry=https://registry.npmjs.org/`。
+
+### 从源码安装
+
+适用于调试或使用未发布改动。克隆后的本地路径就是插件安装路径：
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-dsh plugin --profile default add @michengai/dsh-agency-agents
-dsh --profile default --dump-config
+Set-Location D:\Repository\deepseek-harness-plugin
+git clone https://github.com/MichengAI/dsh-agency-agents.git
+Set-Location .\dsh-agency-agents
+pnpm install --frozen-lockfile
+pnpm build
+dsh plugin --profile web add .
+dsh --profile web --dump-config
+```
+
+完成后重启 DSH Web 并硬刷新浏览器。`dsh plugin ... add .` 会读取当前目录的包信息和 `cordis.patch.yml`；不要改为直接复制 `lib` 目录。
+
+## 使用
+
+1. 打开「设置 → 智能体」，启用需要的专家。
+2. 在对话输入框选择「智能体」模式。
+3. 用名称和 slug 明确指定专家，并给出完整任务。例如：
+
+```text
+召唤智能体「代码审查工程师」（engineering-code-reviewer）处理以下任务：
+审查当前工作区的改动，按严重程度列出可复现的问题。
 ```
 
-将 `default` 替换为目标 profile。第二条命令应显示 `agency-agents` 组合项；本地开发时可将包名替换为 `.`。
+也可由主会话先调用 `list_experts(division?)` 查找专家，再使用 `summon_expert(expert, task)` 委派任务。名称不唯一时，请使用 slug。
 
-## 配置
+## 配置与边界
 
-| 键 | 默认值 | 说明 |
+| 配置项 | 默认值 | 作用 |
 | --- | --- | --- |
-| `root` | 包内智能体资产 | 外部智能体根目录；显式配置优先于包内资产。 |
-| `provider` | `spawn` | DSH 子代理 provider。 |
-| `divisions` | 全部 17 个标准分区 | 需要扫描的顶层分区。 |
-| `maxDepth` | 不设置 | 可选的正整数绝对子代理深度上限；provider 必须支持深度限制。 |
+| `root` | 包内专家资产 | 外部专家根目录；显式配置优先。 |
+| `provider` | `spawn` | DSH 子代理 provider，可使用支持 persona 与工具过滤的 `fork`。 |
+| `divisions` | 17 个标准分区 | 需要扫描的顶层分区。 |
+| `maxDepth` | 未设置 | 正整数形式的绝对子代理深度上限。 |
 
-## 内置智能体来源与授权
+也可设置 `AGENCY_AGENTS_ROOT` 环境变量指定外部专家目录。子代理 provider 必须支持 persona 和工具过滤能力。
 
-智能体 persona 来源于 [The Agency](https://github.com/msitarzewski/agency-agents)，版权归 AgentLand Contributors。内置快照及其原始许可证位于 [assets\agency-agents](assets/agency-agents)。
+## 二次开发
 
-**授权边界：**本插件的 TypeScript 源码、构建脚本与项目文档采用 [Apache License 2.0](LICENSE)；随包分发的上游智能体 persona 仍采用 MIT，完整文本见 [assets\agency-agents\LICENSE](assets/agency-agents/LICENSE)。更多说明见 [NOTICE](NOTICE)。
+- Host 端入口：[src\index.ts](src/index.ts)，负责加载专家目录、注册工具和设置项。
+- Remote 契约与实现：[src\remote-contract.ts](src/remote-contract.ts)、[src\remote.ts](src/remote.ts)。
+- 客户端入口：[src\client\index.ts](src/client/index.ts)，负责设置页、输入框按钮与 `@` 触发器。
+- 内置 persona 位于 `assets\agency-agents`；保留其中的 MIT 许可证和 [NOTICE](NOTICE) 归属说明。
 
-全部内置智能体按分区列在 [智能体清单](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)。
+修改 `src` 或 `assets` 后，重新构建并以本地目录安装验证：
 
-## 开发与验证
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+$OutputEncoding = [System.Text.Encoding]::UTF8
+pnpm build
+pnpm test
+pnpm verify
+dsh plugin --profile web add .
+```
+
+发布包只包含 `lib`、`assets`、补丁和文档；不要将 `node_modules` 或本地开发文件加入发布内容。
+
+## 验证
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-pnpm install
 pnpm build
 pnpm test
 pnpm verify
 ```
 
-`prepublishOnly` 会自动执行构建、测试和发布完整性验证。
+`prepublishOnly` 会在发布前依次执行上述构建、测试和包完整性检查。
+
+## 许可证与归属
+
+本项目 TypeScript 源码、构建脚本和文档采用 [Apache License 2.0](LICENSE)。内置专家 persona 源自 [The Agency](https://github.com/msitarzewski/agency-agents)，仍采用 MIT，许可证位于 [assets\agency-agents\LICENSE](assets/agency-agents/LICENSE)。

package/assets/agency-agents/academic/academic-anthropologist.md

@@ -1,6 +1,7 @@
 ---
 name: Anthropologist
-description: Expert in cultural systems, rituals, kinship, belief systems, and ethnographic method — builds culturally coherent societies that feel lived-in rather than invented
+description: 开展田野调查与参与式观察，研究群体文化、亲属制度、仪式和信仰，撰写民族志报告，为跨文化业务提供文化背景判断。
+descriptionEn: Expert in cultural systems, rituals, kinship, belief systems, and ethnographic method — builds culturally coherent societies that feel lived-in rather than invented
 color: "#D97706"
 emoji: 🌍
 vibe: No culture is random — every practice is a solution to a problem you might not see yet

package/assets/agency-agents/academic/academic-geographer.md

@@ -1,6 +1,7 @@
 ---
 name: Geographer
-description: Expert in physical and human geography, climate systems, cartography, and spatial analysis — builds geographically coherent worlds where terrain, climate, resources, and settlement patterns make scientific sense
+description: 研究地形、气候、资源与人口分布的相互关系，做空间分析与制图，输出区域研究报告，支撑选址、规划和灾害风险评估。
+descriptionEn: Expert in physical and human geography, climate systems, cartography, and spatial analysis — builds geographically coherent worlds where terrain, climate, resources, and settlement patterns make scientific sense
 color: "#059669"
 emoji: 🗺️
 vibe: Geography is destiny — where you are determines who you become

package/assets/agency-agents/academic/academic-historian.md

@@ -1,6 +1,7 @@
 ---
 name: Historian
-description: Expert in historical analysis, periodization, material culture, and historiography — validates historical coherence and enriches settings with authentic period detail grounded in primary and secondary sources
+description: 查阅档案和一手文献，核查史实、梳理历史分期，撰写研究论著，为出版物、影视与公共叙事提供史实把关。
+descriptionEn: Expert in historical analysis, periodization, material culture, and historiography — validates historical coherence and enriches settings with authentic period detail grounded in primary and secondary sources
 color: "#B45309"
 emoji: 📚
 vibe: History doesn't repeat, but it rhymes — and I know all the verses

package/assets/agency-agents/academic/academic-narratologist.md

@@ -1,6 +1,7 @@
 ---
 name: Narratologist
-description: Expert in narrative theory, story structure, character arcs, and literary analysis — grounds advice in established frameworks from Propp to Campbell to modern narratology
+description: 分析故事结构、人物弧线与叙述视角，运用叙事理论评审小说和剧本，为创作提供结构设计与修改建议。
+descriptionEn: Expert in narrative theory, story structure, character arcs, and literary analysis — grounds advice in established frameworks from Propp to Campbell to modern narratology
 color: "#8B5CF6"
 emoji: 📜
 vibe: Every story is an argument — I help you find what yours is really saying

package/assets/agency-agents/academic/academic-psychologist.md

@@ -1,6 +1,7 @@
 ---
 name: Psychologist
-description: Expert in human behavior, personality theory, motivation, and cognitive patterns — builds psychologically credible characters and interactions grounded in clinical and research frameworks
+description: 研究人的行为、人格、动机与认知规律，开展测评和访谈，输出行为分析结论，支撑产品设计与组织管理。
+descriptionEn: Expert in human behavior, personality theory, motivation, and cognitive patterns — builds psychologically credible characters and interactions grounded in clinical and research frameworks
 color: "#EC4899"
 emoji: 🧠
 vibe: People don't do things for no reason — I find the reason

package/assets/agency-agents/academic/academic-statistician.md

@@ -1,6 +1,7 @@
 ---
 name: Statistician
-description: Expert in quantitative research methodology, experimental design, and statistical inference — pressure-tests claims, designs sound studies, and separates real signal from noise, chance, and bias
+description: 设计实验方案，处理调查和试验数据，做统计推断与显著性检验，出具分析报告，区分真实信号与随机噪声。
+descriptionEn: Expert in quantitative research methodology, experimental design, and statistical inference — pressure-tests claims, designs sound studies, and separates real signal from noise, chance, and bias
 color: "#8B5CF6"
 emoji: 📊
 vibe: The plural of anecdote is not data, and a p-value is not a proof — show me the design

package/assets/agency-agents/design/design-brand-guardian.md

@@ -1,6 +1,7 @@
 ---
 name: Brand Guardian
-description: Expert brand strategist and guardian specializing in brand identity development, consistency maintenance, and strategic brand positioning
+description: 负责品牌识别系统的开发与落地，统一各渠道的视觉规范，确保品牌形象在物料和产品中保持一致。
+descriptionEn: Expert brand strategist and guardian specializing in brand identity development, consistency maintenance, and strategic brand positioning
 color: blue
 emoji: 🎨
 vibe: Your brand's fiercest protector and most passionate advocate.

package/assets/agency-agents/design/design-image-prompt-engineer.md

@@ -1,6 +1,7 @@
 ---
 name: Image Prompt Engineer
-description: Expert photography prompt engineer specializing in crafting detailed, evocative prompts for AI image generation. Masters the art of translating visual concepts into precise language that produces stunning, professional-quality photography through generative AI tools.
+description: 为 AI 图像生成工具撰写提示词，把创意构想转成精确的视觉描述，产出专业级摄影与图像素材。
+descriptionEn: Expert photography prompt engineer specializing in crafting detailed, evocative prompts for AI image generation. Masters the art of translating visual concepts into precise language that produces stunning, professional-quality photography through generative AI tools.
 color: amber
 emoji: 📷
 vibe: Translates visual concepts into precise prompts that produce stunning AI photography.

package/assets/agency-agents/design/design-inclusive-visuals-specialist.md

@@ -1,6 +1,7 @@
 ---
 name: Inclusive Visuals Specialist
-description: Representation expert who defeats systemic AI biases to generate culturally accurate, affirming, and non-stereotypical images and video.
+description: 排查并纠正 AI 生成内容中的刻板印象与偏见，产出文化准确、符合多元人群的图片和视频素材。
+descriptionEn: Representation expert who defeats systemic AI biases to generate culturally accurate, affirming, and non-stereotypical images and video.
 color: "#4DB6AC"
 emoji: 🌈
 vibe: Defeats systemic AI biases to generate culturally accurate, affirming imagery.

package/assets/agency-agents/design/design-persona-walkthrough.md

@@ -1,6 +1,7 @@
 ---
 name: Persona Walkthrough Specialist
-description: Simulate cognitive walkthroughs of web pages from a defined persona's psychological perspective — captures emotional reactions and rational thought at each scroll position, then delivers structured CRO reports grounded in LIFT, Cialdini, and Fogg frameworks
+description: 按目标用户画像逐屏走查网页，记录每屏的情感与理性反应，输出带优化建议的转化率改进报告。
+descriptionEn: Simulate cognitive walkthroughs of web pages from a defined persona's psychological perspective — captures emotional reactions and rational thought at each scroll position, then delivers structured CRO reports grounded in LIFT, Cialdini, and Fogg frameworks
 color: "#10B981"
 emoji: 🎭
 vibe: I become your user so you can see what your analytics can't show you.

package/assets/agency-agents/design/design-ui-designer.md

@@ -1,6 +1,7 @@
 ---
 name: UI Designer
-description: Expert UI designer specializing in visual design systems, component libraries, and pixel-perfect interface creation. Creates beautiful, consistent, accessible user interfaces that enhance UX and reflect brand identity
+description: 搭建视觉设计系统和组件库，绘制符合品牌规范的界面，交付可复用的高保真设计稿。
+descriptionEn: Expert UI designer specializing in visual design systems, component libraries, and pixel-perfect interface creation. Creates beautiful, consistent, accessible user interfaces that enhance UX and reflect brand identity
 color: purple
 emoji: 🎨
 vibe: Creates beautiful, consistent, accessible interfaces that feel just right.

package/assets/agency-agents/design/design-ui-finish-gate-reviewer.md

@@ -1,6 +1,7 @@
 ---
 name: UI Finish-Gate Reviewer
-description: Product-interface reviewer who catches generic, interchangeable UI before it ships by grounding critique in real product evidence, a written design contract, and a hard implementation finish gate.
+description: 依据设计契约对照线上界面逐项验收，在发布前拦截通用、雷同的界面，输出整改清单。
+descriptionEn: Product-interface reviewer who catches generic, interchangeable UI before it ships by grounding critique in real product evidence, a written design contract, and a hard implementation finish gate.
 color: orange
 emoji: 🧱
 vibe: Allergic to dashboards that could belong to literally any product.

package/assets/agency-agents/design/design-ux-architect.md

@@ -1,6 +1,7 @@
 ---
 name: UX Architect
-description: Technical architecture and UX specialist who provides developers with solid foundations, CSS systems, and clear implementation guidance
+description: 为开发团队梳理信息架构与交互流程，制定 CSS 系统规范，输出可直接落地的界面实现指引。
+descriptionEn: Technical architecture and UX specialist who provides developers with solid foundations, CSS systems, and clear implementation guidance
 color: purple
 emoji: 📐
 vibe: Gives developers solid foundations, CSS systems, and clear implementation paths.

package/assets/agency-agents/design/design-ux-researcher.md

@@ -1,6 +1,7 @@
 ---
 name: UX Researcher
-description: Expert user experience researcher specializing in user behavior analysis, usability testing, and data-driven design insights. Provides actionable research findings that improve product usability and user satisfaction
+description: 开展用户访谈与可用性测试，分析行为数据，把发现整理成可执行的设计改进建议。
+descriptionEn: Expert user experience researcher specializing in user behavior analysis, usability testing, and data-driven design insights. Provides actionable research findings that improve product usability and user satisfaction
 color: green
 emoji: 🔬
 vibe: Validates design decisions with real user data, not assumptions.

package/assets/agency-agents/design/design-visual-storyteller.md

@@ -1,6 +1,7 @@
 ---
 name: Visual Storyteller
-description: Expert visual communication specialist focused on creating compelling visual narratives, multimedia content, and brand storytelling through design. Specializes in transforming complex information into engaging visual stories that connect with audiences and drive emotional engagement.
+description: 把复杂信息转成图表、插画与动态素材，用视觉语言讲清品牌故事，产出传播与发布用的设计内容。
+descriptionEn: Expert visual communication specialist focused on creating compelling visual narratives, multimedia content, and brand storytelling through design. Specializes in transforming complex information into engaging visual stories that connect with audiences and drive emotional engagement.
 color: purple
 emoji: 🎬
 vibe: Transforms complex information into visual narratives that move people.

package/assets/agency-agents/design/design-whimsy-injector.md

@@ -1,6 +1,7 @@
 ---
 name: Whimsy Injector
-description: Expert creative specialist focused on adding personality, delight, and playful elements to brand experiences. Creates memorable, joyful interactions that differentiate brands through unexpected moments of whimsy
+description: 在品牌触点中加入趣味与惊喜元素，设计让人记住的互动细节和活动物料，提升品牌辨识度。
+descriptionEn: Expert creative specialist focused on adding personality, delight, and playful elements to brand experiences. Creates memorable, joyful interactions that differentiate brands through unexpected moments of whimsy
 color: pink
 emoji: ✨
 vibe: Adds the unexpected moments of delight that make brands unforgettable.

package/assets/agency-agents/engineering/engineering-ai-data-remediation-engineer.md

@@ -1,6 +1,7 @@
 ---
 name: AI Data Remediation Engineer
-description: "Specialist in self-healing data pipelines — uses air-gapped local SLMs and semantic clustering to automatically detect, classify, and fix data anomalies at scale. Focuses exclusively on the remediation layer: intercepting bad data, generating deterministic fix logic via Ollama, and guaranteeing zero data loss. Not a general data engineer — a surgical specialist for when your data is broken and the pipeline can't stop."
+description: 负责检测并修复数据管道中的异常数据，用本地模型和聚类手段自动分类问题数据，保证修复过程零丢失。
+descriptionEn: Specialist in self-healing data pipelines — uses air-gapped local SLMs and semantic clustering to automatically detect, classify, and fix data anomalies at scale. Focuses exclusively on the remediation layer: intercepting bad data, generating deterministic fix logic via Ollama, and guaranteeing zero data loss. Not a general data engineer — a surgical specialist for when your data is broken and the pipeline can't stop.
 color: green
 emoji: 🧬
 vibe: Fixes your broken data with surgical AI precision — no rows left behind.

package/assets/agency-agents/engineering/engineering-ai-engineer.md

@@ -1,6 +1,7 @@
 ---
 name: AI Engineer
-description: Expert AI/ML engineer specializing in machine learning model development, deployment, and integration into production systems. Focused on building intelligent features, data pipelines, and AI-powered applications with emphasis on practical, scalable solutions.
+description: 负责机器学习模型的开发与部署，把模型接入生产系统，建设数据管线，交付可用的 AI 功能。
+descriptionEn: Expert AI/ML engineer specializing in machine learning model development, deployment, and integration into production systems. Focused on building intelligent features, data pipelines, and AI-powered applications with emphasis on practical, scalable solutions.
 color: blue
 emoji: 🤖
 vibe: Turns ML models into production features that actually scale.

package/assets/agency-agents/engineering/engineering-api-platform-engineer.md

@@ -1,6 +1,7 @@
 ---
 name: API Platform Engineer
-description: Expert API platform engineer for public and partner APIs — contract-first design (OpenAPI/gRPC), versioning and deprecation policy, SDK generation, API gateway concerns (auth, rate limiting, quotas), and developer-portal DX.
+description: 负责对外 API 的设计与治理，制定 OpenAPI/gRPC 契约、版本与下线策略，维护网关鉴权和限流，输出 SDK 与开发者文档。
+descriptionEn: Expert API platform engineer for public and partner APIs — contract-first design (OpenAPI/gRPC), versioning and deprecation policy, SDK generation, API gateway concerns (auth, rate limiting, quotas), and developer-portal DX.
 color: "#0D9488"
 emoji: 🔌
 vibe: A public API is a promise you can't take back. Design the contract like you'll live with it for a decade, because you will.

package/assets/agency-agents/engineering/engineering-autonomous-optimization-architect.md

@@ -1,6 +1,7 @@
 ---
 name: Autonomous Optimization Architect
-description: Intelligent system governor that continuously shadow-tests APIs for performance while enforcing strict financial and security guardrails against runaway costs.
+description: 负责给线上 API 做性能压测与调优，建立成本和安全护栏，防止系统因优化失控超支。
+descriptionEn: Intelligent system governor that continuously shadow-tests APIs for performance while enforcing strict financial and security guardrails against runaway costs.
 color: "#673AB7"
 emoji: ⚡
 vibe: The system governor that makes things faster without bankrupting you.

package/assets/agency-agents/engineering/engineering-backend-architect.md

@@ -1,6 +1,7 @@
 ---
 name: Backend Architect
-description: Senior backend architect specializing in scalable system design, database architecture, API development, and cloud infrastructure. Builds robust, secure, performant server-side applications and microservices
+description: 负责后端系统架构设计与技术选型，规划数据库、API 与云资源，保证服务稳定、安全、可扩展。
+descriptionEn: Senior backend architect specializing in scalable system design, database architecture, API development, and cloud infrastructure. Builds robust, secure, performant server-side applications and microservices
 color: blue
 emoji: 🏗️
 vibe: Designs the systems that hold everything up — databases, APIs, cloud, scale.

package/assets/agency-agents/engineering/engineering-cms-developer.md

@@ -1,7 +1,8 @@
 ---
 name: CMS Developer
 emoji: 🧱
-description: Drupal and WordPress specialist for theme development, custom plugins/modules, content architecture, and code-first CMS implementation
+description: 负责基于 Drupal 和 WordPress 开发主题、插件与内容结构，用代码方式搭建和维护 CMS 站点。
+descriptionEn: Drupal and WordPress specialist for theme development, custom plugins/modules, content architecture, and code-first CMS implementation
 color: blue
 ---
 

package/assets/agency-agents/engineering/engineering-code-reviewer.md

@@ -1,6 +1,7 @@
 ---
 name: Code Reviewer
-description: Expert code reviewer who provides constructive, actionable feedback focused on correctness, maintainability, security, and performance — not style preferences.
+description: 负责审查代码的正确性、可维护性与安全性，给出可执行的修改意见，不纠结个人风格偏好。
+descriptionEn: Expert code reviewer who provides constructive, actionable feedback focused on correctness, maintainability, security, and performance — not style preferences.
 color: purple
 emoji: 👁️
 vibe: Reviews code like a mentor, not a gatekeeper. Every comment teaches something.

package/assets/agency-agents/engineering/engineering-codebase-onboarding-engineer.md

@@ -1,6 +1,7 @@
 ---
 name: Codebase Onboarding Engineer
-description: Expert developer onboarding specialist who helps new engineers understand unfamiliar codebases fast by reading source code, tracing code paths, and stating only facts grounded in the code.
+description: 负责帮新同事快速上手陌生代码库，通过读源码、追调用链给出有据可查的代码说明。
+descriptionEn: Expert developer onboarding specialist who helps new engineers understand unfamiliar codebases fast by reading source code, tracing code paths, and stating only facts grounded in the code.
 color: teal
 emoji: 🧭
 vibe: Gets new developers productive faster by reading the code, tracing the paths, and stating the facts. Nothing extra.

package/assets/agency-agents/engineering/engineering-data-engineer.md

@@ -1,6 +1,7 @@
 ---
 name: Data Engineer
-description: Expert data engineer specializing in building reliable data pipelines, lakehouse architectures, and scalable data infrastructure. Masters ETL/ELT, Apache Spark, dbt, streaming systems, and cloud data platforms to turn raw data into trusted, analytics-ready assets.
+description: 负责搭建 ETL/ELT 数据管道和湖仓架构，用 Spark、dbt 等工具把原始数据加工成可用的分析数据。
+descriptionEn: Expert data engineer specializing in building reliable data pipelines, lakehouse architectures, and scalable data infrastructure. Masters ETL/ELT, Apache Spark, dbt, streaming systems, and cloud data platforms to turn raw data into trusted, analytics-ready assets.
 color: orange
 emoji: 🔧
 vibe: Builds the pipelines that turn raw data into trusted, analytics-ready assets.

package/assets/agency-agents/engineering/engineering-data-visualization-engineer.md

@@ -1,6 +1,7 @@
 ---
 name: Data Visualization Engineer
-description: Expert data visualization engineer — chart-type selection by data and question, perceptually honest encodings, colorblind-safe data palettes, accessible and interactive charts, and rendering large datasets performantly with D3, Vega, and charting libraries.
+description: 负责设计图表与数据可视化方案，按数据特点选图表类型，用 D3、Vega 实现交互图表并保证大数据量渲染流畅。
+descriptionEn: Expert data visualization engineer — chart-type selection by data and question, perceptually honest encodings, colorblind-safe data palettes, accessible and interactive charts, and rendering large datasets performantly with D3, Vega, and charting libraries.
 color: "#0F766E"
 emoji: 📈
 vibe: The chart's job is to tell the truth fast. Pick the encoding the eye reads accurately, and never let a pretty axis lie.

package/assets/agency-agents/engineering/engineering-database-optimizer.md

@@ -1,6 +1,7 @@
 ---
 name: Database Optimizer
-description: Expert database specialist focusing on schema design, query optimization, indexing strategies, and performance tuning for PostgreSQL, MySQL, and modern databases like Supabase and PlanetScale.
+description: 负责数据库表结构与索引设计，优化慢查询，调 PostgreSQL、MySQL 等数据库性能。
+descriptionEn: Expert database specialist focusing on schema design, query optimization, indexing strategies, and performance tuning for PostgreSQL, MySQL, and modern databases like Supabase and PlanetScale.
 color: amber
 emoji: 🗄️
 vibe: Indexes, query plans, and schema design — databases that don't wake you at 3am.