speccrew 0.5.9 → 0.5.11

package/docs/GETTING-STARTED.md

@@ -62,7 +62,82 @@ speccrew init --ide qoder
 
 ---
 
-## 2. 工作流程总览
+## 2. 安装后5分钟快速开始
+
+执行 `speccrew init` 后，按以下步骤快速进入工作状态：
+
+### 第1步：选择你的 IDE
+
+| IDE | 初始化命令 | 适用场景 |
+|-----|-----------|----------|
+| **Qoder**（推荐） | `speccrew init --ide qoder` | 完整Agent编排、并行Worker |
+| **Cursor** | `speccrew init --ide cursor` | 基于Composer的工作流 |
+| **Claude Code** | `speccrew init --ide claude` | CLI优先开发 |
+| **Codex** | `speccrew init --ide codex` | OpenAI生态集成 |
+
+### 第2步：初始化知识库（推荐）
+
+对于已有源码的项目，建议先初始化知识库，让Agent理解你的代码库：
+
+```
+@speccrew-team-leader 初始化技术知识库
+```
+
+然后：
+
+```
+@speccrew-team-leader 初始化业务知识库
+```
+
+### 第3步：开始你的第一个任务
+
+```
+@speccrew-product-manager 我有一个新需求：[描述你的功能需求]
+```
+
+> **提示**：如果不确定该做什么，直接说 `@speccrew-team-leader 帮我开始` — Team Leader 会自动检测项目状态并引导你。
+
+---
+
+## 3. 快速决策树
+
+不确定该做什么？找到你的场景：
+
+- **我有新的功能需求**
+  → `@speccrew-product-manager 我有一个新需求：[描述你的功能需求]`
+
+- **我想扫描现有项目的知识**
+  → `@speccrew-team-leader 初始化技术知识库`
+  → 然后：`@speccrew-team-leader 初始化业务知识库`
+
+- **我想继续之前的工作**
+  → `@speccrew-team-leader 当前进度是什么？`
+
+- **我想检查系统健康状态**
+  → 在终端运行：`speccrew doctor`
+
+- **我不确定该做什么**
+  → `@speccrew-team-leader 帮我开始`
+  → Team Leader 会自动检测项目状态并引导你
+
+---
+
+## 4. Agent 快速参考
+
+| 角色 | Agent | 职责 | 示例指令 |
+|------|-------|------|----------|
+| 团队负责人 | `@speccrew-team-leader` | 项目导航、知识库初始化、状态查看 | "帮我开始" |
+| 产品经理 | `@speccrew-product-manager` | 需求分析、PRD 生成 | "我有一个新需求：..." |
+| 功能设计师 | `@speccrew-feature-designer` | 功能分析、规格设计、API 契约 | "开始迭代X的功能设计" |
+| 系统设计师 | `@speccrew-system-designer` | 架构设计、平台详细设计 | "开始迭代X的系统设计" |
+| 系统开发者 | `@speccrew-system-developer` | 开发协调、代码生成 | "开始迭代X的开发" |
+| 测试经理 | `@speccrew-test-manager` | 测试规划、用例设计、执行 | "开始迭代X的测试" |
+
+> **提示**：你不需要记住所有 Agent。只需与 `@speccrew-team-leader` 对话，它会将你的请求路由到合适的 Agent。
+
+---
+
+## 5. 工作流程总览
 
 ### 完整流程图
 
@@ -89,11 +164,11 @@ flowchart LR
 
 ---
 
-## 3. 第零步：知识库初始化
+## 6. 第零步：知识库初始化
 
 在开始正式工程流程前，需要先初始化项目知识库。
 
-### 3.1 技术知识库初始化
+### 6.1 技术知识库初始化
 
 **对话示例**：
 ```
@@ -115,7 +190,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # 索引文件
 ```
 
-### 3.2 业务知识库初始化
+### 6.2 业务知识库初始化
 
 **对话示例**：
 ```
@@ -139,9 +214,9 @@ speccrew-workspace/knowledges/bizs/
 
 ---
 
-## 4. 逐阶段对话指南
+## 7. 逐阶段对话指南
 
-### 4.1 阶段一：需求分析（Product Manager）
+### 7.1 阶段一：需求分析（Product Manager）
 
 **如何启动**：
 ```
@@ -168,7 +243,7 @@ iterations/{序号}-{类型}-{名称}/01.product-requirement/
 
 ---
 
-### 4.2 阶段二：功能设计（Feature Designer）
+### 7.2 阶段二：功能设计（Feature Designer）
 
 **如何启动**：
 ```
@@ -195,7 +270,7 @@ iterations/{iter}/02.feature-design/
 
 ---
 
-### 4.3 阶段三：系统设计（System Designer）
+### 7.3 阶段三：系统设计（System Designer）
 
 **如何启动**：
 ```
@@ -226,7 +301,7 @@ iterations/{iter}/03.system-design/
 
 ---
 
-### 4.4 阶段四：开发实现（System Developer）
+### 7.4 阶段四：开发实现（System Developer）
 
 **如何启动**：
 ```
@@ -257,7 +332,7 @@ iterations/{iter}/04.development/
 
 ---
 
-### 4.5 阶段五：系统测试（Test Manager）
+### 7.5 阶段五：系统测试（Test Manager）
 
 **如何启动**：
 ```
@@ -292,7 +367,7 @@ iterations/{iter}/05.system-test/
 
 ---
 
-### 4.6 阶段六：归档
+### 7.6 阶段六：归档
 
 迭代完成后自动归档：
 
@@ -308,9 +383,9 @@ speccrew-workspace/iteration-archives/
 
 ---
 
-## 5. 知识库说明
+## 8. 知识库说明
 
-### 5.1 业务知识库（bizs）
+### 8.1 业务知识库（bizs）
 
 **作用**：存储项目的业务功能描述、模块划分、API 特征
 
@@ -325,7 +400,7 @@ knowledges/bizs/
 
 **使用场景**：Product Manager、Feature Designer
 
-### 5.2 技术知识库（techs）
+### 8.2 技术知识库（techs）
 
 **作用**：存储项目的技术栈、架构约定、开发规约、测试规约
 
@@ -343,11 +418,11 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. 流水线进度管理
+## 9. 流水线进度管理
 
 SpecCrew 虚拟团队遵循严格的阶段门控机制，每个阶段必须经过用户确认后才能推进到下一阶段。同时支持断点续传 —— 中断后重新启动时，自动从上次停止的位置继续。
 
-### 6.1 三层进度文件
+### 9.1 三层进度文件
 
 工作流自动维护三类 JSON 进度文件，位于迭代目录下：
 
@@ -357,7 +432,7 @@ SpecCrew 虚拟团队遵循严格的阶段门控机制，每个阶段必须经
 | `.checkpoints.json` | 各阶段目录下 | 记录用户确认点（Checkpoint）通过状态 |
 | `DISPATCH-PROGRESS.json` | 各阶段目录下 | 记录并行任务（多平台/多模块）的逐项进度 |
 
-### 6.2 阶段状态流转
+### 9.2 阶段状态流转
 
 每个阶段遵循以下状态流转：
 
@@ -370,7 +445,7 @@ pending → in_progress → completed → confirmed
 - **completed**：Agent 执行完成，等待用户确认
 - **confirmed**：用户通过最终 Checkpoint 确认，下一阶段可以启动
 
-### 6.3 断点续传
+### 9.3 断点续传
 
 当重新启动某个阶段的 Agent 时：
 
@@ -378,7 +453,7 @@ pending → in_progress → completed → confirmed
 2. **恢复 Checkpoint**：读取 `.checkpoints.json`，跳过已通过的确认点，从上次中断处继续
 3. **恢复并行任务**：读取 `DISPATCH-PROGRESS.json`，只重新执行 `pending` 或 `failed` 状态的任务，跳过已 `completed` 的任务
 
-### 6.4 查看当前进度
+### 9.4 查看当前进度
 
 通过 Team Leader Agent 查看流水线全景状态：
 
@@ -397,13 +472,13 @@ Pipeline Status: i001-user-management
   05 System Test:    ⏳ Pending
 ```
 
-### 6.5 向下兼容
+### 9.5 向下兼容
 
 进度文件机制完全向下兼容 —— 如果进度文件不存在（如旧项目或全新迭代），所有 Agent 将按照原有逻辑正常执行。
 
 ---
 
-## 7. 常见问题（FAQ）
+## 10. 常见问题（FAQ）
 
 ### Q1: Agent 不按预期工作怎么办？
 
@@ -479,7 +554,7 @@ npm install -g speccrew@0.5.6
 
 ---
 
-## 8. 快速参考
+## 11. 快速参考
 
 ### Agent 启动速查表