to-spec について
to-spec は、会話の文脈とコードベースの理解から機能仕様を作るスキルです。ユーザーへの聞き取りは行わず、テストの seam を確認してから仕様を issue tracker に登録します。
主な機能
- 01会話とリポジトリの文脈から仕様を作成
- 02作成前にリポジトリを調査
- 03テスト seam の提案と確認
- 04指定テンプレートの使用
- 05ready-for-agent ラベル付きで登録
活用シーン
- 01既存の文脈に基づく機能要件の記録
- 02機能テストの高レベルな seam の選定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ vinvcn/ mattpocock-skills-zh-cn --skill to-specインストール後、Claude Code で/to-specを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
このスキルは、現在の会話コンテキストとコードベースの理解を使って仕様書を作成します。ユーザーにインタビューしてはいけません。すでに把握している情報だけをまとめてください。
Issue tracker と triage label の語彙は、すでに提供されているはずです。提供されていない場合は、ユーザーに /setup-matt-pocock-skills を実行してもらってください。
手順
-
まだリポジトリを調査していない場合は、まず調査してコードベースの現在の状態を把握します。仕様書では常にプロジェクトのドメイン用語集の語彙を使用し、関連する ADR に従ってください。
-
この機能をどの seams でテストするかを下書きします。新たに seams を追加するより、既存の seams を優先してください。可能な限り高いレベルの seam を使用します。seams を新たに追加する必要がある場合は、可能な限り高いレベルで提案してください。
seams は少ないほどよく、理想的には 1 つです。これらの seams が想定どおりか、ユーザーに確認してください。
- 以下のテンプレートを使って仕様書を作成し、プロジェクトの issue tracker に公開します。
ready-for-agenttriage label を適用してください。追加の triage は不要です。
問題の説明
ユーザーが直面している問題を、ユーザーの視点から説明します。
解決策
問題の解決策を、ユーザーの視点から説明します。
ユーザーストーリー
番号付きのユーザーストーリーを詳細に列挙します。各ユーザーストーリーは、次の形式に従ってください。
- As an , I want a , so that
このユーザーストーリーの一覧では、機能のあらゆる側面を十分に網羅してください。
実装上の決定事項
すでに行われた実装上の決定事項を列挙します。以下を含めることができます。
- ビルドまたは変更するモジュール
- 変更するモジュールインターフェース
- 開発者からの技術的な明確化
- アーキテクチャ上の決定事項
- スキーマの変更
- API コントラクト
- 具体的なインタラクション
具体的なファイルパスやコードスニペットは含めないでください。すぐに古くなる可能性があります。
例外:プロトタイプで作成したスニペットが、ある決定事項を散文よりも正確に表現している場合(ステートマシン、reducer、スキーマ、型の形状など)、該当する決定事項にインラインで含め、そのスニペットがプロトタイプ由来であることを簡潔に説明できます。決定事項が密に表現された部分だけを残し、動作するデモ全体は含めないでください。
テスト上の決定事項
すでに行われたテスト上の決定事項を列挙します。以下を含めてください。
- 優れたテストの説明(実装の詳細ではなく、外部動作のみをテストすること)
- テスト対象となるモジュール
- 既存の類似テストなど、コードベース内の参考例
対象外
この仕様書の対象外となる事項を説明します。
補足事項
機能に関するその他のメモを記載します。