# opencode-workflow

**Repository Path**: bruceleelg/opencode-workflow

## Basic Information

- **Project Name**: opencode-workflow
- **Description**: 一个专注于AI开发工作流管理的开源项目，旨在提高开发效率，支持多语言和跨平台，提供灵活的CI/CD解决方案。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenSpec 多智能体协同工作流

OpenSpec 是一套面向多智能体协作开发的可复用工作流包，覆盖从需求接收到验证归档的完整交付链路。

它的目标很简单：让 Agent 不再“边想边做”，而是按统一的阶段、模板、技术决策和归档规则推进任务。

## 适合谁

- 想把 AI Agent 接入真实项目交付流程的团队
- 需要规范需求、原型、规格、架构、计划、实现、验证和归档的项目
- 想让每次改动都有 `change-id`、验证证据和历史记录的开发者
- 想在不同项目里复用同一套 Agent 工作方式的人

## 核心能力

- **阶段化流程**：Intake → Discovery → Prototype → Spec → Architecture → Plan → Implement → Verify → Archive
- **任务分流**：支持新项目、大需求变更、功能、接口改动、UI 调整、优化和 Bug 修复
- **Agent 角色模型**：spec、prototype、architecture、frontend、backend、qa-archive
- **模板体系**：规格说明、架构决策、实施计划、验证报告、归档摘要等
- **技术决策约束**：显式确认前端框架、UI 框架、后端框架和数据库
- **验证与归档**：没有验证证据不宣称完成，每次完成后生成可追溯归档

## 测试样例

本仓库包含一个流程测试产物：`blog-system/` 团队知识博客系统。

它用于验证 OpenSpec 从 Intake、Spec、Architecture、Plan、Implement、Verify 到 Archive 的闭环效果，功能包括文章、分类、标签、搜索、评论和基础管理后台。

`blog-system/` 只是演示样例，不是 OpenSpec 的必需组成部分。把 OpenSpec 接入新项目时，只需要保留：

```text
AGENTS.md
openspec/
```

目标项目自己的 `README.md`、源码目录和业务文件按项目需要自行维护即可。

## 快速开始

### 1. 复制工作流文件

把下面两个入口复制到你的项目根目录：

```text
your-project/
├── AGENTS.md
└── openspec/
```

### 2. 让 Agent 读取入口

每次开始任务时，优先读取：

```text
openspec/README.md
openspec/skills/skill-manifest.md
openspec/skills/skill-checklist.md
openspec/routing/task-routing.md
openspec/routing/change-types.md
openspec/routing/lifecycle.md
openspec/workflow/00-overview.md
```

项目内的 `AGENTS.md` 会把这些读取顺序、强制规则和归档要求固定下来。

### 3. 开始第一个任务

每个任务先进入 Intake，至少确认：

- `change-id`
- 任务类型
- 完整路径或轻量路径
- 是否命中历史归档
- 当前 Git 状态

然后按阶段推进，不跳过验证和归档。

## 工作路径

### 完整路径

适用于新项目、大需求变更、核心流程重做、设计系统重构：

```text
Intake → Discovery → Prototype → Spec → Architecture → Plan → Implement → Verify → Archive
```

### 轻量路径

适用于小功能、局部接口改动、范围明确的 UI 调整、有复现路径的 Bug 修复：

```text
Intake → Spec Lite → Architecture Lite → Plan → Implement → Verify → Archive
```

## 强制规则摘要

- 每个任务必须有 `change-id`
- 新项目和大需求变更必须先做原型
- 前端框架与 UI 框架必须分开确认
- 有模板的文档必须使用 `openspec/templates/`
- 文档类内容默认使用中文
- 没有验证证据不得宣称完成
- 每次完成的变更都必须归档
- Archive 前必须先有本地实现提交
- Archive 后必须再提交归档内容
- `push` 默认由用户手动执行

## 目录结构

```text
openspec/
├── README.md
├── agents/
│   ├── agent-system.md
│   ├── spec-agent.md
│   ├── prototype-agent.md
│   ├── architecture-agent.md
│   ├── frontend-agent.md
│   ├── backend-agent.md
│   └── qa-archive-agent.md
├── routing/
│   ├── task-routing.md
│   ├── change-types.md
│   ├── lifecycle.md
│   └── dependencies.md
├── workflow/
│   ├── 00-overview.md
│   ├── 01-stage-intake.md
│   ├── 02-stage-discovery.md
│   ├── 03-stage-prototype.md
│   ├── 04-stage-spec.md
│   ├── 05-stage-architecture.md
│   ├── 06-stage-plan.md
│   ├── 07-stage-implement.md
│   ├── 08-stage-verify.md
│   ├── 09-stage-archive.md
│   └── 10-stage-retrospective.md
├── skills/
│   ├── skill-manifest.md
│   ├── skill-checklist.md
│   └── skill-selection-rules.md
├── decisions/
│   ├── architecture-decisions.md
│   ├── frontend-framework-options.md
│   ├── ui-framework-options.md
│   ├── backend-framework-options.md
│   ├── database-options.md
│   └── code-standards.md
├── templates/
│   ├── spec-template.md
│   ├── spec-lite-template.md
│   ├── prototype-review-template.md
│   ├── architecture-decision-template.md
│   ├── implementation-plan-template.md
│   ├── verify-report-template.md
│   ├── archive-summary-template.md
│   ├── files-changed-template.md
│   ├── archive-readme-template.md
│   ├── archive-index-by-date-template.md
│   ├── archive-index-by-type-template.md
│   └── archive-index-by-module-template.md
└── archive/
    ├── archive-standard.md
    ├── archive-integration.md
    └── archive-indexing.md
```

## 归档结构

完成任务后，按 `change-id` 新建独立归档目录：

```text
archives/
├── README.md
├── index/
│   ├── by-date.md
│   ├── by-type.md
│   └── by-module.md
└── YYYY-MM-DD-<change-id>/
    ├── summary.md
    ├── files-changed.md
    ├── test-results.md
    └── review-record.md
```

归档用于恢复项目记忆。新任务开始时，先读索引，再按需读取相关历史，不默认做全项目扫描。

## 任务类型

| 类型 | 说明 | 推荐路径 |
| --- | --- | --- |
| `new-project` | 全新项目 | 完整路径 |
| `major-change` | 核心流程或架构边界变化 | 完整路径 |
| `feature` | 新功能 | 视规模而定 |
| `data-api-change` | 数据结构或接口合同变化 | 轻量路径或 Architecture |
| `ui-change` | 页面、布局、组件或视觉调整 | 视影响而定 |
| `tech-optimization` | 性能、重构、维护性优化 | 轻量路径 |
| `bugfix` | 有复现路径的缺陷修复 | 轻量路径 |

## Agent 角色

| 角色 | 职责 | 主要阶段 |
| --- | --- | --- |
| `spec-agent` | 需求澄清与规格沉淀 | Discovery / Spec |
| `prototype-agent` | 原型设计与交互确认 | Prototype |
| `architecture-agent` | 技术选型与架构决策 | Architecture |
| `frontend-agent` | 前端实现 | Implement |
| `backend-agent` | 后端实现 | Implement |
| `qa-archive-agent` | 验证与归档 | Verify / Archive |

## 当前仓库说明

本仓库用于维护和演示 OpenSpec 工作流：

- `AGENTS.md`：项目级 Agent 执行规则
- `openspec/`：可复用工作流包
- `archives/`：本仓库自身任务归档
- `blog-system/`：流程测试样例，可删除，不影响 OpenSpec 接入

如果你只想在自己的项目里使用 OpenSpec，复制 `AGENTS.md` 和 `openspec/` 即可。

## 许可证

MIT License