user-context

ユーザーコンテキスト

ユーザーコンテキストには、デザイナーが頻繁に使用する製品やデザインの参考資料が保存されるため、今後のプロダクトデザイン作業を適切な情報源から始められます。

以下をユーザーから依頼された場合は、このスキルを使用します。

• プロダクトデザインをセットアップする
• プロダクトデザインを始める
• プロダクトデザインのオンボーディングを行う
• 製品やデザインの情報源を保存する
• プロダクトデザインが記憶している内容を確認する
• 保存済みの製品やデザインのコンテキストを更新する
• プロダクトデザインの設定を記憶させる
• プラグインをセットアップする

重要なオーバーライド

• 続行する前に、プラグインルーター $index を参照してください。
• $critical-overrides に従ってください。
• オンボーディングを提案したり、今後の会話のためにコンテキストを保存したりする前に、ローカルシェルにアクセスできること、$CODEX_HOME を解決できること、$CODEX_HOME/state/plugins/product-design/ が存在し、書き込み可能であるか、書き込み可能な親ディレクトリ内に作成できることを確認してください。user-context.md がすでに存在する場合は、それも書き込み可能であることを確認してください。
• 確認を完了できない場合や確認に失敗した場合、永続コンテキストは利用できません。保存済みコンテキストのオンボーディングを提案したり、新しいコンテキストが今後の会話用に保存されたと伝えたりしないでください。ユーザーが保存を依頼した場合は、現在の会話では使用できますが、今後の会話のためには保存できないことを説明してください。

保存済みユーザーコンテキスト

user-context.md が存在する場合は、デフォルトで使用してください。

保存済みの製品 URL、Figma ファイル、スクリーンショット、参考画像、コードベースのパス、Storybook、トークン、デザインシステム、ブランドアセット、コンポーネント参照、ブラウザーの設定、共有先を活用し、プロダクトデザイン作業の土台としてください。

ユーザーが別のものを指定しない限り、アイデア出し、プロトタイプ、監査、クローン、批評では、保存済みの製品コンテキストに合わせてください。

ワークフローでビジュアルを参照する必要がある場合は、関連する保存済みのスクリーンショット、参考画像、トークン、デザイン言語、コンポーネント参照を、ImageGen、アイデア出し、プロトタイプ、監査、批評の作業に添付するか含めてください。

状態ファイル

保存済みコンテキストはここにあります。

$CODEX_HOME/state/plugins/product-design/user-context.md

保存済みのスクリーンショットと参考画像は、その隣にあります。

$CODEX_HOME/state/plugins/product-design/assets/

ファイルが存在しない場合は、ユーザーがプロダクトデザインのセットアップやコンテキストの保存を依頼した場合、または現在のタスクが製品やデザインのコンテキスト不足で進められない場合を除き、通常どおり続行してください。

事前確認

プロダクトデザインのワークフローで保存済みコンテキストが必要な場合は、次を実行してください。

python3 scripts/user_context_preflight.py

返された保存済みエントリを、タスクの開始時のコンテキストとして使用してください。

スクリプトが保存済みコンテキストはないと報告した場合、セットアップ用のコンテキストが必須でない限り、現在のユーザープロンプトをもとに続行してください。

事前確認中に、保存済みの参考資料をすべて参照、開く、または調査しないでください。現在のタスクに必要な参考資料のみを確認してください。

セットアップ

ユーザーがプロダクトデザインのセットアップを依頼した場合、プロダクトデザインが記憶できる内容を尋ねた場合、プロダクトについてプロダクトデザインが知っていることを尋ねた場合、または保存する製品やデザインの参考資料を提供した場合は、references/onboarding.md を使用してください。

セットアップのみの依頼の場合は、プロダクトデザインが記憶できる内容を説明し、役立つ情報源を尋ねてください。

コンテキスト収集の依頼内容は、ユーザーの依頼に合わせて調整してください。初回のセットアップと既存コンテキストの更新では、内容が異なります。

セットアップ中は、ワークスペースの調査、依存関係のインストール、プロトタイプのひな形作成、画像の生成、監査の実施、実装の開始を行わないでください。

ユーザーから保存する参考資料が提供されたら、次を実行してください。

python3 scripts/init_user_context.py

その後、作成された user-context.md に参考資料を追加してください。

保存

役立つ、長期的に使えるプロダクトデザインのコンテキストを保存します。

• プロダクトのURL
• Figma ファイル
• スクリーンショットと参考画像
• コードベース内のパス
• Storybook とコンポーネントのドキュメント
• デザイントークンとテーマの参照元
• ブランド、ロゴ、アイコン、イラスト、画像、アセットの参照元
• 推奨するブラウザー、キャプチャツール、共有先
• 今後のプロダクトデザイン作業の精度を高めるチームの慣例

ユーザーから保存するスクリーンショットや参考画像が提供された場合は、assets/ に user-context.md と並べてコピーし、保存したエントリーからリンクします。

保存する画像には、画像の内容が分かる、明確で説明的なファイル名を付けます。ファイルを開かなくても、今後のプロダクトデザインの実行時に内容を理解できる名前にしてください。

画像名の例：

assets/chatgpt-settings-modal-dark-mode.png
assets/payment-sheet-mobile-error-state.png
assets/product-dashboard-sidebar-navigation.png
assets/storybook-primary-button-states.png
assets/brand-logo-lockup-purple-gradient.png
assets/onboarding-flow-welcome-step.png
assets/checkout-confirmation-screen.png
assets/account-menu-open-state.png

秘密情報、認証情報、API キー、プライベートトークン、コピーした顧客データ、その他永続化すべきでない情報は保存しないでください。

次の構成を使用します。

# {Category}

- Description: {what this category is and when future Product Design runs should use it}

## Saved Links And Context

{Saved reference or fact}
- Date Added: YYYY-MM-DD.
- File: assets/{clear-descriptive-name}.png
- Useful Context: {what this reference represents}
- Future Use: {how future Product Design work should use it}

保存したエントリーにローカル画像ファイルがある場合に限り、File: を含めます。

カテゴリに保存済みの参照情報がない場合は、必ず次のとおり記載します。

status: not provided

保存するコンテキストは厳選してください。考えられるすべての URL やファイルを並べるのではなく、価値の高い参照情報を少数保存することを優先します。

読み込み

• status: not provided を事実として扱わないでください。
• ローカルシェルにアクセスできる場合は、scripts/user_context_preflight.py を通じて読み込みます。
• 保存済みのコンテキストを基本情報として使用し、現在のタスクに必要なものだけを調べます。