google-agents-cli-scaffold 处理 agents-cli 项目的创建、增强和升级。它的核心建议很简单：先把需求和架构说清楚，再用脚手架生成项目，不要因为只是原型就手动拼一套目录。
新项目要先完成 workflow 的 Phase 0，确认代理要解决什么问题、需要哪些工具和 API、是否需要部署；然后选择 `adk` 模板和 prototype 或部署目标。已有项目则先检查是不是已经由 agents-cli 创建，再决定用 `scaffold enhance` 加部署或 CI/CD。项目名、代理目录和指导文件名都要符合 CLI 的约束。
脚手架生成的 manifest、Dockerfile、FastAPI、A2A 和部署目录承担了运行时接线，修改业务逻辑时要尽量保留它们。检索、记忆、沙箱和审批等能力来自 recipe，不是一个随手添加的 scaffold flag。完成后用 workflow 的 smoke test 和 eval 验证，不要把脚手架成功等同于代理已经可用。