Subtask
Verteilt parallele KI-Worker über die subtask CLI in isolierte git Worktrees
Funktioniert mit Setup
Was es kann
Bringt Claude Code bei, parallele Arbeit über die `subtask` Go CLI zu orchestrieren: Jede Aufgabe erhält ihren eigenen git Worktree und Branch, plus einen Aufgaben-Datensatz mit Titel, Basis-Branch und einer Ereignishistorie. Deckt den vollständigen Zyklus von Entwurf, Senden an einen Worker, Überprüfung des Diffs, Fortschreiten der Phasen (doing zu review zu ready) und Squash-Merge zurück in den Basis-Branch ab. Wird ausgelöst, wenn der Benutzer darum bittet, Arbeit an Worker oder Subagenten zu delegieren, mehrere Aufgaben parallel auszuführen oder Subtask namentlich erwähnt.
Testbericht
Die Go CLI aus dem Quellcode gebaut (go1.26.5) und alles unter einem mktemp HOME ausgeführt; die echten ~/.claude/skills und ~/.subtask wurden als unberührt verifiziert. Alle 13 Befehle, die die SKILL.md-Tabelle auflistet (ask, draft, send, stage, list, show, diff, merge, close, workspace, interrupt, log, trace), existieren im Binärprogramm, und `subtask install --no-prompt --scope user --harness claude` schrieb SKILL.md nach ~/.claude/skills/subtask/SKILL.md. Baseline-Artefakt (/tmp/st-baseline): Die Behebung von zwei unabhängigen Python-Bugs auf meine eigene Weise ergab 2 sequentielle Branches und `git worktree list` zeigte 1 Eintrag, ohne Task-Metadaten. Skill-Artefakt (/tmp/st-skill2): Das wörtliche Befolgen des Bodys ergab `git worktree list` mit 3 Einträgen (main + fix/duration-hours + feat/retry-validation gleichzeitig an verschiedenen Pfaden live), einen .subtask/tasks/<task>/-Ordner pro Task, der TASK.md (title/base-branch Frontmatter), WORKFLOW.yaml und history.jsonl enthielt, eine `subtask list`-Statustabelle, die beide in Bearbeitung mit +1 -1 und +7 -3 zeigte, und `subtask merge`, das jeden auf main squashte („Merged ... Workspace freed“) für ein sauberes 2-Commit-Main. Der einzige Schritt, den ich nicht ausführen konnte, ist der eigentliche KI-Worker: `subtask send` stellte den Worktree bereit und versandte, aber das Harness starb in 3,6s und `subtask trace` zeigte, dass die Worker-Eingabeaufforderung mit „Invalid API key - Please run /login“ beantwortet wurde, weil das temporäre HOME keine Anmeldeinformationen hat, also habe ich die Worker-Ausgabe manuell committet, um die Überprüfung/Zusammenführung zu testen. Stieß auch auf einen undokumentierten Blocker: In einem Repo, in dem /.subtask/ vor dem Entwurf nicht gitignored war, verweigerte `subtask merge` mit „has uncommitted changes“ (ensureGitignore wird nur von `subtask config` aufgerufen, nicht von `draft`). Sicherheitsüberprüfung sauber: SKILL.md hat keine URLs, Skripte, base64 oder Injection-Text, und die optionalen Plugin-Hooks geben nur „consider loading the subtask skill“-Erinnerungen aus.
Getestet am: 2026-07-21 · Claude Code 2.x (agent harness)
Installation
git clone --depth 1 https://github.com/zippoxer/subtask.git /tmp/subtask-src
mkdir -p ~/.claude/skills/subtask
cp /tmp/subtask-src/pkg/install/SKILL.md ~/.claude/skills/subtask/SKILL.md
# REQUIRED: the skill is a thin wrapper and does nothing without the `subtask` Go binary.
# brew install zippoxer/tap/subtask
# # or: go install github.com/zippoxer/subtask/cmd/subtask@latest
# # or: curl -fsSL https://subtask.dev/install.sh | bash (upstream install script; audit before running)
# Then configure the worker harness (writes the same SKILL.md itself, so the copy above is optional):
# subtask install --no-prompt --scope user --harness claude # or --harness codex / opencode
# # plain `subtask install` is interactive and fails without a TTY ("could not open a new TTY")
# REQUIRED: the chosen harness CLI (claude / codex / opencode) must be installed and authenticated,
# otherwise `subtask send` fails with "claude failed: exit status 1".
# Recommended: commit `/.subtask/` to .gitignore BEFORE drafting tasks, or `subtask merge` aborts
# with "has uncommitted changes" because .subtask/ is untracked inside each worktree.
# Optional plugin (adds hooks that remind Claude to load the skill):
# /plugin marketplace add zippoxer/subtask && /plugin install subtask@subtask Befehle & Beispiel-Prompts
/subtaskVerteilt parallele KI-Worker über die subtask CLI in isolierte git Worktrees
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
Delegate this task to a subtask workerRun these three tasks in parallel workspacesCreate a new subtask for this feature