用途
该子技能是更广泛的 ui-craft 技能中的一个视角,专门负责撰写或更新项目持久化的设计简报,输出到 .ui-craft/brief.md。当用户要求为其 UI 撰写 brief,或在设计语境下提到 brief 时触发。若 ui-craft 技能也已安装,应先阅读其 SKILL.md 了解 Discovery、Anti-Slop 和 Craft Test,再应用该视角。
主要能力
撰写新简报:引导用户完成五个必需部分——产品目的、主要用户、原则、成功指标、范围之外。
更新已有简报:若 .ui-craft/brief.md 已存在,加载其内容;若用户指定了具体更新点(如更新原则、切换目标用户、增加范围之外内容),聚焦该部分并跳过未改动部分;否则汇总现有内容并询问要改什么。
与既有设计契约协调:若仓库根目录存在 DESIGN.md 或 design-tokens.json,读取并据此预填简报答案,而不是重复提问,并注明来源。简报补充既有设计契约,绝不与之矛盾。
原则工作坊:当用户没有原则或回答含糊(如“做好一点”“保持简单”)时,不凭空编造,而是先加载 references/principles-catalog.md,其中含 8 个产品类别下 42 条示例原则,作为对话种子而非直接套用模板。展示与用户产品最接近类别的 2-3 条,询问哪些有共鸣或会被反转,再作为子流程运行原则工作坊:询问三个曾引发争论的过往设计决策,从中推导候选原则。拒绝空泛套话。
解析长输入:若用户提供产品描述或 PRD,将其解析为五个部分而非重复提问,说明提取了什么并请求确认或修正。
使用方式
第一步:检测现有简报。检查是否已存在 .ui-craft/brief.md,使用 Read 或 ls 查看 .ui-craft/ 目录。
第二步:起草新简报(不存在时)。一次性走完五个部分,每部分只问一个紧凑问题,除非用户要求深入,否则不打开五个独立提示。紧凑提示模板会要求用户简洁回答五件事:产品目的(一句话说明它做什么)、主要用户(按角色和场景)、原则(三到五个立场)、成功指标(用户在该界面成功的可观察行为)、范围之外(三到五项该界面刻意不做的事)。
第三步:写盘前展示。始终先完整展示提议的简报,询问“这样对吗,还是需要调整?”确认后才写入。
第四步:写入文件。创建 .ui-craft/ 目录(若不存在),将确认内容写入 .ui-craft/brief.md。文件必须包含 references/brief.md 中全部五个部分及精确标题,不得遗漏。
第五步:写盘后。告知用户文件位置,建议提交到仓库,说明这是文档而非配置,agent 每次会话都会读取。不自动提交,按项目规则提交需用户明确指示。
后续步骤:/tokens —— 简报决定意图,token 将其编码(第 2 级)。
适用场景
适用于需要为 UI 项目建立或维护持久化设计简报的团队与开发者,尤其涉及设计决策讨论、用户定位、产品原则梳理和成功指标定义的场景。
限制
五个部分均为必需。若某部分确实未知,须写为带日期的占位符,如 [TO DEFINE — YYYY-MM-DD],使缺口可见。
更新时以追加为主,永不删除过往内容,淘汰内容需标注日期和原因。
简报内不得出现品牌名、产品示例或通用 SaaS 语言;简报描述用户自己的产品,而非模板。
原则工作坊中,每个部分最多两次追问,之后标记为不完整并继续。
不自动提交,提交需用户明确指示。