用途:这是 packages/docs/cloud/team-quickstart.mdx 背后的端到端配方,用于在产品变更后刷新该教程,或产出新教程。配套技能包括 cloud-dashboard-walkthrough(Web 流程)、daytona-electron-den(桌面端)、agent-first-screenshots(截图质量标准与美化)。
主要流程:
- 分支:从最新 dev 建独立 worktree,命令为 git fetch origin 与 git worktree add ../_worktrees/<name> -b docs/<tutorial-branch> origin/dev。
- 启动产品:云端用 bash .devcontainer/test-server-on-daytona.sh dev --name <name>,并通过 /api/runtime-config 验证 orgMode:"multi_org";桌面端用 bash .devcontainer/test-on-daytona.sh dev --den-base-url <DEN_WEB_URL> --den-api-base-url <DEN_API_URL>,可从渲染进程执行 window.resizeTo(1600, 1000)。资料明确提示不要在 macOS 本地从 agent shell 运行桌面应用,应使用 Daytona Electron 沙箱。模型密钥来自 openwork-eval-secrets 卷或 Infisical。
- 驱动与截图:以人物角色走流程,每个教程节拍一张截图;2x 捕获、先填表再截图、只隐藏开发专用界面元素、按步骤命名 raw/01-signin-email.png 等。桌面端需通过 handoff 深链事件登录,用 document.execCommand("insertText", …) 插入提示词,等待 "Ready for new tasks" 后再截最终图。
- 美化:用 .opencode/skills/agent-first-screenshots/scripts/beautify.mjs,云端截图用 --chrome browser --url app.openworklabs.com --bg paper --width 1600,桌面截图用 --chrome mac --title OpenWork --bg indigo --width 1600,需在含 node_modules 的仓库根运行。
- 写文档:MDX 放在 packages/docs/<tab>/<name>.mdx,图片放 packages/docs/images/<tutorial-name>/NN-step.png,以 /images/… 绝对路径引用并包在 <Frame> 中,在 docs.json 注册页面,并用 grep 循环校验图片存在。
- 交付:按故事拆分提交、推送、用 gh pr create 向 dev 提 PR,并在 PR 正文嵌入 2–3 张关键截图,说明已验证内容与所跑测试。完成后用 daytona delete 清理沙箱,并 pkill -f remote-debugging-port=9223 结束本地无头 Chrome。
限制:资料未提供该技能的收费、价格、平台支持范围与效果数据;部分步骤依赖 Daytona 沙箱、特定仓库结构与密钥卷,缺失事实暂未提供。