super-dev

# Super Dev

<div align="center">

<img src="docs/assets/super-dev-logo.png" alt="Super Dev - AI PIPELINE ORCHESTRATOR" width="600">

### 面向商业级交付的 AI 开发编排工具 · 知识驱动 · 可编程治理

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)
[![Type Checks](https://img.shields.io/badge/type%20checks-mypy-success)](https://mypy-lang.org/)
[![Lint](https://img.shields.io/badge/lint-ruff-success)](https://docs.astral.sh/ruff/)

[English](README_EN.md) | 简体中文

</div>

---

## 版本

当前版本：`2.3.0`

---

## 演示视频

<video controls playsinline preload="metadata" src="https://shangyankeji.github.io/super-dev/demo.mp4" width="100%"></video>

- 在线播放：[观看演示视频](https://shangyankeji.github.io/super-dev/demo.mp4)
- 仓库文件：[demo.mp4](demo.mp4)

---

## 联系开发者

<div align="center">

微信号：**Excellent_We**

<img src="wx.png" alt="开发者微信" width="200">

扫码或搜索微信号联系开发者

</div>

---

## 项目介绍

`Super Dev` 是一个面向商业级交付的 AI 开发编排工具，用于把宿主里的模型能力组织成一套稳定、清晰、可审计的工程流水线。

产品定位：

- 宿主负责模型调用、联网搜索、代码产出、终端执行与文件修改
- `Super Dev` 负责流程治理、设计约束、质量门禁、审计产物与交付标准

它解决的是交付过程问题：

- 将需求沉淀为可落地工件：PRD、架构、UI/UX、Spec、任务清单与交付清单
- 将开发过程组织为标准化流水线：可追踪、可恢复、可审计、可复盘
- 将质量控制前置到每个阶段：策略治理、红队审查、质量门禁、发布演练
- 将多宿主协作统一到同一套工程规范：CLI 与 IDE 环境共享同一交付标准
- 将知识库与验证规则自动推送到每个阶段：知识驱动治理，而非依赖人工检查

---

## 快速开始

先记住这 5 个入口，其中旧的直达写法仍然保留：

```bash
# 安装引导 / 已有项目下一步
super-dev

# 旧写法仍可用：直接从需求描述进入完整流水线
super-dev "做一个在线教育平台"

# 0-1：为当前机器选择宿主并给出第一句触发词
super-dev start --idea "做一个在线教育平台"

# 第二天回来 / 重开宿主：恢复当前流程
super-dev resume

# 已有流程：继续当前流程，而不是重新开始普通聊天
super-dev continue

# 状态不清楚时：只问系统“下一步”
super-dev next
```

使用方式：

- 当前目录还没接入时，裸跑 `super-dev` 会进入安装引导。
- 当前目录已经有 Super Dev 上下文时，裸跑 `super-dev` 会直接进入“恢复当前流程”路由。
- `super-dev "..."` 仍然是直达完整流水线的快捷入口，适合你已经明确要让 Super Dev 直接开工的场景。
- `super-dev start --idea "..."` 会自动检测宿主、给出推荐宿主、触发词、重开提示和第一句该发什么。
- `super-dev resume` 最适合下班回来、第二天继续、重开电脑、重开宿主后的真实恢复场景。
- `super-dev continue` / `super-dev next` 会直接告诉你当前动作、用户下一步、宿主第一句、机器侧动作。

现实场景怎么继续：

| 场景 | 先做什么 | 为什么 |
|------|----------|--------|
| 下班了，第二天回来继续开发 | `super-dev resume` | 直接恢复当前流程、当前动作、宿主第一句和机器侧下一步 |
| 宿主关了、电脑重启了、会话断了 | `super-dev resume` | 重新生成恢复卡，并提醒先看 `.super-dev/SESSION_BRIEF.md` |
| 只是不知道现在卡在哪一步 | `super-dev next` | 只输出当前仓库唯一推荐的下一步 |
| 流水线命令跑到一半被打断 | `super-dev run --resume` | 从上次中断阶段继续执行机器侧流水线 |
| 当前在确认门，想继续补 PRD / 架构 / UI | `super-dev resume` 后按提示继续说自然语言 | 会继续留在当前确认门，而不是开启普通聊天 |
| 明确要返工 UI | 先更新 `output/*-uiux.md`，再 `super-dev resume` | 先改 UI 真源，再让后续前端实现沿同一套 UI 契约继续 |
| 明确要返工架构 | 先更新 `output/*-architecture.md`，再 `super-dev resume` | 先改技术真源，再让 Spec / 实现重新对齐 |
| 只想离开当前流程，重新聊别的 | 明确说“取消当前流程”或“重新开始一条新流程” | 系统只在你明确退出时才离开当前 Super Dev 流程 |

如果你已经明确知道要从哪里接着做，再用这些命令：

```bash
# 1-N+1 已有项目：分析现有代码库后接入流水线
super-dev init

# 跳转到任意阶段 / 从中断处继续 / 查看状态
super-dev run frontend       # 按名称跳转
super-dev run 6              # 按编号跳转（1-9）
super-dev run --resume       # 从中断处继续
super-dev run --status       # 查看当前流程状态
```

阶段编号对照：

| 编号 | 阶段 | 说明 |
|------|------|------|
| 1 | research | 同类产品研究 |
| 2 | prd | 产品需求文档 |
| 3 | architecture | 架构设计 |
| 4 | uiux | UI/UX 设计 |
| 5 | spec | 任务规格 |
| 6 | frontend | 前端实现 |
| 7 | backend | 后端实现 |
| 8 | quality | 质量门禁 |
| 9 | delivery | 交付打包 |

辅助命令：

```bash
super-dev onboard             # 宿主接入引导
super-dev onboard --dry-run   # 预览接入变更，不实际写入
super-dev onboard --stable-only  # 仅接入已认证宿主
super-dev detect              # 自动检测宿主与推荐默认宿主
super-dev detect --auto       # 自动检测并安装到所有宿主
super-dev doctor              # 诊断检查（显示认证等级、主修复动作和下一步）
```

快速接入（推荐）：

```bash
super-dev init my-project
super-dev init --template ecommerce   # 使用项目模板 (ecommerce/saas/dashboard/mobile/api/blog/miniapp)
super-dev detect --auto               # 自动检测并安装到所有宿主
# 然后在宿主中输入: /super-dev <你的需求>
```

治理与知识命令（2.2.0 新增）：

```bash
super-dev governance                  # 治理规则总览
super-dev spec trace                  # Spec-Code 追踪
super-dev spec consistency            # Spec-Code 一致性检测
super-dev spec acceptance             # Spec 验收检查
super-dev knowledge stats             # 知识库使用统计
super-dev knowledge evolve            # 知识权重自演化
```

治理与执行命令（2.3.0 新增）：

| 命令 | 功能 |
|------|------|
| `super-dev enforce install` | 安装宿主 hooks (emoji 检查等) |
| `super-dev enforce validate` | 运行约束验证脚本 |
| `super-dev enforce status` | 查看 enforcement 配置状态 |
| `super-dev memory list` | 查看项目记忆 |
| `super-dev memory consolidate` | 触发记忆整合 |
| `super-dev hooks list` | 查看已配置的 hooks |
| `super-dev experts list` | 查看可用专家 |
| `super-dev compact list` | 查看上下文压缩摘要 |
| `super-dev generate scaffold` | 生成项目脚手架 |
| `super-dev generate components` | 生成 UI 组件 |
| `super-dev generate types` | 生成前后端共享类型 |

常用交付证据命令：

```bash
super-dev integrate audit --auto --repair --force
super-dev integrate validate --auto
super-dev feature-checklist
super-dev product-audit
super-dev release proof-pack
super-dev release readiness
super-dev review preview --status confirmed --comment "前端预览已确认"
super-dev review architecture --status revision_requested --comment "技术方案需要重构"
super-dev review quality --status revision_requested --comment "质量门禁未通过，需要整改"
```

---

## 核心功能

### 1. 11 专家 Agent 架构

当前内置 11 个领域专家 Agent，每个专家在对应阶段自动注入到 AI 提示词中，约束宿主按专业标准执行：

| 专家 | 角色 | 注入阶段 |
|------|------|----------|
| PRODUCT | 产品负责人 | research, prd, quality, delivery |
| PM | 产品经理 | research, prd |
| ARCHITECT | 系统架构师 | architecture |
| UI | 界面设计师 | uiux, frontend |
| UX | 交互设计师 | uiux, frontend |
| SECURITY | 安全工程师 | architecture, backend, quality |
| CODE | 开发工程师 | frontend, backend |
| DBA | 数据库工程师 | architecture, backend |
| QA | 质量工程师 | quality |
| DEVOPS | 运维工程师 | delivery |
| RCA | 根因分析师 | quality, delivery |

每个专家具备四层武装：Profile（目标定义、背景故事、思维框架、质量标准）+ Knowledge（阶段知识自动推送）+ Rules（验证规则绑定）+ Protocol（交叉审查协议）。每位专家配备 350+ 行深度 Playbook 操作手册，生成的 AI 提示词超过 600 行，确保每个阶段的输出符合该领域的专业基线。

### 2. UI 智能设计系统

内置完整的设计智能引擎，直接约束前端实现阶段的视觉质量：

- **119 套配色方案**：84 套产品配色 + 35 套美学配色，全部自动生成暗色模式
- **39 个组件库**：覆盖 11 个前端技术栈（React 15 / Vue 9 / Angular 4 / Svelte 2 / 其他）
- **17 套字体预设**：基于 Google Fonts 中国镜像，按产品调性分类
- **完整 Design Token 体系**：色阶、阴影、动效、排版、间距
- **12 项交付前检查清单**：A11y、响应式、暗色模式、加载态、空态、错误态等
- **10 个行业定制**：教育、医疗、电商、金融科技、SaaS、社交、内容、企业、工具、游戏

UI/UX 文档不再只是建议，而是会冻结成一份真正的 UI 契约：

- `output/*-uiux.md`
- `output/*-ui-contract.json`
- `output/frontend/design-tokens.css`
- `output/*-ui-contract-alignment.md`
- `output/*-ui-contract-alignment.json`

宿主提示词、前端骨架、后续实现、UI review、frontend runtime、quality gate、proof-pack、release readiness 都会围绕这份 UI 契约继续执行。

支持：

- `super-dev quality --type ui-review`
- `super-dev integrate validate --target <host_id>`
- `super-dev release proof-pack`

来持续检查 UI 契约有没有真的落到源码和交付结果中。

### 3. 流水线编排引擎

- **9 阶段标准流水线**：research -> prd -> architecture -> uiux -> spec -> frontend -> backend -> quality -> delivery
- **检查点与中断续传**：流水线中断后可从断点恢复，不丢失进度
- **阶段超时保护**：每个阶段设有超时机制，防止无限等待
- **确认门控制**：三文档完成后必须等待用户确认，前端预览完成后必须等待用户确认
- **阶段跳转**：`super-dev run <阶段>` 可随时跳转到任意阶段
- **UI 改版回路**：UI 不满意时可发起正式改版回路（`review ui`），先更新 UIUX 文档再重做前端
- **适配 0-1 与 1-N+1**：新建项目走完整流水线，已有项目走增量分析路径
- **继续当前流程路由**：`super-dev resume` / `super-dev continue` / `super-dev next` / `start --json` / `doctor --json` 都共享同一套 workflow state 与 action card
- **恢复状态卡**：`.super-dev/SESSION_BRIEF.md` 和 `.super-dev/workflow-state.json` 会沉淀“当前动作 / 宿主第一句 / 机器侧动作 / 连续性规则”
- **返工优先级**：文档确认门、预览确认门、UI 改版、架构返工、质量整改都进入统一状态机，不再靠用户记命令

### 4. 文档生成引擎

Super Dev 为每个阶段生成初始文档框架，宿主大模型在此基础上结合用户需求、联网研究和专家知识进行深度完善：

| 文档 | 内容 |
|------|------|
| PRD | 用户画像、功能矩阵、验收标准、竞品对标、商业规则 |
| Architecture | 系统架构、数据模型、接口契约、安全策略、部署方案 |
| UIUX | 设计 Token、页面骨架、组件清单、交互状态、响应式策略 |

宿主根据需求深度生成文档内容，最终产出的文档规模取决于项目复杂度和需求范围。支持 10 个行业领域定制：教育、医疗、电商、金融科技、SaaS、社交、内容、企业、工具、游戏。

补充说明：

- 新功能开发默认走完整流水线：`research -> 三文档 -> 用户确认 -> Spec / tasks -> 前端运行验证 -> 后端 / 测试 / 交付`
- 缺陷修复同样不会直接跳过文档；会走轻量补丁路径，先整理问题现象、复现条件、影响范围和回归风险，再更新补丁文档与验证结果
- 分析阶段默认排除 `.venv`、`site-packages`、`node_modules` 等非项目源码目录

### 5. 质量门禁体系

- **验证规则引擎**：25 条 YAML 声明式规则（14 默认 + 11 红队），支持项目级自定义覆盖
- **质量顾问**：不只说"不达标"，还给出具体修复建议（Quick Wins 优先排序）
- **Spec-Code 一致性检测**：自动比对 Spec 描述与实际代码实现，防止偏离
- **A11y 无障碍检查**：自动验证页面的无障碍标准合规性
- **性能预算校验**

[truncated…]