discovery-question-form
Structured clarification form for unresolved material requirements.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-11
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- od
- { "mode": "discovery", "scenario": "general" }
- name
- discovery-question-form
- description
- Structured clarification form for unresolved material requirements.
02 资源文件 1
- 参考文档open-design.json828 B
03 SKILL.md 正文
Discovery question form
This atom defines the <question-form> protocol. It does not decide whether
clarification is required. Follow the active skill and core prompt's
requirements-clarification policy. When they identify unresolved information
that would materially change the design direction, content structure, or
delivery format, surface the smallest possible set of questions that unblocks
the workflow.
The questions are rendered as a <question-form> artifact inline in the
originating assistant message. This is assistant text parsed by the host, not a
plugin GenUI surface or a native tool call. Submitted answers return as the
next user message, beginning with [form answers — <form-id>].
Activation boundary
- A first turn or new project does not by itself require a form.
- A
discoverypipeline stage only makes this protocol available; declaring or entering the stage does not trigger a form. - Missing metadata is not automatically a question. First use the request, conversation, plugin inputs, memory, active skill, and design system.
- If enough information is available to proceed safely, do not emit a form.
- If a material blocker remains, ask only for that unresolved information.
Emission shape
Emit the form as a question-form block whose body is a JSON object with a
top-level questions array. Do not emit a bare question object by itself; the
renderer only recognizes the wrapped form contract.
<question-form id="discovery" title="Quick brief — 30 seconds">
{
"description": "I'll lock these in before building. Skip what doesn't apply — I'll fill defaults.",
"questions": [
{
"id": "audience",
"label": "Who's the primary audience?",
"type": "checkbox",
"options": ["VC", "Customer", "Internal team"],
"maxSelections": 2,
"required": true
}
]
}
</question-form>
Question object shape
Each entry in the top-level questions array uses:
id: stable answer key, for exampleaudience.label: user-facing question copy.type: one ofradio,checkbox,select,text,textarea,number,range,date,time,datetime-local,color,url,email,tel,file, orswitch.options: required for choice controls; strings are allowed, or objects with localizedlabeland stablevalue.- At most 6-7 options per question; merge near-duplicates instead of listing more.
- Choose
radiovsselectby option count, not importance:radiofor a short list,selectonce it runs long (languages, timezones, voices).checkboxis always a plain list. selectoptions may carrygroup(first group expands, the rest collapse) andtrailingLabel(a short end-of-row code such asZH-CN). Both optional.- Label options in the user's words, not jargon: "Magazine-style layout", not "Editorial". Reword only
label; never change a stablevalue. - Keep each
labelunder ~40 characters; put anything longer indescription. allowCustom: leave unset or set totruefor finite-choice controls so users can type their own answer instead of accepting only generated options. SetallowCustom: falseonly when the downstream system needs an exact machine id.customLabel/customPlaceholder: optional localized copy for that custom answer input.maxSelections: include this for checkbox controls with a limited selection count.required: set totrueonly when the answer is needed before work can continue.
Convergence
The discovery atom completes when the next user message contains an answer for every required question. Treat those submitted answers as conversation context and do not ask the same questions again unless later input invalidates an answer.
04 同仓库更多 Skills
Beta Skill
Instruction-only fixture skill.
Alpha Skill
First fixture skill with a runnable demo.
Deck One
A small deck template fixture.
youtube-clipper
YouTube clip generation and editing with automated workflows — pull source video, slice highlights, add captions, and export.
writing-guidelines
Review docs/prose for Writing Guidelines compliance. Use when asked to "review my docs", "check writing style", "audit prose", "review docs voice and tone", or "check this page against the writing handbook".
wpds
WordPress Design System. Apply WordPress's official design tokens, typography, and component patterns to themes and sites.