specsfy-data-discovery

システムが保存する必要のある情報を見つける

必須の準備

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

対話モード

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

データベース、テーブル、フィールド、キー、リレーションシップについて説明を求めず、システムの情報についてブラジルポルトガル語で会話してください。その製品で使われている言葉を使いましょう。 何を記憶するか、誰が使うか、何が変わるか、いつ必要でなくなるかを尋ねてください。

会話の準備

1. Inbox、MVP.md の発見事項、バックログ、spec、または発見のきっかけとなった依頼を読みます。
2. PROJECT.md と .specsfy/DATABASE.md が存在する場合は読みます。すでに確認済みのことと、まだ会話が必要なことを分けます。
3. システムが保存、照会、比較、表示、共有、修正、または削除する必要のある情報だけを探します。ユーザーの利用経路や運用に影響しないデータについては尋ねないでください。
4. 情報源と本人の表現を維持します。仮説をデータファイル内で確認済みの内容として扱わないでください。

技術用語を使わずに質問する

各ラウンドでは、まだ確認されていない該当情報のうち、影響が最も大きいものを選び、中心となる契約に従ってください。保存すべき情報のうち、欠けているものや曖昧なものの一覧を維持します。各回答の後に一覧を更新し、すべてが確認済み、延期、または終了となるまで、次の質問を続けてください。1領域あたり最大8問という上限を守ってください。状況に合わせて、次のような質問を優先してください。

• 「各注文、人物、または対応について、何を記憶する必要がありますか？」
• 「この情報を閲覧または変更できるのは誰ですか？」
• 「同じ人が複数の注文をした場合、何を関連付けておく必要がありますか？」
• 「この情報はいつ変更され、無効になり、または削除される必要がありますか？」
• 「他の人に見せてはいけない情報は何ですか？」

内部の仕組みを説明するのは避けてください。本人が技術用語を使った場合は、回答を記録する前に、その人の業務への影響を確認してください。

各情報の記録方法を提案する

目的を理解した後、各情報の簡単な記録方法を提案し、確認を求めてください。テクノロジーやシステム内部の要素には触れず、想定される使い方に応じて提案を選びます。

• 名前、タイトル、すばやく読み取るコードには短いテキスト
• 備考や長めの説明には自由記述
• 数量、寸法、個数には数値
• 価格、請求額、割引には金額
• 予約、期限、出来事には日付または時刻
• 状況、カテゴリ、優先度には選択肢
• 確認事項にははい／いいえ
• 証明書類や添付ファイルにはファイルまたは画像

提案は製品に関する仮説として提示し、その理由を一文で説明したうえで、実際の使い方に合っているか尋ねてください。確認後にのみ「提案形式」を記録してください。同じ情報に異なる使い方がある場合は、それぞれの使い方を個別に記録してください。

確認済みの内容を記録する

回答が確認された後、以下のスクリプトにコンテキストを渡します。 製品を運用する人にも理解しやすい、ドメインに沿った名前と短い文を使用してください。

node .agents/skills/specsfy-data-discovery/scripts/\
registrar_dados_conversados.mjs \
  --project <raiz> \
  --nome "<informação do produto>" \
  --para-que-serve "<finalidade>" \
  --o-que-guardar "<informações necessárias>" \
  --formato-sugerido "<forma confirmada de registrar>" \
  --ligacoes "<o que permanece ligado a quê>" \
  --acesso "<quem consulta ou altera>" \
  --ciclo-de-vida "<quando muda, deixa de valer ou é apagado>" \
  --fontes "<caminhos de Inbox, backlog, MVP ou spec>"

保存する情報として確認済みのセクションには、確認済みの回答だけを記録してください。このセクションは、コードから確認された内容とは分けてください。自動検出された箇所は変更せず、実際のデータ、認証情報、または機微な個人情報をコピーしないでください。

引き継ぎ

• ジャーニーが保存された情報に依存する場合、ブリーフの準備完了を宣言する前に、バックログでこのディスカバリーを行ってください。
• MVP のディスカバリー中は、MVP.md を情報源として維持してください。また、インポートされたバックログに保存すべき情報がない、または曖昧な場合は、その情報ごとにこのスキルを読み込んでください。
• 仕様策定では、ジャーニーが何を記憶する必要があるか、また各情報を誰が参照できるかがデータソースに記載されていない場合、このスキルを読み込んでください。
• Inbox は質問しません。この段階に向けて、シグナルを保持するだけです。

制限事項

• 技術、内部構造、実装を選定しないでください。
• バックログ、仕様、タスク、テスト、コードを作成しないでください。
• 推測で不足を補わないでください。
• 機密情報を記録しないでください。