unity-to-spec について
unity-to-spec は、会話の文脈とコードベースの理解を詳細な機能仕様にまとめる開発向けスキルです。テスト箇所、ユーザーストーリー、実装判断、対象範囲を整理します。
主な機能
- 01リポジトリと ADR の確認
- 02テスト箇所の検討
- 03詳細なユーザーストーリー作成
- 04テンプレートに沿った仕様作成
- 05テスト判断と対象範囲の記録
活用シーン
- 01既存コードベースに基づく機能仕様の作成
- 02機能動作をテストする箇所の特定
- 03実装判断と対象外事項の記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/unity-to-specを入力して読み込まれたか確認します。
詳細
このスキルは、現在の会話のコンテキストとコードベースに関する理解をもとに、仕様を作成します。ユーザーに質問しないでください。すでに把握している内容をまとめてください。
プロセス
-
まだ確認していない場合は、リポジトリを調べてコードベースの現状を理解します。仕様全体でプロジェクトのドメイン用語集の語彙を使用し、対象領域の ADR を尊重してください。
-
機能をテストする境界を概説します。新しい境界より既存の境界を優先し、可能な限り高いレベルの境界を使用してください。新しい境界が必要な場合は、可能な限り高いレベルで提案します。コードベース全体にまたがる境界は少ないほどよく、理想は 1 つです。
これらの境界がユーザーの期待に合っているか確認してください。
- 次のテンプレートを使用して、
docs/<feature-slug>/spec.mdに仕様を記述します。
問題の説明
ユーザーの視点から見た、ユーザーが直面している問題。
解決策
ユーザーの視点から見た、問題の解決策。
ユーザーストーリー
長く、番号付きのユーザーストーリーのリスト。各ユーザーストーリーは、次の形式にします。
- <利用者>として、<機能>がほしい。そうすれば、<メリット>が得られる。
このユーザーストーリーのリストは非常に網羅的なものとし、機能のあらゆる側面をカバーしてください。
実装上の決定事項
決定済みの実装上の事項を列挙します。以下の内容を含められます。
- 作成または変更するモジュール
- 変更するモジュールのインターフェース
- 開発者からの技術的な補足
- アーキテクチャ上の決定
- スキーマの変更
- API コントラクト
- 具体的な連携方法
具体的なファイルパスやコードスニペットは含めないでください。すぐに古くなる可能性があります。
例外：プロトタイプで作成したスニペットが、文章よりも正確に決定事項を表している場合は、該当する決定事項の中に記載し、プロトタイプ由来であることを簡潔に明記してください。動作するデモ全体ではなく、決定事項を示す部分だけを抜き出してください。
テスト上の決定事項
決定済みのテスト方針を列挙します。以下の内容を含めてください。
- 優れたテストの条件（実装の詳細ではなく、外部から確認できる振る舞いのみをテストする）
- テスト対象となるモジュール
- テストの先例（コードベースにある類似テストなど）
対象外
この仕様の対象外となる事項を説明します。
補足事項
機能に関するその他の補足事項。