3. 边界明确 - Agent 中只补充"角色视角"的内容

应该放在 Agent 中	不应该放在 Agent 中
✅ Purpose: 角色定位	❌ 长篇技术规范
✅ Response Approach: 工作流程	❌ 安全审计具体方法
✅ Output Format: 输出格式	❌ 模板文件内容

4. 验证可执行 - 提供具体命令或检查项 markdown title=".claude/agents/backend-architect.md"

完成验证

• npm run lint --fix 和 npm run format
• npx tsc --noEmit

5. 目录结构统一 - 按约定存放文件 .claude/ ├── agents/ │ └── {agent-name}.md # role definition and workflows └── skills/ └── {skill-name}/ # domain rules and resources ├── SKILL.md # skill definition └── reference/ # rule documents and templates

. 高效编写智能代理的三步法则

第一步先的观点是，明确你的痛点！

1. 代码重复率过高多个Agent中相似功能实现不统一？→ 用Skill抽象共性逻辑让多个Agent共享标准实现。

2. 协作效率低下团队成员常常因为理解不同产生冲突？→ 建立统一的Completion Checklist让所有成员遵循相同标准。

说到接下来，应对方案！

情景1这方面，新建一个后端开发相关的智能代理时：

markdown title=".claude/agents/api-developer.md"

再看name。api-developer # 命名使用小写中划线连接词组合形式保持唯一性和易读性 description: Node.js后端开发专家,负责API设计与实现,基于Express框架提供RESTful服务接口。至于tools，Read,Write,Edit。Grep # 声明所需工具权限列表以支持具体操作场景需求覆盖所有可能涉及到操作类型避免运行时因权限不足导致失败情况发生!model: inherit # 指定使用继承策略从父级获取配置参数简化管理同时保持灵活性控制能力!skills:

- express-api-skill # 引入基础API开发能力集使得当前代理具备基本服务能力而无需重复造轮子!

情景2的观点是，需要调整已有代理时：

diff title=".claude/some-existing-agent.md" --- old version ---

Capabilities

• 能够设计数据库schema
• 能够创建REST API ...

+++ new version +++++++++++++

数据库设计

• 支持MySQL/MongoDB schema设计
• 自动生成Prisma ORM配置

API开发

• 基于OpenAPI Spec生成Express路由 ...

：验证结果！

通过这三步法则，你将获得更可维护更高效且更易于协作的智能代理程序！