superpowers-zh/README.md at main · jnMetaCode/superpowers-zh · GitHub

  - link "Skip to content" [ref=e1]:
    - /url: "#start-of-content"
  - banner:
    - heading "Navigation Menu" [ref=e2] [level=2]
    - link "Homepage" [ref=e3]:
      - /url: /
    - navigation "Global" [ref=e4]:
        - listitem:
          - button "Platform" [ref=e5]
        - listitem:
          - button "Solutions" [ref=e6]
        - listitem:
          - button "Resources" [ref=e7]
        - listitem:
          - button "Open Source" [ref=e8]
        - listitem:
          - button "Enterprise" [ref=e9]
        - listitem:
          - link "Pricing" [ref=e10]:
            - /url: https://github.com/pricing
    - button "Search or jump to…" [ref=e11]
    - link "Sign in" [ref=e12]:
      - /url: /login?return_to=https%3A%2F%2Fgithub.com%2FjnMetaCode%2Fsuperpowers-zh%2Fblob%2Fmain%2FREADME.md
    - link "Sign up" [ref=e13]:
      - /url: /signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fblob%2Fshow&source=header-repo&source_repo=jnMetaCode%2Fsuperpowers-zh
    - button "Appearance settings" [ref=e14]
  - main:
    - link "jnMetaCode" [ref=e15]:
      - /url: /jnMetaCode
    - text: /
    - strong:
      - link "superpowers-zh" [ref=e16]:
        - /url: /jnMetaCode/superpowers-zh
    - text: Public
      - listitem:
        - link "You must be signed in to change notification settings" [ref=e17]:
          - /url: /login?return_to=%2FjnMetaCode%2Fsuperpowers-zh
          - text: Notifications
      - listitem:
        - link "Fork 310" [ref=e18]:
          - /url: /login?return_to=%2FjnMetaCode%2Fsuperpowers-zh
      - listitem:
        - link "You must be signed in to star a repository" [ref=e19]:
          - /url: /login?return_to=%2FjnMetaCode%2Fsuperpowers-zh
          - text: Star 2.9k
    - navigation "Repository" [ref=e20]:
        - listitem:
          - link "Code" [ref=e21]:
            - /url: /jnMetaCode/superpowers-zh
        - listitem:
          - link "Issues 5" [ref=e22]:
            - /url: /jnMetaCode/superpowers-zh/issues
        - listitem:
          - link "Pull requests" [ref=e23]:
            - /url: /jnMetaCode/superpowers-zh/pulls
        - listitem:
          - link "Discussions" [ref=e24]:
            - /url: /jnMetaCode/superpowers-zh/discussions
        - listitem:
          - link "Actions" [ref=e25]:
            - /url: /jnMetaCode/superpowers-zh/actions
        - listitem:
          - link "Projects" [ref=e26]:
            - /url: /jnMetaCode/superpowers-zh/projects
        - listitem:
          - link "Security and quality" [ref=e27]:
            - /url: /jnMetaCode/superpowers-zh/security
        - listitem:
          - link "Insights" [ref=e28]:
            - /url: /jnMetaCode/superpowers-zh/pulse
    - heading "Collapse file tree" [ref=e29] [level=2]:
      - button "Collapse file tree" [ref=e30] [expanded]
    - heading "Files" [ref=e31] [level=2]
    - button "main branch" [ref=e32]: main
    - button "Search this repository (forward slash)" [ref=e33]
    - combobox "Go to file" [ref=e34]
    - navigation "File Tree Navigation" [ref=e35]:
      - tree "Files":
        - treeitem ".claude-plugin" [ref=e36] [level=1]
        - treeitem ".codex-plugin" [ref=e37] [level=1]
        - treeitem ".codex" [ref=e38] [level=1]
        - treeitem ".cursor-plugin" [ref=e39] [level=1]
        - treeitem ".github" [ref=e40] [level=1]
        - treeitem ".opencode" [ref=e41] [level=1]
        - treeitem "assets" [ref=e42] [level=1]
        - treeitem "bin" [ref=e43] [level=1]
        - treeitem "docs" [ref=e44] [level=1]
        - treeitem "hooks" [ref=e45] [level=1]
        - treeitem "scripts" [ref=e46] [level=1]
        - treeitem "skills" [ref=e47] [level=1]
        - treeitem "tests" [ref=e48] [level=1]
        - treeitem ".gitattributes" [ref=e49] [level=1]
        - treeitem ".gitignore" [ref=e50] [level=1]
        - treeitem ".version-bump.json" [ref=e51] [level=1]
        - treeitem "AGENTS.md" [ref=e52] [level=1]
        - treeitem "CLAUDE.md" [ref=e53] [level=1]
        - treeitem "CODE_OF_CONDUCT.md" [ref=e54] [level=1]
        - treeitem "GEMINI.md" [ref=e55] [level=1]
        - treeitem "LICENSE" [ref=e56] [level=1]
        - treeitem "README.md" [ref=e57] [level=1]
        - treeitem "RELEASE-NOTES.md" [ref=e58] [level=1]
        - treeitem "RELEASE-NOTES.zh.md" [ref=e59] [level=1]
        - treeitem "gemini-extension.json" [ref=e60] [level=1]
        - treeitem "package.json" [ref=e61] [level=1]
    - slider "Draggable pane splitter" [ref=e62]
    - navigation "Breadcrumbs" [ref=e63]:
      - heading "Breadcrumbs" [ref=e64] [level=2]
        - listitem:
          - link "superpowers-zh" [ref=e65] [nth=1]:
            - /url: /jnMetaCode/superpowers-zh/tree/main
    - heading "README.md" [ref=e66] [level=1]
    - button "Copy path" [ref=e67]
    - button "More file actions" [ref=e68]
    - heading "Latest commit" [ref=e69] [level=2]
    - link "jnMetaCode" [ref=e70] [nth=1]:
      - /url: /jnMetaCode
    - link "commits by jnMetaCode" [ref=e71]:
      - /url: /jnMetaCode/superpowers-zh/commits?author=jnMetaCode
      - text: jnMetaCode
      - /url: /jnMetaCode/superpowers-zh/commit/9a8d4e471ef178089c133118f64571f66a11ec33
    - link "#27" [ref=e72]:
      - /url: https://github.com/jnMetaCode/superpowers-zh/pull/27
    - link ")" [ref=e73]:
      - /url: /jnMetaCode/superpowers-zh/commit/9a8d4e471ef178089c133118f64571f66a11ec33
    - button "Open commit details" [ref=e74]
    - button "success" [ref=e75]
    - link "Commit 9a8d4e4" [ref=e76]:
      - /url: /jnMetaCode/superpowers-zh/commit/9a8d4e471ef178089c133118f64571f66a11ec33
      - text: 9a8d4e4
    - text: · May 12, 20262 days ago
    - heading "History" [ref=e77] [level=2]
    - link "History" [ref=e78]:
      - /url: /jnMetaCode/superpowers-zh/commits/main/README.md
    - heading "File metadata and controls" [ref=e79] [level=2]
    - list "File view":
      - listitem:
        - button "Preview" [ref=e80]
      - listitem:
        - button "Code" [ref=e81]
      - listitem:
        - button "Blame" [ref=e82]
    - link "Raw" [ref=e83]:
      - /url: https://github.com/jnMetaCode/superpowers-zh/raw/refs/heads/main/README.md
    - button "Copy raw file" [ref=e84]
    - button "Download raw file" [ref=e85]
    - button "Outline" [ref=e86]
    - region "README.md" [ref=e87]:
      - article:
        - heading "superpowers-zh（AI 编程超能力 · 中文增强版）" [ref=e88] [level=1]
          - /url: "#superpowers-zhai-编程超能力--中文增强版"
        - paragraph:
          - text: 🌐
          - strong: 简体中文
          - text: "|"
          - link "English (upstream)" [ref=e89]:
            - /url: https://github.com/obra/superpowers
            - text: 🦸
            - strong: superpowers（159k+ ⭐）完整汉化 + 4 个中国原创 skills
            - text: — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等
            - strong: 17 款 AI 编程工具
            - text: 真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。
        - paragraph:
          - text: Chinese community edition of
          - link "superpowers" [ref=e90]:
            - /url: https://github.com/obra/superpowers
          - text: — 20 skills across 16 AI coding tools, including full translations and China-specific development skills.
            - 'row "没装 superpowers-zh： 你：给用户模块加个批量导出功能 AI：好的，我来实现...（直接开始写代码） export async function exportUsers() { ... } 你：等等，格式不对，没分页，大数据量会 OOM... Copy code to clipboard 装了 superpowers-zh： 你：给用户模块加个批量导出功能 AI：在开始实现之前，我需要了解几个关键问题： 1. 导出格式是 CSV 还是 Excel？ 2. 预计数据量多大？需要异步处理吗？ 3. 有权限要求吗？ → 给出 2-3 个方案，确认后再动手 Copy code to clipboard"':
              - 'cell "没装 superpowers-zh： 你：给用户模块加个批量导出功能 AI：好的，我来实现...（直接开始写代码） export async function exportUsers() { ... } 你：等等，格式不对，没分页，大数据量会 OOM... Copy code to clipboard"':
                  - strong: 没装 superpowers-zh：

[... 843 more lines truncated, use browser_snapshot for full content]


Explanation: I can see this is a complex project. Let me look at the installation instructions. I need to find the install script or setup instructions. Let me look for an install script in the bin folder or similar.


Explanation: Let me look for the install script in the bin directory.


superpowers-zh/bin at main · jnMetaCode/superpowers-zh · GitHub

  - link "Skip to content" [ref=e1]:
    - /url: "#start-of-content"
  - banner:
    - heading "Navigation Menu" [ref=e2] [level=2]
    - link "Homepage" [ref=e3]:
      - /url: /
    - navigation "Global" [ref=e4]:
        - listitem:
          - button "Platform" [ref=e5]
        - listitem:
          - button "Solutions" [ref=e6]
        - listitem:
          - button "Resources" [ref=e7]
        - listitem:
          - button "Open Source" [ref=e8]
        - listitem:
          - button "Enterprise" [ref=e9]
        - listitem:
          - link "Pricing" [ref=e10]:
            - /url: https://github.com/pricing
    - button "Search or jump to…" [ref=e11]
    - link "Sign in" [ref=e12]:
      - /url: /login?return_to=https%3A%2F%2Fgithub.com%2FjnMetaCode%2Fsuperpowers-zh%2Ftree%2Fmain%2Fbin
    - link "Sign up" [ref=e13]:
      - /url: /signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Ffiles%2Fdisambiguate&source=header-repo&source_repo=jnMetaCode%2Fsuperpowers-zh
    - button "Appearance settings" [ref=e14]
  - main:
    - link "jnMetaCode" [ref=e15]:
      - /url: /jnMetaCode
    - text: /
    - strong:
      - link "superpowers-zh" [ref=e16]:
        - /url: /jnMetaCode/superpowers-zh
    - text: Public
      - listitem:
        - link "You must be signed in to change notification settings" [ref=e17]:
          - /url: /login?return_to=%2FjnMetaCode%2Fsuperpowers-zh
          - text: Notifications
      - listitem:
        - link "Fork 310" [ref=e18]:
          - /url: /login?return_to=%2FjnMetaCode%2Fsuperpowers-zh
      - listitem:
        - link "You must be signed in to star a repository" [ref=e19]:
          - /url: /login?return_to=%2FjnMetaCode%2Fsuperpowers-zh
          - text: Star 2.9k
    - navigation "Repository" [ref=e20]:
        - listitem:
          - link "Code" [ref=e21]:
            - /url: /jnMetaCode/superpowers-zh
        - listitem:
          - link "Issues 5" [ref=e22]:
            - /url: /jnMetaCode/superpowers-zh/issues
        - listitem:
          - link "Pull requests" [ref=e23]:
            - /url: /jnMetaCode/superpowers-zh/pulls
        - listitem:
          - link "Discussions" [ref=e24]:
            - /url: /jnMetaCode/superpowers-zh/discussions
        - listitem:
          - link "Actions" [ref=e25]:
            - /url: /jnMetaCode/superpowers-zh/actions
        - listitem:
          - link "Projects" [ref=e26]:
            - /url: /jnMetaCode/superpowers-zh/projects
        - listitem:
          - link "Security and quality" [ref=e27]:
            - /url: /jnMetaCode/superpowers-zh/security
        - listitem:
          - link "Insights" [ref=e28]:
            - /url: /jnMetaCode/superpowers-zh/pulse
    - heading "Collapse file tree" [ref=e29] [level=2]:
      - button "Collapse file tree" [ref=e30] [expanded]
    - heading "Files" [ref=e31] [level=2]
    - button "main branch" [ref=e32]: main
    - button "Search this repository (forward slash)" [ref=e33]
    - combobox "Go to file" [ref=e34]
    - navigation "File Tree Navigation" [ref=e35]:
      - tree "Files":
        - treeitem ".claude-plugin" [ref=e36] [level=1]
        - treeitem ".codex-plugin" [ref=e37] [level=1]
        - treeitem ".codex" [ref=e38] [level=1]
        - treeitem ".cursor-plugin" [ref=e39] [level=1]
        - treeitem ".github" [ref=e40] [level=1]
        - treeitem ".opencode" [ref=e41] [level=1]
        - treeitem "assets" [ref=e42] [level=1]
        - treeitem "bin" [ref=e43] [expanded] [level=1]:
          - text: bin
          - group "bin":
            - treeitem "superpowers-zh.js" [ref=e44] [level=2]
        - treeitem "docs" [ref=e45] [level=1]
        - treeitem "hooks" [ref=e46] [level=1]
        - treeitem "scripts" [ref=e47] [level=1]
        - treeitem "skills" [ref=e48] [level=1]
        - treeitem "tests" [ref=e49] [level=1]
        - treeitem ".gitattributes" [ref=e50] [level=1]
        - treeitem ".gitignore" [ref=e51] [level=1]
        - treeitem ".version-bump.json" [ref=e52] [level=1]
        - treeitem "AGENTS.md" [ref=e53] [level=1]
        - treeitem "CLAUDE.md" [ref=e54] [level=1]
        - treeitem "CODE_OF_CONDUCT.md" [ref=e55] [level=1]
        - treeitem "GEMINI.md" [ref=e56] [level=1]
        - treeitem "LICENSE" [ref=e57] [level=1]
        - treeitem "README.md" [ref=e58] [level=1]
        - treeitem "RELEASE-NOTES.md" [ref=e59] [level=1]
        - treeitem "RELEASE-NOTES.zh.md" [ref=e60] [level=1]
        - treeitem "gemini-extension.json" [ref=e61] [level=1]
        - treeitem "package.json" [ref=e62] [level=1]
    - slider "Draggable pane splitter" [ref=e63]
    - navigation "Breadcrumbs" [ref=e64]:
      - heading "Breadcrumbs" [ref=e65] [level=2]
        - listitem:
          - link "superpowers-zh" [ref=e66] [nth=1]:
            - /url: /jnMetaCode/superpowers-zh/tree/main
    - heading "bin" [ref=e67] [level=1]
    - button "Copy path" [ref=e68]
    - heading "Directory actions" [ref=e69] [level=2]
    - heading "More options" [ref=e70] [level=2]
    - button "More options" [ref=e71]
    - heading "Latest commit" [ref=e72] [level=2]
    - link "jnMetaCode" [ref=e73] [nth=1]:
      - /url: /jnMetaCode
    - link "commits by jnMetaCode" [ref=e74]:
      - /url: /jnMetaCode/superpowers-zh/commits?author=jnMetaCode
      - text: jnMetaCode
      - /url: /jnMetaCode/superpowers-zh/commit/a9e02b501ed7f878fa0f208de7e99286990e3842
    - link "#22" [ref=e75]:
      - /url: https://github.com/jnMetaCode/superpowers-zh/pull/22
    - link ")" [ref=e76]:
      - /url: /jnMetaCode/superpowers-zh/commit/a9e02b501ed7f878fa0f208de7e99286990e3842
    - button "Open commit details" [ref=e77]
    - button "success" [ref=e78]
    - link "Commit a9e02b5" [ref=e79]:
      - /url: /jnMetaCode/superpowers-zh/commit/a9e02b501ed7f878fa0f208de7e99286990e3842
      - text: a9e02b5
    - text: · May 10, 20263 days ago
    - heading "History" [ref=e80] [level=2]
    - link "History" [ref=e81]:
      - /url: /jnMetaCode/superpowers-zh/commits/main/bin
    - heading "Folders and files" [ref=e82] [level=2]
    - table "Folders and files":
        - row "Name Last commit message Last commit date":
          - columnheader "Name" [ref=e83]
          - columnheader "Last commit message" [ref=e84]
          - columnheader "Last commit date" [ref=e85]
        - row "parent directory Parent directory":
          - cell "parent directory Parent directory" [ref=e86]:
            - heading "parent directory" [ref=e87] [level=3]
            - link "Parent directory" [ref=e88]:
              - /url: /jnMetaCode/superpowers-zh/tree/main
              - text: ..
        - 'row "superpowers-zh.js, (File) chore: 跟上游 v5.1.0 对齐 (#22) May 10, 20263 days ago"':
          - cell "superpowers-zh.js, (File)" [ref=e89]:
            - link "superpowers-zh.js, (File)" [ref=e90]:
              - /url: /jnMetaCode/superpowers-zh/blob/main/bin/superpowers-zh.js
              - text: superpowers-zh.js
          - 'cell "chore: 跟上游 v5.1.0 对齐 (#22)"':
              - /url: /jnMetaCode/superpowers-zh/commit/a9e02b501ed7f878fa0f208de7e99286990e3842
            - link "#22" [ref=e91] [nth=1]:
              - /url: https://github.com/jnMetaCode/superpowers-zh/pull/22
            - link ")" [ref=e92] [nth=1]:
              - /url: /jnMetaCode/superpowers-zh/commit/a9e02b501ed7f878fa0f208de7e99286990e3842
          - cell "May 10, 20263 days ago" [ref=e93]


Explanation: I see the bin directory has a `superpowers-zh.js` file. Let me check the README more carefully for installation instructions. Let me look at the raw README to see the full installation guide.


Explanation: Let me try a different approach - download the README via terminal.

terminal

curl -s https://raw.githubusercontent.com/jnMetaCode/superpowers-zh/main/README.md 2>&1 | head -200


Output:
# superpowers-zh（AI 编程超能力 · 中文增强版）

🌐 **简体中文** | [English (upstream)](https://github.com/obra/superpowers)

> 🦸 **superpowers（159k+ ⭐）完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 **17 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。

Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 16 AI coding tools, including full translations and China-specific development skills.

**没装 superpowers-zh：**
```
你：给用户模块加个批量导出功能
AI：好的，我来实现...（直接开始写代码）
    export async function exportUsers() { ... }
你：等等，格式不对，没分页，大数据量会 OOM...
```

**装了 superpowers-zh：**
```
你：给用户模块加个批量导出功能
AI：在开始实现之前，我需要了解几个关键问题：
    1. 导出格式是 CSV 还是 Excel？
    2. 预计数据量多大？需要异步处理吗？
    3. 有权限要求吗？
    → 给出 2-3 个方案，确认后再动手
```

[![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/superpowers-zh)
[![npm version](https://img.shields.io/npm/v/superpowers-zh)](https://www.npmjs.com/package/superpowers-zh)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)

### 📊 项目规模

| 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |
|:---:|:---:|:---:|
| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code** |

---

## 这是什么？

[superpowers](https://github.com/obra/superpowers) 是目前最火的 AI 编程 skills 框架（159k+ stars），为 AI 编程工具提供**系统化的工作方法论**。

**superpowers-zh** 在完整翻译的基础上，新增了面向中国开发者的特色 skills。

### 🆚 与英文上游的区别（老被问，一次说清）

| 维度 | superpowers（英文上游） | superpowers-zh（中文增强版） |
|------|----------------------|---------------------------|
| ⭐ Star 数 | 159k+ | — |
| 📦 Skills 总数 | 14 | **20**（14 翻译 + 4 国产原创 + 2 上游历史保留） |
| 🌐 语言 | 英文 | 中文（技术术语保留英文） |
| 🤖 **支持工具** | **6 款**：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **17 款**：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通义灵码）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider |
| ⚡ **安装方式** | 按工具分别装（每款一条不同的 plugin marketplace 命令） | **`npx superpowers-zh` 一条命令自动识别项目里的工具并安装**；识别不出可 `--tool <name>` 显式指定 |
| 🇨🇳 Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 GitLab + **CNB（腾讯云原生构建）** |
| 🇨🇳 CI/CD 示例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 极狐 CI + `.cnb.yml` |
| 🇨🇳 代码审查风格 | 西方直接风格 | 适配国内团队沟通文化 |
| 🇨🇳 Git 提交规范 | 无 | Conventional Commits 中文适配 |
| 🇨🇳 中文文档规范 | 无 | 中文排版 + 中英混排规则 + 告别机翻味 |
| ➕ MCP 服务器构建 | 无 | 独立 `mcp-builder` skill |
| ➕ 工作流执行器 | 无 | 独立 `workflow-runner` skill（多角色 YAML 编排） |
| 🔄 版本跟进 | 独立迭代 | **同步上游 + 国产增量叠加** |
| 🤝 接受新 skill PR | 一般不接受（原文：*"we don't generally accept contributions of new skills"*） | 欢迎 PR（中国开发者痛点优先） |
| 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 |
| 📜 License | MIT | MIT |

**一句话总结：** 英文上游 = 方法论内核；中文增强版 = 方法论内核 **+** 17 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。

### 🤖 支持 17 款主流 AI 编程工具

| 工具 | 类型 | 一键安装 | 手动安装 |
|------|------|:---:|:---:|
| [Claude Code](https://claude.ai/code) | CLI | `npx superpowers-zh` | `.claude/skills/` |
| [Copilot CLI](https://githubnext.com/projects/copilot-cli) | CLI | `npx superpowers-zh --tool copilot` | `.claude/skills/` |
| [Hermes Agent](https://github.com/NousResearch/hermes-agent) | CLI | `npx superpowers-zh --tool hermes` | `.hermes/skills/` |
| [Cursor](https://cursor.sh) | IDE | `npx superpowers-zh` | `.cursor/skills/` |
| [Windsurf](https://codeium.com/windsurf) | IDE | `npx superpowers-zh` | `.windsurf/skills/` |
| [Kiro](https://kiro.dev) | IDE | `npx superpowers-zh` | `.kiro/steering/` |
| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | CLI | `npx superpowers-zh` | `.gemini/skills/` |
| [Codex CLI](https://github.com/openai/codex) | CLI | `npx superpowers-zh` | `.codex/skills/` |
| [Aider](https://aider.chat) | CLI | `npx superpowers-zh` | `.aider/skills/` |
| [Trae](https://trae.ai) | IDE | `npx superpowers-zh` | `.trae/skills/` + `.trae/rules/` |
| [VS Code](https://code.visualstudio.com) (Copilot) | IDE 插件 | `npx superpowers-zh` | `.github/superpowers/` |
| [DeerFlow 2.0](https://github.com/bytedance/deer-flow) | Agent 框架 | `npx superpowers-zh` | `skills/custom/` |
| [OpenCode](https://opencode.ai) | CLI | `npx superpowers-zh` | `.opencode/skills/` |
| [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
| [Qwen Code](https://tongyi.aliyun.com/lingma) (通义灵码) | IDE 插件 | `npx superpowers-zh` | `.qwen/skills/` |
| [Antigravity](https://github.com/anthropics/antigravity) | CLI | `npx superpowers-zh` | `.antigravity/skills/` |
| [Claw Code](https://github.com/ultraworkers/claw-code) | CLI (Rust) | `npx superpowers-zh` | `.claw/skills/` |

> 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具，将 20 个 skills 安装到正确位置。

### 翻译的 Skills（14 个）

| Skill | 用途 |
|-------|------|
| **头脑风暴** (brainstorming) | 需求分析 → 设计规格，不写代码先想清楚 |
| **编写计划** (writing-plans) | 把规格拆成可执行的实施步骤 |
| **执行计划** (executing-plans) | 按计划逐步实施，每步验证 |
| **测试驱动开发** (test-driven-development) | 严格 TDD：先写测试，再写代码 |
| **系统化调试** (systematic-debugging) | 四阶段调试法：定位→分析→假设→修复 |
| **请求代码审查** (requesting-code-review) | 派遣审查 agent 检查代码质量 |
| **接收代码审查** (receiving-code-review) | 技术严谨地处理审查反馈，拒绝敷衍 |
| **完成前验证** (verification-before-completion) | 证据先行——声称完成前必须跑验证 |
| **派遣并行 Agent** (dispatching-parallel-agents) | 多任务并发执行 |
| **子 Agent 驱动开发** (subagent-driven-development) | 每个任务一个 agent，两轮审查 |
| **Git Worktree 使用** (using-git-worktrees) | 隔离式特性开发 |
| **完成开发分支** (finishing-a-development-branch) | 合并/PR/保留/丢弃四选一 |
| **编写 Skills** (writing-skills) | 创建新 skill 的方法论 |
| **使用 Superpowers** (using-superpowers) | 元技能：如何调用和优先使用 skills |

### 🇨🇳 中国特色 Skills（6 个）

> ⚠ **下表前 4 个 chinese-\* 为「手动调用」skill**——不会自动触发，需在对话中显式输入 `/chinese-xxx` 才会加载。
> 设计为参考资料而非工作流，避免污染上游 skill 的自动调度（如 `requesting-code-review`、`brainstorming` 等）。

| Skill | 用途 | 调用方式 | 上游有吗？ |
|-------|------|---------|:---:|
| **中文代码审查** (chinese-code-review) | 符合国内团队文化的代码审查规范 | `/chinese-code-review`（手动） | 无 |
| **中文 Git 工作流** (chinese-git-workflow) | 适配 Gitee/Coding/极狐 GitLab/CNB | `/chinese-git-workflow`（手动） | 无 |
| **中文技术文档** (chinese-documentation) | 中文排版规范、中英混排、告别机翻味 | `/chinese-documentation`（手动） | 无 |
| **中文提交规范** (chinese-commit-conventions) | 适配国内团队的 commit message 规范 | `/chinese-commit-conventions`（手动） | 无 |
| **MCP 服务器构建** (mcp-builder) | 构建生产级 MCP 工具，扩展 AI 能力边界 | 自动 | 无 |
| **工作流执行器** (workflow-runner) | 在 AI 工具内运行多角色 YAML 工作流 | 自动 | 无 |

---

## 快速开始

### 方式一：npm 安装（推荐）

```bash
cd /your/project
npx superpowers-zh
```

> ⚠ **不要在主目录（`~`）下跑**。v1.2.1 起会拒绝并提示，老版本会把 skills 和 `CLAUDE.md` 等 bootstrap 文件写到你的 home 目录，污染所有项目。如已误装见下文「卸载 / 误装清理」。

### 方式二：手动安装（low-fidelity，仅作备选）

> ⚠ **手动 `cp -r skills` 是低保版安装，不等同于完整 plugin。**
>
> superpowers-zh 是一个完整 plugin，包含：`skills/`（20 个能力）+ `hooks/`（SessionStart 钩子，让 skill 在合适时机自动触发）+ `CLAUDE.md` / `GEMINI.md` 等 bootstrap 引导文件 + 4 套 plugin manifest（Claude Code / Cursor / Codex / Marketplace）。
>
> **下面的 `cp -r skills` 命令只复制 skills 目录**，不会自动配置 hooks、不会生成 bootstrap 引导。结果：skills 物理上存在，但 AI 不会在合适时机自动调用，需要你每次手动喊 "use brainstorming skill" 之类。
>
> **强烈推荐用方式一 `npx superpowers-zh`** —— 它会一键处理 skills 复制 + bootstrap 生成 + hooks 配置 + 工具特定适配。仅在 npx 不可用（极端无网络环境）时才退到手动。

```bash
# 克隆仓库
git clone https://github.com/jnMetaCode/superpowers-zh.git

# 复制 skills 到你的项目（选择你使用的工具）
cp -r superpowers-zh/skills /your/project/.claude/skills      # Claude Code / Copilot CLI
cp -r superpowers-zh/skills /your/project/.hermes/skills      # Hermes Agent
cp -r superpowers-zh/skills /your/project/.cursor/skills      # Cursor
cp -r superpowers-zh/skills /your/project/.codex/skills       # Codex CLI
cp -r superpowers-zh/skills /your/project/.kiro/steering      # Kiro
cp -r superpowers-zh/skills /your/project/skills/custom       # DeerFlow 2.0
cp -r superpowers-zh/skills /your/project/.trae/rules         # Trae
cp -r superpowers-zh/skills /your/project/.antigravity        # Antigravity
cp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)
cp -r superpowers-zh/skills /your/project/skills              # OpenClaw
cp -r superpowers-zh/skills /your/project/.windsurf/skills   # Windsurf
cp -r superpowers-zh/skills /your/project/.gemini/skills     # Gemini CLI
cp -r superpowers-zh/skills /your/project/.aider/skills      # Aider
cp -r superpowers-zh/skills /your/project/.opencode/skills   # OpenCode
cp -r superpowers-zh/skills /your/project/.qwen/skills       # Qwen Code
cp -r superpowers-zh/skills /your/project/.claw/skills       # Claw Code（Rust 版）
```

### 方式三：在配置文件中引用

根据你使用的工具，在对应配置文件中引用 skills：

| 工具 | 配置文件 | 说明 |
|------|---------|------|
| Claude Code | `CLAUDE.md` | 项目根目录 |
| Copilot CLI | `CLAUDE.md` | 与 Claude Code 共用插件格式 |
| Hermes Agent | `HERMES.md` 或 `.hermes.md` | 项目根目录，安装时自动生成 |
| Kiro | `.kiro/steering/*.md` | 支持 always/globs/手动三种模式 |
| DeerFlow 2.0 | `skills/custom/*/SKILL.md` | 字节跳动开源 SuperAgent，自动发现自定义 skills |
| Trae | `.trae/rules/project_rules.md` | 项目级规则 |
| Antigravity | `GEMINI.md` 或 `AGENTS.md` | 项目根目录 |
| VS Code | `.github/copilot-instructions.md` | Copilot 自定义指令 |
| Cursor | `.cursor/rules/*.md` | 项目级规则目录 |
| OpenClaw | `skills/*/SKILL.md` | 工作区级 skills 目录，自动发现 |
| Windsurf | `.windsurf/skills/*/SKILL.md` | 项目级 skills 目录 |
| Gemini CLI | `.gemini/skills/*/SKILL.md` | 项目级 skills 目录 |
| Aider | `.aider/skills/*/SKILL.md` | 项目级 skills 目录 |


安装方式明确，亮为主公执行安装：

Explanation: Now I understand the installation. For Hermes Agent, the skill gets installed to `~/.hermes/skills/`. Let me run the install command.

cd ~/.hermes && npx superpowers-zh --tool hermes 2>&1


Output:
npm warn exec The following package was not found and will be installed: superpowers-zh@1.3.0

  superpowers-zh v1.3.0 — AI 编程超能力中文版

  源: 20 个 skills
  目标项目: /root/.hermes

  ✅ Hermes Agent: 20 个 skills -> /root/.hermes/.hermes/skills
  ✅ Hermes Agent: bootstrap -> /root/.hermes/HERMES.md

  安装完成！重启你的 AI 编程工具即可生效。


Explanation: The installation was successful. Let me verify what was installed.

ls ~/.hermes/.hermes/skills/ 2>/dev/null && echo "---" && ls ~/.hermes/HERMES.md 2>/dev/null


Output:
brainstorming
chinese-code-review
chinese-commit-conventions
chinese-documentation
chinese-git-workflow
dispatching-parallel-agents
executing-plans
finishing-a-development-branch
mcp-builder
receiving-code-review
requesting-code-review
subagent-driven-development
systematic-debugging
test-driven-development
using-git-worktrees
using-superpowers
verification-before-completion
workflow-runner
writing-plans
writing-skills
---
/root/.hermes/HERMES.md


**superpowers-zh 安装完成 ✓**

| 项目 | 状态 |
|------|------|
| 安装路径 | `~/.hermes/.hermes/skills/` |
| Skills 数量 | **20 个**（14 翻译 + 6 中国原创） |
| Bootstrap | `~/.hermes/HERMES.md` 已生成 |

**已安装 Skills 一览：**

| 分类 | Skills |
|------|--------|
| 🔄 上游翻译（14） | brainstorming、writing-plans、executing-plans、test-driven-development、systematic-debugging、requesting-code-review、receiving-code-review、verification-before-completion、dispatching-parallel-agents、subagent-driven-development、using-git-worktrees、finishing-a-development-branch、writing-skills、using-superpowers |
| 🇨🇳 中国原创（6） | chinese-code-review、chinese-git-workflow、chinese-documentation、chinese-commit-conventions、mcp-builder、workflow-runner |

重启 Hermes Agent 即可生效。主公可试着命亮用 `/brainstorming` 或 `/chinese-code-review` 等指令调用相关技能。

Explanation: Installed successfully. All 20 skills are installed in the right place. Let me report back.


Explanation: The user wants me to summarize another article from chuan.us. Let me navigate to it.


王川：论兴趣和世界第九大奇迹 （一）

Running WITHOUT residential proxies. Bot detection may be more aggressive. Consider upgrading Browserbase plan for proxy support.

  - link "Skip to content" [ref=e1]:
    - /url: "#page"
  - banner:
    - paragraph:
      - link [ref=e2]:
        - /url: https://chuan.us/
  - navigation:
      - listitem:
        - link "博客" [ref=e3]:
          - /url: https://chuan.us/blog
      - listitem:
        - link "联系" [ref=e4]:
          - /url: https://chuan.us/contact
      - listitem:
        - link "俱乐部" [ref=e5]:
          - /url: https://chuan.us/club
      - listitem:
        - link "NFT" [ref=e6]:
          - /url: https://chuan.us/nft
      - listitem:
        - link "English" [ref=e7]:
          - /url: https://chuan.us/english
  - article:
    - heading "王川：论兴趣和世界第九大奇迹 （一）" [ref=e8] [level=1]
    - paragraph: 1/ 兴趣让人废寝忘食，是可以持续的巨大内在动力。
    - paragraph: 2/ 兴趣本质是什么? 它有外在的，和内在的两个方面。外在方面，任何领域，有高速增长，不断有更新更好的东西出现，自然会引起兴趣。没有增长，固化了的东西，很快让人觉得枯燥。可以参见笔者的老文章
    - paragraph:
      - link "王川：幸福来自效率的全面复合增长" [ref=e9]:
        - /url: https://chuan.us/archives/690
    - paragraph: 3/ 没有增长的情况下，还对某个事情有巨大兴趣，要么就是陷入类似毒瘾一样的坑，要么就是自欺欺人。
    - paragraph: 4/ 如何找到更多让你产生兴趣的东西? 唯有不断扩大和外界广泛和开放的连接。
    - paragraph: 5/ 内在的方面：兴趣来自于和外界交互中的各种持续的正反馈，推动知识和技能的不断提升。有人说，“兴趣是精通的副产品”， 精通导致更多正反馈。给你带来即时反馈的掌控感和节节贯穿的丝滑顺畅感的事物，可以产生心流，支撑强烈的兴趣。但稍微复杂一点的事情，没人一开始可以马上精通，从不通到精通需要持续的正反馈，而这个正反馈的来源往往不是你想的那样，被急功近利的老师和家长按着头，强行吃苦很长时间来获得的。
    - paragraph: 6/ 达到这种精通的状态需要兴趣驱动的长期摸索和时间的积累，往往在意想不到的地方自发涌现，这就是所谓 “慢就是快”。如果一味主观表面求快，但实际底层操作上不精通不流畅，反而容易陷入 “再而衰，三而竭”的状态，而很快失去兴趣，甚至彻底放弃。
    - paragraph: 7/ 人为设立截止日期，用主观定义的 KPI 来攀比竞赛，会误导甚至扼杀处于萌芽状态的兴趣，潜在危害极大。
    - paragraph: 8/ 兴趣在哪里爆发，很多时候无法提前计划。常常会因为环境 （外因）的变化，某个地方自发涌现出高速增长，和你的知识技能匹配 （内因），产生有益的反馈，而引起你的兴趣。不尊重这种自发涌现的高速增长，而用传统教条定义的兴趣来主观的框住自己，妄图强行在没有增长的环境里一厢情愿的逼自己产生兴趣，无异作茧自缚，最后浪费时间资源吃大亏的还是自己。
    - paragraph: "9/ 以前我犯过的错误包括: 在相对封闭的圈子里，对缺乏增长的东西硬着头皮自欺欺人的表示兴趣; 贪多求快，但很难迅速达到那种节节贯穿的丝滑感，不断被各种挫折损耗意志力，而最终丧失兴趣和内驱力。"
    - paragraph: 10/ 比如说，在大学里，硬着头皮对数理化表示兴趣，内卷化的做大量吉米多维奇的习题，做到最后唯一持续的动力是和同学比赛考分，但越学越觉得无趣。这种技能在就业市场并不能找到更好工作，也发不了大财。反而是读各种历史，科学史，商业史等等，越仔细研究，越能发掘出一些实用的规律，越有兴趣。后来真正自由后，对数理化的一些东西重新产生了真实的兴趣，而这种兴趣更侧重于该学科内的一些更深层次的普适性的结构特征，并不是像个僵尸一样做很多”知其然不知其所以然”的无聊的演算。
    - paragraph: "11/ 促进兴趣的正反馈有两类: 第一类是和过去的自己比较有进步, 知识更丰富了，效率更高了，就很高兴，有更多动力; 第二类是和别人比，在竞争中胜出，获得更多奖励，也很高兴。但即使你在某个领域无法和人竞争，你总是可以利用这个领域最优秀的人的成果，来不断提升自己的效率，这样的组合无止境，这也是兴趣的持久动力。"
    - paragraph: 12/ 因为有兴趣，自然会比别人多下功夫，自然在别人懒得下功夫的地方看到别人没看到的东西，掌握别人没有掌握的技术。这样以后面对缺乏真实兴趣/硬着头皮被赶鸭子上架的对手，自然如削瓜切菜，取上将首级如探囊取物。
    - paragraph: 13/ 兴趣导致在某个领域会慢慢精通，精通就意味着在这个领域稍微用点力气，就可以获得比普通人大得多的回报，从而产生更多兴趣 (复合兴趣），从而在更多领域慢慢精通，有更大的内驱力，层层递进，良性循环，没有止境。
    - paragraph: 14/ 兴趣和利息，在英文里都叫 “interest”, 是有道理的。据称爱因斯坦曾说，“复利是世界第八大奇迹，理解它的人收到复利，不理解它的人要支付复利”。(Compound interest is the eighth wonder of the world. He who understands it, earns it. He who doesn’t, pays it.)
    - paragraph: 15/ 我说，“复合兴趣是世界第九大奇迹，理解它的人每天都有越来越强的内驱力，不理解它的人要被迫追求别人的兴趣“。
    - paragraph: 16/ 没有兴趣的事情，还要假装有兴趣，花很多时间做表面功夫，好比贷款中借出去的坏账。债务违约的时候，才意识到本金早就没有了。停止做根本没兴趣的事情，才意识到逝去的光阴早就没有了。早点冲销坏账，早点停止做没兴趣的事情，总是最好的选择。
    - paragraph: 17/ 很多人说”没兴趣”的实际意思是，某个事情给他带来的利益过于微小，因此不屑去深入钻研。因此他的整个认知体系的基础是空洞，脆弱和粗糙的，他也永远无法积累出可以高效捕捉巨大利益的认知体系，也就永远停留在那种”没兴趣”的状态。
    - paragraph: 18/ 人们轻视可以长期复合增长的复利，而喜欢迅速捞一票大的，因为短期看复利的数量太小了。人们忽视因兴趣而学习带来的微小但真实的进步，而为了一点月薪强迫自己做没兴趣也没有技术含量的事情，外表上还要装得有兴趣.
    - paragraph: 19/ 不喜欢诚实的复利的人，往往落入传销和各种套路贷的陷阱，全部积累最后打水漂。不遵循内心真实兴趣来开拓事业的人，最终光阴(类似本金)耗尽，郁郁寡欢，陷入中老年危机。
    - paragraph: 20/ 当人说”我对发财有兴趣”时，这种空话没有意义。比如说真正发财需要掌握十个复杂矛盾的知识点，如果没有对具体每个点本身的兴趣和渴求，强迫自己学了两三点之后还似懂非懂，一直没有获得奖励，就会觉得太复杂而提前放弃了。实际情况往往是，因为兴趣本身，长期积累了二十个不同的知识点，突然发现里面有十个知识点可以串起来，以某种意想不到的方式发大财，然后对各种新的知识点越来越敏感。这种敏感度体现为：可以隐约提前感知某个知识点，做成某件自己缺乏的事情，可以和别的东西串起来. 因此主动学习的兴趣也越来越大。
    - paragraph: 21/ 知识结构越丰富，这种敏感度和敏感度带来的动力，和常人的差距就越来越大。这也是“数量就是质量”的一种体现， 可以参见笔者的老文章
    - paragraph: 王川：论数量就是质量
    - paragraph: (未完待续）
    - text: by
    - link "Posts by" [ref=e10]:
      - /url: https://chuan.us/archives/author/chuanus
    - link "chuan" [ref=e11]:
      - /url: https://chuan.us/archives/category/blog
    - heading " You may also like..." [ref=e12] [level=4]
            - /url: https://chuan.us/archives/960
            - 'img "王川: 为什么利润翻一倍但股价可能翻九倍"'
              - /url: https://chuan.us/archives/960
      - listitem:
        - article:
          - link "王川： 输入信息狭隘， 近乎精神病 （一）" [ref=e13]:
            - /url: https://chuan.us/archives/440
          - heading "王川： 输入信息狭隘， 近乎精神病 （一）" [ref=e14] [level=4]:
            - link "王川： 输入信息狭隘， 近乎精神病 （一）" [ref=e15] [nth=1]:
              - /url: https://chuan.us/archives/440
            - /url: https://chuan.us/archives/221
            - 'img "王川: 为什么传统汽车厂商大多很快会倒闭？"'
              - /url: https://chuan.us/archives/221
    - listitem:
      - link " Next 2022年1月微博发言摘要" [ref=e16]:
        - /url: https://chuan.us/archives/808
        - text: 
        - strong: Next
        - text: 2022年1月微博发言摘要
    - listitem:
      - link " Previous 王川：从长期国债的悖论到胆固醇的悖论 （三）" [ref=e17]:
        - /url: https://chuan.us/archives/796
        - text: 
        - strong: Previous
        - text: 王川：从长期国债的悖论到胆固醇的悖论 （三）
  - search:
    - text: Search
    - searchbox "Search" [ref=e18]
    - button "Search" [ref=e19]
  - heading "Recent Comments" [ref=e20] [level=2]
    - listitem:
      - article:
        - text: jackworld on
        - link "王川：躺平者最终能赢 （一）" [ref=e21]:
          - /url: https://chuan.us/archives/952#comment-72
    - listitem:
      - article:
        - link "chuanus" [ref=e22]:
          - /url: https://chuan.us
        - text: "on"
          - /url: https://chuan.us/archives/775#comment-71
        - text: lol on
          - /url: https://chuan.us/archives/775#comment-69
        - text: lol on
          - /url: https://chuan.us/archives/788#comment-67
        - text: Yuis on
          - /url: https://chuan.us/archives/775#comment-37
    - listitem:
      - link " 博客" [ref=e23]:
        - /url: https://chuan.us/blog
    - listitem:
      - link " 联系" [ref=e24]:
        - /url: https://chuan.us/contact
    - listitem:
      - link " 俱乐部" [ref=e25]:
        - /url: https://chuan.us/club
    - listitem:
      - link " NFT" [ref=e26]:
        - /url: https://chuan.us/nft
    - listitem:
      - link " English" [ref=e27]:
        - /url: https://chuan.us/english
  - heading "Archives" [ref=e28] [level=2]
    - listitem:
      - link "March 2026" [ref=e29]:
        - /url: https://chuan.us/archives/date/2026/03
    - listitem:
      - link "September 2025" [ref=e30]:
        - /url: https://chuan.us/archives/date/2025/09
    - listitem:
      - link "April 2025" [ref=e31]:
        - /url: https://chuan.us/archives/date/2025/04
    - listitem:
      - link "December 2024" [ref=e32]:
        - /url: https://chuan.us/archives/date/2024/12
    - listitem:
      - link "June 2024" [ref=e33]:
        - /url: https://chuan.us/archives/date/2024/06
    - listitem:
      - link "January 2024" [ref=e34]:
        - /url: https://chuan.us/archives/date/2024/01
    - listitem:
      - link "September 2023" [ref=e35]:
        - /url: https://chuan.us/archives/date/2023/09
    - listitem:
      - link "June 2023" [ref=e36]:
        - /url: https://chuan.us/archives/date/2023/06
    - listitem:
      - link "March 2023" [ref=e37]:
        - /url: https://chuan.us/archives/date/2023/03
    - listitem:
      - link "December 2022" [ref=e38]:
        - /url: https://chuan.us/archives/date/2022/12
    - listitem:
      - link "September 2022" [ref=e39]:
        - /url: https://chuan.us/archives/date/2022/09
    - listitem:
      - link "August 2022" [ref=e40]:
        - /url: https://chuan.us/archives/date/2022/08
    - listitem:
      - link "June 2022" [ref=e41]:
        - /url: https://chuan.us/archives/date/2022/06
    - listitem:
      - link "April 2022" [ref=e42]:
        - /url: https://chuan.us/archives/date/2022/04
    - listitem:
      - link "February 2022" [ref=e43]:
        - /url: https://chuan.us/archives/date/2022/02
    - listitem:
      - link "January 2022" [ref=e44]:
        - /url: https://chuan.us/archives/date/2022/01
    - listitem:
      - link "December 2021" [ref=e45]:

[... 49 more lines truncated, use browser_snapshot for full content]


📖 **《王川：论兴趣和世界第九大奇迹（一）》要点总结**

---

**核心洞见**

> *"复利是世界第八大奇迹，理解它的人收到复利，不理解它的人要支付复利。"* —— 爱因斯坦
>
> *"复合兴趣是世界第九大奇迹，理解它的人每天都有越来越强的内驱力，不理解它的人要被迫追求别人的兴趣。"* —— 王川

---

**兴趣的本质**

- **外在**：某领域有高速增长，不断更新，自然引发兴趣；没有增长，固化的东西，很快让人枯燥
- **内在**：正反馈推动知识和技能不断提升 → 精通 → 更多正反馈 → 心流

---

**兴趣的敌人**

| 错误做法 | 危害 |
|---------|------|
| 硬着头皮自欺欺人表示"有兴趣" | 如同陷入毒瘾 |
| 贪多求快，无法达到"丝滑感" | 再而衰，三而竭，迅速放弃 |
| 用截止日期和KPI强迫 | 扼杀萌芽状态的兴趣 |
| 主观框住自己，在没增长的环境逼出兴趣 | 作茧自缚 |

---

**两类正反馈**

1. **跟过去的自己比**：知识更丰富、效率更高，就高兴
2. **跟别人比**：竞争中胜出，获得奖励

> 即使在某领域无法和人竞争，你总可以利用该领域最优秀的人的成果来提升自己——**组合无止境，兴趣持久**。

---

**复合兴趣的滚雪球效应**

> 兴趣 → 精通 → 比普通人更大回报 → 更多兴趣 → 更多精通 → 更大内驱力 → **层层递进，良性循环，没有止境**

---

**警句**

- *"没兴趣的事情还假装有兴趣，好比贷款中借出去的坏账。停止做没兴趣的事情，才意识到逝去的光阴早就没有了。"*
- *"当你对某事说'没兴趣'时，实际意思是：这件事带来的利益太微小，不值得深入钻研。于是你的认知体系基础空洞、脆弱、粗糙，永远无法积累出能高效捕捉巨大利益的认知体系。"*
- *"数量就是质量——知识结构越丰富，对新知识点的敏感度和主动学习的动力，与常人的差距就越来越大。"*

---

**亮评**：兴趣与复利并举，诚为灼见。世人多知复利之妙，却鲜悟兴趣亦可复合增长。**被迫做的事与真心热爱的事，日久天长，其差距不可以道里计**。找到那件让你"丝滑"的事，比任何KPI都重要。

Explanation: I've now read the full article. Let me summarize it for the user.


这个项目的 reademe 翻译成中文保存 markdown 发送给我：https://github.com/msitarzewski/agency-agents


Explanation: The user wants me to translate the README of https://github.com/msitarzewski/agency-agents into Chinese and save it as a markdown file. Let me first fetch the README content.

curl -s https://raw.githubusercontent.com/msitarzewski/agency-agents/main/README.md 2>&1


Output:
# 🎭 The Agency: AI Specialists Ready to Transform Your Workflow

> **A complete AI agency at your fingertips** - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.

[![GitHub stars](https://img.shields.io/github/stars/msitarzewski/agency-agents?style=social)](https://github.com/msitarzewski/agency-agents)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?logo=github)](https://github.com/sponsors/msitarzewski)

---

## 🚀 What Is This?

Born from a Reddit thread and months of iteration, **The Agency** is a growing collection of meticulously crafted AI agent personalities. Each agent is:

- **🎯 Specialized**: Deep expertise in their domain (not generic prompt templates)
- **🧠 Personality-Driven**: Unique voice, communication style, and approach
- **📋 Deliverable-Focused**: Real code, processes, and measurable outcomes
- **✅ Production-Ready**: Battle-tested workflows and success metrics

**Think of it as**: Assembling your dream team, except they're AI specialists who never sleep, never complain, and always deliver.

---

## ⚡ Quick Start

### Option 1: Use with Claude Code (Recommended)

```bash
# Install all agents to your Claude Code directory
./scripts/install.sh --tool claude-code

# Or manually copy a category if you only want one division
cp engineering/*.md ~/.claude/agents/

# Then activate any agent in your Claude Code sessions:
# "Hey Claude, activate Frontend Developer mode and help me build a React component"
```

### Option 2: Use as Reference

Each agent file contains:
- Identity & personality traits
- Core mission & workflows
- Technical deliverables with code examples
- Success metrics & communication style

Browse the agents below and copy/adapt the ones you need!

### Option 3: Use with Other Tools (GitHub Copilot, Antigravity, Gemini CLI, OpenCode, OpenClaw, Cursor, Aider, Windsurf, Kimi Code)

```bash
# Step 1 -- generate integration files for all supported tools
./scripts/convert.sh

# Step 2 -- install interactively (auto-detects what you have installed)
./scripts/install.sh

# Or target a specific tool directly
./scripts/install.sh --tool antigravity
./scripts/install.sh --tool gemini-cli
./scripts/install.sh --tool opencode
./scripts/install.sh --tool copilot
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool cursor
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf
./scripts/install.sh --tool kimi
```

See the [Multi-Tool Integrations](#-multi-tool-integrations) section below for full details.

---

## 🎨 The Agency Roster

### 💻 Engineering Division

Building the future, one commit at a time.

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🎨 [Frontend Developer](engineering/engineering-frontend-developer.md) | React/Vue/Angular, UI implementation, performance | Modern web apps, pixel-perfect UIs, Core Web Vitals optimization |
| 🏗 [Backend Architect](engineering/engineering-backend-architect.md) | API design, database architecture, scalability | Server-side systems, microservices, cloud infrastructure |
| 📱 [Mobile App Builder](engineering/engineering-mobile-app-builder.md) | iOS/Android, React Native, Flutter | Native and cross-platform mobile applications |
| 🤖 [AI Engineer](engineering/engineering-ai-engineer.md) | ML models, deployment, AI integration | Machine learning features, data pipelines, AI-powered apps |
| 🚀 [DevOps Automator](engineering/engineering-devops-automator.md) | CI/CD, infrastructure automation, cloud ops | Pipeline development, deployment automation, monitoring |
| ⚡ [Rapid Prototyper](engineering/engineering-rapid-prototyper.md) | Fast POC development, MVPs | Quick proof-of-concepts, hackathon projects, fast iteration |
| 💎 [Senior Developer](engineering/engineering-senior-developer.md) | Laravel/Livewire, advanced patterns | Complex implementations, architecture decisions |
| 🔧 [Filament Optimization Specialist](engineering/engineering-filament-optimization-specialist.md) | Filament PHP admin UX, structural form redesign, resource optimization | Restructuring Filament resources/forms/tables for faster, cleaner admin workflows |
| 🔒 [Security Engineer](engineering/engineering-security-engineer.md) | Threat modeling, secure code review, security architecture | Application security, vulnerability assessment, security CI/CD |
| ⚡ [Autonomous Optimization Architect](engineering/engineering-autonomous-optimization-architect.md) | LLM routing, cost optimization, shadow testing | Autonomous systems needing intelligent API selection and cost guardrails |
| 🔩 [Embedded Firmware Engineer](engineering/engineering-embedded-firmware-engineer.md) | Bare-metal, RTOS, ESP32/STM32/Nordic firmware | Production-grade embedded systems and IoT devices |
| 🚨 [Incident Response Commander](engineering/engineering-incident-response-commander.md) | Incident management, post-mortems, on-call | Managing production incidents and building incident readiness |
| ⛓ [Solidity Smart Contract Engineer](engineering/engineering-solidity-smart-contract-engineer.md) | EVM contracts, gas optimization, DeFi | Secure, gas-optimized smart contracts and DeFi protocols |
| 🧭 [Codebase Onboarding Engineer](engineering/engineering-codebase-onboarding-engineer.md) | Fast developer onboarding, read-only codebase exploration, factual explanation | Helping new developers understand unfamiliar repos quickly by reading the code, tracing code paths, and stating facts about structure and behavior |
| 📚 [Technical Writer](engineering/engineering-technical-writer.md) | Developer docs, API reference, tutorials | Clear, accurate technical documentation |
| 🎯 [Threat Detection Engineer](engineering/engineering-threat-detection-engineer.md) | SIEM rules, threat hunting, ATT&CK mapping | Building detection layers and threat hunting |
| 💬 [WeChat Mini Program Developer](engineering/engineering-wechat-mini-program-developer.md) | WeChat ecosystem, Mini Programs, payment integration | Building performant apps for the WeChat ecosystem |
| 👁 [Code Reviewer](engineering/engineering-code-reviewer.md) | Constructive code review, security, maintainability | PR reviews, code quality gates, mentoring through review |
| 🗄 [Database Optimizer](engineering/engineering-database-optimizer.md) | Schema design, query optimization, indexing strategies | PostgreSQL/MySQL tuning, slow query debugging, migration planning |
| 🌿 [Git Workflow Master](engineering/engineering-git-workflow-master.md) | Branching strategies, conventional commits, advanced Git | Git workflow design, history cleanup, CI-friendly branch management |
| 🏛 [Software Architect](engineering/engineering-software-architect.md) | System design, DDD, architectural patterns, trade-off analysis | Architecture decisions, domain modeling, system evolution strategy |
| 🛡 [SRE](engineering/engineering-sre.md) | SLOs, error budgets, observability, chaos engineering | Production reliability, toil reduction, capacity planning |
| 🧬 [AI Data Remediation Engineer](engineering/engineering-ai-data-remediation-engineer.md) | Self-healing pipelines, air-gapped SLMs, semantic clustering | Fixing broken data at scale with zero data loss |
| 🔧 [Data Engineer](engineering/engineering-data-engineer.md) | Data pipelines, lakehouse architecture, ETL/ELT | Building reliable data infrastructure and warehousing |
| 🔗 [Feishu Integration Developer](engineering/engineering-feishu-integration-developer.md) | Feishu/Lark Open Platform, bots, workflows | Building integrations for the Feishu ecosystem |
| 🧱 [CMS Developer](engineering/engineering-cms-developer.md) | WordPress & Drupal themes, plugins/modules, content architecture | Code-first CMS implementation and customization |
| 📧 [Email Intelligence Engineer](engineering/engineering-email-intelligence-engineer.md) | Email parsing, MIME extraction, structured data for AI agents | Turning raw email threads into reasoning-ready context |
| 🎙 [Voice AI Integration Engineer](engineering/engineering-voice-ai-integration-engineer.md) | Speech-to-text pipelines, Whisper, ASR, speaker diarization | End-to-end transcription pipelines, audio preprocessing, structured transcript delivery |

### 🎨 Design Division

Making it beautiful, usable, and delightful.

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🎯 [UI Designer](design/design-ui-designer.md) | Visual design, component libraries, design systems | Interface creation, brand consistency, component design |
| 🔍 [UX Researcher](design/design-ux-researcher.md) | User testing, behavior analysis, research | Understanding users, usability testing, design insights |
| 🏛 [UX Architect](design/design-ux-architect.md) | Technical architecture, CSS systems, implementation | Developer-friendly foundations, implementation guidance |
| 🎭 [Brand Guardian](design/design-brand-guardian.md) | Brand identity, consistency, positioning | Brand strategy, identity development, guidelines |
| 📖 [Visual Storyteller](design/design-visual-storyteller.md) | Visual narratives, multimedia content | Compelling visual stories, brand storytelling |
| ✨ [Whimsy Injector](design/design-whimsy-injector.md) | Personality, delight, playful interactions | Adding joy, micro-interactions, Easter eggs, brand personality |
| 📷 [Image Prompt Engineer](design/design-image-prompt-engineer.md) | AI image generation prompts, photography | Photography prompts for Midjourney, DALL-E, Stable Diffusion |
| 🌈 [Inclusive Visuals Specialist](design/design-inclusive-visuals-specialist.md) | Representation, bias mitigation, authentic imagery | Generating culturally accurate AI images and video |

### 💰 Paid Media Division

Turning ad spend into measurable business outcomes.

| Agent | Specialty | When to Use |
| --- | --- | --- |
| 💰 [PPC Campaign Strategist](paid-media/paid-media-ppc-strategist.md) | Google/Microsoft/Amazon Ads, account architecture, bidding | Account buildouts, budget allocation, scaling, performance diagnosis |
| 🔍 [Search Query Analyst](paid-media/paid-media-search-query-analyst.md) | Search term analysis, negative keywords, intent mapping | Query audits, wasted spend elimination, keyword discovery |
| 📋 [Paid Media Auditor](paid-media/paid-media-auditor.md) | 200+ point account audits, competitive analysis | Account takeovers, quarterly reviews, competitive pitches |
| 📡 [Tracking & Measurement Specialist](paid-media/paid-media-tracking-specialist.md) | GTM, GA4, conversion tracking, CAPI | New implementations, tracking audits, platform migrations |
| ✍ [Ad Creative Strategist](paid-media/paid-media-creative-strategist.md) | RSA copy, Meta creative, Performance Max assets | Creative launches, testing programs, ad fatigue refreshes |
| 📺 [Programmatic & Display Buyer](paid-media/paid-media-programmatic-buyer.md) | GDN, DSPs, partner media, ABM display | Display planning, partner outreach, ABM programs |
| 📱 [Paid Social Strategist](paid-media/paid-media-paid-social-strategist.md) | Meta, LinkedIn, TikTok, cross-platform social | Social ad programs, platform selection, audience strategy |

### 💼 Sales Division

Turning pipeline into revenue through craft, not CRM busywork.

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🎯 [Outbound Strategist](sales/sales-outbound-strategist.md) | Signal-based prospecting, multi-channel sequences, ICP targeting | Building pipeline through research-driven outreach, not volume |
| 🔍 [Discovery Coach](sales/sales-discovery-coach.md) | SPIN, Gap Selling, Sandler — question design and call structure | Preparing for discovery calls, qualifying opportunities, coaching reps |
| ♟ [Deal Strategist](sales/sales-deal-strategist.md) | MEDDPICC qualification, competitive positioning, win planning | Scoring deals, exposing pipeline risk, building win strategies |
| 🛠 [Sales Engineer](sales/sales-engineer.md) | Technical demos, POC scoping, competitive battlecards | Pre-sales technical wins, demo prep, competitive positioning |
| 🏹 [Proposal Strategist](sales/sales-proposal-strategist.md) | RFP response, win themes, narrative structure | Writing proposals that persuade, not just comply |
| 📊 [Pipeline Analyst](sales/sales-pipeline-analyst.md) | Forecasting, pipeline health, deal velocity, RevOps | Pipeline reviews, forecast accuracy, revenue operations |
| 🗺 [Account Strategist](sales/sales-account-strategist.md) | Land-and-expand, QBRs, stakeholder mapping | Post-sale expansion, account planning, NRR growth |
| 🏋 [Sales Coach](sales/sales-coach.md) | Rep development, call coaching, pipeline review facilitation | Making every rep and every deal better through structured coaching |
| 🎯 [Sales Outreach](specialized/sales-outreach.md) | Cold prospecting, multi-touch cadences, objection handling, proposals | Top-of-funnel B2B outreach — from cold email to booked discovery call |

### 📢 Marketing Division

Growing your audience, one authentic interaction at a time.

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🚀 [Growth Hacker](marketing/marketing-growth-hacker.md) | Rapid user acquisition, viral loops, experiments | Explosive growth, user acquisition, conversion optimization |
| 📝 [Content Creator](marketing/marketing-content-creator.md) | Multi-platform content, editorial calendars | Content strategy, copywriting, brand storytelling |
| 🐦 [Twitter Engager](marketing/marketing-twitter-engager.md) | Real-time engagement, thought leadership | Twitter strategy, LinkedIn campaigns, professional social |
| 📱 [TikTok Strategist](marketing/marketing-tiktok-strategist.md) | Viral content, algorithm optimization | TikTok growth, viral content, Gen Z/Millennial audience |
| 📸 [Instagram Curator](marketing/marketing-instagram-curator.md) | Visual storytelling, community building | Instagram strategy, aesthetic development, visual content |
| 🤝 [Reddit Community Builder](marketing/marketing-reddit-community-builder.md) | Authentic engagement, value-driven content | Reddit strategy, community trust, authentic marketing |
| 📱 [App Store Optimizer](marketing/marketing-app-store-optimizer.md) | ASO, conversion optimization, discoverability | App marketing, store optimization, app growth |
| 🌐 [Social Media Strategist](marketing/marketing-social-media-strategist.md) | Cross-platform strategy, campaigns | Overall social strategy, multi-platform campaigns |
| 📕 [Xiaohongshu Specialist](marketing/marketing-xiaohongshu-specialist.md) | Lifestyle content, trend-driven strategy | Xiaohongshu growth, aesthetic storytelling, Gen Z audience |
| 💬 [WeChat Official Account Manager](marketing/marketing-wechat-official-account.md) | Subscriber engagement, content marketing | WeChat OA strategy, community building, conversion optimization |
| 🧠 [Zhihu Strategist](marketing/marketing-zhihu-strategist.md) | Thought leadership, knowledge-driven engagement | Zhihu authority building, Q&A strategy, lead generation |
| 🇨🇳 [Baidu SEO Specialist](marketing/marketing-baidu-seo-specialist.md) | Baidu optimization, China SEO, ICP compliance | Ranking in Baidu and reaching China's search market |
| 🎬 [Bilibili Content Strategist](marketing/marketing-bilibili-content-strategist.md) | B站 algorithm, danmaku culture, UP主 growth | Building audiences on Bilibili with community-first content |
| 🎠 [Carousel Growth Engine](marketing/marketing-carousel-growth-engine.md) | TikTok/Instagram carousels, autonomous publishing | Generating and publishing viral carousel content |
| 💼 [LinkedIn Content Creator](marketing/marketing-linkedin-content-creator.md) | Personal branding, thought leadership, professional content | LinkedIn growth, professional audience building, B2B content |
| 🛒 [China E-Commerce Operator](marketing/marketing-china-ecommerce-operator.md) | Taobao, Tmall, Pinduoduo, live commerce | Running multi-platform e-commerce in China |
| 🎥 [Kuaishou Strategist](marketing/marketing-kuaishou-strategist.md) | Kuaishou, 老铁 community, grassroots growth | Building authentic audiences in lower-tier markets |
| 🔍 [SEO Specialist](marketing/marketing-seo-specialist.md) | Technical SEO, content strategy, link building | Driving sustainable organic search growth |
| 📘 [Book Co-Author](marketing/marketing-book-co-author.md) | Thought-leadership books, ghostwriting, publishing | Strategic book collaboration for founders and experts |
| 🌏 [Cross-Border E-Commerce Specialist](marketing/marketing-cross-border-ecommerce.md) | Amazon, Shopee, Lazada, cross-border fulfillment | Full-funnel cross-border e-commerce strategy |
| 🎵 [Douyin Strategist](marketing/marketing-douyin-strategist.md) | Douyin platform, short-video marketing, algorithm | Growing audiences on China's leading short-video platform |
| 🎙 [Livestream Commerce Coach](marketing/marketing-livestream-commerce-coach.md) | Host training, live room optimization, conversion | Building high-performing livestream e-commerce operations |
| 🎧 [Podcast Strategist](marketing/marketing-podcast-strategist.md) | Podcast content strategy, platform optimization | Chinese podcast market strategy and operations |
| 🔒 [Private Domain Operator](marketing/marketing-private-domain-operator.md) | WeCom, private traffic, community operations | Building enterprise WeChat private domain ecosystems |
| 🎬 [Short-Video Editing Coach](marketing/marketing-short-video-editing-coach.md) | Post-production, editing workflows, platform specs | Hands-on short-video editing training and optimization |
| 🔥 [Weibo Strategist](marketing/marketing-weibo-strategist.md) | Sina Weibo, trending topics, fan engagement | Full-spectrum Weibo operations and growth |
| 🔮 [AI Citation Strategist](marketing/marketing-ai-citation-strategist.md) | AEO/GEO, AI recommendation visibility, citation auditing | Improving brand visibility across ChatGPT, Claude, Gemini, Perplexity |
| 🇨🇳 [China Market Localization Strategist](marketing/marketing-china-market-localization-strategist.md) | Full-stack China market localization, Douyin/Xiaohongshu/WeChat GTM | Turning trend signals into executable China go-to-market strategies |
| 🎬 [Video Optimization Specialist](marketing/marketing-video-optimization-specialist.md) | YouTube algorithm strategy, chaptering, thumbnail concepts | YouTube channel growth, video SEO, audience retention optimization |

### 📊 Product Division

Building the right thing at the right time.

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🎯 [Sprint Prioritizer](product/product-sprint-prioritizer.md) | Agile planning, feature prioritization | Sprint planning, resource allocation, backlog management |
| 🔍 [Trend Researcher](product/product-trend-researcher.md) | Market intelligence, competitive analysis | Market research, opportunity assessment, trend identification |
| 💬 [Feedback Synthesizer](product/product-feedback-synthesizer.md) | User feedback analysis, insights extraction | Feedback analysis, user insights, product priorities |
| 🧠 [Behavioral Nudge Engine](product/product-behavioral-nudge-engine.md) | Behavioral psychology, nudge design, engagement | Maximizing user motivation through behavioral science |
| 🧭 [Product Manager](product/product-manager.md) | Full lifecycle product ownership | Discovery, PRDs, roadmap planning, GTM, outcome measurement |

### 🎬 Project Management Division

Keeping the trains running on time (and under budget).

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🎬 [Studio Producer](project-management/project-management-studio-producer.md) | High-level orchestration, portfolio management | Multi-project oversight, strategic alignment, resource allocation |
| 🐑 [Project Shepherd](project-m

... [OUTPUT TRUNCATED - 7295 chars omitted out of 57295 total] ...

/specialized-mcp-builder.md) | Model Context Protocol servers, AI agent tooling | Building MCP servers that extend AI agent capabilities |
| 📄 [Document Generator](specialized/specialized-document-generator.md) | PDF, PPTX, DOCX, XLSX generation from code | Professional document creation, reports, data visualization |
| ⚙ [Automation Governance Architect](specialized/automation-governance-architect.md) | Automation governance, n8n, workflow auditing | Evaluating and governing business automations at scale |
| 📚 [Corporate Training Designer](specialized/corporate-training-designer.md) | Enterprise training, curriculum development | Designing training systems and learning programs |
| 🏛 [Government Digital Presales Consultant](specialized/government-digital-presales-consultant.md) | China ToG presales, digital transformation | Government digital transformation proposals and bids |
| ⚕ [Healthcare Marketing Compliance](specialized/healthcare-marketing-compliance.md) | China healthcare advertising compliance | Healthcare marketing regulatory compliance |
| 🎯 [Recruitment Specialist](specialized/recruitment-specialist.md) | Talent acquisition, recruiting operations | Recruitment strategy, sourcing, and hiring processes |
| 🎓 [Study Abroad Advisor](specialized/study-abroad-advisor.md) | International education, application planning | Study abroad planning across US, UK, Canada, Australia |
| 🔗 [Supply Chain Strategist](specialized/supply-chain-strategist.md) | Supply chain management, procurement strategy | Supply chain optimization and procurement planning |
| 🗺 [Workflow Architect](specialized/specialized-workflow-architect.md) | Workflow discovery, mapping, and specification | Mapping every path through a system before code is written |
| ☁ [Salesforce Architect](specialized/specialized-salesforce-architect.md) | Multi-cloud Salesforce design, governor limits, integrations | Enterprise Salesforce architecture, org strategy, deployment pipelines |
| 🇫🇷 [French Consulting Market Navigator](specialized/specialized-french-consulting-market.md) | ESN/SI ecosystem, portage salarial, rate positioning | Freelance consulting in the French IT market |
| 🇰🇷 [Korean Business Navigator](specialized/specialized-korean-business-navigator.md) | Korean business culture, 품의 process, relationship mechanics | Foreign professionals navigating Korean business relationships |
| 🏗 [Civil Engineer](specialized/specialized-civil-engineer.md) | Structural analysis, geotechnical design, global building codes | Multi-standard structural engineering across Eurocode, ACI, AISC, and more |
| 🎧 [Customer Service](specialized/customer-service.md) | Omnichannel support, complaint handling, retention, escalation | Any industry customer support — retail, SaaS, hospitality, finance, logistics |
| 🏥 [Healthcare Customer Service](specialized/healthcare-customer-service.md) | HIPAA-aware patient support, billing, insurance, emergency routing | Healthcare organizations needing compliant, empathetic patient support |
| 🏨 [Hospitality Guest Services](specialized/hospitality-guest-services.md) | Reservations, concierge, complaint recovery, loyalty, events | Hotels, resorts, restaurants, and event venues |
| 🤝 [HR Onboarding](specialized/hr-onboarding.md) | Pre-boarding, compliance, benefits enrollment, 30-60-90 day plans | Any company onboarding new hires — from startups to enterprise |
| 🌐 [Language Translator](specialized/language-translator.md) | Spanish ↔ English translation, dialect awareness, cultural context | Travel, business, medical, and legal translation needs |
| ⏱ [Legal Billing & Time Tracking](specialized/legal-billing-time-tracking.md) | Time capture, billing narratives, IOLTA compliance, collections | Law firms maximizing revenue recovery and billing accuracy |
| 📋 [Legal Client Intake](specialized/legal-client-intake.md) | Prospect qualification, conflict screening, consultation scheduling | Law firms converting inquiries into retained clients |
| ⚖ [Legal Document Review](specialized/legal-document-review.md) | Contract review, risk flagging, version comparison, compliance | Attorney-ready first-pass review across any practice area |
| 🏦 [Loan Officer Assistant](specialized/loan-officer-assistant.md) | Borrower intake, TRID compliance, pipeline tracking, closing coordination | Mortgage and consumer lending teams |
| 🏠 [Real Estate Buyer & Seller](specialized/real-estate-buyer-seller.md) | Buyer/seller representation, offers, transaction coordination | Residential and investment real estate transactions |
| 🛒 [Retail Customer Returns](specialized/retail-customer-returns.md) | Return processing, fraud prevention, exchanges, vendor returns | Brick-and-mortar, e-commerce, and omnichannel retail |

### 💵 Finance Division

Accounting, financial analysis, tax strategy, and investment research specialists.

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 📒 [Bookkeeper & Controller](finance/finance-bookkeeper-controller.md) | Month-end close, reconciliation, GAAP compliance, internal controls | Day-to-day accounting operations, audit readiness, financial record-keeping |
| 📊 [Financial Analyst](finance/finance-financial-analyst.md) | Financial modeling, forecasting, scenario analysis, decision support | Three-statement models, variance analysis, data-driven business intelligence |
| 📈 [FP&A Analyst](finance/finance-fpa-analyst.md) | Budgeting, rolling forecasts, variance analysis, business reviews | Annual operating plans, monthly business reviews, strategic resource allocation |
| 🔍 [Investment Researcher](finance/finance-investment-researcher.md) | Due diligence, portfolio analysis, asset valuation, equity research | Investment thesis development, risk assessment, market research |
| 🏛 [Tax Strategist](finance/finance-tax-strategist.md) | Tax optimization, multi-jurisdictional compliance, transfer pricing | Entity structuring, ETR analysis, audit defense, strategic tax planning |

### 🎮 Game Development Division

Building worlds, systems, and experiences across every major engine.

#### Cross-Engine Agents (Engine-Agnostic)

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🎯 [Game Designer](game-development/game-designer.md) | Systems design, GDD authorship, economy balancing, gameplay loops | Designing game mechanics, progression systems, writing design documents |
| 🗺 [Level Designer](game-development/level-designer.md) | Layout theory, pacing, encounter design, environmental storytelling | Building levels, designing encounter flow, spatial narrative |
| 🎨 [Technical Artist](game-development/technical-artist.md) | Shaders, VFX, LOD pipeline, art-to-engine optimization | Bridging art and engineering, shader authoring, performance-safe asset pipelines |
| 🔊 [Game Audio Engineer](game-development/game-audio-engineer.md) | FMOD/Wwise, adaptive music, spatial audio, audio budgets | Interactive audio systems, dynamic music, audio performance |
| 📖 [Narrative Designer](game-development/narrative-designer.md) | Story systems, branching dialogue, lore architecture | Writing branching narratives, implementing dialogue systems, world lore |

#### Unity

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🏗 [Unity Architect](game-development/unity/unity-architect.md) | ScriptableObjects, data-driven modularity, DOTS/ECS | Large-scale Unity projects, data-driven system design, ECS performance work |
| ✨ [Unity Shader Graph Artist](game-development/unity/unity-shader-graph-artist.md) | Shader Graph, HLSL, URP/HDRP, Renderer Features | Custom Unity materials, VFX shaders, post-processing passes |
| 🌐 [Unity Multiplayer Engineer](game-development/unity/unity-multiplayer-engineer.md) | Netcode for GameObjects, Unity Relay/Lobby, server authority, prediction | Online Unity games, client prediction, Unity Gaming Services integration |
| 🛠 [Unity Editor Tool Developer](game-development/unity/unity-editor-tool-developer.md) | EditorWindows, AssetPostprocessors, PropertyDrawers, build validation | Custom Unity Editor tooling, pipeline automation, content validation |

#### Unreal Engine

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ⚙ [Unreal Systems Engineer](game-development/unreal-engine/unreal-systems-engineer.md) | C++/Blueprint hybrid, GAS, Nanite constraints, memory management | Complex Unreal gameplay systems, Gameplay Ability System, engine-level C++ |
| 🎨 [Unreal Technical Artist](game-development/unreal-engine/unreal-technical-artist.md) | Material Editor, Niagara, PCG, Substrate | Unreal materials, Niagara VFX, procedural content generation |
| 🌐 [Unreal Multiplayer Architect](game-development/unreal-engine/unreal-multiplayer-architect.md) | Actor replication, GameMode/GameState hierarchy, dedicated server | Unreal online games, replication graphs, server authoritative Unreal |
| 🗺 [Unreal World Builder](game-development/unreal-engine/unreal-world-builder.md) | World Partition, Landscape, HLOD, LWC | Large open-world Unreal levels, streaming systems, terrain at scale |

#### Godot

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 📜 [Godot Gameplay Scripter](game-development/godot/godot-gameplay-scripter.md) | GDScript 2.0, signals, composition, static typing | Godot gameplay systems, scene composition, performance-conscious GDScript |
| 🌐 [Godot Multiplayer Engineer](game-development/godot/godot-multiplayer-engineer.md) | MultiplayerAPI, ENet/WebRTC, RPCs, authority model | Online Godot games, scene replication, server-authoritative Godot |
| ✨ [Godot Shader Developer](game-development/godot/godot-shader-developer.md) | Godot shading language, VisualShader, RenderingDevice | Custom Godot materials, 2D/3D effects, post-processing, compute shaders |

#### Blender

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🧩 [Blender Addon Engineer](game-development/blender/blender-addon-engineer.md) | Blender Python (`bpy`), custom operators/panels, asset validators, exporters, pipeline automation | Building Blender add-ons, asset prep tools, export workflows, and DCC pipeline automation |

#### Roblox Studio

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| ⚙ [Roblox Systems Scripter](game-development/roblox-studio/roblox-systems-scripter.md) | Luau, RemoteEvents/Functions, DataStore, server-authoritative module architecture | Building secure Roblox game systems, client-server communication, data persistence |
| 🎯 [Roblox Experience Designer](game-development/roblox-studio/roblox-experience-designer.md) | Engagement loops, monetization, D1/D7 retention, onboarding flow | Designing Roblox game loops, Game Passes, daily rewards, player retention |
| 👗 [Roblox Avatar Creator](game-development/roblox-studio/roblox-avatar-creator.md) | UGC pipeline, accessory rigging, Creator Marketplace submission | Roblox UGC items, HumanoidDescription customization, in-experience avatar shops |

### 📚 Academic Division

Scholarly rigor for world-building, storytelling, and narrative design.

| Agent | Specialty | When to Use |
|-------|-----------|-------------|
| 🌍 [Anthropologist](academic/academic-anthropologist.md) | Cultural systems, kinship, rituals, belief systems | Designing culturally coherent societies with internal logic |
| 🌐 [Geographer](academic/academic-geographer.md) | Physical/human geography, climate, cartography | Building geographically coherent worlds with realistic terrain and settlements |
| 📚 [Historian](academic/academic-historian.md) | Historical analysis, periodization, material culture | Validating historical coherence, enriching settings with authentic period detail |
| 📜 [Narratologist](academic/academic-narratologist.md) | Narrative theory, story structure, character arcs | Analyzing and improving story structure with established theoretical frameworks |
| 🧠 [Psychologist](academic/academic-psychologist.md) | Personality theory, motivation, cognitive patterns | Building psychologically credible characters grounded in research |

---

## 🎯 Real-World Use Cases

### Scenario 1: Building a Startup MVP

**Your Team**:
1. 🎨 **Frontend Developer** - Build the React app
2. 🏗 **Backend Architect** - Design the API and database
3. 🚀 **Growth Hacker** - Plan user acquisition
4. ⚡ **Rapid Prototyper** - Fast iteration cycles
5. 🔍 **Reality Checker** - Ensure quality before launch

**Result**: Ship faster with specialized expertise at every stage.

---

### Scenario 2: Marketing Campaign Launch

**Your Team**:
1. 📝 **Content Creator** - Develop campaign content
2. 🐦 **Twitter Engager** - Twitter strategy and execution
3. 📸 **Instagram Curator** - Visual content and stories
4. 🤝 **Reddit Community Builder** - Authentic community engagement
5. 📊 **Analytics Reporter** - Track and optimize performance

**Result**: Multi-channel coordinated campaign with platform-specific expertise.

---

### Scenario 3: Enterprise Feature Development

**Your Team**:
1. 👔 **Senior Project Manager** - Scope and task planning
2. 💎 **Senior Developer** - Complex implementation
3. 🎨 **UI Designer** - Design system and components
4. 🧪 **Experiment Tracker** - A/B test planning
5. 📸 **Evidence Collector** - Quality verification
6. 🔍 **Reality Checker** - Production readiness

**Result**: Enterprise-grade delivery with quality gates and documentation.

---

### Scenario 4: Paid Media Account Takeover

**Your Team**:

1. 📋 **Paid Media Auditor** - Comprehensive account assessment
2. 📡 **Tracking & Measurement Specialist** - Verify conversion tracking accuracy
3. 💰 **PPC Campaign Strategist** - Redesign account architecture
4. 🔍 **Search Query Analyst** - Clean up wasted spend from search terms
5. ✍ **Ad Creative Strategist** - Refresh all ad copy and extensions
6. 📊 **Analytics Reporter** (Support Division) - Build reporting dashboards

**Result**: Systematic account takeover with tracking verified, waste eliminated, structure optimized, and creative refreshed — all within the first 30 days.

---

### Scenario 5: Full Agency Product Discovery

**Your Team**: All 8 divisions working in parallel on a single mission.

See the **[Nexus Spatial Discovery Exercise](examples/nexus-spatial-discovery.md)** -- a complete example where 8 agents (Product Trend Researcher, Backend Architect, Brand Guardian, Growth Hacker, Support Responder, UX Researcher, Project Shepherd, and XR Interface Architect) were deployed simultaneously to evaluate a software opportunity and produce a unified product plan covering market validation, technical architecture, brand strategy, go-to-market, support systems, UX research, project execution, and spatial UI design.

**Result**: Comprehensive, cross-functional product blueprint produced in a single session. [More examples](examples/).

---

## 🤝 Contributing

We welcome contributions! Here's how you can help:

### Add a New Agent

1. Fork the repository
2. Create a new agent file in the appropriate category
3. Follow the agent template structure:
   - Frontmatter with name, description, color
   - Identity & Memory section
   - Core Mission
   - Critical Rules (domain-specific)
   - Technical Deliverables with examples
   - Workflow Process
   - Success Metrics
4. Submit a PR with your agent

### Improve Existing Agents

- Add real-world examples
- Enhance code samples
- Update success metrics
- Improve workflows

### Share Your Success Stories

Have you used these agents successfully? Share your story in the [Discussions](https://github.com/msitarzewski/agency-agents/discussions)!

---

## 📖 Agent Design Philosophy

Each agent is designed with:

1. **🎭 Strong Personality**: Not generic templates - real character and voice
2. **📋 Clear Deliverables**: Concrete outputs, not vague guidance
3. **✅ Success Metrics**: Measurable outcomes and quality standards
4. **🔄 Proven Workflows**: Step-by-step processes that work
5. **💡 Learning Memory**: Pattern recognition and continuous improvement

---

## 🎁 What Makes This Special?

### Unlike Generic AI Prompts:
- ❌ Generic "Act as a developer" prompts
- ✅ Deep specialization with personality and process

### Unlike Prompt Libraries:
- ❌ One-off prompt collections
- ✅ Comprehensive agent systems with workflows and deliverables

### Unlike AI Tools:
- ❌ Black box tools you can't customize
- ✅ Transparent, forkable, adaptable agent personalities

---

## 🎨 Agent Personality Highlights

> "I don't just test your code - I default to finding 3-5 issues and require visual proof for everything."
>
> -- **Evidence Collector** (Testing Division)

> "You're not marketing on Reddit - you're becoming a valued community member who happens to represent a brand."
>
> -- **Reddit Community Builder** (Marketing Division)

> "Every playful element must serve a functional or emotional purpose. Design delight that enhances rather than distracts."
>
> -- **Whimsy Injector** (Design Division)

> "Let me add a celebration animation that reduces task completion anxiety by 40%"
>
> -- **Whimsy Injector** (during a UX review)

---

## 📊 Stats

- 🎭 **144 Specialized Agents** across 12 divisions
- 📝 **10,000+ lines** of personality, process, and code examples
- ⏱ **Months of iteration** from real-world usage
- 🌟 **Battle-tested** in production environments
- 💬 **50+ requests** in first 12 hours on Reddit

---

## 🔌 Multi-Tool Integrations

The Agency works natively with Claude Code, and ships conversion + install scripts so you can use the same agents across every major agentic coding tool.

### Supported Tools

- **[Claude Code](https://claude.ai/code)** — native `.md` agents, no conversion needed → `~/.claude/agents/`
- **[GitHub Copilot](https://github.com/copilot)** — native `.md` agents, no conversion needed → `~/.github/agents/` + `~/.copilot/agents/`
- **[Antigravity](https://github.com/google-gemini/antigravity)** — `SKILL.md` per agent → `~/.gemini/antigravity/skills/`
- **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** — extension + `SKILL.md` files → `~/.gemini/extensions/agency-agents/`
- **[OpenCode](https://opencode.ai)** — `.md` agent files → `.opencode/agents/`
- **[Cursor](https://cursor.sh)** — `.mdc` rule files → `.cursor/rules/`
- **[Aider](https://aider.chat)** — single `CONVENTIONS.md` → `./CONVENTIONS.md`
- **[Windsurf](https://codeium.com/windsurf)** — single `.windsurfrules` → `./.windsurfrules`
- **[OpenClaw](https://github.com/openclaw/openclaw)** — `SOUL.md` + `AGENTS.md` + `IDENTITY.md` per agent
- **[Qwen Code](https://github.com/QwenLM/qwen-code)** — `.md` SubAgent files → `~/.qwen/agents/`
- **[Kimi Code](https://github.com/MoonshotAI/kimi-cli)** — YAML agent specs → `~/.config/kimi/agents/`

---

### ⚡ Quick Install

**Step 1 -- Generate integration files:**
```bash
./scripts/convert.sh
# Faster (parallel, output order may vary): ./scripts/convert.sh --parallel
```

**Step 2 -- Install (interactive, auto-detects your tools):**
```bash
./scripts/install.sh
# Faster (parallel, output order may vary): ./scripts/install.sh --no-interactive --parallel
```

The installer scans your system for installed tools, shows a checkbox UI, and lets you pick exactly what to install:

```
  +------------------------------------------------+
  |   The Agency -- Tool Installer                 |
  +------------------------------------------------+

  System scan: [*] = detected on this machine

  [x]  1)  [*]  Claude Code     (claude.ai/code)
  [x]  2)  [*]  Copilot         (~/.github + ~/.copilot)
  [x]  3)  [*]  Antigravity     (~/.gemini/antigravity)
  [ ]  4)  [ ]  Gemini CLI      (gemini extension)
  [ ]  5)  [ ]  OpenCode        (opencode.ai)
  [ ]  6)  [ ]  OpenClaw        (~/.openclaw/agency-agents)
  [x]  7)  [*]  Cursor          (.cursor/rules)
  [ ]  8)  [ ]  Aider           (CONVENTIONS.md)
  [ ]  9)  [ ]  Windsurf        (.windsurfrules)
  [ ] 10)  [ ]  Qwen Code       (~/.qwen/agents)
  [ ] 11)  [ ]  Kimi Code       (~/.config/kimi/agents)

  [1-11] toggle   [a] all   [n] none   [d] detected
  [Enter] install   [q] quit
```

**Or install a specific tool directly:**
```bash
./scripts/install.sh --tool cursor
./scripts/install.sh --tool opencode
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool antigravity
```

**Non-interactive (CI/scripts):**
```bash
./scripts/install.sh --no-interactive --tool all
```

**Faster runs (parallel)** — On multi-core machines, use `--parallel` so each tool is processed in parallel. Output order across tools is non-deterministic. Works with both interactive and non-interactive install: e.g. `./scripts/install.sh --interactive --parallel` (pick tools, then install in parallel) or `./scripts/install.sh --no-interactive --parallel`. Job count defaults to `nproc` (Linux), `sysctl -n hw.ncpu` (macOS), or 4; override with `--jobs N`.

```bash
./scripts/convert.sh --parallel                    # convert all tools in parallel
./scripts/convert.sh --parallel --jobs 8           # cap parallel jobs
./scripts/install.sh --no-interactive --parallel   # install all detected tools in parallel
./scripts/install.sh --interactive --parallel      # pick tools, then install in parallel
./scripts/install.sh --no-interactive --parallel --jobs 4
```

---

### Tool-Specific Instructions

<details>
<summary><strong>Claude Code</strong></summary>

Agents are copied directly from the repo into `~/.claude/agents/` -- no conversion needed.

```bash
./scripts/install.sh --tool claude-code
```

Then activate in Claude Code:
```
Use the Frontend Developer agent to review this component.
```

See [integrations/claude-code/README.md](integrations/claude-code/README.md) for details.
</details>

<details>
<summary><strong>GitHub Copilot</strong></summary>

Agents are copied directly from the repo into `~/.github/agents/` and `~/.copilot/agents/` -- no conversion needed.

```bash
./scripts/install.sh --tool copilot
```

Then activate in GitHub Copilot:
```
Use the Frontend Developer agent to review this component.
```

See [integrations/github-copilot/README.md](integrations/github-copilot/README.md) for details.
</details>

<details>
<summary><strong>Antigravity (Gemini)</strong></summary>

Each agent becomes a skill in `~/.gemini/antigravity/skills/agency-<slug>/`.

```bash
./scripts/install.sh --tool antigravity
```

Activate in Gemini with Antigravity:
```
@agency-frontend-developer review this React component
```

See [integrations/antigravity/README.md](integrations/antigravity/README.md) for details.
</details>

<details>
<summary><strong>Gemini CLI</strong></summary>

Installs as a Gemini CLI extension with one skill per agent plus a manifest.
On a fresh clone, generate the Gemini extension files before running the installer.

```bash
./scripts/convert.sh --tool gemini-cli
./scripts/install.sh --tool gemini-cli
```

See [integrations/gemini-cli/README.md](integrations/gemini-cli/README.md) for details.
</details>

<details>
<summary><strong>OpenCode</strong></summary>

Agents are placed in `.opencode/agents/` in your project root (project-scoped).

```bash
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool opencode
```

Or install globally:
```bash
mkdir -p ~/.config/opencode/agents
cp integrations/opencode/agents/*.md ~/.config/opencode/agents/
```

Activate in OpenCode:
```
@backend-architect design this API.
```

See [integrations/opencode/README.md](integrations/opencode/README.md) for details.
</details>

<details>
<summary><strong>Cursor</strong></summary>

Each agent becomes a `.mdc` rule file in `.cursor/rules/` of your project.

```bash
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool cursor
```

Rules are auto-applied when Cursor detects them in the project. Reference them explicitly:
```
Use the @security-engineer rules to review this code.
```

See [integrations/cursor/README.md](integrations/cursor/README.md) for details.
</details>

<details>
<summary><strong>Aider</strong></summary>

All agents are compiled into a single `CONVENTIONS.md` file that Aider reads automatically.

```bash
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool aider
```

Then reference agents in your Aider session:
```
Use the Frontend Developer agent to refactor this component.
```

See [integrations/aider/README.md](integrations/aider/README.md) for details.
</details>

<details>
<summary><strong>Windsurf</strong></summary>

All agents are compiled into `.windsurfrules` in your project root.

```bash
cd /your/project
/path/to/agency-agents/scripts/install.sh --tool windsurf
```

Reference agents in Windsurf's Cascade:
```
Use the Reality Checker agent to verify this is production ready.
```

See [integrations/windsurf/README.md](integrations/windsurf/README.md) for details.
</details>

<details>
<summary><strong>OpenClaw</strong></summary>

Each agent becomes a workspace with `SOUL.md`, `AGENTS.md`, and `IDENTITY.md` in `~/.openclaw/agency-agents/`.

```bash
./scripts/convert.sh --tool openclaw
./scripts/install.sh --tool openclaw
```

If the `openclaw` CLI is available, the installer registers each workspace automatically.
Run `openclaw gateway restart` after installation so the new agents are activated.

See [integrations/openclaw/README.md](integrations/openclaw/README.md) for details.

</details>

<details>
<summary><strong>Qwen Code</strong></summary>

SubAgents are installed to `.qwen/agents/` in your project root (project-scoped).

```bash
# Convert and install (run from your project root)
cd /your/project
./scripts/convert.sh --tool qwen
./scripts/install.sh --tool qwen
```

**Usage in Qwen Code:**
- Reference by name: `Use the frontend-developer agent to review this component`
- Or let Qwen auto-delegate based on task context
- Manage via `/agents` command in interactive mode

> 📚 [Qwen SubAgents Docs](https://qwenlm.github.io/qwen-code-docs/en/users/features/sub-agents/)

</details>

<details>
<summary><strong>Kimi Code</strong></summary>

Agents are converted to Kimi Code CLI format (YAML + system prompt) and installed to `~/.config/kimi/agents/`.

```bash
# Convert and install
./scripts/convert.sh --tool kimi
./scripts/install.sh --tool kimi
```

**Usage with Kimi Code:**
```bash
# Use an agent
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml

# In a project
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
     --work-dir /your/project \
     "Review this React component"
```

See [integrations/kimi/README.md](integrations/kimi/README.md) for details.

</details>

---

### Regenerating After Changes

When you add new agents or edit existing ones, regenerate all integration files:

```bash
./scripts/convert.sh                    # regenerate all (serial)
./scripts/convert.sh --parallel         # regenerate all in parallel (faster)
./scripts/convert.sh --tool cursor      # regenerate just one tool
```

---

## 🗺 Roadmap

- [ ] Interactive agent selector web tool
- [x] Multi-agent workflow examples -- see [examples/](examples/)
- [x] Multi-tool integration scripts (Claude Code, GitHub Copilot, Antigravity, Gemini CLI, OpenCode, OpenClaw, Cursor, Aider, Windsurf, Qwen Code, Kimi Code)
- [ ] Video tutorials on agent design
- [ ] Community agent marketplace
- [ ] Agent "personality quiz" for project matching
- [ ] "Agent of the Week" showcase series

---

## 🌐 Community Translations & Localizations

Community-maintained translations and regional adaptations. These are independently maintained -- see each repo for coverage and version compatibility.

| Language | Maintainer | Link | Notes |
|----------|-----------|------|-------|
| 🇨🇳 简体中文 (zh-CN) | [@jnMetaCode](https://github.com/jnMetaCode) | [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) | 141 translated agents + 46 China-market originals |
| 🇨🇳 简体中文 (zh-CN) | [@dsclca12](https://github.com/dsclca12) | [agent-teams](https://github.com/dsclca12/agent-teams) | Independent translation with Bilibili, WeChat, Xiaohongshu localization |

Want to add a translation? Open an issue and we'll link it here.

---

## 🔗 Related Resources

- [awesome-openclaw-agents](https://github.com/mergisi/awesome-openclaw-agents) — Community-maintained OpenClaw agent collection (derived from this repo)

---

## 📜 License

MIT License - Use freely, commercially or personally. Attribution appreciated but not required.

---

## 🙏 Acknowledgments

What started as a Reddit thread about AI agent specialization has grown into something remarkable — **147 agents across 12 divisions**, supported by a community of contributors from around the world. Every agent in this repo exists because someone cared enough to write it, test it, and share it.

To everyone who has opened a PR, filed an issue, started a Discussion, or simply tried an agent and told us what worked — thank you. You're the reason The Agency keeps getting better.

---

## 💬 Community

- **GitHub Discussions**: [Share your success stories](https://github.com/msitarzewski/agency-agents/discussions)
- **Issues**: [Report bugs or request features](https://github.com/msitarzewski/agency-agents/issues)
- **Reddit**: Join the conversation on r/ClaudeAI
- **Twitter/X**: Share with #TheAgency

---

## 🚀 Get Started

1. **Browse** the agents above and find specialists for your needs
2. **Copy** the agents to `~/.claude/agents/` for Claude Code integration
3. **Activate** agents by referencing them in your Claude conversations
4. **Customize** agent personalities and workflows for your specific needs
5. **Share** your results and contribute back to the community

---

<div align="center">

**🎭 The Agency: Your AI Dream Team Awaits 🎭**

[⭐ Star this repo](https://github.com/msitarzewski/agency-agents) • [🍴 Fork it](https://github.com/msitarzewski/agency-agents/fork) • [🐛 Report an issue](https://github.com/msitarzewski/agency-agents/issues) • [❤ Sponsor](https://github.com/sponsors/msitarzewski)

Made with ❤ by the community, for the community

</div>