Claude Code 建 Agent 总是不对？官方这个 Skill 告诉你规范怎么写

你知道吗？大多数人在 Claude Code 里「创建 Agent」时，完全是凭感觉写的——description 随便两句话，system prompt 写得跟普通 prompt 没什么区别，tools 权限全开，color 随便选个蓝色。

结果就是：Agent 根本不在该触发的时候触发，触发了也做不好该做的事，不同 Agent 之间还互相抢活。

直到我找到了这个——Agent Identifier，Anthropic 官方的 Agent 开发规范。65,489 次安装，Smithery Coding 分类榜常年霸榜。

这个 Skill 在解决什么问题？

它本质上是一份完整的 Agent 开发框架文档。从文件结构、YAML frontmatter 规范、触发条件（description）怎么写、系统 prompt 怎么设计，到 Validation Rules，全部覆盖。

换句话说：它是官方给你的一份「Agent 开发最佳实践手册」，而且是写给 AI 看的结构化手册——装进 Claude Code，AI 在创建任何 Agent 之前都会先读它。

几个我认为是精髓的点

1. 触发条件（description）是最关键的字段

文档里反复强调 description 要包含 <example> 块，展示「什么情况下用户说了什么，Claude 应该如何响应并触发这个 Agent」。这才是让 Agent 在对的时间被调用的核心。

2. tools 要遵循最小权限原则

只读分析用 ["Read", "Grep", "Glob"]，代码生成用 ["Read", "Write", "Grep"]，测试用 ["Read", "Bash", "Grep"]——不是全开，是按需配。

3. System prompt 要用第二人称写

文档里的模板是「You are…」「You will…」，而不是「I am…」。这对 Claude 的行为约束效果差异很大。

适用场景

• 你在开发一个 Claude Code 插件，需要创建多个 Agent（代码审查、测试生成、文档写作……）
• 你想让团队的工作流规范固化成 Agent，实现「复制粘贴别人的经验」
• 你在设计 Multi-Agent 系统，需要清晰的职责边界和触发规则

怎么装

在 Claude Code 里直接跑：

npx skills add anthropics/agent-identifier

或者手动把 SKILL.md 放进项目 plugins/plugin-dev/skills/agent-development/ 目录。

最后说一句

2026 年，Agent Skills 已经是 AI 编程的标配了。但很多人还停留在「写好 prompt 让 AI 执行」的层面——没有结构化，没有可复用，没有团队共享。

Agent Identifier 解决的问题，就是让你从「凭感觉建 Agent」变成「按规范建 Agent」。65,489 次安装背后，是真实的使用需求。

如果你在用 Claude Code，这应该是你装的前几个 Skill 之一。

GitHub：https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills/agent-development

GitHub: https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills/agent-development