Communitygithub.com

視覺化問答板

將結構化問答過程呈現在網頁 artifact 上,使用者可直接於頁面中回答問題,支援視覺化方案比較與即時回饋。

視覺化問答板 是什麼?

這個技能將 Grill-me 的結構化問答流程轉化為一個互動式網頁 artifact,讓使用者可以直接在頁面上回答問題、比較方案與提供意見。它特別適合設計討論、功能規劃或架構決策等需要逐步釐清與視覺化比較的場景,支援多種問題格式,包括:介面 mockup 的左右比較(UI)、條件與規則的表格比較(Logic)、單純的同意/反對(Ok)以及已確認事項的清單(Plain)。使用者可直接在 artifact 上點擊按鈕或輸入評論以提供回饋,而 AI 則根據使用者的答案自動更新問題清單與決策樹。此技能支援 Claude Code、Cursor 等具有 artifact 功能的平台,並強調超輕量、無多餘裝飾的設計原則,以確保問答過程高效且專注。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bulkozavr2000/grill-me-visually/tree/HEAD/skills/grill-me-visually

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

視覺化問答板 是做什麼的?

第一部分與原始的 grill-me 完全相同。接下來說明如何在 artifact 頁面上進行視覺化問卷。

Grill-me

持續訪談使用者,直到達成共識。將此流程繪製為一個設計決策樹:每個決定都會衍生出相關的子決定。

以回合方式逐一探索決策樹。前緣(frontier)是指所有前提條件都已經決定的決策:那些你現在可以直接提出的問題,而不必猜測尚未聽到的答案。每一回合提出整個前緣的所有問題:為每個問題編號,並提供你的建議答案。然後等待使用者的回覆,再進入下一回合。

回合的格式如下:

❓ **Q1** - **<問題標題>**:<問題主體,可能包含多個段落,包括多個選項>

➡️ <你的建議答案>

---

❓ **Q2** - **<問題標題>**:<問題主體,可能包含多個段落,包括多個選項>

➡️ <你的建議答案>

每個問題的措辭應使「是」代表接受你的建議答案。

每回合使用者的回答會重塑決策樹:已確定的決定會將前緣向外推進,並解鎖依賴於這些決定的問題。重新計算前緣,然後提出下一回合的問題。某個問題的答案若依賴於同一回合中尚未解決的另一個問題,則屬於後續回合,而非本回合。

發掘事實是你的職責,永遠不該由使用者來做。當前緣問題需要從環境(檔案系統、工具等)中取得事實時,請派遣一個具有全新上下文視窗的子代理去查找;不要向使用者詢問任何你自己可以查到的資訊。也不要因此而阻塞:正在進行的探索屬於未解決的前提,因此只有依賴於它的下游問題需要等待子代理回報;現在就先提出前緣中的其他問題。決策屬於使用者:將每個決策交由他們決定,然後等待。

當前緣為空時,會話即結束:決策樹的每個分支都已被探索,沒有任何遺留的隱含假設。在獲得使用者確認達成共識之前,不要執行任何動作。

回合如何變成 artifact

上述所有規則仍然有效。唯一改變的是回合的呈現位置:不再是聊天中的文字,而是 artifact 頁面上的記錄(使用 assets/template.html 模板),使用者透過按鈕和評論來回答。

在 grill-me 中在頁面上
❓ Q1 - 標題:問題文字問題區塊:編號、標題、上下文行
➡️ 建議答案綠色橫幅「建議:…」
「問題內的選項」選項 A 和選項 B,每個有自己的視覺效果、優點和缺點
「是」接受建議建議選項的按鈕或「確定」
使用者以文字回答按鈕 A / B / 其他 或 確定 / 否定 加上評論
已解決「已確認」區域中的一行

視覺化呈現什麼

回合中的每個問題都應是以下四種類型之一的區塊。選擇最簡單且適合的類型:設計 mockup 的成本比純文字行高,過多圖片會影響閱讀。

類型使用時機內容按鈕
ui問題涉及螢幕外觀或操作流程:佈局、按鈕、導覽、步驟順序、顯示內容建議;左側為 A,右側為 B(如有需要可加入 C、D…);每個都有 mockup,下方列出優點和缺點A · B (· C…) · 其他
logic問題涉及規則而非螢幕:誰做什麼、狀態、時程、價格、資料建議;表格:面向 · A · B (· C…)A · B (· C…) · 其他
ok沒有選項,只有一個你的提議提議文字確定 · 否定
plain已在聊天、先前回合或專案文件中決定的事項「已確認」區域中的一行—

所有問題和所有選項都應放在同一個問卷中(作者規則)。不要為了比較選項而建立單獨的 artifact,即使選項很多:將它們加入同一個問題作為 C、D、E、F(欄位 c…f,參見 references/items.md)。通常兩個就夠;第三個及之後的選項僅在使用者要求更多選項或確實需要超過兩個時才使用。

ui mockup 的規則:

  • 僅在 A 和 B 之間的差異可視時才繪製 mockup。如果差異在於文字,則應使用 logic 或 ok。
  • 僅顯示選項之間的差異,以及足夠理解其在螢幕上位置的少量周邊環境。不需要顯示完整的螢幕及其所有細節。
  • A 和 B 應繪製在相同的框架中,使用相同的資料,從相同的初始狀態開始:這樣眼睛才能只看見差異。
  • 使用專案的實際資料:名稱、價格、使用者的術語。虛構的內容(姓名、金額)請在頁首的 {{NOTE}} 中標註。
  • 對於包含多個步驟的情境,每個選項只需要一個 mockup:步驟由上而下排列,使用者操作以灰色註記標示(例如「點擊了「購物車」」)。
  • 每個選項列出 2–3 個優點和缺點,各一行。
  • Mockup 的類型:Telegram 聊天 (tg) 用於機器人,手機或瀏覽器 (html 帶框架) 用於應用程式和網站。欄位和類別請參閱 references/items.md。

artifact 的外觀

頁面應保持簡潔平靜:常規文字大小(14 px),無大標題,小間距,無多餘裝飾、無多餘表格、無引言段落。支援淺色和深色主題。所有這些已內建於模板中:請勿更改設計,只修改記錄。

從上到下:

  1. 頁首: 一行灰色小字 — 問卷的相關對象;標題「問卷:<主題>」;一行「直接在這裡回答…」;可選的免責聲明({{NOTE}})。
  2. 「其他」:一個文字輸入框和一個「儲存」按鈕 — 用於在不離開問卷的情況下向聊天發送訊息:與下方問題無關的提問、註解或請求。此欄位為一次性:處理完當前回合後清空。
  3. 「需要確認」 及未回答問題的數量。每個問題一個區塊:
    • 編號、標題,如有必要加上「先回答這個」的標記;
    • 灰色上下文行(如有必要);
    • 綠色橫幅「建議:…」(適用於 ui 和 logic);
    • 根據類型的內容:ui — 欄,左側 A,右側 B(第三個選項時為三欄,四個及以上時每行兩個),每個有標籤、mockup、下方的優點 (+) 和缺點 (−);在手機上欄會垂直堆疊。logic — 表格「面向 · A · B (· C…)」。ok — 提議文字;
    • 評論欄位;
    • 底部的按鈕:每個選項一個按鈕和「其他」(對於 ok 為「確定 · 否定」)。「其他」需要評論。
  4. 「已確認」 及已解決問題的數量:編號列表,每行包含日期和以一句話說明的決定;如果有的話,下方以灰色顯示使用者的評論;一個小型的「移回問題」連結。

回答過的問�會立即從第一個區域移動到第二個區域。

步驟

  1. 準備。 載入技能 artifact-capabilities 和 artifact-design:Artifact 工具在發布前需要它們。透過 ToolSearch 載入 ArtifactData。

  2. 頁面。 頁面程式碼已準備好 — assets/template.html;請勿編寫新頁面,只需將模板複製到專案中,並透過資料庫來填充問題。如果目錄位於 Obsidian 儲存庫中,請放在 .code/grill/<主題>.html,否則放在專案目錄或暫存區。更換三個標記:

    • {{TITLE}}(兩個位置)— 主題名稱,2–4 個詞,例如「Coffee Shop 機器人」。模板中其前方已有「問卷:」,因此頁面可與其他 artifact 區分(作者解決方案),完整名稱將為「問卷:Coffee Shop 機器人」;
    • {{SUBTITLE}} — 相關對象,例如「Coffee Shop 客戶 · Telegram 機器人」;
    • {{NOTE}} — 類似「mockup 中的姓名和金額為虛構」的免責聲明,或空字串。

    請勿更改檔案中的其他內容。如果該主題已有此類問卷,請直接使用它:Artifact read 其 URL,然後使用 url publish。

  3. 發布。 Artifact publish,icon: "checklist",capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}。write: admin 規則意味著只有擁有者和編輯者可以回答,而獲得檢視連結的人只能查看。assets 用於 mockup 中的真實照片:將它們上傳到 artifact(asset: true)並在記錄中使用 /_blob/<id> 連結。

  4. 回合。 在集合 items 中呼叫一次 ArtifactData batch:為前緣的每個問題建立一個文件,並為已解決的問題建立 plain 行。順序由 order 欄位指定,最緊急的問題可標記為 first: true。

  5. 傳遞。 提供連結,用一兩行列出回合中的問題,並要求使用者回覆「已回答」:頁面不會通知你關於答案的事。如果需要立即回答,也請在聊天中提問(AskUserQuestion),並將答案自行寫入資料庫 — 就像頁面會記錄一樣。

  6. 讀取答案。 ArtifactData list 集合 items。對於每個 status: "done" 且包含 answer 欄位的記錄:

    • a、b、ok、no — 決定已達成,頁面已記錄 summary。如果評論有助於澄清決定,請用一句話重寫 summary,使其包含實際決定的內容。
    • other — 閱讀評論。如果這是一個已完成的決定,請用一句話重寫 summary。如果這是一個新的選項或反問,請將記錄恢復為 open,並添加新選項或建立一個新問題。
    • 將決定移至專案儲存決策的地方(專案看板、規格文件、ADR),如果有的話。

    還要閱讀「其他」區塊 — ArtifactData get 集合 meta 中的 other 文件。這是使用者發送到聊天的訊息:將其視為聊天中的一則訊息來處理 — 在聊天中回覆、執行請求、將決定記錄在專案儲存決策的地方、將新想法作為下一個回合的問題提出。之後清除此欄位:用 if_version 執行 update,設定 text: "",並刪除 reply、replyAt、at({"__delete__": true})。不要遺失其中的任何資訊:所有需要的內容都已記錄在聊天、看板或問題中。

    然後重新計算前緣,並使用相同的 batch 添加下一回合。

  7. 結束。 前緣為空 — 簡短總結結果,並詢問是否達成共識。

記錄規則

  • 對現有文件的任何寫入都必須使用來自上次讀取的 if_version:使用者可能在你工作時回答了問題。
  • answer 欄位是使用者的回答。除非你將問題重新開啟,否則不要更改它。
  • 保持簡潔:標題最多 8 個詞,建議 1–2 句,「已確認」中的行一句話。
  • 頁面的語言應與使用者語言一致。模板中的標籤是俄語;如需其他語言,請在模板副本中翻譯它們。

檢查

首次發布後 — 執行一次 ArtifactData list(確保所有記錄都在)並在瀏覽器中查看頁面一次:確認 mockup 能正確顯示,A 和 B 並排。請勿代使用者點擊按鈕:那是使用者的回答。

相關技能