用途:在 google/adk-recipes 仓库内自动生成新的 Python ADK recipe,需通过仓库内脚本 scripts/scaffold.py 完成,不得手写样板文件,脚本运行成功后本轮不得再修改该 recipe。文中一律称其为 recipe,不能称为 project。
必要输入:一是输出目录,必须由用户在 contrib/python/(社区 recipe,新 Python recipe 首选)、core/python/(精选 recipe)、contrib/(旧扁平结构,仍接受但优先 contrib/python/)中指定,未指定须先询问;二是 recipe 名称,只能含小写字母与连字符,长度不超过 30 字符,且不能以连字符开头或结尾,不合规则须说明并请用户改正,两者齐全前不得执行。
运行命令:python3 .agents/skills/scaffold-python-recipe/scripts/scaffold.py --name <RECIPE_NAME> --output-dir <OUTPUT_DIRECTORY>。脚本仅接受 --name 与 --output-dir 两个必填参数,不要传其他标志。
成功后须提醒:更新 manifest.yaml 的 description、ownership.team、ownership.poc(占位符标记为 TODO:),该文件由 CI 校验,不可留占位符,也可用 generate-manifest 技能自动生成;更新 README.md,替换通用标题与描述,所有权/POC 只写在 manifest.yaml 中。随后给出快速开始命令:cd <OUTPUT_DIRECTORY>/<RECIPE_NAME>、uv sync、uv run pytest、uv run adk run app。
限制:无法生成垂直技能(skills/<vertical>/<solution>/),其结构不同且目前无模板;相关具体收费、平台与效果资料暂未提供。