Init App

模式检测

核心原则：用户意图优先于文件检测。

1. 先判断用户意图：
   - 用户描述了具体系统（如「生成CRM系统」「做一个项目管理」）→ 直接 Mode C，不检查文件
   - 用户说「基于 spec 生成」「基于方案生成」→ 检查对应文件
   - 用户说「生成 demo」「init-app」等泛指 → 按文件优先级检测

2. 仅当泛指时，按文件检测：
   a. docs/spec/spec.md 存在 → Mode A
   b. 否则 docs/plan/solution.md 存在 → 使用 `AskUserQuestion` 询问用户：
      ```
      AskUserQuestion({
        questions: [{
          question: "检测到已有解决方案（docs/plan/solution.md），请选择 Demo 生成方式：",
          options: [
            { label: "先生成 Spec 再生成 Demo", description: "推荐，精度最高。先运行 /spec-writer，再基于 Spec 生成" },
            { label: "直接基于方案生成 Demo", description: "速度快，但页面结构为推断" }
          ]
        }]
      })
      ```
      用户选「先生成 Spec 再生成 Demo」→ 自动执行 /spec-writer 生成 spec.md，完成后继续以 Mode A 执行
      用户选「直接基于方案生成 Demo」→ Mode B
   c. 否则 → Mode C

禁止反复追问：

• 用户给出了系统类型（如 CRM、ERP、项目管理），不要再问子类型和使用对象
• 一次只问一个问题
• 只有用户描述完全无法判断系统类型时（如只说了「做个管理系统」），才用一个选项确认
• 确认后立即执行，不再追问细节

执行流程

始终使用 1 个 Agent，调用 prompts/generate.md 完成分析 → 生成 → 验证。

禁止多 Agent 并行：多个 Agent 操作同一文件系统会导致文件竞争、import 错误和反复 build-fix 循环，实际更慢更贵。

增量更新

当再次运行时，如果 docs/spec/.spec-mapping.yaml 存在：

1. 比对 specHash → 无变化则输出「无更新」并停止
2. 有变化时标记模块：
   • 新模块 → 生成
   • 变更模块（未锁定） → 重新生成
   • 锁定模块（locked: true） → 跳过
   • 删除模块 → 警告（不自动删除文件）
3. 共享基础设施仅在 sitemap/dict 变化时重新生成

代码规范

• TypeScript 严格模式
• 函数组件 + Hooks
• Tailwind CSS 样式，语义化颜色 token
• shadcn/ui 组件规范
• 代码注释用英文

参考文件

目录结构

.claude/skills/init-app/
├── SKILL.md              # 本文件：编排器
├── design-guide.md       # 设计系统指南
└── prompts/
    └── generate.md       # 全合一 Agent Prompt（分析+生成+验证）

与其他 Skill 的关系