視覺化問答板 是做什麼的?
第一部分與原始的 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),無大標題,小間距,無多餘裝飾、無多餘表格、無引言段落。支援淺色和深色主題。所有這些已內建於模板中:請勿更改設計,只修改記錄。
從上到下:
- 頁首: 一行灰色小字 — 問卷的相關對象;標題「問卷:<主題>」;一行「直接在這裡回答…」;可選的免責聲明(
{{NOTE}})。 - 「其他」:一個文字輸入框和一個「儲存」按鈕 — 用於在不離開問卷的情況下向聊天發送訊息:與下方問題無關的提問、註解或請求。此欄位為一次性:處理完當前回合後清空。
- 「需要確認」 及未回答問題的數量。每個問題一個區塊:
- 編號、標題,如有必要加上「先回答這個」的標記;
- 灰色上下文行(如有必要);
- 綠色橫幅「建議:…」(適用於
ui和logic); - 根據類型的內容:
ui— 欄,左側 A,右側 B(第三個選項時為三欄,四個及以上時每行兩個),每個有標籤、mockup、下方的優點 (+) 和缺點 (−);在手機上欄會垂直堆疊。logic— 表格「面向 · A · B (· C…)」。ok— 提議文字; - 評論欄位;
- 底部的按鈕:每個選項一個按鈕和「其他」(對於
ok為「確定 · 否定」)。「其他」需要評論。
- 「已確認」 及已解決問題的數量:編號列表,每行包含日期和以一句話說明的決定;如果有的話,下方以灰色顯示使用者的評論;一個小型的「移回問題」連結。
回答過的問�會立即從第一個區域移動到第二個區域。
步驟
-
準備。 載入技能
artifact-capabilities和artifact-design:Artifact 工具在發布前需要它們。透過 ToolSearch 載入ArtifactData。 -
頁面。 頁面程式碼已準備好 —
assets/template.html;請勿編寫新頁面,只需將模板複製到專案中,並透過資料庫來填充問題。如果目錄位於 Obsidian 儲存庫中,請放在.code/grill/<主題>.html,否則放在專案目錄或暫存區。更換三個標記:{{TITLE}}(兩個位置)— 主題名稱,2–4 個詞,例如「Coffee Shop 機器人」。模板中其前方已有「問卷:」,因此頁面可與其他 artifact 區分(作者解決方案),完整名稱將為「問卷:Coffee Shop 機器人」;{{SUBTITLE}}— 相關對象,例如「Coffee Shop 客戶 · Telegram 機器人」;{{NOTE}}— 類似「mockup 中的姓名和金額為虛構」的免責聲明,或空字串。
請勿更改檔案中的其他內容。如果該主題已有此類問卷,請直接使用它:Artifact
read其 URL,然後使用urlpublish。 -
發布。 Artifact publish,
icon: "checklist",capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}。write: admin規則意味著只有擁有者和編輯者可以回答,而獲得檢視連結的人只能查看。assets用於 mockup 中的真實照片:將它們上傳到 artifact(asset: true)並在記錄中使用/_blob/<id>連結。 -
回合。 在集合
items中呼叫一次 ArtifactDatabatch:為前緣的每個問題建立一個文件,並為已解決的問題建立plain行。順序由order欄位指定,最緊急的問題可標記為first: true。 -
傳遞。 提供連結,用一兩行列出回合中的問題,並要求使用者回覆「已回答」:頁面不會通知你關於答案的事。如果需要立即回答,也請在聊天中提問(AskUserQuestion),並將答案自行寫入資料庫 — 就像頁面會記錄一樣。
-
讀取答案。 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添加下一回合。 -
結束。 前緣為空 — 簡短總結結果,並詢問是否達成共識。
記錄規則
- 對現有文件的任何寫入都必須使用來自上次讀取的
if_version:使用者可能在你工作時回答了問題。 answer欄位是使用者的回答。除非你將問題重新開啟,否則不要更改它。- 保持簡潔:標題最多 8 個詞,建議 1–2 句,「已確認」中的行一句話。
- 頁面的語言應與使用者語言一致。模板中的標籤是俄語;如需其他語言,請在模板副本中翻譯它們。
檢查
首次發布後 — 執行一次 ArtifactData list(確保所有記錄都在)並在瀏覽器中查看頁面一次:確認 mockup 能正確顯示,A 和 B 並排。請勿代使用者點擊按鈕:那是使用者的回答。