shangyankeji / super-dev
Engineering workflow layer for AI coding tools with specs, review, quality gates, and traceability.为 AI 编程工具提供工程化流程、质量门禁与可追溯能力。
View on GitHubAI Architecture Analysis
This repository is indexed by RepoMind. By analyzing shangyankeji/super-dev in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Overview (README excerpt)
Crawler viewSuper Dev 面向商业级交付的 AI 开发编排工具 English | 简体中文 --- 版本 当前版本: --- 演示视频 • 在线播放:观看演示视频 • 仓库文件:demo.mp4 --- 加入交流群 扫码加入 Super Dev 微信交流群,和开发者一起交流 --- 项目介绍 是一个面向商业级交付的 AI 开发编排工具,用于把宿主里的模型能力组织成一套稳定、清晰、可审计的工程流水线。 产品定位: • 宿主负责模型调用、联网搜索、代码产出、终端执行与文件修改 • 负责流程治理、设计约束、质量门禁、审计产物与交付标准 它解决的是交付过程问题: • 将需求沉淀为可落地工件:PRD、架构、UI/UX、Spec、任务清单与交付清单 • 将开发过程组织为标准化流水线:可追踪、可恢复、可审计、可复盘 • 将质量控制前置到每个阶段:策略治理、红队审查、质量门禁、发布演练 • 将多宿主协作统一到同一套工程规范:CLI 与 IDE 环境共享同一交付标准 --- 快速开始 三条命令覆盖所有场景: 阶段编号对照: | 编号 | 阶段 | 说明 | |------|------|------| | 1 | research | 同类产品研究 | | 2 | prd | 产品需求文档 | | 3 | architecture | 架构设计 | | 4 | uiux | UI/UX 设计 | | 5 | spec | 任务规格 | | 6 | frontend | 前端实现 | | 7 | backend | 后端实现 | | 8 | quality | 质量门禁 | | 9 | delivery | 交付打包 | 辅助命令: 常用交付证据命令: --- 核心功能 • 10 专家 Agent 架构 v2.1.1 引入 10 个领域专家 Agent,每个专家在对应阶段自动注入到 AI 提示词中,约束宿主按专业标准执行: | 专家 | 角色 | 注入阶段 | |------|------|----------| | 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 | 每个专家具备:目标定义、背景故事、思维框架、质量标准。生成的 AI 提示词超过 600 行,确保每个阶段的输出符合该领域的专业基线。 • 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 文档会自动给出组件生态、表单/表格/图表/动效/图标基线,直接约束实现阶段。宿主提示词与 Skill 会继承这些规则,输出更接近现代商业产品的界面结果。 支持 对 / 做结构级视觉审查。 • 流水线编排引擎 • **9 阶段标准流水线**:research -> prd -> architecture -> uiux -> spec -> frontend -> backend -> quality -> delivery • **检查点与中断续传**:流水线中断后可从断点恢复,不丢失进度 • **阶段超时保护**:每个阶段设有超时机制,防止无限等待 • **确认门控制**:三文档完成后必须等待用户确认,前端预览完成后必须等待用户确认 • **阶段跳转**: 可随时跳转到任意阶段 • **UI 改版回路**:UI 不满意时可发起正式改版回路( ),先更新 UIUX 文档再重做前端 • **适配 0-1 与 1-N+1**:新建项目走完整流水线,已有项目走增量分析路径 • 文档生成引擎 Super Dev 为每个阶段生成初始文档框架,宿主大模型在此基础上结合用户需求、联网研究和专家知识进行深度完善: | 文档 | 内容 | |------|------| | PRD | 用户画像、功能矩阵、验收标准、竞品对标、商业规则 | | Architecture | 系统架构、数据模型、接口契约、安全策略、部署方案 | | UIUX | 设计 Token、页面骨架、组件清单、交互状态、响应式策略 | 宿主根据需求深度生成文档内容,最终产出的文档规模取决于项目复杂度和需求范围。支持 10 个行业领域定制:教育、医疗、电商、金融科技、SaaS、社交、内容、企业、工具、游戏。 补充说明: • 新功能开发默认走完整流水线: • 缺陷修复同样不会直接跳过文档;会走轻量补丁路径,先整理问题现象、复现条件、影响范围和回归风险,再更新补丁文档与验证结果 • 分析阶段默认排除 、 、 等非项目源码目录 • 质量门禁体系 • **A11y 无障碍检查**:自动验证页面的无障碍标准合规性 • **性能预算校验**:检查资源大小、加载时间等性能指标 • **红队审查**:从安全、性能、架构三个维度对系统进行攻防审查 • **修复命令建议**:检测到问题后直接给出可执行的修复指令 • **策略治理**:default / balanced / enterprise 三级预设 • **Spec 质量评分**:对任务规格进行结构化评分 • **发布就绪面板**:统一展示发布前所有门禁检查结果 • 宿主接入治理 • 支持 20 个主流 CLI/IDE 宿主统一接入(9 CLI + 11 IDE) • 自动生成宿主规则文件、 映射、Skill 目录 • 形成接入闭环 • 通过宿主能力边界建模,明确哪些宿主是 • 预览模式与 稳定模式 • 写入 并用于质量门禁 • 代码库理解与变更分析 • **repo-map**:生成代码库地图与建议阅读顺序 • **feature-checklist**:审计 PRD 功能范围覆盖率,区分流程完成与范围完成 • **dependency-graph**:输出模块依赖关系与关键路径 • **impact**:分析改动影响范围、风险等级和建议动作 • **regression-guard**:把影响分析转换成可执行回归清单 • 可审计交付 • 指标报告 • 阶段契约证据 • 恢复执行审计 • 交付包 • 交付证据汇总与 executive summary • 、 、 统一发布评分面板 • 知识库系统 Super Dev 内置结构化知识库( 目录),覆盖 20+ 个技术领域: • **架构**:微服务、API 网关、分布式事务、配置管理、服务治理 • **安全**:DevSecOps、SAST/DAST/SCA、容器安全、合规自动化、密钥管理 • **运维**:可观测性、AIOps 异常检测、容量规划、混沌工程、SLO/SLI • **云原生**:容器编排、服务网格、无服务器架构 • **数据工程**:数据管线、流处理、数据治理 • **设计**:UI 全生命周期跨平台手册 • **移动端**:跨平台开发、原生性能优化 • **更多领域**:CI/CD、测试、产品、低代码、边缘/IoT、区块链、量子计算 知识增强机制: • 宿主进入流水线后,Super Dev 会自动检索 下与当前需求相关的知识文件 • 匹配到的本地标准、场景包和检查清单作为硬约束注入到三文档、Spec 和实现阶段 • 如果已生成 ,宿主会继承其中的本地知识命中结果 • 同时支持联网研究增强,将 Web 搜索结果与本地知识合并输出 • 策略治理系统 通过 Policy DSL 实现流程治理的参数化控制: • **default**:标准预设,适合个人和小团队 • **balanced**:平衡预设,适合中等规模团队 • **enterprise**:企业预设,更高质量阈值、宿主画像要求、可按项目配置关键宿主 策略控制维度: • 强制红队 / 质量门禁开关 • 最低质量阈值设定 • CI/CD 平台白名单 • required hosts 与 ready+score 硬校验(按项目启用) • 宿主画像自动探测与评分 • 报告与历史记录 --- 安装方式 • uv 安装(推荐) 升级: • PyPI 安装 安装完成后,直接运行: 默认会进入宿主安装引导: • 顶部显示 安装入口 • 选择宿主 • 勾选宿主 • 开始安装 • 全选 • 仅选择 CLI 宿主 • 仅选择 IDE 宿主 • 清空选择 • 升级已安装宿主 安装完成后,终端会直接给出该宿主的最终触发方式: • slash 宿主: • 非 slash 宿主: • 需要真人验收时,可执行: • 指定版本安装 • GitHub 指定标签安装 • 源码开发安装 开发环境: 开发环境: --- 依赖安装说明 当用户执行: 或: 安装器会自动安装 中声明的 Python 依赖,例如: • • • • • • • 不会自动安装的内容: • Claude Code / Codex CLI / Gemini CLI / Cursor / Trae / Windsurf 等宿主软件本身 • Node.js、npm、pnpm、Docker、数据库服务这类系统级运行环境 • 宿主账号登录状态、联网权限、浏览器能力 • 项目业务依赖以外的前后端运行时 一句话: • / 会自动安装 **Super Dev 自己的 Python 依赖** • 不会替用户安装 **宿主工具和系统环境** 如果你希望先显式初始化项目契约,再开始接入宿主: 这会显式生成: • • 用来固定初始化规范、触发方式和阶段顺序。 --- 整个系统如何工作 的运行方式可以概括为一条固定链路: • 用户在项目目录执行 或 • 安装引导把 Super Dev 接入到目标宿主 • 用户在宿主里输入 或 • 宿主进入 Super Dev 流水线,10 个专家 Agent 按阶段注入 • 宿主负责联网、推理、编码、运行与修改文件 • Super Dev 负责流程、文档、门禁、审计和交付标准 标准流水线: 补充说明: • 新功能开发默认走完整流水线: • 缺陷修复同样不会直接跳过文档;会走轻量补丁路径,先整理问题现象、复现条件、影响范围和回归风险,再更新补丁文档与验证结果 • 分析阶段默认排除 、 、 等非项目源码目录 宿主如何理解 Super Dev: • 是当前项目里的本地 Python CLI 工具,加上宿主里的规则文件 / Skill / slash 映射 • 宿主负责模型推理、联网搜索、编码、运行终端与修改文件 • 负责把宿主拉进固定流水线:research、三文档、确认门、Spec、前端优先、后端联调、质量门禁、交付审计 • 当用户输入 或 时,宿主要切换到 Super Dev 流水线执行模式 • 需要生成或刷新文档、Spec、质量报告、交付产物时,宿主应优先调用本地 CLI • 如果项目根目录存在 ,宿主必须优先读取与当前需求相关的知识文件 • 如果已生成 ,宿主必须把其中命中的本地知识、研究摘要和场景约束继承到三文档、Spec 和实现阶段 --- 架构概览 一、系统高阶流转架构 展示用户、宿主端工具、Super Dev 编排引擎与最终产物之间的流转关系。 二、9 阶段核心工作流 详细描绘每次对话触发后,引擎在底层的流转经过。 三、核心模块调用拓扑 展示 下核心源码目录的职责边界和调用关系。 --- 20 宿主支持 CLI 宿主(9 个) | 宿主 | 触发方式 | 安装命令 | |------|----------|----------| | Claude Code | | | | Codex CLI | | | | Gemini CLI | | | | OpenCode | | | | Kiro CLI | | | | Cursor CLI | | | | Qoder CLI | | | | Copilot CLI | | | | CodeBuddy CLI | | | IDE 宿主(11 个) | 宿主 | 触发方式 | 安装命令 | |------|----------|----------| | Antigravity | | | | Cursor | | | | Windsurf | | | | Kiro | | | | Qoder | | | | Trae | | | | CodeBuddy | | | | Copilot (VS Code) | | | | Roo Code | | | | Kilo Code | | | | Cline | | | --- 每个宿主如何使用 • Claude Code 安装: 触发位置: 在项目目录启动 Claude Code 当前会话后,直接在同一会话里触发。 触发命令: 接入后是否需要重启:否 补充说明: • 推荐作为首选 CLI 宿主。 • 接入后可先执行 确认 slash 已生效。 • Claude Code 官方已公开 与 ,Super Dev 会同步生成 subagent。 • Codex CLI 安装:…