- scripts/prep-sandbox-skills.sh: A1 host-side skill 拷贝 (跳过 symlink/template-boot-jnpf/JNPF_*)
- scripts/setup-xstudio-ai.sh: A2 host-side ai-config writer (python3 merge 不覆盖已有 providers)
- scripts/wait-for-task.sh: A3 host-side completion poller (轮询 /tmp/xstudio-sandbox/*/space/.xstudio-report.md)
- tests/e2e/dispatch_helpers.test.sh: 6 case 自检
- openspec/changes/chg_0003_dispatch_helpers/{5 工件}
Co-Authored-By: Claude Opus 4.8 <[email protected]>
1.8 KiB
1.8 KiB
change_id, owner, status, requires_human_validation
| change_id | owner | status | requires_human_validation |
|---|---|---|---|
| chg_0003 | pd@dth | draft | 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>其中 wsHash 是/tmp/xstudio-sandbox/<wsHash>/space/真实存在的 sandbox - THEN 脚本退出 0,且
/tmp/xstudio-sandbox/<wsHash>/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 <workspaceRoot>其中~/.claude/skills/或~/ssw.ini提供 ANTHROPIC_AUTH_TOKEN - THEN
<workspaceRoot>/.xstudio/ai-config.json写入含claude-processprovider(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 <taskId>默认 timeout = 3000s - AND 在 timeout 内
/tmp/xstudio-sandbox/<hash>/space/.xstudio-report.md出现 - THEN 脚本打印报告内容并 exit 0
S4 wait_for_task_times_out_when_md_missing
- WHEN host 跑
bash scripts/wait-for-task.sh <taskId> 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,纯命令行脚本