issue-progress-tracking

Issue の進捗管理

gh CLI を使って GitHub Issue の進捗を追跡するための手順ガイドです。作業開始から PR 作成まで、Issue が常に最新の状態になるようにします。

呼び出し

このスキルは user-invocable: false かつ disable-model-invocation: true です。 /ork: 形式では呼び出せず、モデルが自動選択することもできません（#3313）。エージェントはこのファイルのパスを読み込んで明示的に利用します。

${CLAUDE_PLUGIN_ROOT}/skills/issue-progress-tracking/SKILL.md

---

フェーズ 1：作業開始

Issue にラベルを付け、フィーチャーブランチを作成します。

# Move issue to in-progress
gh issue edit $ARGUMENTS[0] --add-label "status:in-progress" --remove-label "status:todo"
gh issue comment $ARGUMENTS[0] --body "Starting work on this issue."

# Create feature branch
git checkout -b issue/$ARGUMENTS[0]-brief-description

ルール：

• 必ずデフォルトブランチ（main/dev）から分岐します
• ブランチ名の形式：issue/<number>-<brief-description>
• main/dev で直接作業しないでください

---

フェーズ 2：作業中 — 小さなコミット

最後にまとめてではなく、論理的なステップごとにコミットします。すべてのコミットで Issue を参照します。

# Each commit references the issue number
git commit -m "feat(#$ARGUMENTS[0]): add user model

Co-Authored-By: Claude <[email protected]>"

ルール：

• 1 つのコミットにつき 1 つの論理的な変更にします（アトミック）
• すべてのコミットで Issue を参照します：type(#N): description
• 早めに、こまめにコミットし、大規模な差分をため込まないでください

---

フェーズ 3：進捗報告（長期の実装）

複数のステップにわたる作業では、進捗を報告します。

gh issue comment $ARGUMENTS[0] --body "Progress update:
- Completed: database schema, API endpoints
- In progress: frontend components
- Remaining: tests, documentation"

進捗を報告するタイミング：

• 主要なマイルストーンを完了した後
• 行き詰まったとき、または進め方を変更するとき
• 長時間の作業から離れる前

---

フェーズ 4：作業完了

PR を作成し、ラベルを更新します。

# Create PR that closes the issue
gh pr create \
  --title "feat(#$ARGUMENTS[0]): brief description" \
  --body "Closes #$ARGUMENTS[0]

## Changes
- Change 1
- Change 2

## Test Plan
- [ ] Unit tests pass
- [ ] Manual verification"

# Update issue status
gh issue edit $ARGUMENTS[0] --add-label "status:in-review" --remove-label "status:in-progress"

---

ルールの早見表

ルール	影響度	対象
作業開始の手順	HIGH	ブランチ作成、ラベル更新、最初のコメント
小さなコミット	HIGH	Issue を参照するアトミックなコミット

合計：2 カテゴリにわたる 2 つのルール

---

主な決定事項

決定事項	選択	理由
ラベルのプレフィックス	status:	GitHub の規約との一貫性
ブランチの形式	issue/<N>-desc	ブランチを Issue に自動的にリンク
コミットの参照形式	type(#N):	Conventional Commits と Issue のリンク
進捗コメント	手動	人が状況を把握できるようにする

---

よくある間違い

1. ラベルを付けずに作業を開始する — 誰が何に取り組んでいるか、チームが把握できなくなります
2. 最後に大規模なコミットをする — レビューが難しくなり、二分探索に役立たない履歴になります
3. PR を Issue にリンクし忘れる — マージ後も Issue がオープンのままになります
4. PR 作成時にラベルを更新しない — レビュー中も Issue に「進行中」と表示されます
5. gh issue close で Issue を手動でクローズする** — Issue がクローズされるのは、本文に Closes #N を含む PR をマージした場合のみです。作業中は gh issue comment で進捗をコメントし、直接クローズしないでください。

---

関連スキル

• ork:commit — Conventional Commits 形式でコミットする
• ork:fix-issue — Issue を解決する一連のワークフロー
• ork:implement — 並列エージェントによる機能実装
• ork:create-pr — プルリクエストを作成する