mcpField
A
adk-engineer

adk-engineer

github.com/jeremylongshoreAgent 工作流2.9k39 次安装2 天前更新
代码仓库

关于 adk-engineer

用于构建可维护、可测试的 Google Agent Development Kit（ADK）Agent 及多 Agent 系统的技能，为开发者提供架构设计、结构化工具接口、运行保障和本地或 Agent Engine 部署规划。

主要功能

  1. 01Agent 架构与文件布局
  2. 02结构化工具实现
  3. 03回归测试与冒烟提示词
  4. 04重试、超时与日志
  5. 05部署规划与健康检查

适用场景

  1. 01重构现有 ADK Agent
  2. 02构建多 Agent 工作流
  3. 03为工具和提示词添加测试
  4. 04准备部署检查清单

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill adk-engineer

安装后在 Claude Code 中输入/adk-engineer确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

PRD.md
references/
ARD.md
errors.md
examples.md
implementation.md
scripts/
setup-project.sh

详细介绍

ADK 工程师

构建可用于生产环境的 Agent Development Kit（ADK）Agent 和多 Agent 系统：结构清晰、易于测试、安全使用工具，并实现部署自动化。

概述

使用此技能设计和实现易于维护、可交付的 ADK Agent 代码：明确的模块边界、结构化的工具接口、回归测试，以及部署清单（本地或 Agent Engine）。

前置条件

  • 与项目锁定版本一致的目标运行时（Python/Java/Go）
  • 已安装 ADK（并配置好所需的模型/提供商 SDK）
  • 仓库中有可用的测试运行器（至少包含单元测试）
  • 如果要部署：有权访问 Google Cloud 项目，并拥有所选部署目标所需的权限

说明

  1. 明确需求：Agent 目标、工具范围、延迟/成本限制和部署目标。
  2. 提出架构方案：单 Agent 还是多 Agent、编排模式、状态策略（Memory Bank / 外部存储）。
  3. 搭建项目结构：Agent 入口、工具模块、配置和测试。
  4. 逐步实现：
    • 每次添加一个工具，并进行输入验证、返回结构化输出
    • 为每个工具和关键提示词流程添加回归测试
  5. 添加运维防护措施：重试/退避、超时、日志记录和安全的错误消息。
  6. 在本地验证（测试 + 冒烟提示词），并提供部署计划（如有要求）。

输出

  • 具体的架构方案和文件布局
  • Agent 和工具的实现（或补丁）及测试
  • 验证清单（要运行的命令、预期输出和故障排查）
  • 可选：部署说明和部署后的健康检查

错误处理

  • 构建/测试失败：隔离失败模块，尽量缩小复现范围，修复问题并添加回归测试。
  • 工具/运行时错误：采用结构化错误响应，并在适当情况下安全重试。
  • 部署失败：提供准确的失败命令、需要检查的日志，以及遵循最小权限原则的 IAM 修复方案。

示例

示例：将现有 ADK Agent 改造为生产级实现

  • 请求：“将此 Agent 重构为清晰的模块结构，并在部署前添加测试。”
  • 结果：重新组织 src/ 布局、划分工具边界、建立测试套件，并提供部署清单。

示例：多 Agent 工作流

  • 请求：“构建一个包含验证器、部署器和监控器的 Agent 团队，并使用顺序编排器。”
  • 结果：编排器骨架、各 Agent 的职责，以及每个步骤的冒烟测试。

资源

  • 完整详细操作指南（供参考）：${CLAUDE_SKILL_DIR}/references/SKILL.full.md
  • 仓库规范（权威来源）：
    • 000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md
    • 000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
  • ADK / Agent Engine 文档：

评论

支持 Markdown