把「复杂软件问题」拆成「简单任务」：Claude Code 专用智能体入门指南

一份不到 30 分钟就能读完、立刻上手的实战手册

“需求像毛线团一样越扯越乱，怎么办？”
“写 Kotlin 测试到底从哪一步开始？”
“没有 UI 设计师，怎么快速把界面想法画出来？”

如果你正在用 Claude Code（Anthropic 的 AI 辅助开发 CLI 工具），这篇长文会告诉你：把上面这些头疼问题交给「专用智能体」即可。它们不是万能助手，而是各自只精通一个小领域的“专家同事”——你只需要把问题丢给它，它就会按行业里沉淀下来的最佳实践，一步步带你完成。

目录

  1. Claude Code 与专用智能体：5 句话先搞清楚
  2. 三大智能体速览：一张表看懂谁能帮你做什么
  3. 场景 1：任务太多，先做哪一个？——Cynefin 决策框架智能体
  4. 场景 2：写 Kotlin 却怕测试写成“面条”——TDD Chicago School 智能体
  5. 场景 3：没设计师，也能画原型——ASCII UI 原型智能体
  6. 5 分钟安装与第一次“对话”
  7. 常见问题答疑（FAQ）
  8. 下一步：如果你想贡献自己的智能体

1. Claude Code 与专用智能体：5 句话先搞清楚

问题 一句话回答
Claude Code 是什么？ 一个装在终端里的 AI 开发搭档，输入自然语言指令，它帮你写代码、跑脚本、改配置。
专用智能体又是什么？ Claude Code 的「插件」，每个插件只解决一个具体领域的难题，比如任务拆解、TDD、UI 原型。
为什么用它们？ 避免“通用 AI”给出的泛泛建议，直接拿到行业沉淀的套路和脚本。
需要付费吗？ 智能体代码本身开源，MIT 许可证。Claude Code 的调用需遵循 Anthropic 官方计费。
新手能学会吗？ 能。所有命令都在终端里复制粘贴即可，下文示范一遍就会。

2. 三大智能体速览：一张表看懂谁能帮你做什么

智能体 关键词 解决的核心痛点 典型一句话调用
Cynefin 决策框架 任务拆解、优先级排序、不确定决策 “需求太乱，不知道从哪下手” claude-code --agent cynefin-decision-framework-agent.md "把需求清单分分类"
TDD Chicago School Kotlin 测试驱动开发、Kotlin 语言、经典派风格 “写测试怕走弯路” claude-code --agent tdd-chicago-school-kotlin.md "用 TDD 实现用户注册功能"
ASCII UI 原型 快速原型、纯文本线框图、响应式布局 “没 UI 工具也能画界面” claude-code --agent ui-ascii-prototype.md "画一个仪表盘线框"

3. 场景 1：任务太多，先做哪一个？——Cynefin 决策框架智能体

3.1 它到底做什么？

  • 问题归类：把任务放进「清晰-繁杂-复杂-混乱」四个象限。
  • 任务拆分：大象切块，每块都能单独排期。
  • 策略推荐：不同象限用不同打法，不搞“一刀切”。

3.2 30 秒上手示例

假设你拿到一张需求清单：

1. 对接第三方支付  
2. 优化首页加载速度  
3. 调研新市场  
4. 修复登录偶现 500 错误

终端输入：

claude-code --agent decision-making/cynefin-decision-framework-agent.md \
  "帮我把上述任务按 Cynefin 框架分类，并给出执行顺序"

你会收到一段结构清晰的回答，类似：

【清晰域】修复登录 500 → 立即执行  
【繁杂域】对接支付 → 找专家评估文档后执行  
【复杂域】优化首页加载 → 先做小实验，度量后再迭代  
【混乱域】调研新市场 → 先稳定现有系统，再抽专人调研

3.3 背后原理一句话

Cynefin（读作 /ˈkʌnɪvɪn/）是威尔士语“栖息地”的意思，由 Dave Snowden 提出，用四个域帮助我们判断“问题是否需要先实验再决定”。

4. 场景 2：写 Kotlin 却怕测试写成“面条”——TDD Chicago School 智能体

4.1 经典派 TDD 的三句话

  1. 从内向外地写：先写核心业务对象，再写外围适配器。
  2. 状态断言优先：用 assertEquals 看对象最终状态，少用 mock。
  3. 能真就别假：能用真实对象就不用 mock。

4.2 完整工作流一览

步骤 智能体替你做的事 你看到的终端输出
1. 环境检查 自动跑 gradle clean BUILD SUCCESSFUL
2. 红-绿-重构循环 给出下一个最合理测试名 Next test: shouldRejectDuplicateEmail
3. 覆盖率验证 跑 Jacoco，低于 80% 就报错 Coverage 87% → PASS
4. Kotlin 风格检查 ktlint + 官方 idioms No style issues found

4.3 一个最小可运行示例

需求：用户注册时需要校验邮箱唯一性。
终端输入：

claude-code --agent testing/tdd-chicago-school-kotlin.md \
  "帮我通过 TDD 完成邮箱唯一性校验"

智能体会引导你：

  1. 先写失败的单元测试 UserRegistryTest.shouldRejectDuplicateEmail()
  2. 让你补生产代码 UserRegistry.register()
  3. 跑测试通过
  4. 重构，确保没有多余 mock

5. 场景 3：没设计师，也能画原型——ASCII UI 原型智能体

5.1 为什么选择纯文本线框？

  • 版本友好：git diff 一眼能看出改动。
  • 沟通零成本：复制粘贴到微信、Slack、邮件即可评审。
  • 快速迭代：30 秒改一行字符就能换布局。

5.2 设计一张“用户仪表盘”

终端输入：

claude-code --agent design/ui-ascii-prototype.md \
  "画一个响应式用户仪表盘，有侧边栏、图表区、通知区"

终端输出示例（已排版）：

+----------------------------------------------------------+
|  Dashboard                    [Alice] [🔔3] [⚙️]        |
+----------------------+-----------------------------------+
|  ▪ 概览              |  ┌---------------┐  ┌------------┐ |
|  ▪ 统计              |  │  本周新增用户 │  │  系统公告   │ |
|  ▪ 设置              |  │      1,204     │  │  1. 新功能  │ |
|                      |  └---------------┘  │  2. 维护    │ |
|                      |                     └------------┘ |
|                      |  ┌-------------------------------┐ |
|                      |  │   折线图：7 日活跃度          │ |
|                      |  │   ▁▃▅▇▅▃▁                    │ |
|                      |  └-------------------------------┘ |
+----------------------+-----------------------------------+

5.3 如何让它适配手机？

智能体会在同一段输出里给出「折叠版」ASCII，直接复制给前端同事即可对齐实现方案。

6. 5 分钟安装与第一次“对话”

6.1 前置条件

  • 已安装 Claude Code（官方安装指引见 claude.ai/code）。
  • 终端能跑 git 和 claude-code --version。

6.2 三步装好智能体

  1. 克隆仓库

    git clone https://github.com/tddworks/claude-agents.git
cd claude-agents
  2. 把需要的 .md 文件拷进你的项目根目录（或任何 claude-code 能找到的路径）。
  3. 第一次对话

    claude-code --agent decision-making/cynefin-decision-framework-agent.md \
  "你好，请自我介绍"

6.3 出现 permission denied？

  • macOS/Linux：给脚本加执行权限 chmod +x.
  • Windows：用 WSL 或 Git Bash。

7. 常见问题答疑（FAQ）

Q1：智能体会不会把项目搞乱？
A：不会。所有改动都在你的本地 Git 仓库，可随时 git reset --hard 回退。

Q2：支持 Windows 吗？
A：支持。Claude Code 已提供 Windows 可执行文件；智能体本身是 Markdown，跨平台。

Q3：公司代码不开源，能用吗？
A：可以。智能体只读取你主动传给 claude-code 的文本，不会外泄源码。

Q4：能一次性加载多个智能体吗？
A：目前一次只能指定一个 --agent，但你可以连续跑多条命令。

Q5：我想改智能体的行为怎么办？
A：直接改对应 .md 文件，里面的指令、脚本、示例都可以按团队风格调整。

8. 下一步：如果你想贡献自己的智能体

8.1 三步贡献法

  1. 选题：聚焦一个具体方法论，比如「DDD 聚合设计」或「API 版本管理」。
  2. 写作：照抄现有 .md 结构（YAML 头 + 详细章节），确保包含：

    • 真实可运行的命令
    • 常见错误示范与修正
    • 至少 3 个最小示例
  3. 测试：用 claude-code --agent your-agent.md "跑一遍示例" 自检，确认无歧义。

8.2 Pull Request 模板

  • 标题：Add <AgentName> agent
  • 正文：

    • 解决的具体问题
    • 目录结构截图
    • 本地测试结果截图

小结

把复杂问题拆成简单任务，是工程师最核心的能力。Claude Code 的专用智能体把行业里沉淀下来的「如何拆分」和「如何落地」封装成了可复制粘贴的脚本与对话。你无需成为领域大师，只要会敲命令，就能让大师的经验为你所用。

现在就打开终端，挑一个与你当前任务最贴切的智能体，开始第一次“对话”吧。祝你编码愉快！