pflow-task-finish

Installation
SKILL.md

On any failure (non-zero exit, or an error field / "status":"error" in the JSON) print ⚠️ <message> and stop.

Steps

  1. Compose MESSAGE (see format below). Run .agents/skills/pflow-commit/scripts/git-commit-context.sh (read-only) and write a Conventional Commit message for the diff. If the script reports no changes — or is missing because pflow-commit isn't installed — use a minimal message like chore: finish task <title>. Optionally add a kebab-case SLUG; otherwise the script derives one from the task title.

  2. Run once: .agents/skills/pflow-task-finish/scripts/task-finish.sh --message "MESSAGE" [--slug "SLUG"] [--dev "BRANCH"]. It prints one JSON line; act on status:

    • no_current_task — tell the user there's nothing to finish.
    • closed_no_git — task closed, git skipped; print the JSON warning so they install pflow-commit.
    • finished — report the result:
    ✅ Task closed: <task>
    Branch: <task_branch> → merged into <dev_branch> (<merge_status>)
    Commit: <commit_hash> (<commit_status>) | push task: <push_status_task> | push dev: <push_status_dev>
    Cleanup: local <delete_local_status> | remote <delete_remote_status>
    

Message format (Conventional Commits)

Installs
15
First Seen
Jun 6, 2026
pflow-task-finish — phpinfo/pflow-skills