OPOS: Skill for Claude Code

task-complete

When to use

At task completion: after the final slice is committed and the work is merge-ready. NOT for partial completion (use task-update --status blocked instead).

Inputs

• summary — 2-4 sentence agent-written summary of what shipped and why (required).
• since_sha — git SHA where the task started. If omitted, resolve via the fallback chain below.
• issue — optional override; default: read from <repo-root>/.claude/.current-task. As of v0.7.0 .current-task is a newline-delimited array of active issues; this skill auto-picks when exactly 1 is active and REQUIRES --issue when 2+ are active (see step 3).
• deliverables — optional markdown checklist of final deliverables state.

since_sha fallback chain

When --since_sha is not passed, resolve in this order:

1. git rev-parse origin/HEAD 2>/dev/null — the default branch on the remote (e.g. origin/main).
2. If (1) fails: git rev-parse main 2>/dev/null — a local main branch if it exists.
3. If (2) fails: git rev-list --max-parents=0 HEAD | head -1 — the first commit reachable on the current branch (works in any single-branch repo).
4. If (3) equals HEAD (single-commit branch): empty changelog; post the summary and proceed.

Steps

1. (Removed in v0.21.0 — do NOT invoke check-for-updates.) Update checks belong to the SessionStart updater (shared/scripts/opos-session-update.mjs), which runs once a day for free. Invoking the skill here cost ~5 model requests per lifecycle call, each re-reading the whole session context. Step numbering is kept so the references below stay valid.
2. Resolve repo root via git rev-parse --show-toplevel.
3. Read $REPO_ROOT/.claude/.current-task as a newline-delimited array of active task issue numbers (v0.7.0 array semantics; v0.6.x single-task content parses as 1-element array — fully backwards-compatible). Apply defensive read-side filtering (drop non-digit lines per Risk 30). Then determine the target issue number:
   • If --issue <N> was provided → use it directly.
   • Else if the array has EXACTLY 1 entry → use that entry. This preserves v0.6.x single-task workflow behavior.
   • Else if the array has >1 entries (multi-active parallel-session workflow as of v0.7.0) → ABORT with: Multiple active tasks: #<comma-list>. Pass --issue <N> to specify which one to complete.
   • Else (array empty / file absent) → ABORT with: No active task. Pass --issue <N> explicitly if completing a task you didn't open via task-register on this machine.
4. Read and validate config.
5. Resolve since_sha via the fallback chain above (if not passed).
6. Compute the changelog: git log <since_sha>..HEAD --oneline --no-merges. Capture as a bulleted list.
7. Find PR links via gh issue view <number> --json closedByPullRequestsReferences — extract URLs and titles from GitHub's native link references (PRs that say "Closes #N" or are otherwise GitHub-linked to the issue). More reliable than title or body search.
8. Scan commits in the range for the Refs: #<issue> trailer. Collect commits LACKING the ref. If any are found, prepare a warning block for the final comment AND print to stdout.
9. Render the final comment: agent summary (verbatim from --summary), then changelog bullets (or "no commits in range" line), then PR-link section (skip if empty), then deliverables (if provided), then the warning block (if commits missed the ref). When the warning block has 5 or more missing-ref commits, wrap the list in a markdown <details><summary>N commits missing Refs: #<issue></summary>...</details> block so it doesn't visually dominate the final comment. Threshold (>=5) is intentional — under 5, the inline list is short enough to stay flat for quick scanning. 9b. Lease gate (v0.17.2). node .claude/skills/lease/lease.mjs acquire --key "issue:<repo>#<number>" --intent "completing" — a no-op exit 0 if this session already holds the task, a take if it is free, and exit 2 in every enforcement mode if another session holds it: then STOP and report the holder. Closing someone else's task from another machine is exactly the collision leases exist to stop. 9 = not opted in: skip the gate and proceed as before. 3 = stale clone: git pull --ff-only, retry.