mcpField
K
k2f-survey-form

k2f-survey-form

github.com/suzhengドキュメント3570 回インストール2 週間前に更新
リポジトリ

k2f-survey-form について

k2f-survey-formは、K2Fパッケージを作成する前に、アンケートの内容とデザイン方針を設計するスキルです。印刷用または入力可能な調査票を作るエージェント向けに、提示された目的に沿った質問設計を支援し、研究仮説や同意文の創作を避けます。

主な機能

  1. 01アンケート内容とデザインの設計書作成
  2. 02構成概念、セクション、質問形式の定義
  3. 03尺度、質問順、回答負担の確認
  4. 04前提と未確認事項の記録
  5. 05k2fによるK2F調査票の作成と出力

活用シーン

  1. 01顧客・製品フィードバック調査の設計
  2. 02既存アンケートの再構成
  3. 03従業員・イベント評価の計画
  4. 04学術データ収集フォームの準備

インストール

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

$npx skills add https://github.com/suzheng/k2f --skill k2f-survey-form

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

詳細

K2F Survey Form — AI-Native Aesthetic Design

目的

エージェントが content_and_design.md でアンケートフォームを設計できるようにします。測定する内容、質問の範囲と順序の決め方、美的意図(中立的な信頼性、尺度のリズム、階層構造)を定めます。ユーザーから提供されていない調査仮説、サンプリング計画、同意文言は創作しません。

K2F を基盤に構築

このスキルはアンケートフォームを .K2F パッケージとして生成します。作成時は k2f スキルに従い、ワークスペースを展開または初期化し、セマンティックツリーを編集して、パッケージ化・検証・エクスポートを行ってください。K2F により、エージェントは座標ではなく、意味(セクション、プロンプト、回答形式)に集中できます。

作成を始める前に、コアスキルをインストールしてください:npx skills add suzheng/k2f --skill k2f。

使用する場面

  • 顧客フィードバック、NPS 形式の簡易調査、イベントや講座の評価、従業員エンゲージメント、UX リサーチ、学術データ収集向けの印刷可能または入力可能なアンケート。
  • 長いメール形式の質問票や従来型 PDF を、回答しやすい一貫した調査票に再設計する場合。

ワークフロー

ステップ 1. content_and_design.md を生成する

アンケートの内容とデザイン意図をまとめる単一の設計書です。k2f スキルが後で対応付けられるよう、安定したラベル付きブロック(ヘッダー、導入、セクション、質問、尺度、お礼)を使用してください。

サブステップ

  1. 調査の枠組み(トリアージ) — 何を測定するのか、誰が回答するのか、なぜ今行うのか、結果をどのように活用するのかを確定します。調査モード(顧客、製品/UX、従業員向け簡易調査、イベント評価、学術調査)を設定します。匿名性、実施チャネル、回答所要時間の目安、トーン(中立的な調査、親しみやすいブランド、フォーマル)を記録します。

  2. 測定の合意事項 — 必ず把握する構成概念を列挙し、対象外のテーマと後続回に回すテーマを明示します。不明な対象や法的文言は OPEN QUESTION / NEEDS USER INPUT と記し、IRB、GDPR、ポリシーの文面を捏造しないでください。

  3. 情報アーキテクチャ(含める/削る/統合する) — 標準的な構成:

    • ヘッダー → アンケートのタイトル、実施者/組織、任意のバージョンまたは調査回のラベル。
    • 導入(3~5行):目的、所要時間の目安、提供された範囲での機密性/匿名性、任意のブロックをスキップする方法。
    • スクリーナー(必要な場合のみ) → 対象条件または経験の有無を確認する項目。短い「はい/いいえ」形式の設問。
    • 主要ブロック → 1 セクションにつき 1 テーマ。質問の前に、そのセクションの測定目標を 1 行で示します(謎めいた見出しではなく、主張を示してから項目を並べます)。
    • 自由記述フィードバック → 上限を設けた質問は 1~2 問までとし、ユーザーが早い段階での定性的な質問を求めている場合を除き、尺度を使うブロックの後に配置します。
    • 属性情報 → 通常は最後に配置します(スクリーナーで必要な場合を除く)。明示された分析目的に関係する項目のみを収集し、原則として「知っておくとよい」だけの項目は削ります。
    • お礼/締めくくり → 感謝の言葉と、個人を特定できる形でのフォローアップが許可されている場合は任意の連絡先記入欄。 削除するもの:重複する構成概念、二重質問、誘導的または偏った表現、長すぎる自由記述、確定した何を/なぜに役立たない質問。
  4. 質問設計の確認 — 1 項目につき 1 つの構成概念を扱い、二重質問は分割します。1 ブロック内では回答形式に一貫性を持たせます。共通の尺度ラベルは一度定義して使い回し、1 つのマトリックス内で同意度と頻度を混在させないでください。分岐の意図は文章で記し、自由記述の制限を明示します。

  5. 回答負担と順序の確認 — 簡単で機微性の低い項目を先にし、機微な項目や個人を特定できる項目は後に配置します。スキャンしやすくなる場合は、共通の設問文を持つマトリックス形式の項目をまとめます。調査の枠組みから回答者の疲労が懸念される場合は、設計書で尺度を短縮する前に任意のセクションを削ります。

  6. デザイン意図 — トーン:設問文は中立的にし、親しみやすさは導入とお礼に限ります。階層構造:タイトル、実施者、セクションの目標、設問の順にします。密度:セクション間に区切りを設け、設問文と選択肢を整列し、下線だけのグリッドは使いません。リズム:尺度の行はコンパクトにし、自由記述欄は別の帯状領域にします。ブランド:控えめなデザインにアクセントカラーを 1 色だけ使い、読みやすいコントラストを確保します。

前提(尺度の選択、属性情報を省略することなど)と未解決の質問(同意、サンプリング、分析計画など)を記録します。

ルールと制約

  • スコープゲート:調査の主目的は1つにします。二次的なトピックは FUTURE WAVE に回すか、削除します。
  • 整合性ゲート:各見出しは、その下の質問だけに対応させます。該当しない質問は移動するか、セクション名を変更します。
  • 構成概念ゲート:各質問を、列挙した構成概念のいずれか1つに対応させます。「ちょっと気になる」といった理由だけの項目は残しません。
  • 尺度ゲート:各ブロックで使う尺度の基準点セットは1つにします。ユーザーから別途指定がない限り、選択肢のラベルは対称にします。
  • 事実確認ゲート:組織名、機密保持に関する主張、事前入力済みのデフォルト値は、ユーザーの入力または仮置きに基づいていることを確認します。
  • 回答負担ゲート:所要時間の上限を超える場合は、設計図の中で細かくタイプ分けするのではなく、任意のブロックを削除します。

よくある失敗パターン

  • 範囲を限定しない質問の羅列 → 優先順位付け+構成概念リスト+明示的な削除。
  • 信頼関係が築かれる前に属性を尋ねる → スクリーナーで必要な場合を除き、最後に移動。
  • 1つのマトリクスで尺度が混在 → ブロックを分けるか、尺度の基準点を統一。
  • セクションタイトルと内容が一致しない → 整合性を確認。
  • リッカート尺度のラベルが案内文のような口調 → 中立的な質問文とバランスの取れた基準点にする。
  • 自由回答の質問が多すぎる → 数を制限し、尺度を使った質問の後に配置。

品質チェックリスト

  • 概要に、何を・誰を・なぜ調査するのか、実施方法、所要時間、匿名性、測定に関する取り決めを記載する。
  • セクション構成は安定しており、各主要ブロックの冒頭に測定目標を1文で記載する。
  • すべての項目に、形式、ラベル文、尺度または選択肢の意図、構成概念との対応を記載する。
  • 分岐、任意のブロック、削除項目を文書化する。法務・機密情報に関する箇所は、情報源を明記するか、仮置きにする。
  • デザインの意図に、フォーム全体のトーン、階層、密度、リズム、ブランドを含める。
ステップ 2. content_and_design.md と k2f スキルを使って K2F ファイルを生成し、適切なファイル形式でエクスポートします。

k2f に従って設計図からセクションと回答欄を作成し、デザインの意図を適用して検証したうえで、回答可能な状態のアンケート(通常は入力可能な PDF または DOCX)をエクスポートします。

コメント