Google agents-cli 套件里写代码的一环(SKILL.md 署名 Google):代理用 ADK(Agent Development Kit)写智能体时,按需查智能体类型、工具定义、编排模式、回调、状态管理、图式 Workflow API 和参考范例,Python、Go 各有一份速查。
skills.sh 安装量 520922(+3804 / 24h)
安全审计:有风险提示
- 会安装或运行第三方包(npx / pip 等),属于执行命令
- 会发起网络请求或调用外部 API / 远程 MCP
- 审计范围:GitHub google/agents-cli/skills/google-agents-cli-adk-code/SKILL.md(只扫描 SKILL.md 文本)
理由
- 先学后写:Python 回答“怎么做 X”前要先读 references/recipes.md 的范例目录,覆盖沙箱 / 按用户隔离的代码执行、可加载 SKILL.md 的技能、跨会话记忆、危险操作前的审批关卡、工具护栏、按用户的凭据、定时和事件驱动运行;Go 则去读上游 adk-go 的 examples/
- 项目没搭好之前不准写代码:先用 agents-cli info 检查,新项目用 agents-cli scaffold create <名称> --agent adk_python(Go 用 adk_go),已有代码用 scaffold enhance
- 参考文件按场景拆开:核心 API、ADK Python 2.0 的图式 Workflow(节点、边、扇出扇入、人工介入)、实时语音 / 视频智能体,各自单独读
- 昨天收录的 google-agents-cli-publish 管发布,这个管写代码;套件另有 6 个技能在榜;skills.sh 24 小时安装 3804,累计 520922,近几周每周安装从 132594 回落到 11140(只代表关注度)
用法
- npx skills add https://github.com/google/agents-cli --skill google-agents-cli-adk-code;CLI 用 uv tool install google-agents-cli 安装
- SKILL.md 要求先启用 /google-agents-cli-workflow,建项目、评估、部署分别交给 scaffold、eval、deploy 技能,最好整套一起装
- 说 “build an agent with ADK”“add a tool”“create a callback” 等时触发
风险
- 审计提示的安装和网络请求与用途相符:要装 agents-cli,会 curl adk.dev 的 llms.txt 文档索引再抓具体页面,Go 范例要克隆 adk-go 仓库
- references/ 下的速查和范例目录没有扫描
- 只是 API 速查和范例索引,不脱离 agents-cli 使用:没有脚手架的项目会先被要求搭项目