SuperAPI AI 工具集

adk-dev-guide

编程与开发

查看项目

更新于 10-15 21:53

技能介绍

用途:该技能在每次 ADK 智能体开发会话开始时读取,用于约束开发流程与编码行为。若项目存在 DESIGN_SPEC.md,应优先阅读,将其作为需求、成功标准、行为约束与工具集成的依据。

主要能力与流程:分为四个阶段。一是理解规格,阅读 DESIGN_SPEC.md,识别核心能力、约束与评估标准;二是构建实现,在智能体目录中编写或修改代码,用 make playground 或 adk web . 交互测试;三是评估,必须先激活 /adk-eval-guide,从小规模 1-2 个用例开始,运行 adk eval 或 make eval,迭代修复核心用例后再扩展边界场景,通常需 5-10 次以上迭代;四是部署,参考 /adk-deploy-guide,且未经人工明确批准不得部署。

编码约束:修改代码须精准,只改用户明确指定的部分,保留模型名、版本、api_key、注释与格式等无关内容。不得擅自更改模型名;新建智能体使用 gemini-3-flash-preview、gemini-3-pro-preview,除非用户明确要求否则不用旧模型。模型返回 404 通常是 GOOGLE_CLOUD_LOCATION 问题,应修位置而非改模型名。内置工具需导入实例,如 from google.adk.tools.load_web_page import load_web_page,并直接传入 tools=[load_web_page]。Python 命令用 uv 执行,先运行 make install 或 uv sync。

限制与排错:同一错误连续出现 3 次以上应停止,先修根因;资源已存在用 terraform import;工具缺陷先修源码。可查 /adk-cheatsheet、已安装 ADK 包、curl https://adk.dev/llms.txt 或官方文档。怀疑技能过期时运行 npx skills check -g,过期则提示用户执行 npx skills update -g。