sandcastle-loop

批量并发跑 GitHub issues backlog 的 Claude Code skill —— 三阶段（Plan → Execute → Merge）外层循环，N 个 implementer subagent 在独立 git worktree 并行实现 + 测试 + AC self-check，merger 顺序合并 + 关 issue。复用 Claude 订阅，零 API、零 Docker。

⚠️ 安装前必读

1. 依赖 /triage skill。 sandcastle-loop 只处理带 ## Agent Brief 评论的 issue —— implementer 见 issue 没有 Agent Brief 会直接自拒。这条评论由 /triage skill 写入。/triage 不在本仓库（它是第三方 skill，来自 mattpocock/skills）。没有它，loop 跑起来每个 issue 都会被拒。

2. 只能装到标准路径。 skill 内部硬编码了 ~/.claude/skills/sandcastle-loop/ 和 ~/.claude/agents/。必须装到这两个确切位置 —— 下面的 install.sh 会保证。手动复制到别处会让 skill 失效。

依赖

• Claude Code
• gh（GitHub CLI，已登录）、jq
• 目标项目是 git 仓库，主仓在 main 分支、工作树干净
• test 命令自动识别 Node / Python / Rust / Go；识别不中或识别错时，在 docs/sandcastle-loop.json 或 .sandcastle/loop.json 里显式声明 {"test":"...","typecheck":"..."}

安装

git clone <仓库 URL> sandcastle-loop
cd sandcastle-loop
./install.sh

install.sh 把 skills/sandcastle-loop/ 复制到 ~/.claude/skills/、4 个 subagent 复制到 ~/.claude/agents/。装完重启 Claude Code。

用法

在目标项目里：

/sandcastle-loop            # 默认（含 reviewer 阶段）
/sandcastle-loop no-review  # 跳过 reviewer

内容

skills/sandcastle-loop/   skill 本体（SKILL.md + scripts/ + templates/ + references/）
agents/                   4 个 subagent：planner / implementer / reviewer / merger
install.sh                安装脚本

完整流程与设计见 skills/sandcastle-loop/SKILL.md。