数据库客户端后端前端CLI桌面应用数据可视化AI 应用【免费下载链接】whodbWhere data access meets operational intelligence项目地址https://gitcode.com/gh_mirrors/wh/whodb点击查看免费下载在 WhoDB 仓库中.agents/skills/impeccable/目录内置了一套名为 Impeccable 的前端设计 Agent 技能其中shape命令承担着规划先行的职责通过结构化的发现访谈和方向裁决在写任何代码之前就产出一份经用户确认的设计简报design brief。本文围绕 shape.md 参考文档展开完整讲解其三阶段流程Discovery 访谈、方向裁决、Brief 撰写的规则细节并结合 SKILL.md、context.mjs 和 surface brief 存储脚本等仓库源码说明 shape 在技能路由中的实际位置与落地方式。读完本文你可以掌握如何在 AI 编码代理中驱动 shape 流程、如何组织两轮访谈问题以及如何理解确认后的简报最终去向。一、shape 在 Impeccable 技能中的定位Impeccable 技能的入口清单 SKILL.md 定义了一组子命令shape [feature]归属于 Build 类别描述为 Plan UX/UI before writing codeSKILL.md。命令元数据 command-metadata.json 对其做了更精确的定义Runs a required multi-round discovery interview, uses visual probes when available, and produces a user-confirmed design brief for implementation。shape 与其他命令有明确的职责边界shape 拥有任务发现task discovery只在视觉世界和 surface 概念决策上进入 new-work 流程SKILL.mdshape 永远不写代码也不写方向契约direction contract——这是文档结尾 Confirm and stop 章节的硬约束与之相对craft是 new-work 请求的已弃用别名init负责把产品事实固化进 PRODUCT.mddocument负责从现有代码生成 DESIGN.md。从源码结构看这套分工在执行层面由 context.mjs 的启动指令落实当项目缺少 PRODUCT.md 时脚本会打印NO_PRODUCT_MD与BUILD_INIT_REQUIRED指令明确要求 Before shape or any new-surface/redesign flow, init must capture PRODUCT.md——即 shape 的前置条件是产品事实已经被捕获视觉决策则全部由 new-work 接管。二、Phase 1Discovery 访谈shape 的第一阶段是发现访谈核心纪律是先访谈后设计不写代码、不选视觉方向。文档对访谈节奏Cadence给出了四条硬性规则优先使用结构化提问工具如代理提供的 structured question tool不可用时则直接提问并停下来等待每轮问 23 个相关问题然后等待回答。默认只有一轮只有当第一轮答案暴露出实质性缺口material gap时才允许追加第二轮禁止倾倒问卷。不要一次性抛出问题清单不要重复已确认的事实也不要把显然的事实变成菜单式选项正确做法是断言最可能的解读并邀请用户纠正Assert the likely reading and invite correction提问深度与提示精确度成反比稀疏的提示sparse prompt至少需要一轮真实回答足够精确的提示可能只需要一次紧凑确认。Round 1目的、人群与结果第一轮从以下候选问题中挑选最能改变结果的 23 个而不是逐条照问这个 surface 或功能是为了什么它必须解决什么问题具体是谁、在什么情境和心态下会接触到它用户必须理解或完成的最主要的一件事是什么成功长什么样这里有什么独特为真的东西uniquely true邻近产品或通用模板无法声称的是什么Round 2素材、行为与边界第二轮只在存在实质性未决决策时才运行覆盖五个维度素材与数据体验必须承载哪些真实内容、证据、数据和资产现实的最低、典型、最大范围各是多少状态与过渡哪些状态和转换是重要的——首次运行、空态、加载中、错误、成功、权限、溢出、专家用法保真度与广度预期交付到什么程度——探索性草图、生产级屏幕、完整流程还是更大的 surface交互性是探索还是完整实现不可触碰的部分什么必须保持不动即使结果看起来很精致什么情况会让它感觉不对约束哪些平台、框架、性能、可访问性、本地化或交付约束是绑定性的binding文档在此特别划了一条红线绝不索要 CSS 值或成套的审美赛道canned aesthetic lanes——视觉世界和概念选择归 new-work 所有。这条边界在 new-work.md 的第 2 节被再次强调两处文档相互印证shape 负责问做什么、为谁做、做到什么程度不越权问长什么样。三、Phase 2解决设计方向文档对方向裁决只给了一条路由规则对于新 surface、品牌扩展或整体替换跟随 new-work.md 完成视觉权威visual authority判断、必要的 world workshop 和概念选择复用已有发现访谈的结果然后在其契约、持久化和实现步骤之前返回。也就是说shape 会借道 new-work但只借用前半程。new-work 中真正被 shape 复用的是其第 13 节判断既有视觉权威的状态redesign / established world / incomplete brand / no visual authority、按 visitor mode 追问改变工作的未知量、以及选择正确的发明幅度扩展既有 surface、在既有世界内创建整页、还是创建/替换视觉世界。当新方向确定后new-work 第 5 节明确规定 For shape, return the selected direction to shape.md and stop before persistence or implementationnew-work.md形成一条清晰的回程路径方向选定即返回DESIGN.md 的撰写、surface brief 的写入和后续构建全部不在 shape 的职责内。值得注意的是若新方向选择涉及真正的开放决策new-work 要求运行 concept-seed.mjs 脚本从模型外部掷骰子来分配构建哪个方向——脚本注释说明了动机单一模型的共鸣排序是确定性的若不引入外部随机性同一类别的每次运行都会收敛到最安全的那张牌concept-seed.mjs。这解释了 shape 流程中方向由机制分配而非模型自选这一设计取向的来源。四、Phase 3撰写设计简报方向解决后shape 产出的是最小的有用简报the smallest useful brief包含七个要素Job and audience谁会到达这个 surface、他们的上下文、需求以及 visitor modePersuade / Operate / Read / Experience即 SKILL.md 中定义的四种访客模式Outcome and proof主要任务/动作、成功标准、真实证据以及产品特有的为真之处Selected direction视觉权威、结构/交互论点、内容序列、焦点时刻focal moment及其实现后果Scope and boundaries保真度、广度、交互性、命名目标、保持不动的部分以及显式的反目标anti-goalsStates and ranges真实的内容/数据范围与实质性状态Interaction and layout层级、拓扑、响应式、可供性、反馈与过渡——只写意图不写 CSSintent, not CSSConstraints and open decisions平台、交付、可访问性、本地化、可复用组件以及构建者不得自行发明的决策项。简报体量与任务确定度挂钩任务已确定时用 35 条要点即可只有模糊的、多屏幕的或独立的规划任务才使用完整七段结构。并且不要复述对话——简报是新产物不是访谈记录的回显。五、确认、停止与无人值守回退shape 的收尾规则同样明确把简报呈现给用户做显式确认或一轮修正然后停止当不存在人类或结构化回答机制例如无人值守运行时把假设assumptions显式标注出来返回简报并停止。shape 永远不写代码这条约束使 shape 在流水线中天然安全它的唯一产物是决策记录不会触碰任何实现文件。六、仓库中的落地证据上下文加载与 brief 存储虽然 shape 本身不写文件但围绕它的支撑设施在仓库源码中都有据可查启动时按 shape 语义分支context.mjs 是每会话运行一次的上下文加载器其文件头注释直接点明了 shape 的角色from-scratch build requests (plus init / teach / shape) and clear build/shape intent divert into the init flowcontext.mjs。具体分支逻辑无 PRODUCT.md 且存在既有视觉实现时输出NO_PRODUCT_MDBUILD_INIT_REQUIREDshape 必须先走 init.md 捕获产品事实context.mjs有 PRODUCT.md 但缺 DESIGN.md 且代码中存在既有视觉决策时输出INCUMBENT_WORLD_UNDOCUMENTED指示 shape 或新 surface 请求加载 new-work.md——扩展请求要记录并保留代码定义的世界重设计则把旧外观仅作证据与反参考context.mjs有 PRODUCT.md、无 DESIGN.md、也无既有实现时输出WORLD_DISCOVERY_REQUIRED要求在与用户共同建立视觉世界之前不得开发任务概念。这些指令文本就是 shape 运行时的路由表把 shape.md 文档中的自然语言规则落实为可被任何模型执行的显式指令。简报的持久化由后续流程负责shape 的产物确认后的 brief在后续实施中被持久化为surface brief存储实现见 surface-briefs.mjs目录固定为projectRoot/.impeccable/surfaces/surface-briefs.mjs文件名由目标的 kebab slug 生成slug 上限 50 字符target-slug.mjs支持文件路径、URL 和route:前缀三种目标形式写入时附加 frontmatterversion: 1、slug、primary_target、related_targets解析端按主目标精确匹配reason: slug或映射匹配reason: mapping回读surface-briefs.mjs读写入口为 surface-brief.mjs 的path / list / read / write四个子命令。而 shape 自身运行时的上下文PRODUCT.md、DESIGN.md、已解析的 surface brief、平台指引由 context.mjs 的loadContext()一次性注入。这也解释了为何 SKILL.md 要求每会话只运行一次 context.mjs 且不得重跑。以 WhoDB 本仓库为例shape 访谈中独特为真与反目标问题的答案在本仓库中可以直接对照 PRODUCT.md 找到已固化的实例WhoDB 面向管理多数据库系统、常在故障或维护窗口中切换数据库的 DBA/DevOps 用户设计原则包括速度即功能密度而不杂乱安静的自信并明确列出三类 anti-referencesphpMyAdmin 式杂乱、企业级臃肿、过度 playful 的 SaaS 风PRODUCT.md——这正是 shape 简报第 1、2、4 要素audience、outcome and proof、anti-goals在真实项目中的落样。视觉侧的既定决策则记录在 DESIGN.md 的 frontmatter 中明暗双主题色板、品牌橙#F4781C等属于 new-work/document 流程的产物shape 不触碰它。七、适用前提与限制小结shape 属于 Impeccable 技能的一部分仅适用于前端 UI/UX 任务技能描述明确 Not for backend-only or non-UI tasksSKILL.mdshape 的前置条件是产品事实已被 init 流程写入 PRODUCT.md否则 context.mjs 的BUILD_INIT_REQUIRED指令会强制先走 init.mdshape 的访谈是有界的一轮为默认第二轮仅在有实质缺口时启用且从不询问 CSS 值或审美赛道shape 的终点是确认并停止它不写代码、不写 DESIGN.md、不写 surface brief——这些分别归属后续的构建流程与 document.md、surface-brief.mjs 持久化路径。这套设计体现了 WhoDB 仓库对 Agent 工作流的一个通用取舍把发现—决策—执行拆成边界清晰、各自可停止的阶段使每一步的产物PRODUCT.md、方向契约、确认的简报、DESIGN.md都能被后续会话独立审计而不依赖某次对话的上下文。赞分享数据库客户端后端前端CLI桌面应用数据可视化AI 应用【免费下载链接】whodbWhere data access meets operational intelligence项目地址https://gitcode.com/gh_mirrors/wh/whodb点击查看免费下载相关推荐Impeccable shape 命令完全指南先提问、再定稿、不写代码的 UX/UI 规划流程Impeccable shape 命令完全指南先提问、再定稿、不写代码的 UX/UI 规划流程 本文面向使用 AI 编码助手做前端界面设计的开发者。ImpecAI 技能前端CLIdsh-pluginImpeccable shape 命令详解写代码前先完成一轮被确认的 UX 设计简报Impeccable shape 命令详解写代码前先完成一轮被确认的 UX 设计简报 在 AI 辅助前端开发中最常见的失败模式之一是跳过规划直接写代码AI 技能前端CLIdsh-plugin用 Impeccable 的 shape 命令在写任何代码之前确定 UX/UI 设计方向访谈 → 方向解析 → 确认简报用 Impeccable 的 shape 命令在写任何代码之前确定 UX/UI 设计方向访谈 → 方向解析 → 确认简报 本文是 Impeccable 设计工AI 技能前端CLIdsh-plugin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考