在 UI/前端设计工作中创建或更新项目持久设计…

适用于任何需要在 UI/前端设计中建立或更新持久设计 brief 的协作场景。

适用场景

解决思路

1. 如果 ui-craft 也已安装，先阅读其 SKILL.md，获取 Discovery、Anti-Slop、Craft Test，再应用本 brief lens。
2. 在继续前加载 references/brief.md，获取 brief 格式。
3. 用 Read 或 ls 检查 .ui-craft/ 下是否存在 .ui-craft/brief.md。
4. 如果 .ui-craft/brief.md 存在：加载其内容；如果 $ARGUMENTS 指定具体更新（如「update principles」「shift target user」「add out of scope」），聚焦该处并跳过未变更章节；否则总结 brief 中已有内容并询问「你想改什么？」。
5. 如果 .ui-craft/brief.md 不存在：进入 Step 2；同时检查仓库根目录是否有 DESIGN.md 或 design-tokens.json。
6. 如果仓库根目录存在 DESIGN.md 或 design-tokens.json，读取并用它预填 brief 答案，而不是重复询问，并注明来源；brief 补充已有 design contract，绝不与之矛盾。
7. 在新 brief 缺失场景，一次遍历引导用户完成五个必需部分；每个部分只问一个紧凑问题；除非用户要求深入，不要打开五个独立提示。
8. 使用紧凑提示模板询问五件事：1 Product purpose——用一句话说明产品做什么；2 Primary user——按角色和场景，用户是谁；3 Principles——产品相信什么，给出三到五个立场，若还没有就说出来，我会运行 principles workshop；4 Success metric——在这个界面上「用户成功」在可观察行为上是什么样；5 Out of scope——这个界面刻意不做的三到五件事。
9. Principles workshop 情况：如果用户说还没有原则，或回答模糊（如「make it good」「keep it simple」），不要从模糊输入捏造原则。
10. 先加载 references/principles-catalog.md；该 catalog 有 8 个产品类别下 42 条成品示例原则；把它们用作对话种子，不要逐字套用为模板。
11. 展示与用户产品最接近类别的 2-3 条原则，然后询问哪些有共鸣，或哪些他们会反过来选择。
12. 然后按 references/brief.md 运行 principles workshop 作为聚焦子流程：询问三个过去被争论过的设计决策，再从这些模式中推导候选原则。
13. 拒绝接受空泛套话——要反驳并促使用户补充实质内容。
14. 解析长输入：如果用户提供产品描述或 PRD，从中解析出五个部分，而不是重新询问已给信息；说明你提取了什么，并请求确认或纠正。
15. 处理单薄回答：如果回答过于模糊，无法约束设计决策，问一个针对性追问；每个部分最多两个追问，之后标记为不完整并继续。
16. 写文件前先展示：始终在写入文件前完整展示提议的 brief，并询问「这看起来对吗，还是有要调整的地方？」。
17. 未确认前不要写入。
18. 写入文件：如果 .ui-craft/ 不存在则创建；将确认后的内容写入 .ui-craft/brief.md。
19. 文件必须包含全部五个部分，并使用 references/brief.md 中的确切标题；不得省略。
20. 写完后，告诉用户文件位于 .ui-craft/brief.md；建议提交：把 .ui-craft/brief.md 提交到仓库——它是文档，不是配置，agent 每次会话都会读取它。
21. 不要自动提交；按项目规则，提交需要用户明确指示。
22. 约束：全部五个部分必需；如果某个确实未知，写成带日期的占位符 [TO DEFINE — YYYY-MM-DD]，让缺口可见。
23. 约束：更新时 brief 以追加为主；绝不要删除过往内容——用日期和原因标记为 deprecated。
24. 约束：用户 brief 中不要出现品牌名、产品示例或通用 SaaS 语言；brief 描述他们的产品，而不是模板。
25. 下一步：建议运行 /tokens——brief 决定意图，tokens 编码意图（rung 2）。

适用边界 · 注意事项

• 用户没有做 UI、设计或前端相关工作，也未要求 brief 时，不要调用。
• 用户只想立刻改代码或实现功能，而不需要建立或更新持久设计 brief 时，不适合。
• 已有 DESIGN.md 或 design-tokens.json 时，不要另起炉灶或与其矛盾；应预填并补充，而不是替代。