design-studio 是做什么的?
<studio> 是包含此 SKILL.md 的文件夹。在 Windows 上,如果 python3 缺失,请使用 python;并使用 modules/impeccable/scripts/impeccable.cmd 代替未经处理的启动器。
加载
- 此文件。
- 路线所需的守则:doctrine/workflow.md、doctrine/principles.md、doctrine/gate.md;doctrine/conflicts.md 当模块之间存在分歧时。
- 仅加载下方路由到的
MODULE.md文件,以及它们指向的引用。
绝不加载每个模块。供应商提供的 MODULE.md 文件不是独立的技能。
优先级
- 用户的明确指示和真实品牌资产
- 项目的
DESIGN.md/PRODUCT.md - design-studio 的守则
- 活动模块的规则
- ui-ux-pro-max 数据库的建议——输入,而非决策;每个建议都必须通过“Slop”门槛
路由
/design-studio <route> [target]。如果没有指定路由,则根据请求推断。
| 意图 / 参数 | 加载 | 备注 |
|---|---|---|
build — 落地页、营销页、作品集、公共页面 | modules/taste/MODULE.md + modules/impeccable/MODULE.md (persuade) | ui-ux-pro-max 仅用于技术栈指南 |
app — 仪表盘、设置、表单、产品 UI、原生屏幕 | impeccable (operate) + taste references/app-screens.md | ui-ux-pro-max 技术栈 + UX 指南 |
direction — 配色方案、字体、风格 | 优先使用 taste 库;其次搜索 modules/ui-ux-pro-max/MODULE.md 并进行 Slop 过滤 | 写入 DESIGN.md |
review / audit / roast | modules/ai-design-review/MODULE.md及其报告格式 | 下方扫描器;去重为 ID |
polish bolder quieter typeset colorize animate harden clarify distill delight adapt onboard optimize layout overdrive shape init document extract critique audit live generate | impeccable 命令参考 | pin/unpin 禁用 |
slides / deck / presentation | modules/slides/MODULE.md | template-library/ 作为最后手段;.pptx → pptx 技能 |
diagram (+ import mermaid|drawio|excalidraw, export) | modules/diagrams/MODULE.md + commands/ | |
| 应用中的图表 | 如果安装了 dataviz 技能则使用,否则使用 ui-ux-pro-max 图表领域 | |
| 长篇文案 | 使用 ai-design-review 的文案提示;如果安装了 unslop 技能则使用 | |
hooks on|off|status | impeccable reference/hooks.md | 下方钩子策略 |
工作流程
简要 (PRODUCT.md) → 方向 (DESIGN.md) → 构建 → 审视 → 网关 (Gate) → 报告。详情:doctrine/workflow.md。
Taste 的工作文件保留在 .taste-skill/ 中。将选定的方向总结到 DESIGN.md 中,以便每个模块只读取一个文件。
网关 (Gate)
完成条件:已检查发布尺寸;相关扫描器已运行;零个 P0;每个 P1 都有简要说明的正当理由;新 UI 的通用性评分 ≤ 3/10;SD1–SD5 通过;无虚构内容;应用 UI 具有空/加载/错误状态;报告列出了运行的层级。完整表格:doctrine/gate.md。
审查扫描器(去重到目录 ID):
node <studio>/modules/ai-design-review/scripts/scan.mjs <target> --json
<studio>/modules/impeccable/scripts/impeccable detect <target>
node <studio>/modules/taste/scripts/lint.mjs <target>
Windows 下的 detect:<studio>\modules\impeccable\scripts\impeccable.cmd detect <target>。
钩子策略
默认关闭。绝不静默启用。
在真实项目的 build 或 app 路由开始时,运行:
<studio>/modules/impeccable/scripts/impeccable hooks status
提议用户选择加入,用一句话说明原因,当 满足以下任一条件时:任务将涉及 ≥3 个 UI 文件或跨越多轮对话;审查发现 ≥2 个机械性的 P0/P1 问题(对比度、渐变文本、发光、溢出、设计系统漂移);用户要求持续强制执行。
说明:通过 .claude/settings.local.json(Claude Code)或 .cursor/hooks.json(Cursor)进行每次编辑扫描。Cursor 仅获得每次编辑检查,无 Stop 深度扫描。指向 <studio>/modules/impeccable/scripts/impeccable。
尊重 .impeccable/config.local.json 中的 hook.consent。在该项目中不再询问。
如果用户接受:impeccable hooks on。如果用户拒绝:hooks off 并且不再询问。
环境
| 需求 | 使用者 | 如果缺失 |
|---|---|---|
| Node 18+ | scan.mjs | 跳过扫描器,并说明原因 |
| Node 22+ | taste draw / lint / inspect | 跳过 taste 脚本 |
| Python 3 | ui-ux-pro-max, diagram verify-geometry | 跳过那些功能 |
| Chrome / Edge | taste inspect, impeccable URL detect | 跳过视觉浏览器层级 |
| Playwright | 幻灯片 PDF 导出 | 跳过 PDF |
| python-pptx | PPT 导入 | 跳过导入 |
模块地图
| 路径 | 角色 |
|---|---|
modules/taste/ | 艺术指导 (draw.mjs), lint/inspect |
modules/impeccable/ | 工艺命令, detect, hooks |
modules/ui-ux-pro-max/ | 可搜索的样式 / 配色方案 / 技术栈 |
modules/ai-design-review/ | 问题目录, 扫描, 审查报告 |
modules/slides/ | HTML 幻灯片;template-library/ 是实现参考 |
modules/diagrams/ | HTML/SVG 图表 |