# openspec-superpowers

**Repository Path**: dazhuang/openspec-superpowers

## Basic Information

- **Project Name**: openspec-superpowers
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Team AI Workflow Skills - 快速开始指南

一套完整的团队 AI 交付工作流，基于 OpenSpec + Superpowers 构建标准化开发流程。

---

## 概述

本项目提供：
- **8 个团队命令**：explore、propose、plan、apply、verify、review、archive、retro
- **8 个 Guard Skills**：规范每一阶段的行为
- **OpenSpec 模板**：proposal、design、tasks、spec delta
- **测试场景**：验证工作流有效性

---

## 快速开始

### 1. 安装

将本项目文件复制到你的项目目录：

```bash
# Claude Code 用户
cp -r .claude ~/.claude/  # 复制到全局（可选）
cp -r .claude <your-project>/  # 复制到项目

# Cursor 用户
cp -r .cursor <your-project>/

# OpenSpec 模板
cp -r openspec <your-project>/

# 测试场景（可选）
cp -r tests <your-project>/
```

### 2. 初始化 OpenSpec

```bash
openspec init
```

### 3. 使用命令

```text
/team-explore add login feature         # 探索需求
/team-propose add-user-auth             # 创建提案
/team-plan add-user-auth                # 审查任务
/team-apply add-user-auth               # 实现任务
/team-verify add-user-auth              # 验证结果
/team-review add-user-auth              # 代码审查
/team-archive add-user-auth             # 归档变更
/team-retro add-user-auth               # 复盘改进
```

---

## 工作流详解

### Phase 1：探索 `/team-explore`

**目的**：澄清模糊需求，不创建变更。

**输入**：自由文本描述或问题

**输出**：
- 问题澄清
- 现状分析
- 方案对比（2-3 个）
- 推荐方案
- 建议 Change ID

---

### Phase 2：提案 `/team-propose`

**目的**：创建 OpenSpec 变更提案。

**输入**：change-id 或描述

**输出**：
- `openspec/changes/<id>/proposal.md`
- `openspec/changes/<id>/design.md`（如有架构决策）
- `openspec/changes/<id>/tasks.md`
- `openspec/changes/<id>/specs/<capability>/spec.md`

**强制停止条件**：
- 未决问题影响关键决策时停止
- 校验失败时先修复

---

### Phase 3：规划 `/team-plan`

**目的**：审查任务拆解质量。

**检查项**：
- 任务粒度（<1 小时）
- 依赖排序
- 验证方法
- 未决问题状态

---

### Phase 4：实现 `/team-apply`

**目的**：增量实现任务。

**核心规则**：
- 一次只做一个任务
- 行为变化先写测试
- 验证通过才标记完成
- 不做超出范围的工作

---

### Phase 5：验证 `/team-verify`

**目的**：证明实现符合规格。

**验证分层**：
1. OpenSpec 校验
2. 任务完成度
3. 项目级检查（lint/test/build）
4. 验收标准对齐

---

### Phase 6：审查 `/team-review`

**目的**：合并前代码审查。

**审查范围**：
- 需求对齐
- 安全风险
- 测试覆盖
- 代码质量
- 回归风险

---

### Phase 7：归档 `/team-archive`

**目的**：归档已完成变更。

**归档条件**：
- 校验通过
- 任务完成
- 验收有证据
- 项目检查通过

---

### Phase 8：复盘 `/team-retro`

**目的**：记录 Bad Case，回填 Skill。

**输出**：
- What Worked
- Bad Cases
- Skill Updates Needed
- Command Updates Needed

---

## 核心规则

### 不可跳过的步骤

- ❌ 不要跳过 OpenSpec 创建直接实现
- ❌ 不要跳过测试
- ❌ 不要跳过验证
- ❌ 不要跳过评审（如有要求）
- ❌ 不要在未决问题未解决时实现

### 不可协商条款

- ❌ 不做 tasks.md 中未体现的工作
- ❌ 不"顺手"扩大范围
- ❌ 验证未通过不标记完成
- ❌ 无证据不宣称完成

---

## 测试场景

详见 `TestScenarios.md`：

1. 需求不清场景
2. 跳流程场景
3. 任务未完成场景
4. 完整流程场景
5. 未决问题场景
6. 坏结果回填场景

---

## 文件结构

```
.claude/
├── commands/          # 8 个命令文件
│   ├── TeamExplore.md
│   ├── TeamPropose.md
│   ├── TeamPlan.md
│   ├── TeamApply.md
│   ├── TeamVerify.md
│   ├── TeamReview.md
│   ├── TeamArchive.md
│   └── TeamRetro.md
├── skills/            # 8 个 Skill 目录
│   ├── TeamOpenSpecGuard/
│   ├── TeamImplementationGuard/
│   ├── TeamVerificationGuard/
│   ├── TeamPlanningGuard/
│   ├── TeamReviewGuard/
│   ├── TeamSkillMaintainer/
│   ├── TeamApply/
│   └── TeamExplore/
├── rules/
│   └── TeamAiDelivery.mdc

.cursor/
├── commands/          # 8 个命令文件（kebab-case）
├── skills/            # 8 个 Skill 目录
├── rules/

openspec/
├── templates/         # OpenSpec 模板
├── project.md         # 项目概览
└── changes/           # 变更目录（运行时创建）
```

---

## 更多信息

- 安装说明：`INSTALL.md`
- 测试文档：`TestScenarios.md`
- 原理说明：参考源文章