mcpField
P
paw-ps-research-to-brief

paw-ps-research-to-brief

github.com/pawbytesマーケティング・グロース115145 回インストール4 週間前に更新
リポジトリ

paw-ps-research-to-brief について

検証済みの製品調査を、証拠や未解決事項を残した構造化ブリーフにまとめるワークフロースキルです。調査資料を統合し、出典を追跡したい製品チーム向けです。

主な機能

  1. 01利用可能な調査ファイルの収集
  2. 02入力の完全性確認
  3. 03構造化された製品ブリーフの作成
  4. 04証拠と不確実事項の記録
  5. 05非対話実行への対応

活用シーン

  1. 01製品調査からブリーフを作成
  2. 02統合前に情報不足を特定
  3. 03ブリーフの判断根拠を追跡

インストール

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

$npx skills add https://github.com/pawbytes/skill-suites --skill paw-ps-research-to-brief

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
01-gather-inputs.md
02-validate-completeness.md
03-synthesize-brief.md
04-preserve-signals.md

詳細

リサーチからブリーフへ

概要

検証済みのリサーチ成果を、明確で構造化されたプロダクトブリーフに変換する決定論的なワークフローです。このパイプラインでは、統合の過程で証拠や不確実性が失われないようにします。

引数： 非対話型で実行するための --headless / -H を受け付けます。

出力： シグナル（証拠と不確実性）を保持したプロダクトブリーフ文書。

パイプライン

ステージ 1：入力の収集

./references/01-gather-inputs.md を読み込みます。

プロダクトワークスペースから、関連するすべてのリサーチファイルを収集します。

  • ディスカバリーの成果物（product-context.md）
  • 市場インテリジェンス（market-intelligence.md）
  • オーディエンスインテリジェンス（audience-intelligence.md）

進行条件： 少なくとも 1 つの入力ソースが見つかったら進みます。

ステージ 2：完全性の検証

./references/02-validate-completeness.md を読み込みます。

入力がブリーフの統合に必要な最低基準を満たしているか評価します。不足項目を特定し、利用可能なデータで進めるか、追加リサーチが必要であることを示します。

進行条件： 最低限の入力要件を満たす、または不足項目を記録したうえで明示的に進行を決定したら進みます。

ステージ 3：ブリーフの統合

./references/03-synthesize-brief.md を読み込みます。

検証済みの入力を 1 つの文書に統合し、構造化されたプロダクトブリーフを作成します。一貫した書式を適用し、ソース資料まで追跡できるようにします。

進行条件： ブリーフの構成が完成し、必須セクションがすべて埋まったら進みます。

ステージ 4：シグナルの保持

./references/04-preserve-signals.md を読み込みます。

主要な証拠ソースと未解決の不確実性を記録します。意思決定をリサーチ結果に結び付ける、シグナル保持用の注記を作成します。

進行条件： すべてのシグナルが記録され、ブリーフまたは意思決定ログに追加されたら完了です。

起動時

  1. プロダクトワークスペースのルートを特定します：{project-root}/.pawbytes/prodig-suites/
  2. .pawbytes/prodig-suites/active-product.md が存在する場合は、アクティブなプロダクトコンテキストを特定します
  3. アクティブなプロダクトが設定されておらず、ヘッドレスモードでもない場合は、ユーザーにプロダクトスラッグの指定を求めます
  4. ステージ 1 からパイプラインを開始します

入力ソース

ソースファイルパス必須
ディスカバリー.pawbytes/prodig-suites/products/{product-slug}/product-context.md推奨
市場リサーチ.pawbytes/prodig-suites/products/{product-slug}/market-intelligence.md推奨
オーディエンスリサーチ.pawbytes/prodig-suites/products/{product-slug}/audience-intelligence.md推奨

最低要件： 3 つの入力ソースのうち、少なくとも 1 つを利用できること。

出力構成

.pawbytes/prodig-suites/products/{product-slug}/
├── product-brief.md              # Main brief document
├── signal-notes.md               # Evidence and uncertainty log
└── product-decisions.md          # Appended brief metadata (if exists)

出力仕様

実行のたびに、以下を出力します。

  • アクションの種類： リサーチ入力からのブリーフ統合
  • 保存ファイル：
    • product-brief.md — 構造化されたプロダクトブリーフ
    • signal-notes.md — 証拠と不確実性の保持
  • 推奨事項： 次のステップ（例：ステークホルダーとの検証、デザインフェーズの開始）
  • 保存先： .pawbytes/prodig-suites/products/{product-slug}/

ヘッドレスモード

--headless または -H で起動した場合：

  1. .pawbytes/prodig-suites/active-product.md からアクティブなプロダクトの読み込みを試みます
  2. 見つからない場合は、最終更新日時が最も新しいプロダクトワークスペースを検索します
  3. プロンプトを表示せずに、すべてのステージを実行します
  4. 不足項目や仮定をシグナル注記に記録します
  5. 成功時はステータスコード 0、最低限の入力要件を満たさない場合は 1 で終了します

品質ゲート

ステージゲート条件
入力の収集入力ファイルが 1 つ以上見つかっている
完全性の検証最低限の入力基準を満たしている、または進行の決定が記録されている
ブリーフの統合必須のブリーフセクションがすべて埋まっている
シグナルの保持すべての証拠と不確実性が記録されている

コメント

Markdown 対応