--- change_id: chg_0003 owner: pd@dth status: draft requires_human_validation: false --- # Spec: dispatch_helpers ## Requirement 提供 3 个 host-side bash 脚本,让下次 dispatch 不再需要手动配 ai-config / 手动 cp skill / 手动轮询 task status。 ## ADDED Scenarios ### S1 prep_sandbox_skills_copies_skills - **WHEN** host 跑 `bash scripts/prep-sandbox-skills.sh ` 其中 wsHash 是 `/tmp/xstudio-sandbox//space/` 真实存在的 sandbox - **THEN** 脚本退出 0,且 `/tmp/xstudio-sandbox//space/.claude/skills/` 下包含 `ai-collab-framework` + `ssw-jnpf-lite-react` 两个目录 - **AND** 复制过程跳过 symlink + template-boot-jnpf(>50MB)以减少空间占用 ### S2 setup_xstudio_ai_writes_provider_config - **WHEN** host 跑 `bash scripts/setup-xstudio-ai.sh ` 其中 `~/.claude/skills/` 或 `~/ssw.ini` 提供 ANTHROPIC_AUTH_TOKEN - **THEN** `/.xstudio/ai-config.json` 写入含 `claude-process` provider(baseURL / authTokenEnv=ANTHROPIC_AUTH_TOKEN / model=MiniMax-M3 / ccContainer=true) - **AND** 若 ai-config.json 已有 providers 字段,**不覆盖**已有 provider,只填空缺失字段(幂等) ### S3 wait_for_task_returns_report_when_md_appears - **WHEN** host 跑 `bash scripts/wait-for-task.sh ` 默认 timeout = 3000s - **AND** 在 timeout 内 `/tmp/xstudio-sandbox//space/.xstudio-report.md` 出现 - **THEN** 脚本打印报告内容并 exit 0 ### S4 wait_for_task_times_out_when_md_missing - **WHEN** host 跑 `bash scripts/wait-for-task.sh 5` (timeout 5s) - **AND** `.xstudio-report.md` 不存在 - **THEN** 5s 后脚本 exit 1 并打印 `TIMEOUT after 5s; check mcp__xstudio__xstudio_ai_status manually` ## UX / Interaction(UI 类变更填写) - N/A,纯命令行脚本