start

背景： 此子技能是更广泛的 ui-craft 技能的一个视角。如果也安装了 ui-craft 技能，请先阅读其 SKILL.md，了解 Discovery + Anti-Slop + Craft Test，然后再应用下方的特定视角。

为用户指明方向。加载 ui-craft 技能，阅读当前项目，并报告 ui-craft 现在能为该项目做什么。这是入口——大多数人会先运行它。

---

仅编排规则

此命令负责检测状态并路由。它绝不能构建、编辑、审查或重新实现任何阶段逻辑。它仅负责：

1. 项目检测（只读）。
2. 绘制涵盖三个使用层级的“当前可用项”图谱。
3. 推荐一个下一步操作，以及运行该操作的命令。

当用户想要采取行动时，将其交给真正的命令（/brief、/tokens、/sddesign、/craft、/finalize、审查 Agent 等）。不要在此处直接执行它们的步骤。

---

步骤 1 — 检测（只读）

扫描项目。不要写入任何内容。收集：

信号	检测方式	用途
框架 / 样式	package.json 依赖项、配置文件、文件扩展名——Tailwind、CSS Modules、styled-components/Emotion、vanilla CSS、Vue/Svelte/Astro SFC	确认 ui-craft 能适配此技术栈
Token 主干	CSS 变量（--color-*、--accent-*、--font-*）、Tailwind theme.extend、token 文件	门槛：是否需要 /tokens？
Brief	.ui-craft/brief.md 是否存在？	门槛：是否需要 /brief？
外部设计约定	仓库根目录中的 DESIGN.md 或 design-tokens.json（一些团队采用的生态惯例）	将其视为 brief + token 输入——阅读并遵循，不要重复创建
Spec	.ui-craft/spec.md 是否存在？涵盖哪些界面？	是否有进行中的工作？
运行环境	Claude Code（插件/技能）还是 .codex/.cursor/.gemini/.opencode/.agents 镜像	哪些层级可用（Agent/MCP 仅适用于 Claude Code / MCP 客户端）
现有 UI	是否已有组件/页面，还是全新项目？	确定采用全新构建还是审查/润色的思路

检测要快速、安静——只读几处，不要深度遍历。用简短表格报告结果。

---

步骤 2 — 报告三个层级

根据人们实际使用 ui-craft 的方式，列出当前可用项。每个层级标记为 ● 已激活 / ○ 可用 / – 在此运行环境中不可用。

ui-craft is a design engineering SYSTEM. You're set up for:

● Layer 1 — Just ask
    Describe any UI and the agent designs with taste (anti-slop, system tokens,
    real hierarchy). No command needed. This is the default and the point.

○ Layer 2 — Drive it
    Slash commands for focused passes. Given THIS project:
      <tailored list — see Step 3>

○ Layer 3 — Verify it
    design-reviewer + a11y-auditor agents · ui-craft-mcp gates · UICraftScore · ui-craft-detect CLI.
    <mark – if the harness can't reach agents/MCP, and say so>

根据检测到的状态调整要点——不要照搬通用目录。

---

步骤 3 — 推荐一个下一步

根据检测到的状态，按以下顺序选择价值最高的单一后续操作：

1. 没有 brief，且项目并非简单项目 → 推荐 /brief（“让后续每项决策都以产品原则为依据——5 分钟，写入 .ui-craft/brief.md”）。
2. 已有 brief，没有 token 主干 → 推荐 /tokens（“建立 3 层 token 主干，让构建遵循系统，而不是依赖行内猜测”）。
3. brief 和 tokens 均已存在，正在构建全新内容 → 推荐 /sddesign <surface>（完整流程）或 /craft <surface>（一站式）——询问用户选择哪一个。
4. 需要改进现有 UI → 根据意图分流：审查 → ui-craft:design-reviewer + ui-craft:a11y-auditor（Claude Code）或 /critique + /audit；润色 → /polish；简化 → /distill；风格平淡/普通 → /bolder；视觉喧闹/繁杂 → /quieter；需要现代化改造的过时网站 → /redesign。
5. 即将发布 / 合并 → 推荐 /finalize（10 轮检查），CI 中则推荐 npx ui-craft-detect 或 score_ui MCP 工具。

用一行清楚地列出：

推荐的下一步： … — <一句话说明原因>。

只有在用户询问时，才提供完整菜单：“想看完整命令列表，还是现在就运行它？”

---

步骤 4 — 交接

如果用户确认，就运行推荐的命令。否则停止——/start 不会自行执行操作。只要用户知道当前所处阶段以及下一步该做什么，它的任务就完成了。

---

备注

• 只读。 /start 不会写入任何内容，也不会更改代码。产物（brief.md、spec.md、tokens）由各自的命令写入。
• 如实说明运行环境。 如果项目运行在非 Claude-Code 运行环境（.codex、.cursor 等）中，Layer 3 Agent 和 MCP 服务可能无法从该 Agent 访问——请明确说明，并指出 CLI（ui-craft-detect）是可移植的验证方式。
• 按设计意图路由。 全界面构建（/craft、/sddesign）会在编写代码前声明一次 Craft Read。如果用户将构建好的 UI 描述为“普通”“像模板”或“过于保守”，请转到 /bolder；如果说“太喧闹”或“太繁杂”，请转到 /quieter。
• 不要重新运行 Discovery。 如果 brief 或 spec 已存在，不要询问用户的偏好——读取这些产物并汇报。

下一步： 按照本次运行指定的步骤继续。/start 是只读的——关键在于执行它选出的那条命令。