Community研究&データ分析github.com

bbulman/affinity-diagram

実際の調査ノートを人々が実際に共有するテーマに整理します。機能するにはデータが必要です。

affinity-diagram とは?

このスキルは、観察結果の山を構造化された洞察に変換するアフィニティダイアグラム作成プロセスを自動化します。主にClaude CodeのようなAIエージェント向けに設計されており、`primary.md`ファイルや`inbox/`フォルダ、`--evidence`オプションから生データを取り込みます。まず、少なくとも3人から20以上のノートを収集し、ボトムアップソートとブラインドソートを組み合わせてパターンを特定。各クラスターはトピックラベルではなく参加者の言葉で一文で命名され、発言数ではなくユニークな個人数をカウントすることで偏りを防ぎます。最終的に3〜6つのテーマに統合し、期待を覆す発見や欠落している視点を特定して報告書を生成します。このスキルは、ユーザーリサーチの生データから客観的で人間中心の構造を導き出したいUXリサーチャーやプロダクトチームにとって極めて有用です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bbulman/research-skills/tree/HEAD/skills/affinity-diagram

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

観察結果の山を、論理的に考察できる構造に変換します。プロトモードはありません。データがなければソートするものは何もありません。

~/.claude/skills/research-shared/contract.md を読んで、全体を通してそれに従ってください。$SHARED はそのフォルダを意味します。出力はアイデアフォルダ内の affinity.md です。

手順

  1. 開始. 何よりも先に、inbox/、--evidence、primary.md にデータがないか探します。ない場合は、このスキルに何が必要かを伝え、何も作成せずに停止します。その後、契約書の「実行を開始する」に従います。取り込みは新しい素材を取り込みます。 ブリーフが意思決定を命名し、取り込みが報告を終えた時点で完了です。

  2. ノートを並べる. primary.md 内のすべての抜粋と、人が指定するその他のもの(エクスポートされた付箋、フィードバックのスプレッドシート、フィールドノート)を使用します。それぞれを、1つの観察を保持するノートに分割します。 少なくとも3人から20以上のノートが揃った時点で完了です。それより少ない場合は、停止し、あとどれだけ必要かを伝え、/create-interview-script を指します。

  3. ボトムアップでソートする. リサーチクエスチョンや誰かが期待していたカテゴリは脇に置きます。ノートを1つ取り、それが属するものを見つけ、何も合わなければ新しい山を開始します。まだ何も名前をつけません。各ノートは1つの山に属します。 すべてのノートが山に入った時点で完了です。

  4. ブラインドで再度ソートする. ノートだけを持った新しいエージェントを起動し、あなたの山を見ずにソートさせます。2つを比較します。異なる場所に配置されたノートは構造が弱い箇所です。それぞれを読み直し、どこに属するかを決定します。エージェントを起動できない場合は、実行ノートにその旨を記載します。 すべての不一致が解決されるかリストアップされ、実行ノートに何個のノートが移動したかが記載された時点で完了です。

  5. 各クラスターを一文で命名する. これらの人々に共通することを、彼らの言葉で述べます:「オーナーは患者が来院しなかったことを、患者が現れなかったときに初めて知る」のように、「無断キャンセル」ではありません。 クラスター名がトピックラベルでなくなった時点で完了です。

  6. ノートではなく人数を数える. 各クラスターについて、ユニークな個人と組織を数えます。おしゃべりな人が1人いれば、何枚ノートをくれようと1つの声です。1人だけに依存するクラスターは「外れ値」に移動します。12ノートを超える山は分割します。孤立したノート1つも「外れ値」に移動し、なぜそれが際立っているのかを記載します。 すべてのクラスターに少なくとも2人が含まれ、「外れ値」にそれぞれがそこにある理由が記載された時点で完了です。

  7. テーマに積み上げる. クラスターを3〜6のテーマにグループ化します。各テーマは、ブリーフの意思決定について何を教えてくれるか、そしてその背後に何人いるかを示します。 すべてのクラスターが1つのテーマの下にある時点で完了です。

  8. 驚きを探す. チームの期待と矛盾するものは何か?壁から欠けている人々のグループはどれか? 「驚いたこと」に少なくとも1行、または [gap] がある時点で完了です。

  9. 書く. $SHARED/templates/affinity.md を埋めます。 すべてのセクションにその主張または [gap] がある時点で完了です。

  10. 終了. 契約書の「実行を終了する」に従います。次のスキルは /summarize-research、またはリアルモードでは /create-persona です。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

関連スキル