1仕組みと動作原理
純粋なプロンプトオーケストレーション:実行可能コードやスクリプトは一切含まず、SKILL.md 内の指示テキスト(3ステップのワークフロー+組み込みテンプレート)のみで全機能を駆動。
/var/ytdown/skills-portal/spy-repos/mattpocock/skills/productivity/to-questionnaire/SKILL.md
Turn something the user can't answer alone into a **questionnaire**: a Markdown document they hand to one person to fill in async, or fill out together over a meeting. The recipient holds knowledge the user lacks; the questionnaire pulls it out of them.
ディレクトリ全体でも SKILL.md (2,904B) + agents/openai.yaml (166B、純粋な宣言ファイル) のみで構成。機能の実体はステップ 1→2→3 に沿ってモデルが対話を進めるオーケストレーションであり、CLI、API、ネットワークの介在はありません。
中核メカニズム「Grill the send, not the subject」:ヒアリング対象をユーザーが必ず回答できる2軸(誰に送るか/どんな成果を求めるか)に限定し、知識ギャップは生成されたアンケート側で解消。ユーザーの専門外領域についてモデルが無駄に質問を繰り返すのを防止。
/var/ytdown/skills-portal/spy-repos/mattpocock/skills/productivity/to-questionnaire/SKILL.md
**Grill the send, not the subject.** Interview the user only about the _send_, which they can always answer: who it goes to, and what they need back. The questions in the document then target the **gap** between what the recipient knows and what the user needs.
これが本スキルの成立理由です。LLMは「受信者が何を知っているか」を把握できませんが、ユーザーは送信の両端を常に明確に説明できます。ドキュメントの質問をギャップに集中させ、知識抽出をリアルタイム対話から非同期の回答記入へと委譲します。
1往復限定の規律+明示的な Done 条件による進行管理で、無限の深掘りや中途半端な成果物の出力を防止。
/var/ytdown/skills-portal/spy-repos/mattpocock/skills/productivity/to-questionnaire/SKILL.md
1. **Who is it going to?** Ask, in one exchange, the recipient's role, expertise, and relationship to the user. This fixes the questionnaire's tone and how much context it must carry. Done when you know who the recipient is and what they know that the user doesn't.
各ステップは1往復(one exchange)に限定され、自己検証可能な完了判定基準を提示(ステップ2「Done when you have a concrete list…」、ステップ3「Done when the file exists and every item the user named in step 2 is covered」)。
組み込みの固定アンケートテンプレート+構造化ルールによる出力形式の決定:非同期で記入可能、トピック別グループ化、最優先の質問を先頭に配置した Markdown ドキュメント。
/var/ytdown/skills-portal/spy-repos/mattpocock/skills/productivity/to-questionnaire/SKILL.md
Frame the document as a **discovery questionnaire**: the user lacks context, the recipient holds it. Order questions most-important-first, since async means you may only get one pass, and group them under `##` headings by theme once there are more than a handful.
テンプレートは `<questionnaire-template>`…`</questionnaire-template>` タグ(L22–50)で組み込まれており、Purpose、From-To-How used、Context、How to answer、トピック別セクション、Anything else(その他)の受け皿を含みます。
唯一の外部副作用は納品アクション:カレントディレクトリに `to-questionnaire-<slug>.md` ファイルを書き込み、パスを報告。
/var/ytdown/skills-portal/spy-repos/mattpocock/skills/productivity/to-questionnaire/SKILL.md
Write it to `to-questionnaire-<slug>.md` in the current directory (slug from the topic) and report the path.
ファイルはホストエージェントのファイル書き込み機能によってディスクに保存され、スキル自体に書き込みコードは含まれません。slug はモデルがトピックに基づいて生成し、パスのホワイトリスト検証はありません。
両ホストにおける暗黙的呼び出しの二重無効化:ユーザーによる明示的なトリガーのみ(Claude 側と OpenAI/Codex 側の双方にスイッチを設置)。
/var/ytdown/skills-portal/spy-repos/mattpocock/skills/productivity/to-questionnaire/SKILL.md
disable-model-invocation: true
SKILL.md の frontmatter で Claude 側を無効化し、agents/openai.yaml の `policy.allow_implicit_invocation: false` で OpenAI/Codex 側を無効化。2つの仕組みは同一の目的を持ち、productivity/README の「User-invoked」グループポリシーと一致しています。
2コア機能
011往復で受信者のプロファイル(役割/専門性/ユーザーとの関係性)を抽出し、トーンとコンテキスト量を調整
021往復でユーザーが回収すべき具体的な決定事項/事実リストを確定
03知識ギャップに焦点を当てた探索的(discovery)アンケート質問を生成
04アンケートをファイルとしてカレントディレクトリに出力し、ファイルパスを報告
05強制構造:Purpose + From/To/How answers used + Context + How to answer + トピック別グループ + その他受け皿
06質問クオリティの規律:1問につき1つの意図、直下に回答スタブ配置、誤読防止が必要な場合のみ _why this matters_ を付与
07明示的な完了判定:ファイルが存在し、ステップ2で挙げられた全項目が質問でカバーされていること
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠(ファイルパスと抜粋)
- 本地工作目录: ファイルの読み書きおよび成果物出力: to-questionnaire-<slug>.md(カレントディレクトリに書き込み。ファイル名の slug はトピックからモデルが推測するため、同名の過去ファイルを上書きする可能性あり)
監査ノート: 純粋なプロンプトオーケストレーションであり、スクリプト、外部ネットワーク通信、認証情報読み取り、サードパーティ依存関係は一切なく、実行可能な攻撃面は存在しません。唯一の挙動は指示に従ってカレントディレクトリに Markdown ファイルを書き込むことのみです(「ローカル読み書きのみ」に分類され、青色ランクの特性に合致)。留意点:同名ファイルの上書きの可能性、コンテンツの独立検証がない点(いずれも悪意ある挙動ではありません)。
5二重目の独立検証
- [ok] official_desc 与 frontmatter description 一致 — SKILL.md L3 原文逐字一致
- [ok] 三步工作流(步骤 1/2/3 原文存在) — L12/L14/L16 逐一确认,步骤 3 含写文件指令与 Done 条件
- [ok] 『Grill the send, not the subject』引文 — L9 原文一致,粗体标记确认
- [ok] 写文件指令 to-questionnaire-<slug>.md 在当前目录 — L16 原文含此路径模板
- [ok] 模板结构(Purpose/From-To-How/Context/How to answer/主题/Anything else) — L22–50 `<questionnaire-template>` 块内逐节确认
- [ok] 提问纪律(一问一意/answer stub/why this matters) — L40 原文确认
- [ok] openai.yaml allow_implicit_invocation: false — yaml L4–5 确认;与 SKILL.md L4 disable-model-invocation 双锁成立
- [ok] 无脚本/无隐藏文件(目录仅 2 文件) — find + git ls-tree -r 全树核对,to-questionnaire/ 下仅 SKILL.md 与 agents/openai.yaml
6結論
最適な用途: 「誰に送るか、何を得たいかを自分で明確に説明でき」、特定の専門家/同僚/顧客/上司から決定事項や事実を非同期で引き出す必要があるユーザーに最適。1回のセッションでそのまま共有できる Markdown を生成し、会議や雑談を構造化された非同期アンケートに変換可能。grill-me/grilling と併用して事前に対話で思考を整理した後にアンケート化する運用にも適しています。
不向きな用途: 受信者が複数人または不特定多数の場合(テンプレートは1対1を想定しており多くの事前コンテキストが必要);モデル自身のドメイン知識による回答の正誤判定が必要な場合;ファイル出力が不要で対話内だけで完結するシナリオ;対象者がテキストでの自己回答を行えない場合(デモやハンズオンが必要なケース)。
Install Agent-Ready
① Verified Mirror 2026-09-06
Option A · Direct DownloadDownload to-questionnaire.tar.gz
sha256:
Option B · Copy Guide for Agentfa2c2235ececc45d…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 3cca18b368.