openspec-autodev

OpenSpec + Superpowers 全自动开发工作流 Claude Code 插件
支持多子代理并行批次执行，多人 Vibe Coding 协作，一键安装即用

✨ 特性

一键安装：安装插件后运行 /openspec-autodev:setup 即可完成所有配置
全自动开发：从需求确认到代码完成，仅需一个人工确认节点
并行执行：基于依赖分析的多子代理并行批次执行，大幅缩短开发时间
多人协作：Session 隔离 + 文件占用声明 + 可选的跨机器协调服务，多人同时 Vibe Coding 同一项目不冲突
TDD 驱动：严格遵循 Red-Green-Refactor 循环
断点恢复：工作流中断后可从断点继续，支持跨 Session 恢复
安全防护：自动阻止修改敏感文件，自动格式化代码

🚀 快速开始

Step 1：安装插件

方式一：Plugin Marketplace（推荐）

# 1. 注册插件市场源
/plugin marketplace add https://github.com/<your-repo>/openspec-autodev

# 2. 从市场中安装插件
/plugin install openspec-autodev

方式二：手动安装

# 克隆到 Claude Code 插件目录
git clone https://github.com/<your-repo>/openspec-autodev.git ~/.claude/plugins/openspec-autodev

Step 2：初始化项目

推荐：跳过权限确认模式

为了在整个流程中不被打断，建议运行claude code 时使用：

claude --dangerously-skip-permissions

当然，如果你不想使用这个flag，在项目初始化的过程中也会通过.claude/settings.json中加入一些细粒度的权限来跳过指定的权限确认弹窗。

在 Claude Code 中进入你的项目目录，执行：

/openspec-autodev:setup

这会自动：

✅ 检测并安装 OpenSpec（如未安装）
✅ 检测并安装 Superpowers 技能包（如未安装）
✅ 初始化 openspec/ 目录
✅ 配置 CLAUDE.md 项目宪法
✅ 更新 .gitignore（包含 Session 状态文件）
✅ 自动检测项目语言和测试框架
✅ 可选：配置跨机器协调服务（多人远程协作时需要）

Step 3：开始开发

/openspec-autodev:auto-dev 用户搜索功能

然后就可以放手了！整个流程自动执行：

需求澄清 → 规格生成 → 环境准备 → 并行TDD开发 → 验证收尾 → 等待确认
   人工          自动        自动         自动           自动       人工

📋 命令列表

命令	说明
`/openspec-autodev:setup`	一键初始化项目（首次使用必须执行）
`/openspec-autodev:auto-dev <feature>`	启动全自动开发工作流
`/openspec-autodev:resume`	恢复中断的工作流（支持跨 Session 恢复）
`/openspec-autodev:iterate <feature> [vN]`	基于已完成功能进行迭代开发
`/openspec-autodev:bugfix <bug-description>`	轻量级 Bug 修复（TDD + 追溯记录）
`/openspec-autodev:parallel-dev <feature>`	生成外部 CLI 并行执行脚本
`/openspec-autodev:status`	查看所有活跃 Session 和文件占用情况
`/openspec-autodev:claim <action> <pattern>`	管理文件占用声明（add/release/transfer）

👥 多人 Vibe Coding

插件支持两种多人协作模式：

模式	适用场景	需要额外部署
本地模式（默认）	同一台机器多个终端	否
远程模式	不同机器各自编码，推同一仓库	需部署协调服务

本地模式

当多个开发者在同一台机器上同时用 Claude Code 开发时，通过本地文件系统协调：

┌─────────────────────────────────────────────────────────┐
│                    共享项目仓库                            │
│                                                         │
│  .claude/sessions/                                      │
│  ├── alice-1713600000.json    ← Alice 的 Session 注册    │
│  ├── alice-1713600000/        ← Alice 的工作流状态        │
│  │   ├── workflow-state.json                            │
│  │   └── current-plan.md                                │
│  ├── bob-1713600100.json      ← Bob 的 Session 注册      │
│  └── bob-1713600100/          ← Bob 的工作流状态          │
│      ├── workflow-state.json                            │
│      └── current-plan.md                                │
└─────────────────────────────────────────────────────────┘

远程模式（跨机器协作）

当开发者在各自的机器上编码并推送到同一 Git 仓库时，需要部署协调服务来实时同步状态：

Developer A (Machine A)              Developer B (Machine B)
┌────────────────────┐               ┌────────────────────┐
│ Claude Code        │               │ Claude Code        │
│  ├─ SessionStart   │               │  ├─ SessionStart   │
│  ├─ PreToolUse     │    REST API   │  ├─ PreToolUse     │
│  └─ PostToolUse    │◄─────────────►│  └─ PostToolUse    │
└────────┬───────────┘               └──────────┬─────────┘
         │                                      │
         └──────────────┬───────────────────────┘
                        ▼
              ┌──────────────────┐
              │ openspec-autodev │
              │     -server      │
              │   (自托管 Docker) │
              │   Node.js+SQLite │
              └──────────────────┘

部署协调服务

# Docker 一键部署
docker run -d --name oadev-server -p 9527:9527 -v oadev-data:/data openspec-autodev-server

# 或直接运行（Node.js 18+）
cd server && npm install && npm start

启动后在浏览器打开 http://<host>:<port>/ 可使用内置管理页：新建项目、复制 API Key、查看看板（Sessions / Specs）。也可纯用 API，例如：

curl -X POST http://localhost:9527/api/v1/projects \
  -H "Content-Type: application/json" \
  -d "{\"id\":\"my-app\",\"name\":\"My App\"}"

日志：默认每条 HTTP 请求由 morgan 输出一行（/health 除外）；业务事件为 [coord] 前缀的结构化日志。环境变量：

变量	说明	默认
`LOG_LEVEL`	`error` / `warn` / `info` / `debug`（心跳、`claims/check` 等为 debug）	`info`
`MORGAN_FORMAT`	morgan 日志格式，如 `combined`、`tiny`	`tiny`
`PORT` / `DATA_DIR`	监听端口与 SQLite 数据目录	`9527` / `./data`

客户端连接

每个开发者在 /openspec-autodev:setup 的 Step 7 中输入服务器地址和 API Key 即可。也可以手动创建 .claude/coordination.json：

{
  "enabled": true,
  "server": "http://192.168.1.100:9527",
  "projectId": "my-app",
  "apiKey": "oadev_xxxxxxxxxxxxx",
  "timeout": 3000
}

openspec-autodev

Popularity

What's Inside

README