agent-development – AI Agent 开发 Skill

3周前更新 7 0 0 0

agent-development 是 Anthropic 官方插件仓库提供的 Agent 开发指导型 Skill,用于辅助 AI 编程助手在指令组织、任务拆解、工具调用和上下文管理上给出方法参考,适合开发自定义 Agent 或 Subagent 的场景。

Skill 安装

多 Agent 安装
npx skills add https://github.com/anthropics/claude-plugins-official --skill agent-development

使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。

Skill 调研报告

Skill 详细介绍

anthropics/claude-plugins-official#agent-development 是 Anthropic 官方插件市场仓库 anthropics/claude-plugins-official 中收录的一个 Skill,名称可以理解为 agent-development。它的作用不是帮用户“跑一个 Agent”,而是给正在开发 Agent 的场景提供一套可被 AI 编程助手加载的开发指导、方法论与工作流参考。

用一句话区分:

  • 它是给“开发 Agent 的人”或“让 Agent 帮忙写 Agent 的人”用的指导型 Skill。
  • 它不是 Agent 运行时、不是框架、不是 SDK、不是可独立运行的程序。
  • 它不会自己启动一个 Agent 服务,也不会自动帮你部署。

安装之后,Claude Code 之类的编程 Agent 在处理“Agent 开发”相关任务时,会多出一层针对性的方法参考,例如如何组织 Agent 的指令、任务拆解、工具调用思路、上下文管理等。具体能力边界以该 Skill 当前官方说明为准。

身份信息

  • 作者 / 组织:Anthropic(官方插件仓库)
  • 仓库:claude-plugins-official
  • Skill 名称:agent-development
  • 归类:属于 Anthropic 官方插件仓库中的 Skill

由于它位于 Anthropic 官方插件仓库,可信度来源主要是官方仓库本身,而不是第三方转载。但要注意,官方仓库收录并不等于对第三方 Agent 做了兼容性承诺。

典型使用场景

  1. 你在用 Claude Code 写一个自定义 Agent,希望它给结构建议。
  2. 你想让 Agent 帮你梳理多步骤任务、工具调用和指令组织。
  3. 你在设计 Subagent、任务编排、上下文策略时希望获得一致的方法参考。
  4. 你想在“开发 Agent”的方向上得到有针对性的建议,而不是通用对话回复。

不太适合的场景

  1. 只想直接运行一个现成 Agent。
  2. 需要它替代框架(如自主搭建多 Agent 系统)。
  3. 需要它自动完成部署、监控、托管。
  4. 需要它访问某个特定第三方服务。

它和普通 Agent 自身能力的区别

普通 Agent 本身已经能做代码生成和结构化任务。这个 Skill 的价值在于把“Agent 开发”这一方向的方法沉淀成可加载的指令,让 Agent 在这类任务里更聚焦,而不是从零开始推断。它不是新增运行时能力,更像是在 Agent 已有的推理与编码能力上叠加一层领域指导。

Skill 安全评估

总体判断:来自 Anthropic 官方插件仓库,来源可信度较高。它本身属于指导型 Skill,通常是提示词 / 方法论 / 工作流类资产,不具备独立执行能力。真正的风险主要来自“你让 Agent 用它做什么”,而不是 Skill 文件本身。

需要关注的点:

  • 来源:anthropics/claude-plugins-official 是 Anthropic 官方仓库,相比不明来源的第三方 Skill,来源透明度更高。
  • 代码执行:指导型 Skill 一般不会自带可执行脚本。但如果配合你的 Agent 使用,Agent 可能会按建议生成并运行代码,此时风险来自 Agent 的执行动作,而不是 Skill。
  • 文件读写:如果让 Agent 帮你把建议落到实际项目文件,就可能产生写入或覆盖文件的动作。重要项目建议先在分支或副本中操作。
  • Shell 权限:Skill 本身通常不需要 Shell。如果你希望更保守,可以关闭 Agent 的自动执行 Shell 权限,让所有命令由你手动确认。
  • 网络访问:单纯作为开发指导,一般不需要 Skill 主动联网。如果任务涉及安装依赖,网络行为来自你或 Agent 后续的操作。
  • API Key / Token:Skill 本身通常不需要凭证。但如果它引导你去调用某个外部模型或服务,那部分凭证属于后续项目需求,请按最小权限原则管理,不要写入仓库。
  • Prompt Injection:任何被加载的指令型资产都要考虑这一点。仅从官方仓库获取,不要混入来源不明的同名 Skill。

降低风险的做法

  1. 只从官方仓库 anthropics/claude-plugins-official 获取该 Skill。
  2. 不要让 Agent 自动执行 Shell,改为逐条确认。
  3. 在独立分支或副本中试验,不要在主干直接改动。
  4. 不把 API Key、Token、Cookie 放进项目文件或 Skill 配置里。
  5. 定期检查 Agent 生成的命令是否符合预期后再执行。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Anthropic 官方插件仓库,主要面向 Anthropic 自家 Agent 生态,Claude Code 是优先、最自然的使用环境。官方没有提供完整的第三方 Agent 兼容列表。从 Skill 的工作方式看,在支持 Skills、自定义 Skill 或类似指令加载机制的环境里,通常也可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中使用,但不同 Agent 的加载方式和兼容程度可能不同,具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

由于是指导型 Skill,通常不存在强制的独立运行时依赖。是否需要 Node.js、Python、Git、Docker 等,取决于你让 Agent 实际完成的任务,而不取决于这个 Skill 本身。官方未在此 Skill 中明确规定版本要求,请以该 Skill 当前官方说明为准。

项目 要求
Agent Claude Code 优先,其他兼容 Agent 可尝试
Node.js Skill 本身通常不需要;具体任务可能用到
Python Skill 本身通常不需要;具体任务可能用到
网络 Skill 本身通常不需要;安装依赖或调用服务时可能需要

三、权限

  • 文件读取:可选。让 Agent 读取你的项目代码时有用。
  • 文件写入:可选。让 Agent 直接把建议落到文件时需要。
  • Shell:可选。允许 Agent 自动执行指令时需要,建议谨慎开启。
  • 网络:可选。通常由具体任务触发。

四、账号 / API Key

该 Skill 本身通常不需要账号、API Key 或 Token。需要区分两件事:

  • 使用这个 Skill:一般不需要凭证。
  • 用它辅助开发的项目:如果你开发的 Agent 要调用模型或服务,才可能需要相应的 Key / Token。

最小使用条件

  1. 一个能加载 Skill 的 Agent(优先 Claude Code)。
  2. 明确你要开发的 Agent 目标和场景。
  3. 对 Agent 的 Shell / 文件权限做一次评审。

Skill 安装、使用与卸载教程

一、安装

LemonAIKit 的 Skill 详情页已经单独提供了该 Skill 的安装指令,可以直接复制本页面的安装指令,粘贴到对应的 Agent 或终端执行。

如果你不确定自己用的 Agent 如何安装 Skill,最省事的方法是直接问当前 Agent,例如:

如何安装 anthropics/claude-plugins-official#agent-development?

也可以指定 Agent 再问:

如何在 Claude Code 中安装 anthropics/claude-plugins-official#agent-development?

如何在 Codex 中安装 anthropics/claude-plugins-official#agent-development?

如何在 Cursor 中安装 anthropics/claude-plugins-official#agent-development?

让当前 Agent 根据自己的 Skill 加载 / 管理机制给出对应步骤,通常比手动照抄通用命令更可靠。

二、安装后如何使用

安装后一般不需要特殊命令触发。只要你在任务里表达出“Agent 开发”相关需求,Agent 就会在对应语境下参考这个 Skill。适合交给它的任务类型:

  • 设计一个自定义 Agent 的指令结构。
  • 拆解一个多步骤、带工具调用的 Agent 任务。
  • 优化 Agent 的上下文组织与任务流。
  • 评审已有 Agent 设计的合理性。

自然语言示例:

使用 agent-development,帮我设计一个负责代码审查的 Subagent 指令结构。

用 agent-development 的思路,把这个多步骤自动化任务拆解成 Agent 可执行的流程。

参考 agent-development,评审一下我现在的 Agent 提示词,指出结构和上下文管理上的问题。

以上为自然语言使用示例,不是官方 CLI 命令或 Slash Command。

三、卸载

卸载方式保持简单:

  • 用对应 Agent / Skill 管理器提供的删除方式移除这个 Skill。
  • 或者直接问当前 Agent:如何卸载 anthropics/claude-plugins-official#agent-development?

不同 Agent 的 Skill 安装位置和管理方式可能不同。如果没有统一卸载命令,直接询问当前 Agent 如何移除通常更稳妥。

常见问题

  1. 这个 Skill 能直接在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 里用吗?
    官方没有公布完整的第三方 Agent 兼容列表。它主要面向 Anthropic 自家生态,Claude Code 优先。其他 Agent 只要支持 Skills 或类似的指令加载机制,通常可以尝试,实际以各 Agent 当前版本为准。
  2. 安装后 Agent 没有识别到这个 Skill,怎么办?
    先确认安装是否真的完成,再确认当前 Agent 是否支持 Skill 加载。可以直接问 Agent:“你能否识别到 anthropics/claude-plugins-official#agent-development?”由它自己报告加载状态通常最快。
  3. 我同时用多个 Agent,需要分别安装吗?
    通常需要。不同 Agent 的 Skill 管理是各自独立的,在一个 Agent 里安装,一般不会自动同步到另一个 Agent。
  4. Skill 更新后需要重新安装吗?
    取决于你使用的 Agent 的 Skill 管理机制。有的会跟随仓库更新,有的需要手动更新。不确定时,直接问当前 Agent 该 Skill 是否可更新。
  5. 这个 Skill 会自动修改我的项目吗?
    Skill 本身是指导型资产,不会主动修改项目。是否修改取决于你让 Agent 做什么,以及你是否授予了文件写入权限。
  6. 能关掉 Shell 权限只用它的建议吗?
    可以。如果只需要它帮忙设计 Agent、给出建议,完全可以在不给自动执行 Shell 权限的情况下使用,让所有命令由你手动确认和执行。
  7. 这个 Skill 和通用的 Agent 框架(如多 Agent 编排库)是一回事吗?
    不是。它是开发方法论 / 指导层,不替代框架。框架负责运行时和编排,这个 Skill 负责在开发过程中提供方法参考。

Skill 更新日志

版本列表
无版本号
将转录风格的 agent 示例替换为散文式触发描述 若干 agent 文件使用了 块,其中包含 user: "..." / assistant: "..." 轮次标记,并以 \n 转义字符串的形式嵌入在 YAML frontmatter 的 description: 字段中。将这些替换为 description: 中的 扁平散文式触发描述,并在 agent 正文中添加一个“何时调用”部分, 其中包含散文式项目符号场景。 受影响的文件: - 5 个 agent 定义: - plugins/hookify/agents/conversation-analyzer.md - plugins/pr-review-toolkit/agents/code-reviewer.md - plugins/pr-review-toolkit/agents/pr-test-analyzer.md - plugins/pr-review-toolkit/agents/type-design-analyzer.md - plugins/pr-review-toolkit/agents/comment-analyzer.md - 5 个 agent-development 技能文件已更新,以教授新格式: - plugins/plugin-dev/skills/agent-development/SKILL.md - .../references/triggering-examples.md - .../references/agent-creation-system-prompt.md - .../examples/complete-agent-examples.md - .../examples/agent-creation-prompt.md 路由不受影响:每个 description: 仍以简明英语标明触发 面。
无版本号
在 hookify 和 plugin-dev 中,SKILL.md 名称使用 lower-kebab-case 技能和命令现已合并,因此 SKILL.md 的 name 字段会作为斜杠命令显示在 UI 中。像 'Hook Development' 这样的大写空格名称 会变成 '/Hook Development',这行不通,因为用户调用的 命令不支持空格。 将所有受影响的 SKILL.md name 字段重命名为 lower-kebab-case: - hookify: Writing Hookify Rules -> writing-hookify-rules - plugin-dev: Agent Development -> agent-development - plugin-dev: Command Development -> command-development - plugin-dev: Hook Development -> hook-development - plugin-dev: MCP Integration -> mcp-integration - plugin-dev: Plugin Settings -> plugin-settings - plugin-dev: Plugin Structure -> plugin-structure - plugin-dev: Skill Development -> skill-development 同时更新 plugin-dev/README.md 中的引用。
无版本号
为 claude code 插件创建初始脚手架

暂无评论

none
暂无评论...