スペック改善

ステップ 1 — イシューを読んで理解する

1. gh issue view $ARGUMENTS を使用してイシューのタイトル、本文、ラベル、アサイニーを取得します。
2. gh issue view $ARGUMENTS --comments を使用してすべてのコメントと議論のコンテキストを読みます。
3. イシューの本文またはコメントに画像が含まれている場合は、それらを表示して視覚的なコンテキスト（モックアップ、スクリーンショット、図）を理解します。
4. 親イシュー（tracked-by 参照など）と関連リンク済みイシューを確認します。より広いコンテキストのためにそれらも読みます。
5. イシューの本文またはコメントにリンクが含まれている場合：
   • Figma リンクの場合は、Figma MCP を使用してデザインを検査します。
   • その他の URL については、追加のコンテキストを収集するためにそれらを取得して読みます。
6. ユーザーに対して、このイシューについてのあなたの理解の簡潔なサマリーを提示します。

ステップ 2 — あいまいさを明確化する

1. イシューを確認し、不明な点、仕様不足、または解釈の余地がある部分を見つけます。
2. あいまいさや質問をユーザーに提示し、明確化を求めます。
3. 先に進む前にユーザーの応答を待ちます。

ステップ 3 — 改善されたスペックを作成する

収集したコンテキストと受け取った明確化に基づいて、以下のテンプレートに従って改善されたスペックを作成します：

## 概要

構築または変更が必要な内容と理由を、明確な 1 段落で説明します。

## コンテキスト

関連する背景情報：事前の決定、関連するイシュー（#番号でリンク）、依存関係、または標準／ドキュメントへのリンク。

## 要件

- [ ] このイシューを完了するために実施する必要があるものの詳細なチェックリスト。
- [ ] 具体的に：ファイルパス、コンポーネント名、サービスクラス、フォーマット。
- [ ] イシューが複数のレイヤーにまたがる場合は、領域別にグループ化します（モデル、サービス、UI）。

### 提案されるアプローチ

オプション。実装パスが明白でない場合は、推奨アプローチの概要を示します。クラス構造、パターン、主要な決定事項。

## スコープ外

- このイシューの明確に含まれていないもの（将来の作業、別のタスク）。
- 該当する場合は、フォローアップイシューへのリンク（#番号）。

## 受け入れ条件

ユーザー向けまたは開発者向けの成果を説明する 1～2 文。「ユーザーとして私は〜できる」または「X が発生した場合、Y は〜するべき」。

## 有用なリンク

- [デザイン](figma-link) — デザインが示す内容の説明
- [標準／ドキュメント](url) — 説明

改善されたスペックをユーザーにレビューのために提示します。承認されるまでフィードバックに基づいて反復します。

ステップ 4 — イシューを更新する

ユーザーがスペックを承認したら、gh issue edit $ARGUMENTS --body を使用してイシューの本文を更新します。