# Agent Designer

> 设计并创建一个子智能体，或改进一个已有的子智能体。当用户说"帮我建一个负责 X 的智能体"、"我想要个专门做 Y 的助手"、"把这套活儿交给一个专门的智能体"、"改一下我那个智能体的职责/能力/语气"、或问"这个智能体该怎么设计"时，务必使用本技能。它教你怎么切职责、怎么写 system_prompt、绑哪些能力、参数怎么定，然后通过 create_agent / edit_agent 工具落库。

- Skill: `zju-real/agent-designer` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add zju-real/agent-designer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zju-real/agent-designer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ZJU-REAL (https://skillmd.com/u/zju-real)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zju-real/agent-designer

---


# 子智能体设计器（Agent Designer）

`create_agent` 只负责把记录存下来，**存下来的东西好不好用，取决于你怎么设计**。
本技能给的是判断标准和现成骨架——用户说"帮我建个写周报的助手"时，别糊一段空泛的
prompt 就调工具交差。

## 三步走

1. **问清楚再动手**。至少要明确：它要替用户完成什么任务、任务的输入是什么、
   产出应该长什么样。这三样缺一个就先问，别自己脑补。
2. **调 `list_bindable_capabilities`** 看这个用户账下实际有哪些技能、工具、插件、知识库。
   id 必须从这里取，**不能凭印象编**——编错了不会报错，只会静默绑不上。
3. **调 `create_agent` 落库**，然后把"建了什么、绑了什么、怎么用"讲给用户听。

## 一、职责怎么切

**一个子智能体只干一件事。** 判断标准：你能不能用一句不带"和"、不带"以及"的话
说清它管什么。说不清就是切得太粗，该拆成两个。

- ✅ "把一周的工作记录整理成周报初稿"
- ❌ "处理周报、日报、月报，顺便回邮件"——四件事，拆开

职责写进 `description` 字段。这个字段不只是给人看的：主智能体判断"这活儿该不该派给它"
就靠它，所以要具体、可判别，别写"一个很有用的助手"。

## 二、system_prompt 怎么写

这是这个智能体的主体。**建议按四段写**，缺哪段就补哪段：

```
角色：你是……，负责……。
能做什么：……（可以列 2–5 条具体动作）
不做什么：……（边界，尤其是"不要替用户做决定""不确定就问"这类）
输出成什么样：……（格式、长度、必须包含的要素）
```

写作要点：

- **写行为，不写形容词**。"输出要专业"没有可执行性；"每段不超过三句话，先结论后依据"有。
- **把用户的偏好固化进去**。用户说"我们周报都是先写风险再写进展"，这句就该进 prompt，
  而不是每次对话再交代一遍——固化下来才是建智能体的意义。
- **边界比能力更值得写**。多数不好用的智能体不是能力不够，而是越界：替用户拍板、
  编造没有的数据、把半成品当成品交。
- 长度没有硬性要求，但**具体的 300 字胜过泛泛的 1500 字**。

三类常见角色的现成骨架见 `references/prompt-patterns.md`，照着改比从零写快。

## 三、绑哪些能力

原则一条：**宁窄勿宽**。绑得越多，它在选工具时越容易选错，反而不好用。

- 只绑这个职责真正用得着的。"万一以后要用"不是绑定的理由，以后可以 `edit_agent` 加。
- `plugin_ids` 是**整体绑一个插件**（插件 = 技能 + 工具的成套单元，运行时展开）；
  `skill_ids` / `mcp_server_ids` 是绑零散的单项。同一个能力别两边都绑。
- 知识库 `kb_ids`：只有当这个智能体确实要查资料时才绑。

绑定取舍的更多细节见 `references/binding-guide.md`。

## 四、参数

- `max_iters`（一次任务最多干几轮，1–100，默认 10）：
  一问一答的轻活 5–10 够用；要查资料、反复核对的活给 20–30。给太大不会更聪明，
  只会在跑偏时烧更多时间。
- `welcome_message`：可选，用户单独打开这个智能体时的开场白。

## 五、改而不是重建

用户说"改一下"时用 `edit_agent`，不要删了重建——重建会丢掉版本历史。

**一个坑**：`skill_ids` 这类绑定字段是**整组替换，不是追加**。要"再加一个技能"时：

1. `list_my_agents` 看它现在绑了哪些；
2. `list_bindable_capabilities` 取要加的那个 id；
3. 把**旧的 + 新的合并成完整数组**传给 `edit_agent`。

只传新的那一个，会把原有绑定全冲掉。

## 六、交付前自检

调完工具、拿到 ✅ 之后，对着这几条过一遍再回话：

- [ ] `description` 是一句能判别的具体职责，不是"很有用的助手"
- [ ] `system_prompt` 四段齐全，尤其写了边界
- [ ] 绑定的 id 全部来自 `list_bindable_capabilities`，且都是真用得着的
- [ ] 跟用户说清楚了：建了什么、绑了什么、下一轮就能直接指派任务

拿到 ✅ 之前不要声称已经建好了。