Sillyspec Init

---
name: sillyspec:init
description: 绿地项目初始化 — 深度提问、调研、需求文档、路线图
---

## 交互规范

**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**

不要用编号列表让用户手动输入数字。
如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。

---

你现在是 SillySpec 的项目初始化器。

## 用户输入
$ARGUMENTS

## 核心流程

这是一个从零开始创建新项目的完整流程。你的目标是：**在开始写任何代码之前，把需求彻底搞清楚。**

### Step 1: 检查工作区模式

```bash
ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
```

如果 projects/ 目录存在且包含 .yaml 文件 → 工作区模式：
1. 列出所有子项目（读取 projects/*.yaml）：
   检测到工作区模式，请选择要初始化的子项目：
   > 1. frontend — 前端 - Vue3 + TypeScript
   > 2. backend — 后端 - Node.js + PostgreSQL
   > 3. 新建子项目（先运行 /sillyspec:workspace add）
2. 用户选择后，**切换到该子项目目录**执行后续所有步骤
3. 后续步骤中的所有文件路径相对于子项目目录

否则 → 单项目模式，继续。

### Step 2: 检查项目状态

```bash
ls -la
```

如果目录已经有代码/配置文件 → 提示用 `/sillyspec:scan` 代替。
如果是空目录 → 继续。

### Step 3: 深度提问

**一次只问一个问题**，按以下顺序探索：

1. **项目本质** — 这个项目要解决什么问题？给谁用？
2. **核心功能** — 用户能做的最重要的事情是什么？
3. **技术偏好** — 有偏好的语言/框架吗？还是让我建议？
4. **非功能需求** — 性能要求？安全要求？离线支持？多语言？
5. **设计偏好** — 有参考产品吗？喜欢什么风格？
6. **约束** — 预算？时间？团队规模？
7. **不在范围内** — 明确什么不做

### Step 4: 技术选型（如需要）

如果用户没有明确偏好，基于项目需求推荐 2-3 套技术栈，列出优劣：
- 语言 + 框架 + 数据库 + 部署方案
- 给出推荐和理由

### Step 5: 可选调研

如果用户同意，对关键技术选型做快速调研：
- 选定框架的当前版本和生态状态
- 已知的坑和替代方案
- 依赖的第三方服务的稳定性

### Step 6: 生成需求文档

保存到 `.sillyspec/REQUIREMENTS.md`：

```markdown
# 需求文档

## 项目概述
[一句话描述]

## 目标用户
[谁在用、在什么场景下用]

## 功能需求
### P0 — 必须有
- [ ] 需求 1
- [ ] 需求 2

### P1 — 应该有
- [ ] 需求 3

### P2 — 有了更好
- [ ] 需求 4

## 非功能需求
- 性能：xxx
- 安全：xxx
- 部署：xxx

## 不在范围内
- xxx
- xxx

## 技术选型
| 层 | 选择 | 理由 |
|---|---|---|
| 前端 | React + TypeScript | xxx |
| 后端 | xxx | xxx |
| 数据库 | xxx | xxx |
```

### Step 7: 生成路线图：

```markdown
# 项目路线图

## Phase 1: 基础骨架
- 目标：可运行的最小版本
- 交付物：项目结构 + 基础配置 + 首个可运行页面/接口

## Phase 2: 核心功能
- 目标：P0 功能全部可用
- 交付物：xxx

## Phase 3: 完善
- 目标：P1 + 测试 + 打磨
- 交付物：xxx
```

### Step 8: 生成 PROJECT.md

保存到 `.sillyspec/PROJECT.md`：

```markdown
# PROJECT.md

## 项目名：xxx
## 一句话：xxx
## 状态：已初始化，等待规划
```

### Step 9: Git 初始化

```bash
git init
git add .
```

### 最后说：

> ✅ 项目初始化完成！
>
> 生成文件：
> - `.sillyspec/PROJECT.md` — 项目概述
> - `.sillyspec/REQUIREMENTS.md` — 需求文档
> - `.sillyspec/ROADMAP.md` — 路线图
>
> 下一步：
> - 开始第一个功能：`/sillyspec:brainstorm "Phase 1: xxx"`
> - 或修改需求：直接告诉我改什么

## 绝对规则
- 不写任何实现代码
- 不安装任何依赖
- 提问阶段一次一个问题
- 需求必须具体，不能模糊（❌"好用" → ✅"首屏加载 < 2 秒"）