用 `impeccable shape` 做设计前期的 Discovery：从零代码访谈到可确认的 Design Brief

用impeccable shape做设计前期的 Discovery从零代码访谈到可确认的 Design Brief【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable在设计 AI 辅助界面之前最贵的错误往往不是画得不够好而是还没搞清楚该做什么就动手写代码。本项目impeccable的 skill 体系中shape命令正是为此设计的流程它负责发现该做什么、应该如何工作然后只交回一份经用户确认的设计简报design brief全程不写一行代码。本文以 shape 参考文档 为主体结合 SKILL.md 命令表、command-metadata.json 及与其衔接的 new-work 参考完整还原这一先塑形、后建造流程的阶段划分、提问节奏、简报结构与停止条件让你能把它直接复用到任何新界面、新功能或品牌改版的前期规划中。一、shape 在整个 impeccable 命令体系中的位置在 impeccable 的 Commands 表中命令按类别组织shape属于Build创建类其用途定义为在写代码前规划 UX/UI。与它同类的craft [feature]是普通 new-work 请求的废弃别名而shape的职责是显式的任务发现两者并不等价。SKILL.md 的路由规则明确写着shapeowns task discovery, then enters new-work only for visual-world and surface-concept decisions.shape 负责任务发现仅当需要做出视觉世界与表面概念决策时才进入 new-work。换言之shape是设计前的那一步new-work是开始动手造的那一步。命令元数据文件 command-metadata.json 给出了面向调用侧的一句话描述Plan UX and UI before code. Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation.在写代码前规划 UX/UI运行必需的多轮发现式访谈在可用时使用视觉探针产出一份经用户确认的、面向实现的设计简报。而其参数提示为[feature to shape]要塑形的功能/界面入口示例对应{{command_prefix}}impeccable shape [feature]。一条不可逾越的边界贯穿始终shape 阶段不写代码也不产出方向契约direction contract或持久化产物。它的完整交付物只有一份用户确认过的简报。这与 new-work 的契约记录、visualize 的 comp 产出、build-phase 的逐门实现都严格分离。二、为什么必须先塑形一个值得记住的管线前提shape 文档的核心主张是先搞清楚三件事——做什么what should be made、如何工作how it should work——然后停下来。把塑形阶段独立出来的直接收益是发现阶段的结论不会在不知不觉中被代码实现、视觉倾向甚至现有布局带偏。因此 Phase 1 的第一句指令就是禁令级的Do not write code or choose visual direction yet.此刻不要写代码也不要选择视觉方向。这与整个 skill 的协作哲学一致shape只负责把产品要什么、用户要什么问清楚而这个世界看起来像什么视觉权威、采用哪个概念方向concept这类审美决策全部移交给 new-work.md 处理。后面我们会看到 Phase 2 正是这道移交的落点。三、Phase 1Discovery interview发现式访谈发现访谈是整个 shape 流程的主体。它有一套严格的节奏纪律cadence、两轮提问并有明确的禁止清单。3.1 节奏纪律Cadence访谈不是问卷轰炸而是每轮两三个相关问题、问完就等的收敛式对话。文档给出的硬性规则可以归纳为四条优先使用结构化提问工具当 harness宿主环境如 Cursor / Claude Code / Codex 等提供结构化 question 工具时使用它否则就提问并停下来等待。每轮只问 23 个彼此相关的问题然后等待。默认只进行一轮只有当答案暴露出实质性的信息缺口时才追加第二轮。禁止倾倒问卷、复述已确定事实、或把显而易见的事实变成选择题。更好的做法是先断言最可能的理解再邀请用户纠正Assert the likely reading and invite correction。提问轮数的下限取决于输入的稀疏度非常简略的 prompt 至少需要一轮问答而一份已经很精确的 prompt 可能只需要一次紧凑的确认即可。3.2 Round 1目的、人群与结果purpose, people, and outcome第一轮聚焦于为什么做、为谁做、做成什么样。注意它不是让你全问而是从中挑出最能改变结果的 23 个问题。文档给出四个候选提问按改变结果的能力取舍这个界面surface或功能是做什么的它必须解决什么问题谁会具体地触达它在什么情境、什么心态下他们最需要理解或做的第一件事是什么怎样才算成功这里有什么是独一无二的——是相邻产品、通用模板无法声称的最后一个问题尤其关键它逼着访谈者越过通用落地页式的模板去寻找只有这个产品能主张的事实。这与 new-work 中truth binds claims真实约束主张以及 Persuade 模式demonstrate something only this product can prove一脉相承。3.3 Round 2材料、行为与边界material, behavior, and boundaries第二轮仅在存在实质性未决决策时运行问题覆盖四个维度内容/材料这个体验必须承载哪些真实内容、证据、数据和资产最小 / 典型 / 最大数量级分别是多少状态与流转哪些状态和过渡是重要的——首次运行first-run、空态empty、加载、报错、成功、权限、溢出还是专家级使用保真度与范围预期是哪种保真度、广度和交互度——探索草图exploration、可交付的成品屏production-ready screen、完整流程full flow还是更大范围的表面不可触碰的部分什么必须原样保留即使看起来已经打磨过什么东西一旦变了就会让结果感觉不对哪些平台 / 框架 / 性能 / 无障碍 / 本地化 / 交付约束是硬性的3.4 访谈的禁区绝不问 CSS绝不过问审美shape 明确把视觉世界visual world与概念concept的取舍划给 new-workNever ask for CSS values or canned aesthetic lanes. New-work owns visual-world and concept choices.绝不要问 CSS 数值或既定的审美路线。视觉世界与概念的选择归 new-work 所有。这也解释了为什么 shape 的产出可以保持意图intent而不是 CSS——详见第六节简报结构。类似的禁令也出现在 new-work 中Never ask for CSS values or canned aesthetic lanes说明这是贯穿整个 skill 的设计前期阶段只收集约束与意图把美学实现推迟到真正拥有视觉权威的环节。四、Phase 2解决设计方向问题Resolve the design direction当访谈得出的结论指向这是新的表面 / 品牌扩展 / 替换性设计时shape 并不亲自做方向决策而是把用户导向 new-work 的视觉权威流程For new surfaces, brand expansion, or replacement, follow new-work.md through visual authority, any world workshop, and concept choice. Reuse discovery, then return before its contract, persistence, or implementation.翻译成流程语言就是先判定已经存在什么new-work 的第 1 步读取 DESIGN.md、代表代码、tokens、组件与资产确认这次是 Redesign替换旧视觉世界、Established world继承现有世界、Incomplete brand与用户共同扩展不完整的品牌还是 No visual authority创建全新世界。再问什么会改变这件工作一轮 23 个相关问题按 Persuade / Operate / Read / Experience 四种访客模式询问。shape 中途返回把发现阶段discovery的结果复用给 new-work 后shape 在 new-work 进入方向契约direction contract、持久化persistence如写入 DESIGN.md或实现implementation之前就退出。只有在已确立的视觉世界内部、但构图或交互仍存在实质空白时shape 才允许在那个世界内部使用概念流程。换句话说shape 是上游方向裁决是下游它可以把问题递下去但从不替下游做决定、也从不参与执行。五、Phase 3撰写简报Write the brief5.1 规模原则写最小有用的简报文档给的黄金法则是Write the smallest useful brief。这不仅是为了省 token更是为了让简报成为后续所有环节可加载的记忆而不是一份流水账。另外两条纪律不要复述对话Do not restate the conversation已解决的背景不必回放。不要复制全局产品事实或 DESIGN.md tokens 进来new-work 第 5 节同款要求那些属于 PRODUCT.md / DESIGN.md 的管辖范围简报只装载属于这一条路由或这一个工件的策略。5.2 简报的七大区块当任务足够模糊、多屏或需要独立规划时使用完整结构否则用 35 条要点即可。完整结构的七个区块如下#区块必须回答的内容1Job and audience任务与受众谁到达这里他们的上下文、需求与访客模式visitor mode2Outcome and proof结果与证据首要任务/动作、成功标准、真实证据、产品特有的真相3Selected direction选定的方向视觉权威、结构与交互论点、叙事顺序、焦点时刻、实现影响4Scope and boundaries范围与边界保真度、广度、交互度、具名的目标、不可触碰之物、明确的反目标anti-goals5States and ranges状态与量级现实的内容/数据量级以及必须覆盖的材料状态6Interaction and layout交互与布局层级、拓扑、响应式、可供性affordances、反馈、过渡——意图而非 CSS7Constraints and open decisions约束与开放决策平台、交付、无障碍、本地化、可复用组件以及建造者不得自行发明的选择注意第 3 块里 Selected direction 与第 6 块 intent, not CSS 的组合shape 可以在简报中记录方向选择的骨架视觉权威指哪、结构论点是什么但把最终的方向契约撰写含 THESIS / OWN-WORLD / STORY / FIRST VIEWPORT / FORM / FINISH 六个小块、≤150 词留给 new-work 的Commit the world阶段去完成。5.3 什么时候用要点、什么时候用全文任务已定案task is settled35 条要点即可简报越短越有用。任务模糊、多屏或独立规划ambiguous, multi-screen, or standalone planning才使用上面完整的 7 区块结构。六、确认并停止Confirm and stop简报写完不等于流程结束最后一步是提交确认把简报呈现给用户要求明确的确认explicit confirmation或一轮修正one correction round。然后停止shape 永不写代码也永不产出方向契约。同时文档规定了无人工应答机制headless / unattended时的兜底When no human or structured answer mechanism exists, mark assumptions plainly, return the brief, and stop.当不存在人类或结构化应答机制时把假设如实标注交回简报然后停止。这条规则让 shape 在自动化管线例如 Agent 无人值守调用中也能收敛没有确认对象时不猜测、不擅自写契约而是把假设摊在明面上、把简报作为产出返回并停止——等待后续有人真正进入 new-work 的决策流程。这也呼应了 new-work 中shapereturn the selected direction to shape.md and stop before persistence or implementation的交接约定。七、shape 与下游流程的完整衔接实战路径把 shape 放回整个 impeccable 的设计管线中一次完整流程是这样的用户发起shape [feature]例如shape 定价页对应 SKILL.md 命令表 Build 类的 shape 条目。shape 执行第 1 阶段用结构化提问工具进行一轮必要时两轮发现访谈收敛出目的、人群、结果、材料、状态、边界。当涉及新表面或替换视觉身份时shape 进入第 2 阶段将访谈结论复用给 new-work.md在其concept-seed.mjs/serve-question.mjs驱动的方向掷骰与决策页之前或之中介入但在方向契约落笔前返回。若 PRODUCT.md 缺失new-work 会要求先完成 init.md这不会反向把 shape 打回 init。shape 在第 3 阶段写出最小有用简报覆盖第七节的 7 区块或要点版并在第 6 步确认并停止。从实现证据看命令体系对 shape 的归类是一致的skill-categories.js 将shape映射为create类别与 impeccable、craft 同属创作类而 command-metadata.json 中 shape 的正式说明确认了必需的多轮访谈 视觉探针 用户确认的简报这一行为契约。想对照 skill 源码副本也可以查看仓库 skill/reference/shape.md 与技能源文件 skill/SKILL.src.md。八、把 shape 纪律复用到你自己的设计工作流即使不运行 impeccable skillshape 的三条纪律也可以直接迁移到你手写的任何设计前期流程中先问再画问完就停。每轮只问 23 个最能改变结果的问题宁可断言最可能的理解并邀请纠正也不要倾倒问卷。信息稀疏时至少问一轮信息精确时一轮紧凑确认即可。把功能问题和审美问题分阶段。目的、受众、结果、状态、边界属于 Discovery视觉世界、概念方向属于另一道门对应 new-work。绝不要在发现阶段就问 CSS 数值或审美路线——那会过早把实现细节塞进意图层。简报要有明确的确认闸门。产出定位为最小有用简报任务定案用 35 条要点模糊/多屏才用完整 7 区块。提交后要求显式确认或一轮修正然后停手没有确认渠道时把假设标注清楚、交回简报即结束绝不越界去写契约或代码。记住 shape 那个自证的收尾一份经过确认的简报是让后续所有造的工作不再猜该做什么的最小投资而任何在确认前就开始的代码都是在为一个尚未成形的问题提前买单。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考