specsfy-mvp-milestone-interviewer

開発要件を含むMVPを確認する

必須の準備

このスキルを実行する前に、プロジェクトのルートで $specsfy-setup を必ず読み込んでください。自動ハンドオフの場合は、この手順の前に再度読み込んでください。会話内で確認済みのルートを再利用し、セットアップで未解決の項目が示された場合は先に進まないでください。

対話モード

対話モード：perguntas。 質問を作成する前に、.specsfy/Spec.md の「番号付き質問の契約」を読み、適用してください。

このスキルは、MVP の入力をオーケストレーションします。MVP.md をマイルストーン 1.0 としてインポートし、開発要件のみを選択して、選択した各要件の候補バックログを作成します。ビジネスコンテキストはソースファイルに残します。続いて、各バックログへの聞き取りを担当するスキルを読み込み、各段階で結果が確認されてから次に進みます。

利用可能なコンテキストを読み込む

1. ファイルを読む前に、利用するプロジェクトのルートを特定してください。Git サブモジュールの場合は、git -C <raiz> rev-parse --show-superproject-working-tree を使ってスーパープロジェクトを確認してください。出力が空でない場合は、その親ルートのみを検索対象に追加してください。それ以外の親はたどらないでください。

2. 利用するルートに通常ファイルとして MVP.md がある場合は、それを読み込んでください。ファイルがなく、ルートがサブモジュールの場合は、スーパープロジェクトの MVP.md を読み込んでください。ローカルのファイルを優先します。参照したソースを記録し、会話で相手が伝えた内容に置き換えず、申告されたコンテキストとして使用してください。

3. 最初の質問をする前に、インポーターを一度だけ実行してください。

   node \
     .agents/skills/specsfy-mvp-milestone-interviewer/scripts/importar_mvp.mjs \
     --root <raiz>
   

   インポーターは MVP.md から specs/milestones/M01.md を作成し、開発可能なソフトウェア成果物に分類できるテーマに限ってバックログと仕様書を作成します。ビジョン、対象ユーザー、原則、コンテキスト、指標、および構築する動作を伴わないその他の記録は、MVP.md にのみ残します。これらについて Inbox を作成したり、マイルストーンにコピーしたりしないでください。 開発ファイルを書き込む前に、インポーターは、Problema、 Público、Resultado、Contexto などの明示的なラベル、または明確な機能を示す文が該当箇所にある場合に限り、デフォルト値を適用します。 これらのデフォルト値は、根拠とともにバックログと出力 JSON に記録してください。該当箇所から回答を裏付けられない場合は、妥当そうな値を作成せず、未記入のままにしてください。各バックログには、インポートした箇所の記録ブロックが保持されます。 作成時点ではバックログを Captured とし、最後に Draft 仕様書を作成して Promoted としてその仕様書を参照するようにします。仕様書の Definition Gate: Pending は維持します。M01.md が存在する場合は、どのファイルも上書きせず、担当者に知らせてください。

4. BRAND.md も同じ順序で読み込んでください。まず利用するルートを確認し、サブモジュールの場合に限ってスーパープロジェクトをフォールバック先とします。質問中は、ブランドの言語、対象ユーザー、提案内容、制約との一貫性を保つために使用してください。その内容を派生成果物にコピーしないでください。

5. インポーターが作成した各バックログのソースとして MVP.md を記録してください。コンテキストファイルを作成、移動、変更しないでください。

6. 重複や矛盾の回避に役立つ場合に限り、PROJECT.md、Inbox、既存のバックログ、仕様書を読んでください。これらは、今回のセッションで受け取った内容とは引き続き分けて扱ってください。

7. インポーターが返す JSON を、セッションで処理するバックログの順序付きキューとして扱ってください。各項目には title、backlog、spec が含まれます。コンテキストのみのテーマは MVP.md にのみ残るため、キューには含まれません。

インポートする前に、Inbox と同じ機密データの確認を行ってください。ソースに認証情報、トークン、秘密鍵、または機微な個人情報が含まれている場合は、マイルストーンを生成せず、その値をメッセージに転載しないでください。

セッションを保持する

1. 最初に受け取ったテーマから、DESC-AAAAMMDD-<slug> 形式の安定した識別子を導出します。
2. ユーザーの各回答の後、同じセッションと次のターンを持つ別の Inbox に意味内容を記録します。ユーザーが 1、2、3 のいずれかだけで回答した場合は、--input、--summary、--signals などの各フィールドを作成する前に、その数字を選択肢の全文に置き換えます。入力された文字列そのものはやり取りの追跡情報に含めてもかまいませんが、マイルストーンのコンテキストとして使用してはいけません。以前の記録を編集、統合、置換してはいけません。確認のために提示したマイルストーンの仮説も、Inbox に記録します。
3. すべての呼び出しで --sources を指定します。参照した MVP.md と BRAND.md のパスを、スーパープロジェクト由来の場合も含めて列挙するか、ファイルが存在しなかったことを示します。
4. 書き込みの前に毎回、$specsfy-01-inbox の機密データのトリアージを適用します。トリアージによって記録できない場合は、安全に記録できるテキストを受け取るまで会話を中断します。
5. 分析、要約、メタデータ、生成するマイルストーンは、ブラジルポルトガル語で記述します。原文または回答の文字列が別の言語の場合は、引用としてのみ保持し、その解釈をブラジルポルトガル語で記録します。

Inbox スクリプトを使用し、記録フィールドにセッションを追加します。

node .agents/skills/specsfy-01-inbox/scripts/capturar_inbox.mjs \
  --input "<texto integral da pessoa>" \
  --title "<tema da descoberta>" \
  --session "DESC-AAAAMMDD-<slug>" \
  --turn "<número sequencial>" \
  --sources "<situação de MVP.md e BRAND.md>" \
    [campos de análise da Inbox] [--root <raiz>]

質問する前にデフォルトを解決する

インポート後は、各テーマを次の順序で扱います。

1. 原文の該当箇所、「自動適用されたデフォルト」、バックログ、マイルストーン M01 を読み直します。
2. MVP に明示的な記述がある、またはインポーターが記録した明確な表現によって入力済みのフィールドは、確認済みの回答として扱います。
3. MVP と実質的に適合する選択肢が一つだけの場合は、それを明白なデフォルトとして適用し、正規化した表現と出典を記録します。すでに明確な回答について確認を求めてはいけません。
4. 複数の妥当な解釈、出典間の矛盾、または情報の欠落がある場合は、黙って選択してはいけません。その点だけを次の番号付き質問にし、最も適合する候補を先に提示します。
5. 各回答の後、すべてのフィールドを再評価します。すでに回答済みの質問を繰り返したり、根拠のあるデフォルトを確認するための質問を新たに設けたりしてはいけません。

質問を提示するのは、MVP に回答がない場合、実際の選択が必要な場合、または曖昧さや矛盾がある場合に限ります。インポート結果には、自動的に解決した内容と、ユーザーの回答がまだ必要な内容を明確に示します。

開発対象を絞り込む

$specsfy-02-backlog を読み込む前に、テーマを分類します。

1. 開発可能：機能、画面、フロー、統合、データ、自動化、実行可能なルール、またはシステムの振る舞いを記述しています。バックログと Draft 仕様を作成します。
2. 背景情報：ソフトウェアの提供物を明示せずに、ビジョン、対象ユーザー、ポジショニング、原則、課題、指標、前提、背景、または制約を記述しています。MVP.md に保持し、Inbox、バックログ、仕様を作成してはいけません。
3. どちらか判断に迷う場合は、該当箇所自体に 開発する、実装する、作成する、可能にする、登録する、参照する、統合する など、検証可能な構築を示す動詞または目的語がある場合に限り、開発可能と分類します。それ以外は背景情報として扱い、その理由を記録します。

将来の実装に役立つ可能性があるという理由だけで、製品の説明をバックログに変えてはいけません。バックログには、このインポートで開発する提供物を記載します。

スキルの発見をオーケストレーションする

インポーターが返したキュー内の各項目について、責務を省略せずに次の手順を実行します。

1. 自動遷移：$specsfy-mvp-milestone-interviewer から $specsfy-02-backlog へ；理由：MVPから派生したバックログをヒアリングするため； 期待される結果：回答が確認された、洗練済みのバックログ と告知し、 候補のバックログパスに対して $specsfy-02-backlog を読み込みます。
2. まず、そのバックログに付随するMVPの記録を読み、すでに明示されている回答の記入に使用します。残っている不足、曖昧さ、矛盾に対してのみ、適応型のヒアリングを行います。1回につき質問は1つとし、数値選択肢は選択肢の文面で解決し、領域ごとの質問数は8問以内にします。
3. バックログまたはヒアリングで、保存すべき情報が欠落している、または曖昧だとわかった場合は、$specsfy-data-discovery への遷移を告知し、データのヒアリングを完了してから、コンテキストとして .specsfy/DATABASE.md を用いてバックログに戻ります。
4. 各バックログの後、このスキルに戻り、セッションの要約に項目の状況を記録してから、キューの次のバックログに進みます。このスキルはMVPのインポートのために呼び出されているため、各バックログの自動調整が完了したら $specsfy-03-specify を読み込み、それに基づくDraft仕様を作成します。セクション10ではメニューとメインナビゲーションの領域を維持します。MVPに記載されている内容を使い、情報がない場合は 保留 とします。コードを実装せず、タスクを実行せず、Definition Gateを昇格させないでください。
5. キューの処理が終わったら、開発可能な各テーマにバックログとDraft仕様があり、コンテキストのみのテーマからSpecsfyにアーティファクトが生成されていないことを確認します。specsfy milestones sync --project <raiz> を実行し、$specsfy-milestone-governor を読み込んで、M01 の関連付けと進捗を確認します。Draftの自動生成は、実装や最終検証を許可するものではありません。

適応型の会話を進める

1. 目的、対象者、観察可能な問題から始めます。
2. 収集のたびに、セッション内のすべてのInboxを読み直します。受け取った記述と会話上の仮説を分けた、短い要約を提示します。
3. 中核となる契約に沿って質問のラウンドを組み立てます。番号付きの質問を1つ、具体的な選択肢、別の回答を入力、次へ を用意します。
4. ジャーニー、必須データ、役割、ルール、統合、制約、デモ、検証を理解するために必要な範囲だけを掘り下げます。明確でない保存対象の情報については、それぞれ $specsfy-data-discovery を読み込み、次の項目に移る前にその調査を完了します。固定フォームを適用せず、すでに保持されている回答を繰り返し尋ねないでください。
5. 対象者がある領域を終了または延期した場合は、その人の記述を記録し、要約に該当するInboxを示します。不足情報を独自に補わないでください。

終了と後続対応

終了時には、セッションの識別情報、M01、生成されたバックログとDraft仕様の順序付き一覧、確認済みの回答、保留 としてマークされた項目を伝えます。その他のテーマは引き続き MVP.md に記載されていることも伝えます。仕様の生成をもってインポートは終了します。実装、最終検証、ゲートの昇格は、別途許可された段階で行います。

制限事項

• 回答、目的、終了条件、スコープ外の項目、マイルストーンとの関連付けを創作しないでください。
• マイルストーン1.0や既存のバックログを上書きしないでください。
• インポーターが生成したバックログのヒアリングを省略しないでください。
• インポート中にコードを実装したり、ゲートをPassedとしてマークしたりしないでください。
• Inboxを規範的な情報源として扱わないでください。
• 確認なしにMVPを拡張するため、ロードマップインタビュアーを使用しないでください。