--- change_id: chg_0003 status: proposed owner: pm@dth stakeholders: [dev, sre] priority: P1 target_release: v0.2 created: 2026-09-28 skip_coverage: false --- # Change: xstudio-sandbox-dispatch 三个 host-side 辅助脚本 ## Why 首次 dispatch(taskId ai-1790562657-0EF743)暴露三个真坑:沙盒拿不到 skill 资产(手搓降级骨架)/ ai-config.json 缺省值 401 重试 / 任务完成信号只走 macOS 通知 AI agent 漏接。本 chg 给出 host-side 最小修改路径。 ## Who 编排 agent(host 侧)、未来 dispatch 的复用者。 ## Scope - 3 个脚本:`scripts/prep-sandbox-skills.sh`(A1)、`scripts/setup-xstudio-ai.sh`(A2)、`scripts/wait-for-task.sh`(A3) - 不动 xstudio 内核、不重打 sandbox 镜像、不改 ai-collab-framework 门禁脚本 ## Non-Goals - 不补 ssw-jnpf-lite-react 完整 demo/shop/dashboard 业务模块(那是 chg_0005+) - 不做 React 前端(chg_0004) ## Impact - 新 capability `dispatch_helpers`(独立元能力) ## Acceptance - [ ] `bash scripts/prep-sandbox-skills.sh ` 后 `/tmp/xstudio-sandbox//space/.claude/skills/ai-collab-framework/` 存在 - [ ] `bash scripts/setup-xstudio-ai.sh ` 后 `/.xstudio/ai-config.json` 含正确 provider 配置(baseURL / authTokenEnv=ANTHROPIC_AUTH_TOKEN / model=MiniMax-M3 / ccContainer=true) - [ ] `bash scripts/wait-for-task.sh ` 在 `.xstudio-report.md` 出现后立即打印内容并 exit 0 - [ ] 三个脚本自带 `set -euo pipefail` + `--help` 输出 - [ ] check_spec_coverage.sh gap=0 ## Rollout 合并 main 即生效;host 在下次 dispatch 前手动调三个脚本即可。