mcpField
P
product-research

product-research

github.com/alpacalabsllc生産性39752 回インストール1 週間前に更新
リポジトリ

product-research について

product-researchは、依頼内容から候補リストを作るデザイナー向け製品リサーチスキルです。許可された情報源を検索し、出典付きの仕様と留意点を提示します。選定品の保存は、許可の範囲でproduct-libraryに引き継げます。

主な機能

  1. 01概要または詳細な依頼から調査を開始
  2. 02複数の観点から製品を検索
  3. 03製品ページから仕様を確認
  4. 04未確認の購入情報を明示
  5. 05選定したライブラリ行をproduct-libraryに委任

活用シーン

  1. 01オフィスや住宅のプロジェクト向け家具探し
  2. 02予算や寸法の条件に合う製品の選定
  3. 03在庫、納期、認証の確認
  4. 04製品選定前の候補比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/alpacalabsllc/skills-for-architects --skill product-research

インストール後、Claude Code で/product-researchを入力して読み込まれたか確認します。

同梱ファイルhost-contract.jsonREADME.md

詳細

/as:product-research — 製品リサーチ

実行前に、ホスト契約と、このコンポーネントの宣言(skill:product-research)をお読みください。共有カタログから、参照されているモードプロファイルのみを読み込みます。実際のタスクに必要なモードを組み合わせてください。宣言は要件であり、アクセス権や許可の証明ではありません。

ライブラリの変更は/as:product-libraryが担当します。選択した行と変更セット、およびエビデンスをすべて準備したうえで、既存の許可に基づき、ネイティブの保存処理を引き継いでください。担当側でバッチ全体を検証し、正確なリクエスト、プレビュー、現在の状態を関連付け、実際に公開されたことを確認します。このスキルでは、product-library.csvを独自に変更しません。

ホストアダプター:呼び出し、質問、対象へのアクセス、任意の委任については、デリバリー固有のガイダンスをお読みください。

記録の権限とホストへの引き継ぎ

構造化された証拠の引き継ぎについては、ネイティブの製品観察情報の所有者とスキーマをすべて確認してください。エンベロープ全体にネイティブの validate/validate-batch を適用し、明示的に選択した項目/現在のリビジョン/フィールドのバインディングを使ってのみ適応してください。型付きの値、出典/ロケーター/時刻、未知のステータスを正確に保持し、完全なエンベロープ、監査観察情報、競合、通知をまとめて保持してください。既存の null/空欄/ユーザーによる上書きはそのまま維持します。これは未採用の証拠であり、レビュー提案であって、仕様を書き込む権限を与えるものではありません。

プロジェクトに紐づく作業では、ネイティブのコンテキスト解決を適用し、検証済みのプロジェクト ID を使用して、プロジェクトの指示を確認してください。インラインまたは単発のソース作業では、プロジェクトを作成する必要はありません。再利用可能な CSV の保存先は product-library が所有し、採用済み仕様の ID/リビジョンは master-schedule が所有し、受け入れ済みジョブ入力は product-data-import が所有します。ディレクトリ、ソース文書、または納品時の宣言から権限を導き出さないでください。

採用済みプロジェクトスケジュール、単発のソース作業、任意の再利用可能な product-library.csv を明確に区別してください。採用済みの項目/スケジュール記録が正となります。/as:master-schedule を通じて固定されたリビジョンを読み取り、期待するリビジョン、証拠、保持された上書きとともに、変更をその所有者に提案してください。このスキルが正規の項目/スケジュール記録を独自に書き換えたり、承認を推測したりすることはありません。以下のライブラリ保存の指示は、任意の CSV ライブラリにのみ適用され、プロジェクトスケジュールを採用または更新するものではありません。

ホストは、利用可能な機能を使って提供されたワークブックを読み取り、編集します。元のファイル、選択された画像、数式、実際のハイパーリンク、無関係なセルを保持してください。採用済みスケジュールでは、採用/照合、編集前のネイティブバックアップ、検証済みの編集前/編集後の記録 CSV 復旧スナップショットを /as:master-schedule に引き継ぎ、ホストが抽出したワークブックデータとマッピングは別途保持してください。単発モードでは、ホストはスケジュールのスナップショット作成や記録の採用を行わず、ネイティブバックアップと、実際にワークブックから抽出した CSV スナップショット/マッピングをジョブ復旧ファイルに保持します。三者間の競合と削除案には、明示的な解決が必要です。ワークブックにアクセスできない場合は、完了したと偽らず、具体的に引き継いでください。単発作業では、受け入れ済みのソースは暗黙に採用されることなく、タスク入力のままです。

各観察情報には、ソース ID、ページ/URL ロケーター、取得時刻、選択済みか利用可能かの設定、単位、不確実性を保持してください。SKU の組み合わせ、寸法、仕上げの選択、価格、通貨を決して捏造しないでください。$ だけでは曖昧です。ユーザーの選択は、明示的に変更されるまで保持してください。現在の事実に関する主張には、実際にソースを取得する必要があります。アクセスできない証拠は未知のままにしてください。受け入れ済みジョブ入力と修正は /as:product-data-import が所有し、相違点は /as:product-audit が報告しますが、暗黙に適用することはありません。/as:product-cut-sheet と /as:ffe-spec-book は、入力の解決後に共有ドキュメントテンプレートとホストレンダリングを使用します。

デザイナーからブリーフを受け取り、ウェブ全体から製品を調査し、厳選した候補リストを返します。選択した製品は、最も近いプロジェクトの product-library.csv に保存できます。

仕組み

Designer gives a brief
        ↓
Host searches authorized sources
        ↓
Presents candidates with specs + reasoning
        ↓
Designer picks winners
        ↓
Saved to project product library

ステップ 1:ブリーフを受け取る

デザイナーが探しているものを説明します。ブリーフは大まかなものでも、具体的なものでもかまいません。

大まかな例:

「テック企業のオフィスロビーに置く吸音パネルが必要です」

具体的な例:

「直径 48~54 インチの円形ダイニングテーブルを探しています。天板は無垢材(ウォールナットまたはオークが希望)、脚部はスチールか真鍮、価格は 3,000 ドル未満で、在庫があるか納期が 6 週間未満のものを希望します」

ブリーフから収集する情報

デザイナーが提示した情報を、できるだけ多く抽出してください。言及されていない項目について質問せず、手元にある情報で進めてください。

項目例
カテゴリテーブル、座席、照明、吸音パネル、プランター、収納
使用場所オフィスのロビー、会議室、屋外テラス、ホームオフィス
スタイル/美的傾向北欧風、ミッドセンチュリー、インダストリアル、ミニマル、温かみのある、大胆な
素材無垢材、大理石、スチール、ファブリック、メッシュ、リサイクル素材
寸法「直径48〜54インチ」、「高さ30インチ未満」、「6x4のスペースに収まる」
予算3,000ドル未満、500〜1,000ドルの範囲、ハイエンド、予算重視
サステナビリティGREENGUARD、FSC、Cradle to Cradle、リサイクル素材の含有、B Corp
納期在庫あり、6週間以内、急ぎではない
数量主役となる1点、会議室用に12点、オープンオフィス用に50点以上
屋内/屋外屋内、屋外、両方
必須条件スタッキング可能、COM対応、ADA準拠、耐候性
避けるブランド「Ikeaは不可」、「Amazonの商品は避ける」

デザイナーに聞き取りをしないでください。 ブリーフが「ロビー用の吸音パネル」であれば、それだけで検索を始めるのに十分です。必要に応じて、最初の検索結果を提示した後で確認できます(「ファブリック、フェルト、木製ルーバーの選択肢が見つかりましたが、どれがお好みですか?」)。

ステップ 2:調査

ブリーフに合う製品をウェブで検索します。さまざまな観点をカバーするため、複数の的を絞ったクエリを使います。

検索戦略

「ウォールナットの円形ダイニングテーブル、3,000ドル未満」というブリーフの場合:

  1. カテゴリ+素材で検索:round walnut dining table
  2. デザインに焦点を当てた検索:best round wood dining tables architects designers
  3. 業務用/契約案件向け検索:contract round dining table solid wood specifications(商業プロジェクト向け)
  4. デザイナーが希望を示した場合は、特定ブランドを検索:Muuto round table、HAY dining table
  5. 関連する場合は、サステナビリティに関する検索:FSC certified round dining table

ブリーフの複雑さに応じて、3〜5件の検索を行います。さまざまな価格帯、ブランド、スタイルを含め、幅広く探してください。

見つかった候補ごとに

WebFetchで製品ページを取得し、詳細な仕様を抽出してください。ページがJSでレンダリングされていてデータを取得できない場合:

  • 検索結果は候補の特定にのみ使用し、最新かつ信頼できる別の情報源を探してください。
  • 価格、在庫状況、納期、寸法、仕上げ、認証、その他の購入に関する事実を、モデルの記憶から補ってはいけません。
  • 現在のメーカー、正規販売店、または認証機関の登録情報を情報源として確認できない変動情報には、Not verifiedのラベルを付けてください。検索スニペットを確認済みの事実として扱ってはいけません。

価格、在庫状況、納期、仕上げ、寸法、認証について述べるたびに、情報源のURLとアクセス日を記録してください。メーカーの最新製品ページまたは価格表を優先し、メーカーが情報を公開していない場合に限り、正規販売店を利用してください。Not verifiedの項目があっても候補として有用な場合がありますが、ショートリストでは未確認事項が分かるようにしてください。

目標: ブリーフに実際に合致する候補を6〜10点選びます。適合度の低い候補でリストの数を増やさないでください。

ステップ 3:候補を提示する

評価に十分な詳細を添えて、番号付きのショートリストとして結果を提示します。

Synthetic formatting input only:
Example Product A | Example Manufacturer | quantity 2 | supplied specification pending
提示ルール
  • 候補が6点以上の場合は、要約表を最初に提示してください。デザイナーは視覚的にざっと確認します。
  • 各候補に**「理由」**を含めてください。製品がブリーフに合う理由を説明し、妥協点があれば明示します。
  • トレードオフを正直に伝えてください。「無垢材ではなく突板」、「予算超過だが検討する価値あり」、「納期が長い」
  • 過剰に売り込まないでください。適合度が低い製品は、その旨を伝えるか、候補に含めないでください。
  • 有用であれば、観点ごとにグループ分けしてください。「予算重視の候補」、「プレミアム候補」、「最短納期」

ステップ 4:プロジェクトライブラリに保存する

デザイナーが候補を選んだ場合(「1、3、5を保存」など)、最も近いプロジェクトルートにあるproduct-library.csv用の行を準備します。プロジェクトルートとは、PROJECT.mdを含む最も近い祖先ディレクトリです。その外部にライブラリを作成してはいけません。

行フォーマット

正確な33列の行契約については ../../schema/product-schema.md を、ローカルファイルのルールについては ../../schema/csv-conventions.md を参照してください。選択したすべての製品と保存先のパスをプレビューし、既存の正確な承認を使用するか、不足している承認を一度だけ依頼してください。承認後、完全な行をすべて1つのJSON配列としてシリアライズし、完全なバッチを1回、product-libraryのネイティブな追記操作に渡してください。所有者が現在の状態とバッチ全体を検証してから保護された状態で公開し、新たに読み戻します。行ごとに処理を繰り返したり、永続CSVを手作業で編集したりしないでください。

スキル固有の列値:

  • AG(Source): research
  • AF(Status): saved
  • AD(Tags): ブリーフのコンテキストから設定します(例:「lobby-reno, walnut」)
  • AE(Notes): プレゼンテーションにおける「理由」の説明
  • T(Selected Color/Finish): 空欄(デザイナーはまだ設定していません)
保存後
✓ Saved 3 products to your library (rows 48-50).
  Tagged: lobby-reno, walnut

Want me to refine the search? Different style, budget, or materials?

ステップ5(任意):反復する

デザイナーは、次のような調整を希望する場合があります。

  • 「#1に似ているけれど、もっと安いもの」 → 同じスタイル/ブランド層で代替品を検索します
  • 「屋外向けのものはありますか?」 → 条件を追加して新たに検索します
  • 「#3の仕様書PDFを見つけてもらえますか?」 → メーカーのカットシートを検索します
  • 「#1と#3を並べて比較してください」 → 詳細に比較します
  • 「この中にGREENGUARD認証を取得しているものはありますか?」 → 最終候補の認証を確認します

各反復で、ライブラリに製品を追加できます。

会話スタイル

  • 検索前に質問しすぎないでください。 検索を始めるには1行のブリーフで十分です。
  • 結果を見せてから調整してください。 すべての条件を最初に指定するより、実際の選択肢を見て反応するほうが効率的です。
  • 明確な見解を示してください。 デザイナーが求めているのは、検索エンジンではなく、知識のある調査アシスタントです。最適な選択肢を示し、トレードオフに触れ、代替案を提案してください。
  • 業界に詳しくあってください。 関連するブランド、デザイナー、業界向けプラットフォームに言及してください。コントラクト向けと住宅向け、COM/COL、リードタイム、認証について理解してください。

メモ

  • JSで描画される製品ページはよくあります(Hem、Muuto、Vitraなど)。ネイティブな取得でデータが得られない場合は、検索結果を候補の発見にのみ使用し、最新の信頼できる情報源を探してください。購入に関する情報は、引き続き未検証として扱います。一般知識で補わないでください。
  • ライブラリは共有されています。 このスキルの製品は、一括取得によるインポートやPDFから抽出したデータと並んで保存されます。Sourceフィールド(research)で、各行の情報源を識別します。

製品の一次資料による根拠

タスクでは、選択したメーカー、製品、バリエーションの正確な情報を一次資料から取得してください。例示データは架空のものであり、根拠として使用できません。製品情報、認証、価格、ベンダーのフォーマット定義を、再利用可能な参照知識としてプラグインにコピーしないでください。未解決の値はそのまま保持し、代表的な画像と実際に選択したバリエーションを区別してください。

ネイティブ出力と所有者への引き継ぎ

依頼された永続的な作成レポートでは、正確な座標ベースの配置、クエリ、登録のために、receive のネイティブなドキュメント所有者を使用します。ラベルからプロジェクトフォルダーを組み立てないでください。単発レポートでは、明示的に許可された出力先のみを使用し、スタジオやプロジェクトの設定は不要です。正式に採用された改訂版や再利用可能なライブラリへの保存は、引き続き各所有者が管理します。既存の明示的な許可は有効です。不足している素材の範囲またはネイティブ権限のみを取得してください。

このスキルが実際に保存または編集する出力には、影響を受ける対象の全体に対してネイティブ変更シーケンスを適用してください。元のバイト列とアクセス権、ソース/アイデンティティのガード、準備済み出力全体、不在状態/事前条件を保持します。永続的な保存を完了し、最初の公開処理の前に、保持したすべての内容とアクセス権、および準備済みのすべての内容を独立して再読み込みしてください。該当する場合は、無関係なデータと実際のワークブック機能を維持します。実際のすべての出力先について、バイト列全体とモード/該当する所有権/ACL を再度開いて確認し、完了を報告する前に変更、ソースの系譜、保護対象の原本を検証してください。バイト列が正しいこと、作成モードの引数、または出力されたレシートだけでは不十分です。保護がサポートされていない場合や公開に不確実性がある場合は、復旧用の証拠を残してブロック/保留状態にします。

選択したモードに適したネイティブ機能を使用します。選択した方法で必要な場合を除き、プロセスの実行は任意です。Arch Studio ランナー、実行ファイルのダウンロード、ソースの再構築は必要ありません。読み取り専用またはインラインでの作業には、書き込み機能は不要です。実際の調査/抽出、検証済みの提案、独立して検証された所有者による保存は、それぞれ分けて報告してください。実際の証拠がない限り、所有者への引き継ぎが完了したと主張しないでください。

ネイティブなワークブック保持の比較

明示的に選択された変更前/変更後のネイティブ .xlsx または .xlsm のペアと、許可されたセル編集が利用可能な場合は、ワークブック比較の所有者を完全に読み込み、実際の ZIP/XML 検査を行うネイティブな workbook_preservation.compare を実行してください。正確なメンバーのバイト列、宣言されたワークシート/セルの側面、数式とキャッシュの区別、XML の空白規則を維持してください。この読み取り専用の比較は、編集を許可するものではなく、タスクで必要とされる対象セルの実際の読み戻し、バックアップ、機能検査、再計算、または目視検証の代わりにもなりません。プロバイダー形式やバイナリ形式、および検査精度が得られない場合は、明示的な制約として残してください。そうした制約を隠すためにワークブックを再保存/変換してはいけません。Arch Studio のヘルパーやプロセスランタイムは必須ではありません。

コメント