design-brief-builder
基于设计证据、产品意图和实现约束,编写简洁的 Agent Harness 5.0 Design-Brief。
SKILL.md.agents/skills/design-brief-builder/SKILL.md
GitHub何时使用
- 需要把设计稿、用户说明、Product-Spec.md、讨论记录或验收反馈整理成可执行的 Design-Brief 时使用。
- 实现前缺少明确目标、成功标准、边界、约束或优先级,导致编码容易变成猜测时使用。
- 需要为 design-maker、dev-planner 或实现 agent 提供统一设计意图和验收口径时使用。
依赖输入
- 设计稿、截图、原型、参考图或视觉验收反馈优先级最高。
- 已有 Design-Brief 次之;没有 Brief 时再使用 Product-Spec.md、用户叙述、issue、PR 或会议记录。
- 需要已知平台、目标用户、关键流程、不可做事项、技术约束、品牌/内容素材和验收偏好。
- 重型领域知识、长规范、竞品分析、样式词库和研究材料应放入
references/,正文只保留必要指针。
第一性原则与边界
- Agent Harness 5.0 由目标、标准、边界驱动:先定义要达成什么、如何判断达成、哪些不能越界。
- 设计稿优先于 Design-Brief,Design-Brief 优先于 Product-Spec.md;冲突时保留最高优先级来源并标出差异。
- Brief 是执行契约,不是长篇流程、完整研究报告或实现步骤清单。
- 不虚构缺失事实;对未知项、风险和待确认点保持显式标注。
- 保持精炼,避免把可按需加载的知识塞进主文档。
验收标准
- 明确用户目标、核心场景、范围、非目标、设计依据和优先级。
- 每个关键体验都有可观察、可验证的成功标准。
- 约束足以防止实现 agent 误选方向,包括视觉、交互、内容、技术和项目边界。
- 冲突、假设、未确认输入和需要 references 支撑的内容被单独标出。
产出
- 一份精炼 Design-Brief,包含目标、用户/场景、设计来源、范围边界、体验标准、验收标准和开放问题。
- 必要时附 references 索引,而不是在 Brief 中展开重型知识。