home / skills / shotaiuchi / dotclaude / ghwf7-pr

ghwf7-pr skill

safe

This skill updates a Draft PR to Ready for Review and completes the workflow, guiding you through checks, labeling, and posting completion comments.

npx playbooks add skill shotaiuchi/dotclaude --skill ghwf7-pr

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

1.7 KB

---
name: ghwf7-pr
description: Draft PR を Ready for Review に変更
argument-hint: ""
context: fork
agent: general-purpose
---

**Always respond in Japanese. Write all workflow documents (*.md) in Japanese.**

# /ghwf7-pr

Draft PR を Ready for Review に変更し、ワークフローを完了する。

## Usage

```
/ghwf7-pr
```

## Prerequisites

- `ghwf6-verify` 完了済み
- 全検証パス

## Processing

### 1. Load Context

- Read `state.json` for active work
- Fetch Issue/PR with comments:
  ```bash
  gh issue view <issue> --json body,comments
  gh pr view <pr> --json comments,reviews
  ```

### 2. Final Check

- All CI checks passing
- No uncommitted changes
- Documentation complete

### 3. Update PR Body

全チェックボックスを完了に:

```markdown
## Progress
- [x] ghwf1-kickoff
- [x] ghwf2-spec
- [x] ghwf3-plan
- [x] ghwf4-review
- [x] ghwf5-implement
- [x] ghwf6-verify
- [x] ghwf7-pr (Ready for Review)
```

### 4. Convert to Ready

```bash
gh pr ready
```

### 5. Update PR Title

Remove "WIP: " prefix:

```bash
gh pr edit --title "<issue-title>"
```

### 6. Update Labels

```bash
gh issue edit <issue> \
  --remove-label "ghwf:waiting" \
  --add-label "ghwf:completed,ghwf:step-7"
```

### 7. Post Completion Comment

```bash
gh pr comment --body "🤖 Workflow completed. Ready for review.

## Summary
- Commits: N
- Files changed: M
- Lines: +X / -Y

## Documents
- [01_KICKOFF.md](link)
- [02_SPEC.md](link)
- [03_PLAN.md](link)
"
```

### 8. Update State

```json
{
  "current": "ghwf7-pr",
  "next": null,
  "completed_at": "<ISO8601>",
  "last_execution": "<ISO8601>"
}
```

## Post-Completion

After PR is reviewed:
- If changes requested: add `ghwf:revision` label
- Daemon will detect and restart workflow

Overview

This skill automates converting a draft Pull Request to Ready for Review and completes the final workflow step. It verifies CI status, updates the PR body and title, adjusts labels, posts a completion comment, and records state. Use it when the change set is verified and ready for formal review.

How this skill works

The skill reads the current workflow state and fetches PR/issue details and comments. It confirms final checks (CI passing, no uncommitted changes, documentation present), updates the PR body to mark all checklist items complete, then runs the GitHub CLI to mark the PR ready, edits the title to remove WIP, and updates labels. Finally it posts a summary comment and writes the updated state file.

When to use it

All verification steps (ghwf6-verify) have completed successfully
Continuous integration checks are passing
No local or pending uncommitted changes remain
Documentation and required artifacts are complete
You want to mark a draft PR as formally ready for review

Best practices

Run automated checks and fix any CI failures before converting the PR
Ensure the PR body includes a completed progress checklist before marking ready
Remove any WIP or draft markers in the title and description
Use the GitHub CLI (gh) in an authenticated environment with proper permissions
Record timestamps and state updates to enable reproducible workflow auditing

Example use cases

A feature branch has passed all tests and needs to be reviewed by maintainers
A documentation update finished verification and should be made review-ready
A bugfix PR was iterated in draft mode and now meets release criteria
Automation finalizes the workflow after manual verification steps were confirmed

FAQ

What CI status is required before running this skill?

All configured CI checks must be green; do not mark ready if any check fails.

What happens if reviewers request changes after conversion?

Add the ghwf:revision label and the workflow daemon will detect the change and restart the appropriate steps.