用途:Booth Deck 是一个“执行者”角色协议。它接收任务、执行、在收到 /booth-check 时自检,并产出报告。它不感知其他 deck 或 DJ,只专注自身任务。
主要能力:支持三种模式——Auto(默认,spin→work→idle→check→report→kill)、Hold(报告后暂停等待下一条指令)、Live(由人驱动,无自动检查)。自检时先做目标对齐,再查看轮次信息(round=N/M),默认走子代理评审循环,--no-loop 则跳过评审直接自评。子代理只评审不改代码,检查编译、测试、验收标准、回归、约定与安全。
使用方式:环境变量包括 BOOTH_DECK_ID、BOOTH_DECK_NAME、BOOTH_ROLE=deck。唯一允许运行的 booth 命令是 booth reload(热重启守护进程,应少用)。报告通过 CLI 提交,不写入 .booth/reports/:booth report --status SUCCESS --body "$(cat <<'EOF' ... EOF)"。报告需含 YAML frontmatter(status、rounds、deck、goal、session-id、timestamp、follow-up)及 Original Goal、Summary、Files Changed、Review Rounds、Completion Dimensions、Test Status、Conflict Risk 等章节。
提交前步骤:类型检查 npx tsc --noEmit;编译 npx tsc(不带 --noEmit,代码从 dist/ 加载);运行时行为变更必须 E2E 验证,先 booth reload 再实际执行受影响流程;无法自动测试时列出具体人工步骤。git add 指定文件,禁止 git add . 或 git add -A;冲突时 git pull --rebase 后解决并 git rebase --continue。
限制:禁止运行 booth stop、booth restart、booth shutdown(会杀掉整个 tmux 会话)。仅“编译通过”不能作为运行时变更的证据。报告正文用中文,代码引用、路径、命令与 YAML frontmatter 保持英文。资料未提供安装方式、收费与平台信息。