Grill me visually
最初の部分はオリジナルのgrill-meをそのまま記載します。その後、同じ質問をアーティファクトページ上で視覚的に行う方法を説明します。
Grill-me
共有理解に達するまで、ユーザーに執拗に質問を続けます。これをデザインツリーとしてマッピングします。すべての決定は、それに依存する決定へと分岐します。
ツリーをラウンドで進めます。フロンティアとは、前提条件がすでに確定しているすべての決定、つまり、まだ聞いていない回答を推測することなく_今_質問できる質問のことです。1ラウンドでフロンティア全体を質問します。各質問に番号を付け、推奨回答を示します。その後、次のラウンドに進む前にユーザーの回答を待ちます。
ラウンドは次のようにフォーマットします。
❓ **Q1** - **<質問タイトル>**: <質問本文、複数段落になる場合があり、複数の選択肢を含む>
➡️ <推奨回答>
---
❓ **Q2** - **<質問タイトル>**: <質問本文、複数段落になる場合があり、複数の選択肢を含む>
➡️ <推奨回答>
「はい」が推奨回答を受け入れるように各質問を表現します。
各ラウンドでユーザーが回答するとツリーが再形成されます。確定した決定はフロンティアを押し広げ、それに依存していた質問のブロックを解除します。フロンティアを再計算し、次のラウンドの質問をします。回答が同じラウンドの別の未解決の質問に依存する質問は、_今_のラウンドではなく_後の_ラウンドに属します。
_事実_を見つけるのはあなたの仕事であり、決してユーザーの仕事ではありません。フロンティアの質問に環境(ファイルシステム、ツールなど)からの事実が必要な場合は、新しいコンテキストウィンドウを持つサブエージェントを派遣してそれを探します。自分で調べられることをユーザーに尋ねてはいけません。これをブロックにしてはいけません。実行中の調査は未確定の前提条件であるため、そのサブエージェントの報告を待つのは下流の質問だけです。フロンティアの残りの質問は今すぐ行います。_決定_はユーザーのものです。それぞれをユーザーに提示し、待ちます。
フロンティアが空になった時点でセッションは終了です。デザインツリーのすべてのブランチが訪問され、暗黙のうちに仮定されたものは何も残っていません。ユーザーが共有理解に達したことを確認するまで、それに基づいて行動してはいけません。
ラウンドがアーティファクトになる方法
上記のすべては引き続き有効です。変更されるのはラウンドが存在する場所だけです。チャット内のテキストの代わりに、アーティファクトページ(テンプレート assets/template.html)上のレコードを使用し、ユーザーはボタンとコメントで回答します。
| grill-me内 | ページ上 |
|---|---|
❓ Q1 - タイトル: 質問本文 | 質問ブロック: 番号、タイトル、コンテキスト行 |
➡️ 推奨回答 | 緑色のバッジ「推奨: ...」 |
| 「質問内の選択肢」 | 選択肢Aと選択肢B、それぞれに独自の表示、長所と短所 |
| 「はい」で推奨を受け入れ | 推奨された選択肢のボタン、または「OK」 |
| ユーザーのテキスト回答 | A / B / その他 または OK / いいえ のボタンとコメント |
| 解決済み | 「確認済み」セクションの1行 |
視覚的に表示するもの
ラウンドの各質問は、4つの種類のうちの1つのブロックです。最も簡単な種類を選んでください。モックアップはテキスト行よりもコストがかかり、余分な画像は読みにくさの原因になります。
| 種類 | いつ | 内部 | ボタン |
|---|---|---|---|
ui | 画面の見た目や操作方法(配置、ボタン、ナビゲーション、ステップの順序、どこに何が表示されるか)に関する質問 | 推奨; 左にA、右にB(必要に応じてC、D...); それぞれにモックアップ、その下に長所と短所 | A · B (· C…) · その他 |
logic | 画面ではなくルール(誰が何をするか、ステータス、期限、価格、データ)に関する質問 | 推奨; 表: 側面 · A · B (· C…) | A · B (· C…) · その他 |
ok | 選択肢がなく、あなたの提案が1つだけの場合 | 提案のテキスト | OK · いいえ |
plain | すでに解決済み(チャット内、過去のラウンド、プロジェクト文書内) | 「確認済み」の1行 | — |
すべての質問とすべての選択肢は、アンケート内のみに配置します(作成者ルール)。選択肢を比較するために別のアーティファクトを作成してはいけません(たとえ多数あっても)。同じ質問にC、D、Eとして追加してください(フィールド c…f、references/items.md を参照)。通常は2つで十分です。3つ目以降は、ユーザーがさらに選択肢を要求した場合、または実際に3つ以上の選択肢がある場合にのみ使用します。
ui モックアップのルール:
- AとBの違いが目に見える場合にのみモックアップを描画します。違いが言葉の場合は
logicまたはokです。 - 選択肢が異なる部分と、それが画面上のどこにあるかを理解できる最小限のコンテキストを表示します。細部まで含めた画面全体は不要です。
- AとBは同じフレーム、同じデータ、同じ初期状態で描画します。そうすることで、目は違いだけを見ることができます。
- プロジェクトの実際のデータ(名前、価格、ユーザーの用語)を使用します。架空のもの(名前、金額)はヘッダーの
{{NOTE}}で注記します。 - 複数ステップのシナリオの場合、選択肢ごとに1つのモックアップで十分です。ステップは上から下に進み、ユーザーの操作はグレーの注釈(「「カート」を押した」)で示します。
- 長所と短所は選択肢ごとに2~3個、1行ずつです。
- モックアップの種類: ボットの場合はTelegramチャット(
tg)、アプリやウェブサイトの場合は電話またはブラウザ(枠付きhtml)。フィールドとクラスはreferences/items.mdを参照してください。
アーティファクトの外観
ページはコンパクトで落ち着いています。標準のテキストサイズ(14px)、大きな見出しなし、小さな余白、装飾や不要なテーブル、導入段落などの無駄はありません。ライトテーマとダークテーマをサポートします。これらはすべてテンプレートに組み込まれています。デザインを変更せず、レコードのみを変更してください。
上から下へ:
- ヘッダー: 小さなグレーの行 — ボードの対象; タイトル「アンケート: <テーマ>」; 「ここで直接回答してください...」の1行; オプションの但し書き(
{{NOTE}})。 - 「その他」: 1つのテキストフィールドと「保存」ボタン — アンケートから出ずにチャットにメッセージを送信: 以下のどの質問にも関連しない質問、指摘、または依頼。フィールドは1回限りです。ラウンドの解析後、クリアされます。
- 「確認が必要」 と未回答の質問数。各質問は1つのブロック:
- 番号、タイトル、必要に応じて「これを最初に」の注釈;
- 必要に応じてグレーのコンテキスト行;
- 緑色のバッジ「推奨: ...」(
uiとlogicの場合); - 種類に応じたコンテンツ:
ui— 列、左にA、右にB(3つ目の選択肢の場合は3列、4つ以上の場合は2列ずつ)、それぞれにラベル、モックアップ、その下に長所(+)と短所(−); 電話では列が縦に積み重なります。logic— 表「側面 · A · B (· C…)」。ok— 提案のテキスト; - コメントフィールド;
- 下部のボタン: 選択肢ごとに1つのボタンと「その他」(
okの場合は OK · いいえ)。「その他」にはコメントが必要です。
- 「確認済み」 と解決済みの数: 番号付きリスト、各行に日付と解決策を1文で; 行の下にグレーでユーザーのコメント(あった場合); 小さなリンク「質問に戻す」。
回答された質問はすぐに最初のセクションから2番目のセクションに移動します。
手順
-
準備. スキル
artifact-capabilitiesとartifact-designをロードします。Artifactツールは公開前にこれらを必要とします。ToolSearch でArtifactDataをロードします。 -
ページ. ページコードはすでに準備されています —
assets/template.html; 新しいページは作成せず、テンプレートをプロジェクトにコピーし、データベースを介して質問を入力するだけです。フォルダがObsidianストレージにある場合は.code/grill/<テーマ>.htmlに配置し、そうでない場合はプロジェクトフォルダまたはスクラッチパッドに配置します。3つのプレースホルダを置き換えます:{{TITLE}}(2か所) — テーマ名、2~4単語、例「bot Coffee Shop」。テンプレートではその前に「アンケート: 」がすでにあります — これにより、ページは他のアーティファクトの中ですぐに認識されます(作成者の決定)、完全なタイトルは「アンケート: bot Coffee Shop」になります;{{SUBTITLE}}— 対象の説明、例「クライアント Coffee Shop · Telegram ボット」;{{NOTE}}— 「モックアップの名前と金額は架空のものです」などの但し書き、または空の文字列。
ファイル内のその他は変更しないでください。そのテーマにすでにそのようなボードがある場合は、それを使用します: Artifact
readでURLを読み取り、urlを指定してpublishします。 -
公開. Artifact publish、
icon: "checklist"、capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}。write: adminルールは、所有者と編集者のみが回答でき、閲覧リンクを受け取った人は閲覧のみ可能であることを意味します。assetsはモックアップ内の実際の写真に必要です。アーティファクトにアップロードし(asset: true)、レコードに/_blob/<id>リンクを設定します。 -
ラウンド. ArtifactData
batchをコレクションitemsに対して1回呼び出します。フロンティアの質問ごとに1つのドキュメントと、すでに解決済みのためのplain行を含めます。順序はフィールドorderで指定します。最も緊急の質問にはfirst: trueをマークできます。 -
受け渡し. URLを提供し、数行でラウンドの質問を述べ、「回答しました」と書くように依頼します。ページはあなたに回答を通知しません。すぐに回答が必要な場合は、チャットでも質問し(AskUserQuestion)、自分で回答をデータベースに記録します — ページが記録したのと同じ方法で。
-
回答の読み取り. ArtifactData
listでコレクションitemsを取得します。status: "done"とフィールドanswerを持つ各レコードについて:a、b、ok、no— 決定が受け入れられ、ページはすでにsummaryを記録しています。コメントが決定を明確にする場合は、summaryを1行で書き換え、実際に決定された内容が反映されるようにします。other— コメントを読みます。それが完成した解決策の場合は、summaryを1行で書き換えます。新しい選択肢や逆質問の場合は、新しい選択肢を追加してレコードをopenに戻すか、新しい質問を作成します。- 決定をプロジェクトがそれらを保存する場所(プロジェクトボード、仕様書、ADR)に移動します(そのような場所がある場合)。
さらに「その他」を読み取ります — ArtifactData
getでドキュメントotherをコレクションmetaから取得します。これはユーザーからチャットへのメッセージです。チャットメッセージとして扱います — チャットで返信し、リクエストを実行し、決定をプロジェクトが決定を保存する場所に記録し、新しいアイデアは次のラウンドで質問として作成します。その後、フィールドをクリアします:updateをif_versionで実行し、text: ""とし、reply、replyAt、atを削除します({"__delete__": true})。何も失わないでください。必要なものはすべて、チャット、ボード、または質問にすでに記録されています。その後、フロンティアを再計算し、同じ
batchで次のラウンドを追加します。 -
終了. フロンティアが空になったら、結果を簡潔に要約し、共通の理解が得られたかどうかを尋ねます。
記録ルール
- 既存のドキュメントへのレコードは、最後の読み取りからの
if_versionを使用してピン留めします。あなたが作業している間にユーザーが回答した可能性があります。 - フィールド
answerはユーザーの回答です。自分で質問を未解決に戻す場合を除き、変更しないでください。 - 簡潔に記述します。タイトルは最大8単語、推奨は1~2文、「確認済み」の行は1文。
- ページの言語はユーザーの言語です。テンプレートのラベルはロシア語です。他の言語の場合は、テンプレートのコピーで翻訳してください。
確認
最初の公開後、ArtifactData list を1回(すべてのレコードが存在することの確認)と、ブラウザでページを1回確認します。モックアップが描画され、AとBが並んでいること。ユーザーに代わってボタンを押さないでください。それはユーザーの回答です。