用途
start 是 ui-craft 技能体系中的入口子技能，定位为“前门”。它帮助用户了解当前项目处于什么状态，以及 ui-craft 此刻能为该项目做什么，然后引导用户进入合适的下一步命令。多数人第一次使用 ui-craft 时会先运行它。
主要能力
该子技能遵循“仅编排”规则：只检测状态并路由，不构建、不编辑、不审计、不重新实现任何阶段逻辑。它只贡献三件事：
- 项目检测（只读）。
- 跨三个使用层级的“当前可用能力”地图。
- 一个推荐的下一步动作及其对应命令。
当用户想要执行操作时，它会把任务交给真实命令（/brief、/tokens、/sddesign、/craft、/finalize、审查代理等），不会内联这些命令的步骤。
使用方式
第一步：检测（只读）
扫描项目，不写入任何内容，收集以下信号：
- 框架 / 样式：通过 package.json 依赖、配置文件、文件扩展名检测 Tailwind、CSS Modules、styled-components/Emotion、原生 CSS、Vue/Svelte/Astro SFC，用于确认 ui-craft 适配该技术栈。
- 令牌主干：检测 CSS 变量（--color-、--accent-、--font-*）、Tailwind theme.extend、令牌文件，用于判断是否需要运行 /tokens。
- Brief：检测 .ui-craft/brief.md 是否存在，用于判断是否需要运行 /brief。
- 外部设计契约：检测仓库根目录的 DESIGN.md 或 design-tokens.json（部分团队采用的生态约定），将其视为 brief 与令牌输入，读取并遵循，不重复创建。
- Spec：检测 .ui-craft/spec.md 是否存在、涉及哪些界面，用于判断是否有进行中的工作。
- 运行环境：区分 Claude Code（插件/技能）与 .codex/.cursor/.gemini/.opencode/.agents 镜像，判断哪些层级可达（agents/MCP 仅限 Claude Code / MCP 客户端）。
- 现有 UI：判断已有组件/页面还是全新项目，用于决定是“新建”还是“审查/打磨”框架。
检测应快速且安静——少量读取，不做深度遍历。发现结果以简短表格报告。
第二步：报告三个层级
打印当前可用能力，映射到人们实际使用 ui-craft 的方式。每个层级标记为 ● 活跃 / ○ 可用 / – 在当前运行环境不可达。
ui-craft 是一个设计工程系统，用户可用的层级包括：
- ● 层级 1 — 直接提问：描述任意 UI，代理会以有品味的判断进行设计（反粗糙、系统令牌、真实层级）。无需命令，这是默认方式也是核心。
- ○ 层级 2 — 驱动它：用于聚焦处理的斜杠命令。根据当前项目给出定制列表。
- ○ 层级 3 — 验证它：design-reviewer 与 a11y-auditor 代理、ui-craft-mcp 门禁、UICraftScore、ui-craft-detect CLI。如果运行环境无法访问 agents/MCP，则标记为 – 并说明。
根据检测到的状态定制条目，不打印通用目录。
第三步：推荐一个下一步
从检测到的状态中选出单一最高价值的下一步动作，决策顺序如下：
- 无 brief 且项目非平凡 → 推荐 /brief（“将后续每个决策锚定到产品原则——5 分钟，写入 .ui-craft/brief.md”）。
- 有 brief 但无令牌主干 → 推荐 /tokens（“建立三层令牌主干，让构建匹配系统而非内联猜测”）。
- 有 brief 和令牌，正在构建全新内容 → 推荐 /sddesign <surface>（完整流水线）或 /craft <surface>（一次性），并询问选择哪个。
- 有现有 UI 需要改进 → 按意图路由：审查 → ui-craft:design-reviewer + ui-craft:a11y-auditor（Claude Code）或 /critique + /audit；打磨 → /polish；简化 → /distill；平淡/通用 → /bolder；喧闹/杂乱 → /quieter；过时网站现代化 → /redesign。
- 即将发布/合并 → 推荐 /finalize（10 轮门禁），CI 场景推荐 npx ui-craft-detect 或 score_ui MCP 工具。
以一行清晰文字打印：Recommended next: … — …。
仅在用户询问时提供完整菜单：“Want the full command list, or shall I run that now?”
第四步：交接
如果用户确认，运行推荐的命令。否则停止——/start 从不自行行动。一旦用户知道自己在哪里、该往哪里走，它的任务就完成了。
适用场景
- 首次在项目中使用 ui-craft，需要了解当前状态与可用能力。
- 不确定下一步该运行哪个命令时，获取单一推荐动作。
- 需要快速了解项目是否已有 brief、令牌、spec 等工件。
- 需要判断当前运行环境是否支持 agents/MCP 验证层级。
限制
- 只读：/start 不写入任何内容，不修改任何代码。工件（brief.md、spec.md、令牌）由各自的命令写入。
- 运行环境诚实：如果项目处于非 Claude Code 运行环境（.codex、.cursor 等），层级 3 的代理与 MCP 服务器可能无法从该代理访问，需明确说明并指向 CLI（ui-craft-detect）作为可移植的验证路径。
- 工艺意图路由：全界面构建（/craft、/sddesign）在写代码前声明 Craft Read。如果用户将已构建的 UI 描述为“通用”“模板感”或“太安全”，路由到 /bolder；如果“太吵”或“太忙”，路由到 /quieter。
- 不重复 Discovery：如果 brief 或 spec 已存在，不要向用户询问偏好——读取工件并报告。
- 下一步：遵循本次运行指定的阶梯。/start 是只读的——其价值在于执行它选中的那一个命令。