home / skills / shotaiuchi / dotclaude / ghwf5-implement

ghwf5-implement skill

safe

This skill helps you implement a planned step by loading context, writing code, and updating documentation following established patterns.

npx playbooks add skill shotaiuchi/dotclaude --skill ghwf5-implement

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

Files (1)

SKILL.md

1.6 KB

---
name: ghwf5-implement
description: Plan の1ステップを実装
argument-hint: "[step-number]"
context: fork
agent: general-purpose
---

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

# /ghwf5-implement

実装計画の1ステップを実装する。

## Usage

```
/ghwf5-implement          # 次のステップを実装
/ghwf5-implement <N>      # ステップ N を実装
```

## Prerequisites

- `ghwf4-review` 完了済み (Plan レビュー)
- `03_PLAN.md` が存在

## Processing

### 1. Load Context

- Read `state.json` for active work
- Read `03_PLAN.md`
- Fetch Issue/PR with comments:
  ```bash
  gh issue view <issue> --json body,comments
  gh pr view <pr> --json comments,reviews
  ```
- Identify next step to implement

### 2. Implement

- Write code according to plan
- Follow existing code patterns
- Add tests if applicable

### 3. Update 05_IMPLEMENTATION.md

- Track completed steps
- Note any deviations from plan

### 4. Commit & Push

**Execute immediately without confirmation:**

```bash
git add .
git commit -m "feat(<scope>): <description>

Implements step N of <work-id>"
git push
```

### 5. Check Completion

- All steps done → next: ghwf6-verify
- More steps → next: ghwf5-implement (same step)

### 6. Update PR & Labels

- PR チェックリスト更新
- `ghwf:step-5` ラベル追加 (完了時)

### 7. Update State

```json
{
  "current": "ghwf5-implement",
  "next": "ghwf6-verify",  // or "ghwf5-implement"
  "last_execution": "<ISO8601>",
  "implement": {
    "current_step": N,
    "total_steps": M
  }
}
```

Overview

This skill implements a single step from an existing implementation plan. It reads the current plan and state, applies code changes following the plan, updates implementation tracking, and pushes the commit immediately. It is designed to automate and standardize one-step progress in a multi-step workflow.

How this skill works

The skill loads work context from state.json and 03_PLAN.md, inspects the related issue or PR comments via the GitHub CLI, and identifies the next step to implement. It then applies code changes following existing patterns, adds tests when applicable, updates 05_IMPLEMENTATION.md to record progress and deviations, commits and pushes changes, and updates state and PR metadata to reflect completion.

When to use it

You have a reviewed Plan (ghwf4-review completed) and 03_PLAN.md exists.
You need to implement the next actionable step from a formal plan.
You want automated tracking of implementation progress and state updates.
You are working through a multi-step feature or bugfix and need repeatable execution.

Best practices

Confirm ghwf4-review is complete and 03_PLAN.md accurately describes the step.
Follow existing repository coding patterns and add tests for new behavior.
Document any deviations from the original plan in 05_IMPLEMENTATION.md.
Keep commit messages in the prescribed format so automation and reviewers can parse them.
Run local tests and linters before committing to reduce CI failures.

Example use cases

Implement step 2 of a feature that adds a new API endpoint, following the plan’s code snippets and tests.
Fix a specific bug listed as step 4 in the plan, update implementation notes, then push the change.
Apply a refactor step that touches multiple files while recording deviations from the plan.
Add unit tests for a module as specified by the plan’s testing step and update the PR checklist.

FAQ

What does the skill require before running?

It requires ghwf4-review to be completed and 03_PLAN.md to be present in the repository.

Will it ask for confirmation before committing?

No. The workflow commits and pushes immediately using the prescribed commit message format.