open-design

name	open-design
description	Use Open Design as an external local-first design workbench for prototypes, decks, mobile screens, dashboards, DESIGN.md systems, and exportable visual artifacts. Keep TSP responsible for team workflow, handoff, and quality gates.
origin	nexu-io/open-design (reference-only controlled integration)

Open Design

用途

• 用 Open Design 生成或迭代高保真视觉 artifacts：web prototype、dashboard、mobile flow、deck、poster、social carousel、runbook/spec 类页面。
• 在前端任务中把 DESIGN.md、设计方向、skill、preview 和 export 结果作为证据回落到 TSP 主链。
• 让 product-manager、frontend-engineer、qa-engineer 在同一套可预览 artifact 上讨论，而不是只靠文字描述。

触发信号

• 用户要“像 Claude Design 那样”快速生成可编辑原型、deck、营销页、移动界面或设计系统。
• 需求还没有稳定视觉方向，需要先通过表单、方向 picker 或 DESIGN.md 锁定风格。
• /team-plan 或 /team-execute 进入 UI 实施前，需要可截图、可导出、可评审的设计证据。
• /team-review 需要对 artifact 做视觉、响应式、可访问性、反 AI 味、导出完整性检查。

默认工作流

1. 先完成 TSP 侧任务收敛：
   • 目标、受众、页面/屏幕范围、数据真实性、品牌约束、响应式范围、A11y/性能门禁。
   • 若任务来自 /team-*，把这些约束写入 artifact 或 handoff，不只留在聊天里。
2. 检查目标项目是否已有 DESIGN.md：
   • 有：把它作为 Open Design 的 active design system 或直接放入 OD 项目工作目录。
   • 无：先用 frontend-ui-ux-system 或 OD 的 design-system 能力生成候选 DESIGN.md。
3. 若用户安装的是 TSP full profile，Open Design 默认会由 TSP 安装器准备到 ~/.tsp/open-design；否则在独立 Open Design checkout 中运行上游工具，不在 TSP 仓库里启动 OD daemon：

   # full profile 自动路径
   cd ~/.tsp/open-design
   
   # 手动路径
   git clone https://github.com/nexu-io/open-design.git
   cd open-design
   corepack enable
   pnpm install
   pnpm tools-dev
   

4. 在 OD 中选择合适 surface：
   • prototype：web-prototype、saas-landing、dashboard、mobile-app 等。
   • deck：guizang-ppt、simple-deck、weekly-update 等。
   • document-like：pm-spec、eng-runbook、finance-report、team-okrs 等。
5. 生成后把关键产物回落到 TSP：
   • artifact 路径或导出文件
   • 使用的 OD skill、design system、visual direction
   • 约束与自检结论
   • 对 /team-plan、/team-execute、/team-review 或 /team-release 的决策影响
6. 若 artifact 会进入实现，frontend 角色必须继续执行 TSP 前端门禁：
   • 响应式、键盘访问、对比度、性能、加载/空态/错误态
   • 真实数据与授权素材检查
   • 不能把 OD 输出直接视为生产代码完成

输出约定

• TSP 侧只沉淀集成证据，不复制 Open Design 源码或生成数据库。
• 推荐在消费方项目中落盘：
  • docs/artifacts/<date>-open-design-brief.md
  • docs/artifacts/<date>-open-design-review.md
  • 需要长期复用时，将最终 DESIGN.md 放在项目根目录或设计文档目录。
• 最小交付字段：
  • 任务目标
  • 使用的 OD skill / design system / visual direction
  • 产物路径或导出格式
  • 主要设计决策及证据
  • 风险、未验证项、下一步 TSP 命令

边界与禁用项

• 只有 TSP full profile 会自动 clone/update Open Design；其他 profile 只安装 TSP 侧 skill/runbook。
• 不把 Open Design 当作 TSP 的默认 npm 依赖；它要求独立 Node/pnpm/daemon 生命周期。
• 不在本仓库 vendoring Open Design 的 skills/、design-systems/、daemon、web app 或 SQLite 数据。
• 不把 OD 的视觉结果绕过 /team-review 直接发布。
• 不使用未授权品牌素材、字体、截图或第三方图片作为可分发 artifact。
• 不在 TSP 管理仓库中运行会改写本仓库 hooks、AGENTS 或 MCP 契约的外部 setup 命令。

推荐组合

• 需求到原型：/team-intake -> frontend-ui-ux-system -> open-design -> /team-plan
• UI 实施：/team-execute -> open-design artifact evidence -> frontend-engineering -> /handoff
• 视觉评审：/team-review -> open-design artifact review -> browser-smoke-testing
• Deck / 汇报材料：frontend-slides -> open-design deck mode -> /team-release