アイデア研磨スキル
目的
構造化された質問を通じて機能アイデアを明確化し洗練させます。このプロセスは、正式なコンセプト文書を作成する前に、曖昧さ、エッジケース、設計上の考慮事項を明らかにするのに役立ちます。
使用するタイミング
- ユーザーが大まかな機能アイデアを持っているが、完全には形成されていない場合
- コンセプト文書を書く前
- 機能アイデアにもっと明確さが必要な場合
- 設計空間とトレードオフを探求するため
前提条件
- ユーザーが大まかな機能アイデアを説明していること
- 機能番号と名前が決定されている（または決定される予定であること）
手順
1. 機能番号と名前を決定する
まだ決定されていない場合:
ls -1d ./docs/features/[0-9][0-9][0-9][0-9]-* 2>/dev/null | tail -1
ユーザーと協力して、次の番号と説明的な名前を選択します。
2. 計画ディレクトリを作成する
mkdir -p ./planning/NNNN-feature-name
3. アイデア研磨ドキュメントを初期化する
cat > ./planning/NNNN-feature-name/idea-honing.md << 'EOF'
# アイデア研磨: 機能名
## 初期アイデア
[ユーザーの大まかな機能の説明]
## 質問と回答
EOF
4. 初期質問を生成する
ユーザーの大まかなアイデアに基づいて、曖昧さを特定し、以下に関する質問を生成します:
- ユースケースとユーザーワークフロー
- スコープと境界
- 統合ポイント
- エッジケース
- トレードオフと制約
- 成功基準
調査する質問のリストを作成します。
5. 質問を一度に1つずつ投げかける
重要: 一度に1つだけ質問してください。
各質問について:
- 質問を明確に投げかける
- ユーザーの回答を待つ
- 必要に応じて回答を議論し洗練させる
- 内容に満足したら、Q&Aをドキュメントに書き込む
- 新たな曖昧さが生じた場合は、それを質問リストに追加する
- 次の質問に移る
6. 各Q&Aの後にドキュメントを更新する
各質問が回答された後、ドキュメントに追記します:
cat >> ./planning/NNNN-feature-name/idea-honing.md << 'EOF'
### Q: [質問文]
**A**: [回答文]
EOF
7. プロセスを発展させる
質問を進めるにつれて:
- 新たな曖昧さが生じる場合がある – それらを新しい質問として追加する
- 一部の質問が無関係になる場合がある – それらはスキップする
- プロセスは有機的に構築されていく
質問が既存のコードの動作に関するもの（例：「Xは現在どのように動作していますか？」）の場合:
- それを調査が必要としてメモする
- 他の質問を続ける
- これらは後続の調査で対処される
8. 明確になったら終了する
機能アイデアが十分に明確になったら:
- 主要な洞察を要約する
- ユーザーにコンセプトを書く準備ができているか確認する
- アイデア研磨ドキュメントは参照用として
planning/に残る
検証
アイデア研磨ドキュメントを確認する:
# ドキュメントが存在することを確認
ls ./planning/NNNN-feature-name/idea-honing.md
# 内容を確認
cat ./planning/NNNN-feature-name/idea-honing.md
よくある問題
複数の質問を同時に投げかけてしまう: 一度に1つだけ質問してください。これにより集中力が保たれ、より深い探求が可能になります。
回答を記録しない: 各質問への回答後、即座にドキュメントを更新してください。一度にまとめて更新しないでください。
早すぎる終了: ユーザーが機能のスコープとアプローチに確信を持てるまで続けてください。
次のステップ
アイデア研磨の後:
propose-feature-conceptスキルを使用して正式なコンセプトを作成する- コンセプト作成時にアイデア研磨ドキュメントを参照する
- Q&Aはコンセプトの物語の材料を提供する