SuperAPI AI 工具集

deploy-cookbook

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:这是每个 Cargo cookbook 共用的安装流程。cookbook 是一组 define* CDK 资源,叠在共享 base-gtm 之上形成单一结果;单个 cookbook 的差异(结果、问题、验收测试、账单)写在其 SKILL.md 中。本技能负责安装的四步:scaffold、fit、deploy、verify。

准备:安装并登录 CLI。npm install -g @cargo-ai/cli;cargo-ai login --email you@company.com(发送验证码后退出);cargo-ai login --email you@company.com --code 123456;cargo-ai whoami 确认已登录。务必先确认指向哪个工作区,装错工作区看似成功但实际错误。

脚手架:cargo-ai cdk init <dir> --from getcargohq/cargo-cookbooks/<slug>,随后 cd <dir> && npm install。--from 读取 cargo.scaffold.json,递归拉取 cookbook 及其依赖,并保留目录结构以便跨目录导入;base-gtm 总会一并带出。不要手动复制文件夹,否则会遗漏依赖导致导入失败。向已有 cookbook 的项目追加时,先脚手架到临时目录再拷贝新文件夹。

适配:读取 <slug>/cookbook.json,其 inputs 数组列出部署前必须确认的全部内容。带 derive 的输入属于查询而非提问,应先查询,为空或有歧义才询问;提问超过约四个说明漏跑了查询。按 kind 处理:value 把答案补进 path 指定文件的对应值;generated 依据答案整文件生成(如 ICP);env 让操作者自行写入 .env,绝不读取、打印或提交该值;manual 是仓库外必须成立的条件(如 CRM 属性、OAuth 连接),需检查并报告,缺失会导致运行看似成功却无结果。每个输入附有 why,用于解释答错的后果;带 validate 的输入须在继续前校验。问题应一次性提出,并先读 cookbook 的 README。

计划与部署:先 npm run typecheck(需先执行 cargo-ai login 和 npm run types),再 cargo-ai cdk plan,展示计划后停下等待工作区所有者明确同意,再执行 cargo-ai cdk deploy。不得自行判断部署到生产,也不得部署操作者未见过的计划。

验收:逐条核对 cookbook.json 的 doneWhen,报告 pass 或 fail 及证据。部署干净却无产出是常见失败,因为 CDK 资源无论背后数据是否正确都会顺利协调。若全新工作区全部通过,需明确说明,这属于审批证据的一部分,由人记录在 approval.demoWorkspace。

记录安装:用 grep 检查 ~/.claude/plugins/installed_plugins.json 中是否已有 "cargo@gtm",否则执行 cargo-ai workspaceManagement session upsert --session-id "${SESSION_ID:-$(date +%s)}" --title "<slug>" --summary "[cookbook: <slug>] Installed via deploy-cookbook."。已装 Cargo GTM 插件时跳过,避免重复计数。

限制:不展示计划不部署;不自行标记 cookbook 已批准(需全新工作区测试与两项客户或伙伴实现,并由人记录);不宣称处于 to-be-approved 状态的 cookbook 有结果;不虚构 cookbook.json 中不存在的输入,若确有缺失应指出并通过 PR 补充。官方文档未提供具体 cookbook 的功能、收费与效果信息。