specops 0.1.0

package/README.md

@@ -0,0 +1,630 @@
+# SpecOps — AI Agent 工作流状态轮转引擎
+
+> 让每个 Agent 在可配置的阶段间有序流转，并实时可视化展示各 Agent 的阶段、操作和工具使用情况。
+
+## 当前版本
+
+**v0.2.0** — Plugin 模式 + CI/CD
+
+### 已完成功能
+
+| 功能 | 阶段 | 说明 |
+|------|------|------|
+| ✅ Agent 状态机 | Phase 1 | 支持任意阶段序列的泛化状态机 |
+| ✅ 多 Agent 并发 | Phase 1 | Supervisor 协调多个子 Agent |
+| ✅ 状态持久化 | Phase 1 | JSON 原子写入 + 乐观锁 |
+| ✅ CLI 命令行 | Phase 1 | 18 个命令覆盖完整工作流 |
+| ✅ 技术守护 | Phase 2 | TECH-CONTEXT.md + 偏移检测脚本 |
+| ✅ 验收框架 | Phase 2 | E2E 测试 + 偷懒检测 + 报告生成 |
+| ✅ 上下文注入 | Phase 2 | Executor Agent 技术上下文自动注入 |
+| ✅ OpenCode Plugin | v0.2.0 | 8 个工具，AI Agent 直接操作 specops 状态 |
+| ⏳ Pipeline 编排 | Phase 3 | discuss→plan→execute→verify 全自动 |
+| ⏳ Web 看板 | Phase 4 | WebSocket + 实时看板 UI |
+
+---
+
+## 快速开始
+
+### CLI 模式
+
+```bash
+# 安装依赖
+cd kanban/v1
+npm install
+
+# 初始化新项目
+npx tsx src/cli.ts new-project -p my-project
+
+# 启动单个 Agent（默认分析阶段）
+npx tsx src/cli.ts start -p my-project
+
+# 启动 3 个 Agent（Supervisor 模式）
+npx tsx src/cli.ts start -p my-project -n 3
+
+# 查看状态
+npx tsx src/cli.ts status
+
+# 恢复中断的流转
+npx tsx src/cli.ts resume
+```
+
+### Plugin 模式（OpenCode）
+
+SpecOps 同时是一个 OpenCode Plugin。安装后，AI Agent 可以在 OpenCode 中直接调用 specops 工具，无需手动执行 CLI。
+
+在项目的 `.opencode/config.json` 中添加：
+
+```json
+{
+  "plugins": {
+    "specops": {
+      "type": "local",
+      "path": "/path/to/kanban/v1"
+    }
+  }
+}
+```
+
+加载后，Agent 可直接调用 `specops_status`、`specops_advance` 等 8 个工具。详见下方「Plugin 工具」章节。
+
+---
+
+## Plugin 工具
+
+SpecOps 作为 OpenCode Plugin 暴露 8 个工具，供 AI Agent 在对话中直接调用：
+
+| 工具名 | 功能 | 参数 |
+|--------|------|------|
+| `specops_status` | 获取项目当前状态（项目名、阶段、Agent 表格） | 无 |
+| `specops_advance` | 推进指定 Agent 到下一个阶段 | `agent_id`（可选） |
+| `specops_new_project` | 创建新项目，初始化 `.specops/state.json` | `project_name` |
+| `specops_update_operation` | 更新 Agent 的当前操作描述和使用的工具 | `agent_id`, `operation`, `skill` |
+| `specops_register_agent` | 注册新 Agent 到状态系统 | `agent_id`, `parent_id`（可选）, `phase`（可选） |
+| `specops_deregister_agent` | 从状态系统注销 Agent | `agent_id` |
+| `specops_progress` | 显示详细进度（完成百分比、阶段分布、Agent 详情） | 无 |
+| `specops_quick` | 快速任务模式，跳过完整 Pipeline 直接执行 | `task` |
+
+Plugin 入口文件：`src/plugin.ts`，通过 `@opencode-ai/plugin` SDK 注册工具。
+
+---
+
+## CLI 命令详解
+
+SpecOps CLI 共 18 个命令（含 help），覆盖项目初始化、状态管理、Pipeline 编排、Agent 注册等完整工作流。
+
+| 命令 | 说明 |
+|------|------|
+| `start` | 启动 Agent 工作流状态轮转 |
+| `status` | 查看 Agent 当前状态 |
+| `resume` | 恢复中断的 Agent 流转 |
+| `advance` | 推进指定 Agent 到下一个阶段 |
+| `update-operation` | 更新指定 Agent 的当前操作描述 |
+| `register` | 注册外部 Agent 到 state.json |
+| `deregister` | 从 state.json 注销指定 Agent |
+| `new-project` | 初始化新项目，创建 `.specops/` 目录和初始状态 |
+| `init` | 初始化项目，将 skill 和 agent 配置复制到 `.opencode/` |
+| `discuss` | 进入讨论阶段，收集需求和讨论方案 |
+| `plan` | 进入规划阶段，分解任务和制定计划 |
+| `execute` | 进入执行阶段，执行具体任务 |
+| `verify` | 进入验证阶段，验证成果和运行测试 |
+| `analyze` | 分析输入（需求文本、GitHub URL、网站 URL） |
+| `progress` | 显示详细项目进度（阶段分布、完成百分比） |
+| `quick` | 快速任务模式，不走完整 Pipeline |
+| `stop` | 停止引擎，清理所有 Actor |
+| `help` | 显示帮助信息 |
+
+### `specops start` — 启动 Agent 状态轮转
+
+```bash
+npx tsx src/cli.ts start [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `-p, --project <name>` | 项目名称 | `default` |
+| `-n, --agents <count>` | Agent 数量 | `1` |
+
+**示例:**
+
+```bash
+# 单 Agent 模式
+npx tsx src/cli.ts start -p my-saas
+
+# 输出:
+# 🚀 启动 Kanban Agent 引擎
+#    项目: my-saas
+#    Agent 数量: 1
+#
+# [agent_V1StGXR8] Agent 已启动
+# [agent_V1StGXR8] 需求分析 → 竞品分析
+# [agent_V1StGXR8] 竞品分析 → 功能分析
+# [agent_V1StGXR8] 功能分析 → 技术选型
+# [agent_V1StGXR8] 技术选型 → completed
+#
+# ✅ Agent agent_V1StGXR8 已完成全部阶段
+```
+
+```bash
+# 多 Agent 模式（自动使用 Supervisor）
+npx tsx src/cli.ts start -p my-saas -n 3
+
+# 输出:
+# 🚀 启动 Kanban Agent 引擎
+#    项目: my-saas
+#    Agent 数量: 3
+#
+# [agent_8f3kQ2Mx] Supervisor 已启动
+# [agent_8f3kQ2Mx] 派发子 Agent: agent_Pn1xYz4W
+# [agent_8f3kQ2Mx] 派发子 Agent: agent_Kj7mBv9R
+# [agent_8f3kQ2Mx] 派发子 Agent: agent_Qs5tNw2L
+# [agent_Pn1xYz4W] 需求分析 → 竞品分析
+# [agent_Kj7mBv9R] 需求分析 → 竞品分析
+# ...
+# ✅ 所有 3 个 Agent 已完成
+```
+
+### `specops status` — 查看当前状态
+
+```bash
+npx tsx src/cli.ts status
+
+# 输出:
+# 📊 项目状态: my-saas
+#    当前阶段: completed
+#    版本: 13
+#    更新时间: 2026-02-25T10:30:00.000Z
+#
+#    Agent ID          | 阶段           | 操作                  | 工具
+#    --------------------------------------------------------------------------------
+#    agent_V1StGXR8     | completed      | -                     | -
+```
+
+### `specops resume` — 恢复中断的流转
+
+```bash
+npx tsx src/cli.ts resume
+
+# 如果有未完成的 Agent，从断点继续执行
+# 输出:
+# 🔄 恢复引擎执行
+#    项目: my-saas
+#    未完成 Agent: 1
+#
+# [agent_V1StGXR8] 从 竞品分析 恢复
+# [agent_V1StGXR8] 竞品分析 → 功能分析
+# ...
+# ✅ 恢复完成，所有 Agent 已完成
+```
+
+---
+
+## 质量工具
+
+### 技术偏移检测 — `tech-guard`
+
+检测代码是否偏离了 TECH-CONTEXT.md 中锁定的技术决策。
+
+```bash
+npx tsx scripts/tech-guard.ts
+
+# 输出:
+# 🔍 技术偏移检测报告
+# ==================================================
+# 状态: ✅ PASS
+# 检查项: 4 项（通过 4，失败 0）
+#
+# ✅ 未批准依赖
+# ✅ tsconfig 关键配置
+# ✅ 禁止代码模式
+# ✅ 导入路径 .js 后缀
+#
+# --- JSON 报告 ---
+# { "timestamp": "...", "status": "PASS", ... }
+```
+
+**检查项说明:**
+
+| 检查项 | 检测内容 |
+|--------|----------|
+| 未批准依赖 | package.json 中出现了 TECH-CONTEXT.md 快照之外的新包 |
+| tsconfig 关键配置 | target/module/moduleResolution/strict 被修改 |
+| 禁止代码模式 | `as any`、`@ts-ignore`、`@ts-expect-error`、XState v4 API |
+| 导入路径 .js 后缀 | 相对导入缺少 `.js` 后缀（ESM 要求） |
+
+### 验收测试运行器 — `acceptance runner`
+
+串联所有质量检查，生成验收报告。
+
+```bash
+npx tsx src/acceptance/runner.ts --phase 01-state-engine
+
+# 输出:
+# 🔍 验收测试运行器
+# ==================================================
+# 阶段: 01-state-engine
+#
+# 📋 运行 E2E 测试...
+#    ✅ E2E 测试
+# 📋 运行单元测试...
+#    ✅ 单元测试
+# 📋 运行 TypeScript 编译检查...
+#    ✅ TypeScript 编译
+# 📋 运行技术偏移检测...
+#    ✅ 技术偏移检测
+# 📋 运行偷懒检测...
+#    ✅ 偷懒检测
+#
+# 📄 报告已写入: .planning/phases/01-state-engine/ACCEPTANCE.md
+#
+# ==================================================
+# 状态: ✅ PASS
+# 检查项: 5 项（通过 5，失败 0）
+# 总耗时: 12345ms
+```
+
+**验收检查清单:**
+
+| 步骤 | 说明 |
+|------|------|
+| E2E 测试 | 运行 `vitest.config.e2e.ts` 配置的端到端测试 |
+| 单元测试 | 运行所有 `.test.ts` 单元测试 |
+| TypeScript 编译 | `tsc --noEmit` 检查类型安全 |
+| 技术偏移检测 | 调用 `tech-guard.ts` 脚本 |
+| 偷懒检测 | 扫描测试文件中的低质量模式 |
+
+### 偷懒检测说明
+
+偷懒检测器（lazyDetector）扫描测试文件中的以下模式：
+
+| 类型 | 示例 | 说明 |
+|------|------|------|
+| `trivial-assertion` | `expect(true).toBe(true)` | 无意义的断言，不验证任何逻辑 |
+| `no-assertions` | `test('xxx', () => { /* 没有 expect */ })` | 测试块中没有断言 |
+| `excessive-mocks` | 单文件超过 5 个 `vi.mock`/`vi.spyOn` | mock 过多，可能没测到真实逻辑 |
+
+### 上下文注入 — `context` 模块
+
+自动从 TECH-CONTEXT.md 加载技术约束，生成 Executor Agent prompt。
+
+**核心功能:**
+
+| 函数 | 说明 |
+|------|------|
+| `loadTechContext(filePath?)` | 加载并解析 TECH-CONTEXT.md，返回结构化 `TechContext` |
+| `generateExecutorPrompt(context, task)` | 基于技术上下文生成 Executor Agent 完整 prompt |
+
+**loadTechContext 解析内容:**
+
+| 字段 | 来源 | 示例 |
+|------|------|------|
+| `lockedDependencies` | "锁定依赖" 表格 | `{ "xstate": "^5.28.0", ... }` |
+| `forbiddenPatterns` | "禁止模式" 表格 | `["as any", "@ts-ignore", ...]` |
+| `codingConventions` | "编码约定" 列表 | `["使用 Record<K, V> 代替 Map", ...]` |
+| `projectStructure` | "项目结构" 代码块 | 目录树字符串 |
+
+**使用示例:**
+
+```typescript
+import { loadTechContext, generateExecutorPrompt } from './context/index.js'
+
+// 加载技术上下文（TECH-CONTEXT.md 不存在时返回 null）
+const techContext = loadTechContext()
+
+// 生成 Executor Agent prompt
+const prompt = generateExecutorPrompt(techContext, '实现用户登录功能')
+console.log(prompt)
+// 输出:
+// ## 技术约束（不可违反）
+// ### 锁定技术栈
+// - xstate: ^5.28.0
+// - write-file-atomic: ^7.0.0
+// ...
+// ### 禁止行为
+// - as any
+// - @ts-ignore
+// ...
+// ### 编码约定
+// - 使用 Record<K, V> 代替 Map
+// ...
+// ## 当前任务
+// 实现用户登录功能
+// ## 验收要求
+// - 所有新增代码必须通过 TypeScript 编译（strict mode）
+// - 禁止引入未批准的依赖
+// - 测试覆盖所有新增功能的核心路径
+```
+
+**注意:** TECH-CONTEXT.md 不存在时，`loadTechContext` 返回 `null` 并输出 warning，不会阻塞引擎启动。`generateExecutorPrompt` 在 context 为 null 时只输出任务部分。
+
+---
+
+## 验收配置
+
+配置文件：`.specops/acceptance.config.json`
+
+```json
+{
+  "agent": {
+    "model": "claude-sonnet-4-20250514",
+    "maxRetries": 3,
+    "strictness": "normal"
+  },
+  "tests": {
+    "e2eDir": "src/__e2e__",
+    "unitDir": "src",
+    "timeout": 30000
+  },
+  "lazyDetection": {
+    "maxMocksPerFile": 5,
+    "forbiddenPatterns": [
+      "expect(true).toBe(true)",
+      "expect(false).toBe(false)",
+      "expect(1).toBe(1)"
+    ]
+  },
+  "techGuard": {
+    "enabled": true,
+    "scriptPath": "scripts/tech-guard.ts"
+  }
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| `agent.model` | 验收 Agent 使用的 LLM 模型 |
+| `agent.maxRetries` | 验收失败后最多重试次数 |
+| `agent.strictness` | 严格程度：`strict` / `normal` / `lenient` |
+| `lazyDetection.maxMocksPerFile` | 单文件最大 mock 数量 |
+| `lazyDetection.forbiddenPatterns` | 自定义的禁止断言模式 |
+| `techGuard.enabled` | 是否启用技术偏移检测 |
+
+---
+
+## 测试
+
+```bash
+# 运行所有单元测试
+npx vitest run
+
+# 运行 E2E 测试
+npx vitest run --config vitest.config.e2e.ts
+
+# 监听模式
+npx vitest
+
+# 运行指定测试文件
+npx vitest run src/machines/agentMachine.test.ts
+```
+
+**测试统计:** 9 个文件，91 个测试
+
+| 测试文件 | 测试数 | 说明 |
+|----------|--------|------|
+| `agentMachine.test.ts` | 12 | Agent 状态机：默认阶段 + SpecOps 阶段 + 自定义阶段 |
+| `supervisorMachine.test.ts` | 7 | Supervisor：spawn/stop/生命周期 |
+| `stateFile.test.ts` | 8 | 持久化：原子写入 + 乐观锁 |
+| `tech-guard.test.ts` | 21 | 技术偏移：依赖/配置/代码模式/导入路径 |
+| `lazyDetector.test.ts` | 14 | 偷懒检测：trivial/无断言/过多mock |
+| `reporter.test.ts` | 5 | 报告生成：PASS/FAIL 格式 |
+| `runner.test.ts` | 11 | 验收运行器：配置加载/命令执行/报告构建 |
+| `techContextLoader.test.ts` | 7 | 技术上下文加载：解析依赖/禁止模式/编码约定 |
+| `promptTemplate.test.ts` | 6 | Prompt 模板：完整/无上下文/验收要求 |
+| `01-state-engine.e2e.test.ts` | 4 | Phase 1 端到端：四阶段流转/多Agent/状态文件/Supervisor |
+
+---
+
+## 核心概念
+
+### 可配置的阶段序列
+
+状态机支持任意阶段序列，不只是硬编码的 4 个分析阶段。
+
+```typescript
+import { createAgentMachine } from './machines/agentMachine.js'
+import { ANALYSIS_PHASES, PIPELINE_PHASES } from './types/index.js'
+
+// 1. 默认分析阶段：需求分析 → 竞品分析 → 功能分析 → 技术选型
+const analysisMachine = createAgentMachine(ANALYSIS_PHASES)
+
+// 2. SpecOps Pipeline 阶段：讨论 → 规划 → 执行 → 验证
+const pipelineMachine = createAgentMachine(PIPELINE_PHASES)
+
+// 3. 自定义阶段：任意字符串数组
+const customMachine = createAgentMachine(['research', 'design', 'implement', 'review'])
+```
+
+**预定义阶段:**
+
+| 常量 | 阶段 | 用途 |
+|------|------|------|
+| `ANALYSIS_PHASES` | demand_analysis → competitor_analysis → feature_analysis → tech_selection | Agent 分析工作流 |
+| `PIPELINE_PHASES` | discuss → plan → execute → verify | SpecOps 自动编排流程 |
+
+### 状态机流转
+
+```
+idle → [阶段1] → [阶段2] → ... → [阶段N] → completed
+  │        │                                    │
+  │  UPDATE_OPERATION                           │
+  │  (更新操作/工具信息)                          │
+  │                                             │
+  └── START ──→ PHASE_COMPLETE ──→ ... ──→ PHASE_COMPLETE
+```
+
+- `START` 事件：从 idle 进入第一个阶段
+- `PHASE_COMPLETE` 事件：推进到下一个阶段
+- `UPDATE_OPERATION` 事件：更新当前操作描述和使用的工具
+- 到达最后一个阶段后 `PHASE_COMPLETE` → `completed`（final 状态）
+
+### 状态文件
+
+运行后生成 `.specops/state.json`：
+
+```json
+{
+  "version": 5,
+  "updatedAt": "2026-02-25T10:30:00.000Z",
+  "project": {
+    "name": "my-project",
+    "currentPhase": "completed"
+  },
+  "agents": {
+    "agent_V1StGXR8": {
+      "agentId": "agent_V1StGXR8",
+      "parentId": null,
+      "childIds": [],
+      "phase": "completed",
+      "currentOperation": "",
+      "currentSkill": ""
+    }
+  },
+  "machineSnapshot": null
+}
+```
+
+---
+
+## 项目结构
+
+```
+kanban/v1/
+├── package.json                           # 项目配置
+├── tsconfig.json                          # TypeScript 配置
+├── vitest.config.ts                       # 单元测试配置
+├── vitest.config.e2e.ts                   # E2E 测试配置
+├── bin/
+│   └── specops.js                         # CLI 可执行入口
+├── scripts/
+│   ├── tech-guard.ts                      # 技术偏移检测脚本
+│   └── tech-guard.test.ts                 # 偏移检测测试
+├── src/
+│   ├── cli.ts                             # CLI 入口（18 个命令）
+│   ├── engine.ts                          # 引擎编排层
+│   ├── plugin.ts                          # OpenCode Plugin 入口
+│   ├── plugin-engine.ts                   # Plugin 专用引擎层
+│   ├── init.ts                            # 项目初始化（.opencode/ 配置）
+│   ├── types/
+│   │   └── index.ts                       # 类型定义（PHASES、AgentContext 等）
+│   ├── machines/
+│   │   ├── agentMachine.ts                # Agent 状态机（工厂函数）
+│   │   ├── agentMachine.test.ts
+│   │   ├── supervisorMachine.ts           # Supervisor 状态机
+│   │   └── supervisorMachine.test.ts
+│   ├── persistence/
+│   │   ├── schema.ts                      # 状态文件 Zod schema
+│   │   ├── stateFile.ts                   # 原子写入 + 乐观锁
+│   │   └── stateFile.test.ts
+│   ├── acceptance/
+│   │   ├── types.ts                       # 验收相关类型
+│   │   ├── runner.ts                      # 验收运行器
+│   │   ├── runner.test.ts
+│   │   ├── reporter.ts                    # 报告生成器
+│   │   ├── reporter.test.ts
+│   │   ├── lazyDetector.ts                # 偷懒检测
+│   │   └── lazyDetector.test.ts
+│   ├── context/
+│   │   ├── index.ts                       # 上下文模块导出
+│   │   ├── techContextLoader.ts           # TECH-CONTEXT.md 加载/解析
+│   │   ├── techContextLoader.test.ts
+│   │   ├── promptTemplate.ts              # Executor Agent prompt 模板
+│   │   └── promptTemplate.test.ts
+│   ├── __e2e__/
+│   │   └── 01-state-engine.e2e.test.ts    # Phase 1 E2E 测试
+│   └── utils/
+│       └── id.ts                          # Agent ID 生成（nanoid）
+└── .specops/
+    └── state.json                         # 运行时状态（git忽略）
+```
+
+---
+
+## 技术栈
+
+| 技术 | 版本 | 用途 |
+|------|------|------|
+| XState | ^5.28.0 | 状态机引擎 + Actor 模型 |
+| TypeScript | ^5.5.0 | 类型系统（strict mode） |
+| Commander | ^13.0.0 | CLI 命令行解析 |
+| Zod | ^3.23.0 | 运行时类型校验 |
+| nanoid | ^5.0.0 | Agent ID 生成 |
+| write-file-atomic | ^7.0.0 | JSON 原子写入 |
+| @opencode-ai/plugin | ^1.2.6 | OpenCode Plugin SDK |
+| vitest | ^3.0.0 | 测试框架 |
+| tsx | ^4.0.0 | TypeScript 直接执行 |
+
+**编码约定:**
+- ESM（`type: module`）
+- `Record<K,V>` 代替 `Map`
+- XState v5 `setup()` API
+- 中文注释和文档
+- 2 空格缩进
+
+---
+
+## 版本记录
+
+### v0.2.0 — Plugin 模式 + CI/CD
+
+- 新增 OpenCode Plugin 模式：specops 可作为 OpenCode Plugin 加载，AI Agent 直接调用 8 个工具操作项目状态
+- Plugin 入口 `src/plugin.ts`，基于 `@opencode-ai/plugin` SDK
+- Plugin 专用引擎层 `src/plugin-engine.ts`，适配 Plugin 上下文
+- 新增 `init` 命令：将 skill 和 agent 配置复制到目标项目的 `.opencode/` 目录
+- CLI 扩展至 18 个命令（新增 advance, update-operation, register, deregister, discuss, plan, execute, verify, analyze, progress, quick, init, stop）
+- `bin/specops.js` 可执行入口，支持 `npx specops` 直接调用
+
+### v0.1.0 — Phase 1 + Phase 2 完成
+
+**Phase 1: 状态轮转引擎** ✅
+
+| 提交 | 说明 |
+|------|------|
+| `e857e5f` ~ `13cfa2d` | 项目骨架 + Agent 状态机（TDD） |
+| `2fbb690` ~ `e0789a4` | 持久化层 + Supervisor 状态机（TDD） |
+| `640bc09` ~ `47a382f` | CLI 入口 + 引擎编排层 |
+| `2a8d297` | 修复多 Agent 乐观锁并发冲突 |
+
+- 实现 6 状态 Agent 状态机（idle + 4 分析阶段 + completed）
+- Supervisor 模式管理多子 Agent 生命周期
+- JSON 文件原子写入 + 版本号乐观锁
+- CLI 三命令：start / status / resume
+- 21 个单元测试
+
+**Phase 2: 质量基础设施** ✅
+
+| 提交 | 说明 |
+|------|------|
+| `dc29923` | Roadmap 重构（11 phases），解决 6 个 SpecOps 痛点 |
+| `d5efc13` | TECH-CONTEXT + 偏移检测 + 验收框架 + E2E 测试 |
+| `75f776f` | PHASES 泛化：状态机支持任意阶段序列 |
+| `e15fc8f` | README.md 完整中文文档 |
+| `4863f65` | Executor Agent 上下文注入 + context 模块 |
+
+- 创建 TECH-CONTEXT.md 锁定全部技术决策
+- tech-guard.ts 技术偏移检测（4 项检查）
+- 验收 Agent 框架（runner + reporter + lazyDetector）
+- Phase 1 回溯 E2E 测试（4 个用例覆盖全部 SC）
+- PHASES 泛化：支持 SpecOps Pipeline 阶段 + 自定义阶段
+- 上下文注入模块：techContextLoader + promptTemplate + engine 集成
+- 91 个测试（单元 87 + E2E 4）
+
+---
+
+## 路线图
+
+详见 [.planning/ROADMAP.md](../../.planning/ROADMAP.md)
+
+```
+Phase 1  ✅  状态轮转引擎
+Phase 2  ✅  质量基础设施（验收 Agent + 技术守护 + 上下文注入）
+Phase 3  ⏳  Pipeline 自动编排（discuss→plan→execute→verify）
+Phase 4  ⏳  WebSocket 广播 + Web 看板
+Phase 5  ⏳  竞品搜索 Skill
+Phase 6  ⏳  代码搜索 Skills
+Phase 7  ⏳  需求分析模块
+Phase 8  ⏳  深度分析 + 技术选型
+Phase 9  ⏳  多入口编排
+Phase 10 ⏳  SpecOps 文档生成
+Phase 11 ⏳  全流程集成测试
+```
+
+详细变更历史请看 [CHANGELOG.md](./CHANGELOG.md)