launch-your-agent (启动 Agent)

五维评分

优秀点拆解

• 完整闭环 + 降级阶梯：Phase 1-4 覆盖访谈→预演→启动→评分迭代→调度化，每阶段有明确产出物（build-sheet.json、LAUNCH.md、evals/results、NEXT-DIRECTIONS.md），CMA 不可达时还能降级到本地 Claude Code workflow 兜底，会话不会以失败告终
• 凭据交互零摩擦 + 卫生红线：先查 shell env 已有 key 就跳过提问；否则用 Write 工具预建 .env（避开 shell 重定向权限拦截）chmod 600 并给绝对路径让用户并行取 key；硬规则是 key 永不进 chat，泄露即提示 rotate
• 访谈是映射练习而非表单：8 个问题簇按需取 2-3 个，每个答案锁定对应原语决策（附 11 行决策→原语映射表）；可枚举选择走 AskUserQuestion，开放问题每轮至多一个；边界只在相关时刻提出
• Mock now, wire later 连接器策略：outbox（写 schema-true JSON payload，可无人值守）与 custom-tool（可交互感受）双模式，附七类典型端点 schema；「当投递是核心时 v0 交付物就是消息本身」，v1 升级只是 swap 真 MCP server
• 工程健壮性：build-sheet.json 单一事实源其余文件是投影；launch 序列每步读 IDS.env 跳过已存在对象（失败可断点续传不产生重复）；用 python strict=False 而非 jq 解析（session payload 含控制字符）；检查点一行一原语格式 + Console deep link

可复用的设计模式

• 版本化路线图文件：把不放进 v0 的需求即时写入 NEXT-DIRECTIONS.md 编号版本（v1/v2…），每条带 what/why_deferred/how 三件套和文档链接，「Not yet」永远伴随「here's exactly how in v1」
• 可恢复的幂等执行序列：每步先读状态文件跳过已存在对象、成功后立即追加新 ID，失败重跑同一命令即可，适合多步骤 API 编排
• Mock 外部依赖让行为先成型：outbox 写 schema-true payload / stub custom tool，替身期产出与真调用参数 1:1 映射，后期替换零重写
• 单一事实源 + 投影文件集：访谈结论只落 build-sheet.json，agent.json/outcome.md/deployment.json/概览页都是它的渲染；概览页做成活 schema（元素标注真实 API 字段，ID 变 deep link），只 Edit 变更槽位

适用场景

边界与注意：强绑定 Claude Managed Agents 平台（依赖 managed-agents beta API，文件自承 live docs win，平台演进需同步更新）；面向技术型用户（明说 no hand-holding theater）；写操作（发送/下单）默认只能草稿或 always_ask gate，要全自动需先接受 drafts-first 哲学；依赖用户提供 API key；部分功能（MCP tunnel、Dreams、self-hosted sandbox）是 research preview，只能 flag 不能承诺。