Grill me visually은(는) 무엇을 하나요?
첫 번째 부분은 원래의 grill-me을 그대로 따릅니다. 그 다음은 동일한 질문 과정을 아티팩트 페이지에서 시각적으로 진행하는 방법입니다.
Grill-me
공통된 이해에 도달할 때까지 사용자를 끊임없이 인터뷰하십시오. 이를 설계 트리로 매핑하세요: 모든 결정은 그에 달린 결정들로 분기됩니다.
트리를 라운드 단위로 작업하십시오. 프론티어는 전제 조건이 이미 해결된 모든 결정입니다: 아직 듣지 못한 답변을 추측하지 않고 지금 물어볼 수 있는 질문들입니다. 한 라운드에서 프론티어 전체를 질문하십시오: 각 질문에 번호를 매기고 추천 답변을 제시하십시오. 그런 다음 다음 라운드 전에 사용자의 답변을 기다리십시오.
라운드는 다음과 같이 형식을 지정하십시오:
❓ **Q1** - **<질문 제목>**: <질문 본문, 여러 문단일 수 있으며 여러 선택지 포함>
➡️ <추천 답변>
---
❓ **Q2** - **<질문 제목>**: <질문 본문, 여러 문단일 수 있으며 여러 선택지 포함>
➡️ <추천 답변>
각 질문은 "예"가 추천 답변을 수락하는 방식으로 작성하십시오.
각 라운드에서 사용자의 답변은 트리를 재구성합니다: 해결된 결정은 프론티어를 확장하고 이에 의존했던 질문들의 차단을 해제합니다. 프론티어를 다시 계산하고 다음 라운드를 질문하십시오. 다른 질문의 답변에 의존하는 질문은 현재 라운드가 아닌 이후 라운드에 속합니다.
_사실_을 찾는 것은 사용자의 일이 아니라 여러분의 일입니다. 프론티어 질문에 환경(파일 시스템, 도구 등)의 사실이 필요한 경우, 새로운 컨텍스트 창으로 하위 에이전트를 파견하여 찾도록 하십시오. 직접 조회할 수 있는 것을 사용자에게 묻지 마십시오. 이를 차단하지 마십시오: 실행 중인 탐색은 불확정적인 전제 조건이므로, 그 아래의 질문들만 하위 에이전트가 보고할 때까지 기다리고, 나머지 프론티어는 지금 질문하십시오. _결정_은 사용자의 몫입니다: 각 결정을 사용자에게 제시하고 기다리십시오.
프론티어가 비어 있으면 세션이 종료됩니다: 설계 트리의 모든 분기를 방문했으며, 암묵적으로 가정된 것은 아무것도 남지 않았습니다. 사용자가 공통된 이해에 도달했음을 확인할 때까지 행동하지 마십시오.
라운드가 아티팩트가 되는 방법
위의 모든 내용은 그대로 유효합니다. 변경되는 것은 라운드가 위치하는 곳뿐입니다: 채팅 텍스트 대신 아티팩트 페이지(assets/template.html 템플릿)의 레코드이며, 사용자는 버튼과 댓글로 답변합니다.
| Grill-me에서 | 페이지에서 |
|---|---|
❓ Q1 - 제목: 질문 텍스트 | 질문 블록: 번호, 제목, 컨텍스트 줄 |
➡️ 추천 답변 | 녹색 배지 "추천: …" |
| "질문 내 옵션" | 옵션 A와 옵션 B, 각각 고유한 모양, 장점과 단점 |
| "yes"는 추천 수락 | 추천 옵션 버튼 또는 "확인" |
| 사용자 답변 텍스트 | A / B / 기타 또는 확인 / 취소 버튼 + 댓글 |
| 해결됨 | "확인됨" 섹션의 한 줄 |
시각적으로 표시할 내용
라운드의 각 질문은 네 가지 유형 중 하나의 정확히 하나의 블록입니다. 가장 간단한 유형을 선택하십시오: 목업은 텍스트 줄보다 비용이 많이 들고, 불필요한 이미지는 가독성을 해칩니다.
| 유형 | 사용 시기 | 내부 구성 | 버튼 |
|---|---|---|---|
ui | 화면 모양이나 탐색 방식(배치, 버튼, 내비게이션, 단계 순서, 무엇이 어디에 표시되는지)에 대한 질문 | 추천; 왼쪽 A, 오른쪽 B (필요시 C, D…); 각각 목업, 아래 장점과 단점 | A · B (· C…) · 기타 |
logic | 화면이 아닌 규칙(누가 무엇을 하는지, 상태, 기한, 가격, 데이터)에 대한 질문 | 추천; 표: 측면 · A · B (· C…) | A · B (· C…) · 기타 |
ok | 옵션이 없고 하나의 제안만 있는 경우 | 제안 텍스트 | 확인 · 취소 |
plain | 이미 해결됨(채팅, 이전 라운드, 프로젝트 문서에서) | "확인됨"의 한 줄 | — |
모든 질문과 모든 옵션은 오직 설문지에만 포함 (작성자 규칙). 옵션이 많더라도 비교를 위해 별도의 아티팩트를 만들지 마십시오: 동일한 질문에 C, D, E, F 필드(참고: references/items.md)로 추가하십시오. 보통 두 개면 충분하며, 세 번째 이상은 사용자가 추가 옵션을 요청하거나 실제로 두 개 이상의 옵션이 있을 때만 사용하십시오.
ui 목업 규칙:
- A와 B의 차이가 눈에 띄는 경우에만 목업을 그리십시오. 차이가 단어에 있다면
logic또는ok입니다. - 옵션 간의 차이점과 그것이 화면 어디에 있는지 이해할 수 있는 최소한의 주변 환경만 표시하십시오. 모든 세부 사항이 포함된 전체 화면은 필요하지 않습니다.
- A와 B는 동일한 프레임, 동일한 데이터, 동일한 초기 상태로 그리십시오: 그래야 눈이 차이점만 볼 수 있습니다.
- 실제 프로젝트 데이터(이름, 가격, 사용자 용어)를 사용하십시오. 가상의 데이터(이름, 금액)는 헤더의
{{NOTE}}에 표시하십시오. - 여러 단계로 구성된 시나리오의 경우 옵션당 하나의 목업으로 충분합니다: 단계는 위에서 아래로, 사용자 동작은 회색 메모("장바구니" 클릭)로 표시합니다.
- 장점과 단점은 옵션당 2~3개, 각각 한 줄씩입니다.
- 목업 유형: 봇은 Telegram 채팅(
tg), 앱과 웹사이트는 전화기 또는 브라우저(html프레임 포함)입니다. 필드와 클래스는references/items.md를 참조하십시오.
아티팩트의 모양
페이지는 간결하고 차분합니다: 일반 텍스트 크기(14px), 큰 제목 없음, 작은 여백, 불필요한 요소(장식, 추가 표, 서론 단락) 없음. 밝은 테마와 어두운 테마 모두 지원. 이 모든 것은 템플릿에 이미 포함되어 있습니다: 디자인을 다시 만들지 말고 레코드만 변경하십시오.
위에서 아래로:
- 헤더: 작은 회색 줄(보드 관련 대상); 제목 "설문지: <주제>"; 한 줄 "여기에 직접 답변하세요…"; 선택적 고지사항(
{{NOTE}}). - "기타": 하나의 텍스트 필드와 "저장" 버튼 — 설문지를 나가지 않고 채팅으로 메시지(아래 질문과 관련 없는 질문, 의견, 요청)를 보냅니다. 필드는 일회용입니다: 라운드 처리 후 비워집니다.
- "확인 필요" 및 열린 질문 수. 각 질문은 하나의 블록:
- 번호, 제목, 필요한 경우 "먼저 이것" 표시;
- 필요한 경우 회색 컨텍스트 줄;
- 녹색 배지 "추천: …" (
ui및logic의 경우); - 유형별 내용:
ui— 열, 왼쪽 A, 오른쪽 B (세 번째 옵션부터 세 열, 네 개 이상은 두 열씩 행), 각각 레이블, 목업, 아래 장점(+)과 단점(-); 모바일에서는 열이 세로로 쌓입니다.logic— 표 "측면 · A · B (· C…)".ok— 제안 텍스트; - 댓글 필드;
- 하단 버튼: 옵션당 하나의 버튼과 "기타" (
ok의 경우 확인 · 취소). "기타"는 댓글을 요구합니다.
- "확인됨" 및 결정 수: 번호 목록, 각 줄에 날짜와 결정(한 문장); 줄 아래 회색으로 사용자 댓글(있는 경우); 작은 링크 "질문으로 되돌리기".
답변된 질문은 즉시 첫 번째 섹션에서 두 번째 섹션으로 이동합니다.
단계
-
준비.
artifact-capabilities와artifact-design스킬을 로드하십시오: Artifact tool은 게시 전에 이 스킬들이 필요합니다. ToolSearch를 통해ArtifactData를 로드하십시오. -
페이지. 페이지 코드는 이미 준비되어 있습니다 —
assets/template.html; 새 페이지를 작성하지 말고 템플릿을 프로젝트에 복사한 후 데이터베이스를 통해 질문을 채우십시오. 폴더가 Obsidian 저장소에 있으면.code/grill/<주제>.html에, 그렇지 않으면 프로젝트 폴더나 스크래치패드에 넣으십시오. 세 개의 레이블을 바꾸십시오:{{TITLE}}(두 곳) — 주제 이름, 2~4단어, 예: "Coffee Shop 봇". 템플릿 앞에는 이미 "설문지: "가 있습니다 — 페이지가 다른 아티팩트 중에서 즉시 식별되도록 (작성자 결정), 전체 이름은 "설문지: Coffee Shop 봇"이 됩니다;{{SUBTITLE}}— 관련 대상, 예: "Coffee Shop 고객 · Telegram 봇";{{NOTE}}— "목업의 이름과 금액은 가상입니다"와 같은 고지사항 또는 빈 줄.
파일의 다른 부분은 변경하지 마십시오. 해당 주제에 이미 보드가 있으면, 해당 URL로 Artifact
read를 한 다음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컬렉션에 한 번 호출: 프론티어 질문당 하나의 문서와 이미 해결된 항목에 대한plain줄. 순서는order필드로 지정하며, 가장 긴급한 질문은first: true로 표시할 수 있습니다. -
전달. 링크를 제공하고, 한두 줄로 라운드 질문을 언급한 후 "답변했습니다"라고 말해 달라고 요청하십시오: 페이지는 답변을 알리지 않습니다. 답변이 즉시 필요하면 채팅으로도 질문하고(AskUserQuestion), 답변을 직접 데이터베이스에 페이지가 기록했을 방식과 동일하게 기록하십시오.
-
답변 읽기. ArtifactData
list컬렉션items.status: "done"이고answer필드가 있는 각 레코드:a,b,ok,no— 결정이 수락됨, 페이지가 이미summary를 기록했습니다. 댓글이 결정을 명확히 하면, 실제로 결정된 내용을 한 문장으로summary를 다시 작성하십시오.other— 댓글을 읽으십시오. 완성된 결정이면summary를 한 문장으로 다시 작성하십시오. 새 옵션이나 반대 질문이면 레코드를open상태로 되돌리거나 새 질문을 만드십시오.- 결정을 프로젝트가 저장하는 곳(프로젝트 보드, 요구사항 명세, ADR)으로 옮기십시오 (해당 장소가 있는 경우).
또한 "기타"를 읽으십시오 — ArtifactData
getmeta컬렉션의other문서. 이는 채팅으로 보내는 사용자 메시지입니다: 채팅 메시지처럼 처리하십시오 — 채팅으로 답변하고, 요청을 수행하고, 결정을 프로젝트가 저장하는 곳에 기록하고, 새 아이디어는 다음 라운드의 질문으로 만드십시오. 그런 다음 필드를 비우십시오:updatewithif_version,text: "", 그리고reply,replyAt,at을 삭제하십시오({"__delete__": true}). 어떤 것도 잃지 마십시오: 필요한 모든 것은 이미 채팅, 보드 또는 질문에 기록되어 있습니다.그런 다음 프론티어를 다시 계산하고 동일한
batch로 다음 라운드를 추가하십시오. -
종료. 프론티어가 비어 있으면 — 결과를 간략히 요약하고 공통된 이해가 있는지 질문하십시오.
기록 규칙
- 기존 문서의 레코드는 마지막 읽기의
if_version을 사용하십시오: 사용자가 작업 중에 답변했을 수 있습니다. answer필드는 사용자의 답변입니다. 직접 질문을 열린 상태로 되돌리는 경우 외에는 변경하지 마십시오.- 간결하게 작성하십시오: 제목은 8단어 이내, 추천은 1~2문장, "확인됨" 줄은 한 문장.
- 페이지 언어는 사용자의 언어입니다. 템플릿 레이블은 러시아어입니다; 다른 언어의 경우 템플릿 사본에서 번역하십시오.
확인
첫 번째 게시 후 — ArtifactData list 한 번(모든 레코드가 제자리에 있는지)과 브라우저에서 페이지를 한 번 확인: 목업이 그려지고 A와 B가 나란히 있는지 확인하십시오. 사용자를 대신해 버튼을 클릭하지 마십시오: 그것은 사용자의 답변입니다.