mcpField
P
plan-interview

plan-interview

github.com/secondsky開発240400 回インストール5 週間前に更新
リポジトリ

plan-interview について

Plan Interviewは、適応型インタビューを通じて粗い計画やアイデアを実装可能な仕様書にまとめるスキルです。計画の複雑さに応じて質問の深さを調整し、完全性、一貫性、明確さ、エッジケースの観点から仕様書をレビューするエージェントも備えています。

主な機能

  1. 01計画の複雑さに応じたインタビュー
  2. 026段階にわたる構造化された質問
  3. 03実装詳細を含む仕様書の作成
  4. 044つの観点からの品質レビュー

活用シーン

  1. 01機能案を詳細な仕様書にまとめる
  2. 02実装前に要件や前提を洗い出す
  3. 03仕様書の矛盾や不足を確認する
  4. 04リスク、エッジケース、運用要件を評価する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/secondsky/claude-skills --skill plan-interview

インストール後、Claude Code で/plan-interviewを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
example-spec.md
interview-techniques.md
phase-1-clarifications.md
phase-2-technical.md
phase-3-ux.md
phase-4-risks.md

詳細

計画インタビュースキル

適応型の構造化されたインタビューを通じて、粗削りな計画を包括的で実装可能な仕様に変換します。

使用する場面

  • 計画やアイデアを詳細な仕様に落とし込むとき
  • 構造化された質問を通じて要件を収集するとき
  • 粗削りなドキュメントを実装可能な仕様に変換するとき
  • 実装前に、すべてのエッジケース、リスク、ステークホルダーが考慮されていることを確認するとき

利用可能なコンポーネント

コマンド:/plan-interview:interview [plan-file]

計画の複雑さに応じて深さを調整する適応型インタビューです。

複雑さ判断材料質問数
シンプル単一機能、明確な範囲10-15
中程度複数コンポーネント、一部連携あり18-23
複雑システム横断、多数のステークホルダー22-28

使用方法:

/plan-interview:interview docs/feature-plan.md
# Output: docs/feature-plan-spec.md
エージェント:spec-reviewer

4つの観点から仕様の品質を自律的に分析します。

  • 完全性(25 点)- すべてのセクションが記入されているか?
  • 一貫性(25 点)- 矛盾がないか?
  • 明確さ(25 点)- 曖昧な表現がないか?
  • エッジケース(25 点)- エラー処理が定義されているか?

「仕様をレビューして」または「仕様の品質を確認して」と言うと起動します。

インタビューのフェーズ

  1. 基礎と範囲 - ステークホルダー、成功基準、制約、MVP の範囲
  2. 技術的な詳細 - アーキテクチャ、データモデル、スケーラビリティ、セキュリティ
  3. ユーザー体験 - ペルソナ、フロー、認知負荷、エラーからの復旧
  4. リスクとトレードオフ - リスクの分類、影響範囲、緊急時対応計画
  5. 運用化 - テスト、デプロイ、監視
  6. まとめ(任意)- 残っている課題がある複雑な計画の場合のみ

インタビューの方針

基本原則:幅より深さを重視します。すべてを表面的に扱うより、重要な側面を深く理解するほうが効果的です。

主な手法:

  • 自明でない質問 - 計画ですでに回答されている内容は省略します
  • エッジケースの探求 - 例外的な状況では何が起きるか?
  • 前提の明示化 - 暗黙の前提を明らかにします
  • 矛盾の検出 - 回答に整合性がない場合は指摘します
  • 深さの適応 - 複雑な領域は掘り下げ、明確な領域は迅速に進めます

仕様の出力構成

生成される仕様には、次の内容が含まれます。

  • 概要(問題、解決策、成功基準、ステークホルダー)
  • 機能要件および非機能要件
  • 技術設計(アーキテクチャ、データモデル、API、セキュリティ)
  • ユーザー体験(ペルソナ、フロー、状態、エッジケース)
  • リスクと軽減策(リスク一覧、トレードオフ、緊急時対応計画)
  • 実装上の注意事項(重要な決定事項、依存関係、移行)
  • 運用化(テスト、デプロイ、監視)
  • 未解決の質問と対象範囲外の項目
  • フェーズ分け(MVP と将来の計画)

参考資料

インタビュー中に詳しいガイダンスが必要な場合は、次の資料を読み込んでください。

  • references/phase-1-clarifications.md - 基礎に関する質問と注意点
  • references/phase-2-technical.md - アーキテクチャの議論パターン
  • references/phase-3-ux.md - ペルソナの作成、UX パターン
  • references/phase-4-risks.md - リスク評価フレームワーク
  • references/interview-techniques.md - インタビュー全般のスキル
  • references/example-spec.md - 注釈付きの高品質な仕様の例

コメント