finishlisted
Install: claude install-skill amurshak/hephaestus
<!-- requires: none -->
<!-- chains: /update-docs -->
<!-- generated from .ai/workflows/finish.md; do not edit directly -->
> **Codex:** this skill is the `/finish` adapter. For chained workflows (/update-docs), invoke the matching generated skill (for example `heph:<workflow>`) when it is available; otherwise read and follow `.agents/skills/<workflow>/SKILL.md`. Use Codex role agents from `.codex/agents/` when the runtime exposes them; otherwise perform the work directly and keep the same structured output.
> Codex does not substitute `$ARGUMENTS` — read it as the arguments given in the user's request.
Finish and close issue $ARGUMENTS. Run autonomously.
Steps:
1. **Detect repo**: Run `git remote get-url origin` from current directory.
2. **Load PR state once, then branch deterministically**:
- Find the PR for the issue (or use the explicit PR number if provided). If no PR exists, stop finish and run `/ship <#>` first.
- Read one state payload before cleanup: `gh pr view <pr-number> --repo <detected-repo> --json state,mergedAt,mergeStateStatus,autoMergeRequest,headRefName,headRefOid,baseRefOid,closingIssuesReferences`
- Branch from that payload:
- `state=MERGED` and `mergedAt != null` → proceed with issue close, branch cleanup, breadcrumbs, retrospective, docs check, and summary.
- `state=OPEN`, `mergeStateStatus=CLEAN`, and `autoMergeRequest != null` → log `auto-merge pending for PR #N`; proceed with cleanup-as-far-as-possible, but do not close the