finish-task

What problem does it solve?

This Skill automates finishing the current development task by updating task status, preparing commits, and performing mode-aware merges across MAIN, FEATURE_BRANCH, and WORKTREE workflows.

Core Features & Use Cases

• Mode detection: Detects whether in MAIN, FEATURE_BRANCH, or WORKTREE and applies the correct merge/commit strategy.
• Prerequisite checks: Ensures no uncommitted changes (unless --force), runs tests (unless --no-test), and formatting checks.
• Mode-specific actions: MAIN updates task status only; FEATURE_BRANCH performs squash merge into main with a commit; WORKTREE performs squash merge in the main repo with optional worktree cleanup.
• Task status & cleanup: Marks tasks complete and performs branch operations accordingly.

Quick Start

Run the finish-task command to complete the current task with automatic mode detection. Optional flags: --no-test to skip tests, --force to override safety checks.