- 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.6 KiB
1.6 KiB
change_id, status, owner, stakeholders, priority, target_release, created, skip_coverage
| change_id | status | owner | stakeholders | priority | target_release | created | skip_coverage | ||
|---|---|---|---|---|---|---|---|---|---|
| chg_0003 | proposed | pm@dth |
|
P1 | v0.2 | 2026-09-28 | 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 <wsHash>后/tmp/xstudio-sandbox/<wsHash>/space/.claude/skills/ai-collab-framework/存在bash scripts/setup-xstudio-ai.sh <workspaceRoot>后<workspaceRoot>/.xstudio/ai-config.json含正确 provider 配置(baseURL / authTokenEnv=ANTHROPIC_AUTH_TOKEN / model=MiniMax-M3 / ccContainer=true)bash scripts/wait-for-task.sh <taskId>在.xstudio-report.md出现后立即打印内容并 exit 0- 三个脚本自带
set -euo pipefail+--help输出 - check_spec_coverage.sh gap=0
Rollout
合并 main 即生效;host 在下次 dispatch 前手动调三个脚本即可。