gza-task-fix

Fix Stuck Gza Task Inline

Use this skill when an implementation task is stuck in review/improve churn — the same blockers keep reappearing, or a previous improve/fix pass failed to close them. fix is escalation: it diagnoses why the loop is happening before making any edits, then applies a bounded repair scoped strictly to blocker closure.

Unlike /gza-task-improve, this skill requires you to verify each blocker against the current code before deciding whether a change is needed. A stuck task often already has the fix on disk — in which case the answer is "no change, this was hallucinated-closure churn," not another edit pass.

This skill runs entirely inline in the current Claude Code session. Do not invoke gza fix or any background worker — that defeats the purpose of running here.

Process

Step 0: Capture the starting directory

pwd

Save as <START_DIR>. This skill must never change the branch checked out in the directory the user invoked it from — all branch work happens in a separate worktree (Step 3). You return here at the end by cd, not by any git checkout.

Step 1: Resolve the target task and recent review history

The user provides a full prefixed task ID (for example, gza-1234) — implementation, review, improve, or prior fix. Resolve to the implementation task and fetch the last three reviews so you can detect churn:

uv run python -c "
import json, sys
from pathlib import Path
from gza.config import Config
from gza.db import SqliteTaskStore

config = Config.load(Path.cwd())
store = SqliteTaskStore.from_config(config)
task = store.get('<TASK_ID>')
if not task:
    print('ERROR: task not found', file=sys.stderr); sys.exit(1)

impl = task
if task.task_type in ('review', 'fix') and task.depends_on:
    impl = store.get(task.depends_on)
    if impl and impl.task_type == 'review' and impl.depends_on:
        impl = store.get(impl.depends_on)
elif task.task_type == 'improve' and task.based_on:
    impl = store.get(task.based_on)

reviews = store.get_reviews_for_task(impl.id)[:3] if impl else []
print(json.dumps({
    'impl_id': impl.id if impl else None,
    'impl_branch': impl.branch if impl else None,
    'impl_prompt': impl.prompt if impl else None,
    'impl_tags': list(impl.tags) if impl else [],
    'verify_command': config.verify_command,
    'inner_verify_command': config.inner_verify_command,
    'reviews': [
        {'id': r.id, 'report_file': r.report_file, 'output_content': r.output_content, 'completed_at': str(r.completed_at)}
        for r in reviews
    ],
}, default=str))
"