---

name: pr-description-format description: Provides PR description format and workflow requirements for GitHub pull requests. Use this skill when creating PRs or using 'gh pr create'.

PR Description Format

Instructions

Important Notes

• Do not use roleplay; use normal professional tone.
• If "Why" is unclear, ask user before creating PR.
• PR descriptions should be written in Japanese using plain form (だ/である/体言止め style), not polite form (です/ます style).
• Always check if the repository has a PR template first (common locations: .github/PULL_REQUEST_TEMPLATE.md, .github/pull_request_template.md, PULL_REQUEST_TEMPLATE.md, docs/PULL_REQUEST_TEMPLATE.md). If a template exists, use that template instead of the format provided below.

Workflow Requirements

1. Always start with Draft PR: gh pr create --draft
2. Switch to open only when requested: gh pr ready
3. Update description on new commits: gh pr edit --body to reflect current state

Examples

Format: What / Why / How

Copy## 概要
[変更内容の簡潔な要約]

## 変更の背景
[なぜこの変更が必要だったか]

## 変更詳細
- [具体的な変更内容と実装の詳細]