gza-task-improve

Improve Gza Task Inline

Address feedback for a gza task directly in the current conversation. Feedback can come from two sources: a completed review (Must-Fix items plus Suggestions) and/or unresolved feedback task comments attached to the implementation. If no review exists but unresolved feedback comments do, improve still runs — comments alone are a valid feedback source. Other comment kinds such as review_scope remain visible to operators but are not improve-actionable and must not be resolved by this workflow. This skill is useful when a task has reached max review/improve cycles and needs human-guided fixes, or when you want to interactively resolve feedback.

Process

Step 0: Capture the starting checkout

Before touching task state, capture where the user started:

git symbolic-ref --quiet --short HEAD || git rev-parse --short HEAD

Save this as <START_CHECKOUT>. You may switch to the implementation branch to make changes, but before finishing you must return the user to <START_CHECKOUT>. If <START_CHECKOUT> is a detached HEAD, restore it with git checkout --detach <START_CHECKOUT>.

Step 1: Get task ID and find the feedback (review and/or unresolved comments)

The user should provide a full prefixed task ID (for example, gza-1234). If they provide a review task ID, resolve it to the implementation task. If no task ID is provided, ask the user.

Query the task, its most recent review, and any unresolved task comments:

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)

# If the user gave us a review task, resolve to its parent implementation
impl_task = task
if task.task_type == 'review' and task.depends_on:
    impl_task = store.get(task.depends_on)
elif task.task_type == 'improve' and task.based_on:
    impl_task = store.get(task.based_on)

# Find latest review
assert impl_task.id is not None
reviews = store.get_reviews_for_task(impl_task.id)
latest_review = reviews[0] if reviews else None

# Find unresolved feedback comments (comments-only improve runs when no usable review exists)
unresolved_comments = store.get_comments(
    impl_task.id,
    unresolved_only=True,
    kinds=('feedback',),
)

print(json.dumps({
    'impl_task_id': impl_task.id,
    'impl_task_type': impl_task.task_type,
    'impl_branch': impl_task.branch,
    'impl_prompt': impl_task.prompt,
    'review_task_id': latest_review.id if latest_review else None,
    'review_report_file': latest_review.report_file if latest_review else None,
    'review_output': latest_review.output_content if latest_review else None,
    'unresolved_comments': [
        {'id': c.id, 'source': c.source, 'author': c.author, 'content': c.content, 'created_at': str(c.created_at)}
        for c in unresolved_comments
    ],
    'verify_command': config.verify_command,
    'inner_verify_command': config.inner_verify_command,
}, default=str))
"