A-2 prep-sandbox-space.sh: - 修 A-1 mount 断链:拷贝 workspace 当前状态到 /tmp/xstudio-sandbox/<hash>/space/ - +force 选项覆盖已有空间 - 推断 workspaceRoot 走 last_workspace 文件兜底 A-2 dispatch-preflight.sh: - 4 项自检:docker / 容器 up / space 可写 / .claude/skills 拷到位 - + bonus: workspaceRoot ai-config - 自动调 prep-sandbox-space / prep-sandbox-skills / auto-setup-xstudio-ai - 实测:ccc workspace 全部 ✅ B-2 brainstorming-openspec-mapping.md: - design.md → chg 工件字段映射表 - naming 约定 (capability / chg_id / S 编号 / C 编号) - chg 创建 10 步 checklist - 与 superskills using-superpowers 冲突解决 E-2 prompt-template.md: - 6 段 prompt 结构 (Header / Cache / Don't / 工件 / 步骤 / 汇报) - 完整 chg_0005 实例 - 模板生成脚本占位(待下次写) Co-Authored-By: Claude Opus 4.8 <[email protected]>
5.9 KiB
5.9 KiB
Dispatch Prompt 模板(E-2)
编制:2026-09-28 · 配合 learnings §E-2 状态:host-side 模板(不用模板,直接抄结构)
1. 模板使用方式
每个 dispatch 的 prompt 由 host 手工拼接以下 6 段:
- Header(必有) — 角色 + 工作目录 + 约束
- Cache 约定(必 include)—
dispatch-cache-env.sh注入 - 不要做的事(必有)—
prompt-protocol.md§2 清单 - chg 工件内容(必有)— proposal / spec / tasks / testcases / map.yaml
- 实施步骤(按 tasks.md T 顺序)
- 汇报约定 + 不要做的事 —
.xstudio-report.md格式
2. Prompt Header 模板
你是 xstudio 沙盒 agent。本任务:<chg_id>_<chg_slug> —— <一句话目标>。
# 角色与约束(硬约定)
- 工作目录:**`$XSTUDIO_SANDBOX_SPACE`**(git 分支 `sandbox`,已由内核播种,主线 HEAD = <main commit hash>)。shell 初始 cwd 是只读 ccWorkDir,**每条命令先 `cd $XSTUDIO_SANDBOX_SPACE` 再执行**。
- 写文件只允许落在 `$XSTUDIO_SANDBOX_SPACE`(已 bind-mount);落工作区或 home 都被拒。
- 容器内路径:`/home/ubuntu/ccWorkDir` = 宿主工作区只读;`/home/ubuntu/space` = 本空间可写。
- 本空间非持久,**每个 task 完成后立即 git commit**。
- 不要执行 `xstudio.build.run` / `xstudio.console.*`(容器已关闭);构建/测试走容器本地 shell。
- workspace 在 `<commit>` commit(main),本空间 re-seed 后应基于此。
3. Cache 约定(cat dispatch-cache-env.sh)
直接 cat 脚本内容,详见 scripts/dispatch-cache-env.sh。
4. 不要做的事(防 host 接管硬约束)
# 不要做的事(防 host 接管硬约束)
- 不修改 ~/.zshrc / ~/.bashrc / ~/ssw.ini / 全局 git config
- 不动 /usr/local/bin / /opt/
- 不动 macOS 系统设置
- 不写 /Users/xs/Desktop/workspace 之外的工作区
- 不 fallback 到 /tmp 或其他路径(mount 不可用就报错退出)
- 不调 xstudio.build.run / xstudio.console.*
- <chg 专属约束,如"不修改 src/backend/src/auth/" 等>
5. chg 工件内容(5 个文件逐个粘贴)
详见 docs/superpowers/dispatch-helpers/brainstorming-openspec-mapping.md §6。
6. 实施步骤(按 tasks.md T1→Tn 顺序)
每 T 含:
- 目标:一句话
- 输出文件:明确路径
- 验证命令:可执行的 shell 片段
- commit:
feat(<scope>): T<n> <短描述>
7. 汇报约定(最终必填)
.xstudio-report.md 模板:
=== <chg_id> <chg_slug> ===
PASS / FAIL
改动文件清单(每文件一句话):
- <path1>: <说明>
- <path2>: <说明>
...
门禁:
- check_spec_coverage.sh: gap=N
- e2e <test>.sh: pass=N/fail=N
- tsc --noEmit: N error
git log sandbox --oneline | head -10:
- <hash> <msg>
...
是否建议合并:是 / 否(说明原因)
8. 完整 Prompt 实例(chg_0005)
你是 xstudio 沙盒 agent。本任务:chg_0005_experiment_platform_extend —— 在 chg_0002 已落地的 3 算子基础上,新增 6 个真算法算子。
# 角色与约束(硬约定)
- 工作目录:**`$XSTUDIO_SANDBOX_SPACE`**(git 分支 `sandbox`,已由内核播种,主线 a94f40e + 1 phase-1 commit)。shell 初始 cwd 是只读 ccWorkDir,**每条命令先 `cd $XSTUDIO_SANDBOX_SPACE` 再执行**。
- 写文件只允许落在 `$XSTUDIO_SANDBOX_SPACE`(已 bind-mount);落工作区或 home 都被拒。
- 容器内路径:`/home/ubuntu/ccWorkDir` = 宿主工作区只读(main 刚合并 phase 1 + chg_0004);`/home/ubuntu/space` = 本空间可写。
- 本空间非持久,**每个 task 完成后立即 git commit**。
- 不要执行 `xstudio.build.run` / `xstudio.console.*`(容器已关闭);构建/测试走容器本地 shell。
# Cache 约定(cat dispatch-cache-env.sh 输出)
export npm_config_cache=/tmp/npm-cache
export PIP_CACHE_DIR=/tmp/pip-cache
export UV_CACHE_DIR=/tmp/uv-cache
# 不要做的事(防 host 接管硬约束)
- 不修改 ~/.zshrc / ~/ssw.ini / 全局 git config
- 不动 /usr/local/bin / /opt/
- 不写 /Users/xs/Desktop/workspace 之外的工作区
- 不 fallback 到 /tmp 或其他路径
- 不调 xstudio.build.run / xstudio.console.*
- 不动 src/backend/src/auth/(契约红线)
- 不动 src/frontend/(chg_0004 已定,本 chg 不涉及前端)
# chg_0005 五件套(写到 openspec/changes/chg_0005_experiment_platform_extend/)
## proposal.md
<... 600 字 ...>
## spec.md
<... 1300 字 ...>
## tasks.md
<... 700 字 ...>
## testcases.md
<... 1500 字 ...>
## testcases.map.yaml
<... 200 字 ...>
# 实施步骤(按 tasks.md T1→T5)
[每个 T 一段,含目标/输出/验证/commit]
# 汇报约定
完成写 $XSTUDIO_SANDBOX_SPACE/.xstudio-report.md,格式:
=== chg_0005 experiment_platform_extend ===
PASS / FAIL
...(详见上文模板)
# 注意事项
- timeoutSec=3000,约 50 分钟
- 真问题(mount 不可用 / npm 失败)回退给我,不要硬扛
9. 模板生成的工具脚本(可选)
host 可写 scripts/render-dispatch-prompt.sh <chg_dir> 自动化:
- 读
openspec/changes/<chg>/proposal.mdspec.mdtasks.mdtestcases.mdtestcases.map.yaml - 拼成完整 prompt 写到
<chg_dir>/.prompt-for-sandbox.md - host 可直接
mcp__xstudio__xstudio_ai_exec(prompt=$(cat .prompt-for-sandbox.md))
(这次没写,下次有需求再加。)
10. 验证
- chg_0003/0004/0005 用本模板走通
- sandbox agent 没误改 host 全局配置
- 模板工具脚本化(待 E-2 完整落地)
11. 相关文件
scripts/dispatch-cache-env.sh— Cache 约定scripts/dispatch-with-wait.sh— 一键派单 + waitscripts/dispatch-preflight.sh— 派单前自检docs/superpowers/dispatch-helpers/prompt-protocol.md— "不要做"清单docs/superpowers/dispatch-helpers/brainstorming-openspec-mapping.md— chg 工件结构