用途：把用户意图转化为最小化的 pilot.yaml，并完成校验与渲染，得到不含凭据的版本 1 清单和渲染文件 .cookbook/generated.tfvars.json。协调器 cookbookctl 仅在本地校验和渲染，不会对任何 BTP 账户做实时变更。
使用方式：在 Cookbook 仓库根目录工作，编辑状态前先阅读 pilot.yaml.example、docs/cookbookctl.md 和 README.md。可用 ./cookbookctl pilots --json（只读，无需清单）查看当前试点阶段进度和已搁置的试点，不要打印密钥或完整环境文件。流程先询问是沿用现有试点状态还是全新开始；已有激活试点时总结其架构与已完成阶段，再询问继续、修改或搁置。搁置用 ./cookbookctl park，恢复用 ./cookbookctl unpark <dir>。全新试点可选快速本地原型（按 recipes/01-scaffold-agent/README.md，暂不需要 BTP）或完整设置（访谈、写 pilot.yaml、校验、渲染）。用户确认总结前不要写入 pilot.yaml。
主要能力：渐进式披露的完整设置访谈，覆盖结果场景（从 templates/ 选择，也支持自定义）、账户（先运行 ./cookbookctl accounts --json 探测会话，无会话时请用户自行执行 btp login --sso）、运行时（Cloud Foundry 或 Kyma，不可同时启用）、任务状态与应用栈（内存或 HANA；栈为 TypeScript + Express、TypeScript + CAP 或 Python）、模型（SAP AI Core 或 OpenAI 兼容端点）、Joule 集成、最终确认。之后把决策写入 gitignored 的 pilot.yaml，运行 ./cookbookctl validate 做无状态模式与依赖检查，再运行 ./cookbookctl render 生成 .cookbook/generated.tfvars.json。
限制与约束：绝不在对话或 pilot.yaml 中接收密码、令牌、服务密钥、证书或 API 密钥；绝不让已登录用户重复登录；默认首次对话使用 mock 工具。可见子账户列表是 BTP 清单，不代表本工作区管理的试点，不得当作可恢复的试点。已存在子域名会冲突，需另选。不要从已有清单、本地运行时或示例推断应用栈。所有命令需保持在原样。官方文本暂未提供。