research
Installation
SKILL.md
GitHub issue ( $ARGUMENTS ) に対して、実装に着手する前の技術調査を行う。$ARGUMENTS は issue 番号(123、#123)または URL。$ARGUMENTS が空の場合はユーザーに issue 番号を質問する。
tmp/issues/<issue番号>/research.mdが既にある場合はその内容を確認し、更新が必要か判断するgh issue viewで issue を取得する- issue の目的・要件・受け入れ条件を分析する
- 実装計画を進める上で不足している情報(仕様の曖昧な点、未定義の振る舞い、外部依存の確認事項など)を洗い出し、ユーザーに質問する
- コードベースを調査し、影響範囲(変更対象のファイル・関数、呼び出し元、依存関係)を特定する
- 実装方法の候補を 3 つ程度洗い出し、それぞれの Pros / Cons を整理する。各候補に 5 段階の推奨度を付ける
- ユーザーに実装方法を選択してもらう(自由入力でのフィードバックも受け付ける)
- 結果を Write ツールで
tmp/issues/<issue番号>/research.mdに書き込む(フォーマットは template.md を参照)
注意事項
- issue の内容が曖昧な場合は、ステップ 4 でユーザーに確認を取ってから先に進む
- コードベースが大きい場合、調査は issue に関連する部分に絞る
- 既存のテスト・型定義・ドキュメントも調査対象に含める
- 調査結果は事実とコードの根拠に基づくこと。推測が含まれる場合は明示する
Related skills