Skip to content
Back to search

super-dev

Engineering workflow layer for AI coding tools with specs, review, quality gates, and traceability.为 AI 编程工具提供工程化流程、质量门禁与可追溯能力。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shangyankeji--super-dev/badge.svg)](/listings/shangyankeji--super-dev)

HTML

<a href="/listings/shangyankeji--super-dev"><img src="/api/listings/shangyankeji--super-dev/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

首页安装口径默认使用 uv:

uv tool install super-dev

安装完成后执行:

super-dev

源码安装、指定版本回滚等次级安装方式保留在 [docs/INSTALL_OPTIONS.md](docs/INSTALL_OPTIONS.md)。

跨平台说明:

- Windows、macOS、Linux 都先安装包,再直接运行 `super-dev` - 仓库内的 `install.sh` 只是 macOS/Linux 便捷入口,不是 Windows 唯一入口

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "super-dev-local",
  3. "plugins": [
  4. {
  5. "name": "super-dev-claude",
  6. "source": "./plugins/super-dev-claude",
  7. "version": "2.3.8"
  8. }
  9. ]
  10. }
  11. ## Super Dev System Flow Contract
  12. - SUPER_DEV_FLOW_CONTRACT_V1
  13. - PHASE_CHAIN: research>docs>docs_confirm>spec>frontend>preview_confirm>backend>quality>delivery
  14. - DOC_CONFIRM_GATE: required
  15. - PREVIEW_CONFIRM_GATE: required
  16. - HOST_PARITY: required
README.md · README · 1,160 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Super Dev
  2. <div align="center">
  3. <img src="docs/assets/super-dev-logo.png" alt="Super Dev - AI PIPELINE ORCHESTRATOR" width="600">
  4. ### 面向商业级交付的宿主教练系统 · 知识驱动治理
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  6. [![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)
  7. [![Type Checks](https://img.shields.io/badge/type%20checks-mypy-success)](https://mypy-lang.org/)
  8. [![Lint](https://img.shields.io/badge/lint-ruff-success)](https://docs.astral.sh/ruff/)
  9. [English](README_EN.md) | 简体中文
  10. </div>
  11. ---
  12. ## 版本
  13. 当前版本:`2.4.0`
  14. - 发布说明:[v2.4.0 更新内容](docs/releases/2.4.0.md)
  15. - 官网更新历史:[superdev.goder.ai/changelog](https://superdev.goder.ai/changelog)
  16. ## 安装
  17. 首页安装口径默认使用 uv:
  18. ```bash
  19. uv tool install super-dev
  20. ```
  21. 安装完成后执行:
  22. ```bash
  23. super-dev
  24. ```
  25. 源码安装、指定版本回滚等次级安装方式保留在 [docs/INSTALL_OPTIONS.md](docs/INSTALL_OPTIONS.md)。
  26. 跨平台说明:
  27. - Windows、macOS、Linux 都先安装包,再直接运行 `super-dev`
  28. - 仓库内的 `install.sh` 只是 macOS/Linux 便捷入口,不是 Windows 唯一入口
  29. ---
  30. ## 演示视频
  31. <video controls playsinline preload="metadata" src="https://shangyankeji.github.io/super-dev/demo.mp4" width="100%"></video>
  32. - 在线播放:[观看演示视频](https://shangyankeji.github.io/super-dev/demo.mp4)
  33. - 仓库文件:[demo.mp4](super-dev-website/public/demo.mp4)
  34. ---
  35. ## 联系开发者
  36. <div align="center">
  37. 微信号:**Excellent_We**
  38. <img src="super-dev-website/public/wx.png" alt="开发者微信" width="200">
  39. 扫码或搜索微信号联系开发者
  40. </div>
  41. ---
  42. ## 项目介绍
  43. `Super Dev` 不是再给宿主叠一层命令集合或脚手架壳。它更像一个宿主教练系统,用来把宿主里的模型能力训练成一套稳定、清晰、可审计、能做商业项目的交付流程。
  44. 产品定位:
  45. - 宿主负责模型调用、联网搜索、代码产出、终端执行与文件修改
  46. - `Super Dev` 负责图纸生成、流程治理、设计约束、质量门禁、审计产物与交付标准
  47. 换句话说:
  48. - 宿主是执行者
  49. - `Super Dev` 是产品总监、架构师、设计总监、技术教练和 QA 负责人组成的指导系统
  50. 它解决的是“宿主会写代码,但不一定会稳定交付”的问题:
  51. - 将需求沉淀为可落地工件:PRD、架构、UI/UX、Spec、任务清单与交付清单
  52. - 将开发过程组织为标准化流水线:可追踪、可恢复、可审计、可复盘
  53. - 将质量控制前置到每个阶段:策略治理、红队审查、质量门禁、发布演练
  54. - 将多宿主协作统一到同一套工程规范:12 个 CLI、9 个 IDE、5 个桌面助手按项目优先注入,共享同一交付标准
  55. - 将知识库与验证规则自动推送到每个阶段:知识驱动治理,而非依赖人工检查
  56. - 将宿主训练成“能稳定做出精品商业项目”的团队,而不是让用户自己拼流程、拼审美、拼质量门
  57. ---
  58. ## 5 分钟上手
  59. 普通用户先记住 1 条安装命令和 3 个终端命令:
  60. ```bash
  61. uv tool install super-dev
  62. ```
  63. ```bash
  64. # 进入宿主接入引导
  65. super-dev
  66. # 更新到最新版,并迁移已接入宿主
  67. super-dev update
  68. # 清理已注入的宿主接入面
  69. super-dev uninstall
  70. ```
  71. ### 5 分钟路径
  72. 1. 在项目目录运行 `super-dev`
  73. 2. 让安装器自动检测宿主并写入项目级接入面;只有明确需要跨项目复用时才补用户/全局接入面
  74. 3. 打开 `output/maintenance/host-onboard-smoke-*.md`
  75. 4. 先看 `标准流第一句` / `比赛流第一句`
  76. 5. 再看 `接入后先验`、`框架焦点`、`官方工作流检查`
  77. 6. 回到宿主里触发第一句,观察它是否按 `research -> 三文档 -> 等待确认` 进入流程
  78. 如果这 6 步成立,你拿到的不是“装好了一个工具”,而是“把当前宿主训练成了这个项目的交付教练”。
  79. ### 终端只做 3 件事
  80. - 接入
  81. - 升级
  82. - 卸载 / 预演清理
  83. 接入完成后,正常使用都回到宿主里。普通用户第一眼只需要记住:
  84. ```text
  85. /super-dev 你的需求
  86. super-dev: 你的需求
  87. /super-dev-seeai 比赛需求
  88. ```
  89. 更细的入口差异不要靠记忆硬背,直接看安装后生成的 `host-onboard-smoke`,复制里面的 `标准流第一句` 或 `比赛流第一句` 即可。
  90. 正确心智:
  91. - 终端只负责接入、升级与卸载
  92. - 宿主才负责 baseline、research、三文档、确认门、Spec、实现、质量门禁与交付
  93. - 普通开发不要离开宿主主路径;如果不是在做接入、诊断、治理收尾或兼容修复,就不要先回终端找阶段命令
  94. - 自动判断会在接入/升级阶段发生,但不会在普通开发流程里越层改宿主配置
  95. - `已接入` 与 `已验证` 是两回事:文件落盘不代表宿主已经真实跑通
  96. - 已有项目不是直接开干:`evolve / variant / patch` 必须先做 `baseline -> baseline confirmation`,再进入差量 research 和三文档
  97. - 恢复是默认场景:关窗口、关电脑、第二天继续,都优先按 `.super-dev/` 与 `output/` 工件恢复当前流程
  98. 工作模式:
  99. - `new`:从 0 到 1 的新项目
  100. - `evolve`:已有项目增量迭代
  101. - `variant`:基于现有项目派生 1-N+1 版本
  102. - `patch`:已有项目缺陷修复
  103. - `resume`:中断后的恢复继续
  104. 记住一个原则:安装完成后,终端基本就该退场。真正开发回到宿主里,先复制 `标准流第一句` 或 `比赛流第一句`,再按 smoke guide 做首轮验收。
  105. SEEAI 赛事极速版:
  106. - 入口:`/super-dev-seeai` 或 `super-dev-seeai:`
  107. - 仍然保留 `research -> 三文档 -> docs confirm -> spec`
  108. - 但 `spec` 之后直接进入前后端一体化快速开发,不再拆预览确认门
  109. - 适合 30 分钟左右的官网、小游戏、展示型工具、单页 demo
  110. 只有在接入、诊断、兼容修复或治理收尾时,才需要回终端。普通用户只需要记住:
  111. ```bash
  112. super-dev
  113. super-dev update
  114. super-dev uninstall
  115. ```
  116. 维护者补充:
  117. - 安装/接入后烟测指南会落到 `output/maintenance/host-onboard-smoke-*.md`
  118. - 如果当前项目已经冻结了 `framework playbook`,安装后烟测指南会直接显示 `框架焦点(Framework Coaching Focus)`、必验场景和交付证据
  119. - 卸载预演或正式清理会落到 `output/maintenance/host-cleanup-*.json/.md`
  120. - 如果只是想先看会删什么,用 `super-dev uninstall --dry-run`
  121. - 升级完成后先重开终端并执行 `super-dev --version`;如果宿主没有进入 `research -> 三文档 -> 等待确认`,再回终端跑 `doctor`
  122. - 如果第一轮 UI 看起来过平、过空、模板味太重,不要指望“最后再补美化”;截图级 UI gate 会在 UI review、quality gate、proof-pack 和 release readiness 里继续拦截
  123. - 正式发版文档 `docs/PUBLISHING.md` 与 `docs/RELEASE_RUNBOOK.md` 只属于维护者,不是普通用户上手路径。
  124. 其余 `detect / doctor / review / quality / release / spec / task` 都属于维护面,只在报告明确要求时由维护者进入。
  125. 说明:
  126. - `skill / integrate` 只用于宿主接入、兼容性审计和真人验收,不属于日常开发主路径
  127. - `config / enforce / generate` 属于内部维护能力,不是普通用户入口
  128. - `onboard / detect / doctor / run / review / release` 允许保留,但应视为维护面而不是普通用户心智
  129. - 真正的项目开发仍应回到宿主里,优先使用 `/super-dev` 或 `super-dev:` 开题,并直接说“继续当前流程”“现在下一步是什么”
  130. - 如果你在已有项目里做增量开发,不要先在终端里手工跳阶段,先让宿主完成 `baseline -> baseline confirmation`,再进入差量文档和实现
  131. - 如果只是回来继续昨天的活,不要先回终端找 `run` / `jump` / `confirm`,优先在宿主里直接说“继续当前流程”
  132. 交付与卡点处理仍然存在治理入口,但它们属于维护面,不应当成普通用户命令目录:
  133. - `product-audit`:范围缺口与实施覆盖率体检
  134. - `release readiness / proof-pack`:发布证据与交付闭环
  135. - `review *`:维护者同步 gate 状态或修订状态
  136. 普通用户仍应优先回宿主里说“继续当前流程”“现在下一步是什么”。
  137. ---
  138. ## 核心功能
  139. ### 1. 11 专家 Agent 架构
  140. 当前内置 11 个领域专家 Agent,每个专家在对应阶段自动注入到 AI 提示词中,约束宿主按专业标准执行:
  141. | 专家 | 角色 | 注入阶段 |
  142. |------|------|----------|
  143. | PRODUCT | 产品负责人 | research, prd, quality, delivery |
  144. | PM | 产品经理 | research, prd |
  145. | ARCHITECT | 系统架构师 | architecture |
  146. | UI | 界面设计师 | uiux, frontend |
  147. | UX | 交互设计师 | uiux, frontend |
  148. | SECURITY | 安全工程师 | architecture, backend, quality |
  149. | CODE | 开发工程师 | frontend, backend |
  150. | DBA | 数据库工程师 | architecture, backend |
  151. | QA | 质量工程师 | quality |
  152. | DEVOPS | 运维工程师 | delivery |
  153. | RCA | 根因分析师 | quality, delivery |
  154. 每个专家具备四层武装:Profile(目标定义、背景故事、思维框架、质量标准)+ Knowledge(阶段知识自动推送)+ Rules(验证规则绑定)+ Protocol(交叉审查协议)。每位专家配备 350+ 行深度 Playbook 操作手册,生成的 AI 提示词超过 600 行,确保每个阶段的输出符合该领域的专业基线。
  155. ### 2. UI 智能设计系统
  156. 内置完整的设计智能引擎,直接约束前端实现阶段的视觉质量:
  157. - **119 套配色方案**:84 套产品配色 + 35 套美学配色,全部自动生成暗色模式
  158. - **39 个组件库**:覆盖 11 个前端技术栈(React 15 / Vue 9 / Angular 4 / Svelte 2 / 其他)
  159. - **17 套字体预设**:基于 Google Fonts 中国镜像,按产品调性分类
  160. - **完整 Design Token 体系**:色阶、阴影、动效、排版、间距
  161. - **12 项交付前检查清单**:A11y、响应式、暗色模式、加载态、空态、错误态等
  162. - **10 个行业定制**:教育、医疗、电商、金融科技、SaaS、社交、内容、企业、工具、游戏
  163. UI/UX 文档不再只是建议,而是会冻结成一份真正的 UI 契约:
  164. - `output/*-uiux.md`
  165. - `output/*-ui-contract.json`
  166. - `output/frontend/design-tokens.css`
  167. - `output/*-ui-contract-alignment.md`
  168. - `output/*-ui-contract-alignment.json`
  169. 宿主提示词、实现约束、UI review、frontend runtime、quality gate、proof-pack、release readiness 都会围绕这份 UI 契约继续执行。
  170. 关键治理证据:
  171. - UI review 与 UI contract alignment
  172. - frontend runtime 运行证据
  173. - proof-pack 与 release readiness 摘要
  174. 它们共同用于持续检查 UI 契约有没有真的落到源码和交付结果中。
  175. ### 3. 流水线编排引擎
  176. - **新项目主链**:research -> docs -> docs_confirm -> spec -> frontend -> preview_confirm -> backend -> quality -> delivery
  177. - **已有项目主链**:baseline -> baseline_confirm -> delta research -> docs -> docs_confirm -> spec -> frontend -> preview_confirm -> backend -> quality -> delivery
  178. - **检查点与中断续传**:流水线中断后可从断点恢复,不丢失进度
  179. - **阶段超时保护**:每个阶段设有超时机制,防止无限等待
  180. - **确认门控制**:三文档完成后必须等待用户确认,前端预览完成后必须等待用户确认
  181. - **阶段恢复**:宿主可以通过自然语言恢复到目标阶段,高级阶段跳转只保留给维护场景
  182. - **UI 改版回路**:UI 不满意时可在宿主里发起正式改版回路,先更新 UIUX 文档再重做前端
  183. - **适配 0-1 与 1-N+1**:新建项目走完整流水线,已有项目先 baseline 再走增量分析路径
  184. - **继续当前流程路由**:内部恢复与状态命令共享同一套 workflow state 与 action card
  185. - **恢复状态卡**:`.super-dev/SESSION_BRIEF.md` 和 `.super-dev/workflow-state.json` 会沉淀“当前动作 / 宿主第一句 / 机器侧动作 / 连续性规则”
  186. - **关键时间线**:流程快照、语义事件、Hook 事件会汇总成统一的 recent timeline,进入 `SESSION_BRIEF`、Workflow Harness、proof-pack 与 release readiness
  187. - **返工优先级**:文档确认门、预览确认门、UI 改版、架构返工、质量整改都进入统一状态机,不再靠用户记命令
  188. ### 4. 文档生成引擎
  189. Super Dev 为每个阶段生成初始文档框架,宿主大模型在此基础上结合用户需求、联网研究和专家知识进行深度完善:
  190. | 文档 | 内容 |
  191. |------|------|
  192. | PRD | 用户画像、功能矩阵、验收标准、竞品对标、商业规则 |
  193. | Architecture | 系统架构、数据模型、接口契约、安全策略、部署方案 |
  194. | UIUX | 设计 Token、页面骨架、组件清单、交互状态、响应式策略 |
  195. 宿主根据需求深度生成文档内容,最终产出的文档规模取决于项目复杂度和需求范围。支持 10 个行业领域定制:教育、医疗、电商、金融科技、SaaS、社交、内容、企业、工具、游戏。
  196. 补充说明:
  197. - 新功能开发默认走完整流水线:`research -> 三文档 -> 用户确认 -> Spec / tasks -> 前端运行验证 -> 后端 / 测试 / 交付`
  198. - 缺陷修复同样不会直接跳过文档;会走轻量补丁路径,先整理问题现象、复现条件、影响范围和回归风险,再更新补丁文档与验证结果
  199. - 分析阶段默认排除 `.venv`、`site-packages`、`node_modules` 等非项目源码目录
  200. ### 5. 质量门禁体系
  201. - **验证规则引擎**:25 条 YAML 声明式规则(14 默认 + 11 红队),支持项目级自定义覆盖
  202. - **质量顾问**:不只说"不达标",还给出具体修复建议(Quick Wins 优先排序)
  203. - **Spec-Code 一致性检测**:自动比对 Spec 描述与实际代码实现,防止偏离
  204. - **A11y 无障碍检查**:自动验证页面的无障碍标准合规性
  205. - **性能预算校验**:检查资源大小、加载时间等性能指标
  206. - **红队审查**:从安全、性能、架构三个维度对系统进行攻防审查
  207. - **修复命令建议**:检测到问题后直接给出可执行的修复指令
  208. - **策略治理**:default / balanced / enterprise 三级预设
  209. - **Spec 质量评分**:对任务规格进行结构化评分
  210. - **发布就绪面板**:统一展示发布前所有门禁检查结果
  211. - **UI 契约执行检查**:质量门禁会检查 `ui-contract.json`、`design-tokens.css`、frontend runtime 与 UI 对齐报告是否一致
  212. ### 6. 宿主接入治理
  213. - 支持 26 个主流宿主统一接入(12 CLI + 9 IDE + 5 桌面助手)
  214. - 新增 `Droid CLI` 官方 `.factory` 宿主接入:`AGENTS.md + .factory/rules + .factory/skills`,`.factory/commands` 仅作为兼容增强面
  215. - 自动生成宿主规则文件、`/super-dev` 映射、Skill 目录
  216. - `detect / onboard / doctor / setup / install / start` 形成接入闭环
  217. - 通过宿主能力边界建模,明确哪些宿主是 `Certified / Compatible / Experimental`
  218. - `--dry-run` 预览模式与 `--stable-only` 稳定模式
  219. - `--save-profile` 写入 `super-dev.yaml` 并用于质量门禁
  220. - `doctor`、`detect`、`start` 默认会输出决策卡:推荐宿主、推荐理由、第一步动作、候选宿主、路径覆盖修复提示
  221. - 决策卡、安装向导与 runtime 报告会直接给出 `标准流第一句 / 比赛流第一句 / 接入后先验 / 官方工作流检查 / 修复剧本`
  222. - 宿主准备度会明确区分 `标准流可直接开工` 和 `SEEAI 比赛模式可直接开工`
  223. - 支持 Windows 注册信息、shim 目录、常见路径和 `SUPER_DEV_HOST_PATH_<HOST>` 自定义路径覆盖
  224. - 显式指定宿主时,系统会围绕你指定的宿主给建议,不再被自动检测结果带偏
  225. ### 7. 产品审计与范围缺口
  226. - **product-audit**:从产品、交互、闭环和代码结构角度生成总审查报告
  227. - 区分“流水线已经走完”和“范围是否真的做完”
  228. - 为 `proof-pack`、`release readiness`、质量整改提供范围缺口输入
  229. ### 8. 可审计交付
  230. - `proof-pack`:交付证据汇总与 executive summary
  231. - `release readiness`:发布就绪度检查
  232. - `frontend runtime / UI Contract Alignment / quality gate`:前端、设计契约与质量门禁闭环
  233. - `delivery manifest/report/archive`:交付包与归档产物
  234. - `pipeline metrics / knowledge tracking / validation report`:作为内部证据进入交付闭环,不属于普通用户主入口
  235. ### 9. 知识库系统
  236. Super Dev 内置结构化知识库(`knowledge/` 目录),270+ 个知识文件、15 万行深度内容,覆盖 23 个技术领域:
  237. - **架构**:微服务、API 网关、分布式事务、配置管理、服务治理
  238. - **安全**:DevSecOps、SAST/DAST/SCA、容器安全、合规自动化、密钥管理
  239. - **运维**:可观测性、AIOps 异常检测、容量规划、混沌工程、SLO/SLI
  240. - **云原生**:容器编排、服务网格、无服务器架构
  241. - **数据工程**:数据管线、流处理、数据治理
  242. - **设计**:UI 全生命周期跨平台手册
  243. - **移动端**:跨平台开发、原生性能优化
  244. - **更多领域**:CI/CD、测试、产品、低代码、边缘/IoT、区块链、量子计算
  245. 知识推送引擎:
  246. - **阶段精准映射**:306 个知识文件建立索引,7 个 pipeline 阶段精准推送相关约束
  247. - **渐进式加载**:L1 索引(目录级快速匹配)/ L2 详情(文件级内容推送)/ L3 深度引用(段落级精准引用),token 预算控制
  248. - **知识自演化**:SQLite 追踪每条知识的使用效果(采纳率、命中率),数据驱动权重优化
  249. - 宿主进入流水线后,Super Dev 会自动检索 `knowledge/` 下与当前需求相关的知识文件
  250. - 匹配到的本地标准、场景包和检查清单作为硬约束注入到三文档、Spec 和实现阶段
  251. - 如果已生成 `output/knowledge-cache/*-knowledge-bundle.json`,宿主会继承其中的本地知识命中结果
  252. - 同时支持联网研究增强,将 Web 搜索结果与本地知识合并输出
  253. ### 10. 内部治理能力
  254. 这部分属于内部维护与交付保障,不是普通用户日常命令面:
  255. - YAML 验证规则与质量门禁
  256. - 宿主兼容度探测与接入审计
  257. - Pipeline 指标、知识跟踪、治理快照
  258. - Prompt / 文档模板 / 规则版本化
  259. ---
  260. ## 安装方式
  261. ### 1. uv 安装(推荐)
  262. ```bash
  263. uv tool install super-dev
  264. ```
  265. 升级:
  266. ```bash
  267. super-dev update
  268. ```
  269. ### 2. 指定版本安装
  270. ```bash
  271. uv tool install super-dev==2.4.0
  272. ```
  273. 升级:
  274. ```bash
  275. uv tool upgrade super-dev
  276. super-dev update
  277. ```
  278. 安装完成后,直接运行:
  279. ```bash
  280. super-dev
  281. ```
  282. 默认会进入宿主安装引导:
  283. - 顶部显示 `Super Dev` 安装入口
  284. - `↑ / ↓` 选择宿主
  285. - `Space` 勾选宿主
  286. - `Enter` 开始安装
  287. - `A` 全选
  288. - `C` 仅选择 CLI 宿主
  289. - `I` 仅选择 IDE 宿主
  290. - `R` 清空选择
  291. - `U` 升级已安装宿主
  292. 安装完成后,终端会直接给出该宿主的最终触发方式:
  293. - slash 宿主:`/super-dev 你的需求`
  294. - 非 slash 宿主:`super-dev: 你的需求`
  295. - 比赛极速版:`/super-dev-seeai 比赛需求` 或 `super-dev-seeai: 比赛需求`
  296. - 需要继续验收或恢复时,优先回到宿主里说“继续当前流程”或“现在下一步是什么”
  297. ### 3. GitHub 指定标签安装
  298. ```bash
  299. uv tool install --from git+https://github.com/shangyankeji/super-dev.git@v2.4.0 super-dev
  300. ```
  301. ### 4. 源码开发安装
  302. ```bash
  303. git clone https://github.com/shangyankeji/super-dev.git
  304. cd super-dev
  305. uv sync
  306. uv run super-dev --version
  307. ```
  308. ---
  309. ## 依赖安装说明
  310. 当用户执行:
  311. ```bash
  312. uv tool install super-dev
  313. ```
  314. 或:
  315. ```bash
  316. uv tool install super-dev
  317. ```
  318. 安装器会自动安装 `pyproject.toml` 中声明的 Python 依赖,例如:
  319. - `rich`
  320. - `pyyaml`
  321. - `ddgs`
  322. - `requests`
  323. - `beautifulsoup4`
  324. - `fastapi`
  325. - `uvicorn`
  326. 不会自动安装的内容:
  327. - Claude Code / Codex CLI / Gemini CLI / Cursor / Trae / Windsurf / 桌面助手等宿主软件本身
  328. - Node.js、npm、pnpm、Docker、数据库服务这类系统级运行环境
  329. - 宿主账号登录状态、联网权限、浏览器能力
  330. - 项目业务依赖以外的前后端运行时
  331. 一句话:
  332. - `pip` / `uv` 会自动安装 **Super Dev 自己的 Python 依赖**
  333. - 不会替用户安装 **宿主工具和系统环境**
  334. 如果你希望先显式初始化项目契约,再开始接入宿主:
  335. ```bash
  336. super-dev bootstrap --name my-project --platform web --frontend next --backend node
  337. ```
  338. 这会显式生成:
  339. - `.super-dev/WORKFLOW.md`
  340. 用来固定初始化规范、触发方式和阶段顺序。
  341. ---
  342. ## 当前保留的核心增强
  343. 围绕“宿主接入 + 主流水线 + 交付闭环”,当前重点保留这些增强:
  344. - 宿主接入治理:`detect / onboard / doctor / setup / install / start`
  345. - 三文档、Spec、前端优先、预览确认、后端、质量门禁、交付证据
  346. - 专家按阶段注入,知识库在 research / docs / spec / implementation 阶段持续生效
  347. - Plan-Execute / Overseer / Claude-Codex hybrid mode 仍保留在编排内核
  348. - Design inspiration workflow 仍保留在 UI/UX 增强链里
  349. - UI 契约、frontend runtime、UI review、quality gate、proof-pack、release readiness 同一轮证据闭环
  350. - 交付证据、知识跟踪、Pipeline 指标作为内部治理面持续产出
  351. ## 历史能力沉淀
  352. 下面这些能力仍然是系统底座的一部分,但不再作为单独公开产品面强调:
  353. - 知识驱动治理、渐进式知识加载、知识自演化
  354. - YAML 验证规则、质量顾问、Spec-Code 一致性检测
  355. - 11 专家 Playbook、交叉审查、Prompt/模板版本化
  356. - Pipeline 指标、ADR、治理快照等内部证据
  357. - 宿主深度适配矩阵与多宿主接入治理
  358. ---
  359. ## 整个系统如何工作
  360. `Super Dev` 的运行方式可以概括为一条固定链路:
  361. 1. 用户在项目目录执行 `super-dev`
  362. 2. 安装引导把 Super Dev 接入到目标宿主
  363. 3. 用户在宿主里输入 `/super-dev 需求` 或 `super-dev: 需求`
  364. 4. 宿主进入 Super Dev 流水线,11 个专家 Agent 按阶段注入,知识推送引擎自动推送相关约束
  365. 5. 宿主负责联网、推理、编码、运行与修改文件
  366. 6. Super Dev 负责流程、文档、知识推送、验证规则、门禁、审计和交付标准
  367. 标准流水线:`research -> docs -> docs_confirm -> spec -> frontend -> preview_confirm -> backend -> quality -> delivery`
  368. 补充说明:
  369. - 新功能开发默认走完整流水线:`research -> 三文档 -> 用户确认 -> Spec / tasks -> 前端运行验证 -> 后端 / 测试 / 交付`
  370. - 缺陷修复同样不会直接跳过文档;会走轻量补丁路径,先整理问题现象、复现条件、影响范围和回归风险,再更新补丁文档与验证结果
  371. - 分析阶段默认排除 `.venv`、`site-packages`、`node_modules` 等非项目源码目录
  372. 宿主如何理解 Super Dev:
  373. - `Super Dev` 是当前项目里的本地 Python CLI 工具,加上宿主里的规则文件 / Skill / slash 映射
  374. - 宿主负责模型推理、联网搜索、编码、运行终端与修改文件
  375. - `Super Dev` 负责把宿主拉进固定流水线:research、三文档、确认门、Spec、前端优先、后端联调、质量门禁、交付审计,并在每个阶段自动推送相关知识约束与验证规则
  376. - 当用户输入 `/super-dev 需求` 或 `super-dev: 需求` 时,宿主要切换到 Super Dev 流水线执行模式
  377. - 需要生成或刷新文档、Spec、质量报告、交付产物时,宿主应优先调用本地 `super-dev` CLI
  378. - 如果项目根目录存在 `knowledge/`,宿主必须优先读取与当前需求相关的知识文件
  379. - 如果已生成 `output/knowledge-cache/*-knowledge-bundle.json`,宿主必须把其中命中的本地知识、研究摘要和场景约束继承到三文档、Spec 和实现阶段
  380. ---
  381. ## 架构概览
  382. Super Dev 2.4.0 架构由四层组成:**宿主接入层**(统一宿主矩阵,按 CLI / IDE / 桌面助手分组)、**知识治理层**(306 索引 / 渐进式加载 / 自演化)、**编排引擎层**(9 阶段流水线 / 11 专家 + Overseer / 验证规则引擎)、**交付审计层**(DORA 度量 / ADR / 一致性检测 / proof-pack)。
  383. ### 一、系统高阶流转架构
  384. 展示用户、宿主端工具、Super Dev 编排引擎与最终产物之间的流转关系。
  385. ![系统高阶流转架构](docs/assets/architecture/system-overview.png)
  386. ### 二、9 阶段核心工作流
  387. 详细描绘每次对话触发后,引擎在底层的流转经过。
  388. ![9 阶段核心工作流](docs/assets/architecture/pipeline-12-phase.png)
  389. ### 三、核心模块调用拓扑
  390. 展示 `super_dev` 下核心源码目录的职责边界和调用关系。
  391. ![核心模块调用拓扑](docs/assets/architecture/module-topology.png)
  392. ---
  393. ## 统一接入宿主矩阵
  394. 正式产品口径:
  395. - 当前矩阵按 `CLI / IDE / 桌面助手` 分组
  396. - `Codex` 和 `Codex CLI` 是两个不同宿主,`Claude` 和 `Claude Code` 也是两个不同宿主
  397. - 默认采用项目优先注入:先写项目级接入面,再按需补齐用户 / 全局接入面
  398. ### CLI 宿主(12 个)
  399. | 宿主 | 触发方式 | 终端入口 |
  400. |------|----------|----------|
  401. | Claude Code | `/super-dev 需求` | `super-dev` |
  402. | Codex CLI | `$super-dev`;回退 `super-dev: 需求` | `super-dev` |
  403. | OpenCode | `/super-dev 需求` | `super-dev` |
  404. | Droid CLI | `/super-dev 需求`;比赛模式 `/super-dev-seeai`;回退 `super-dev: 需求` | `super-dev` |
  405. | Gemini CLI | `/super-dev 需求` | `super-dev` |
  406. | Kiro CLI | `/super-dev 需求` | `super-dev` |
  407. | Cursor CLI | `super-dev: 需求` | `super-dev` |
  408. | Copilot CLI | `super-dev: 需求` | `super-dev` |
  409. | Qoder CLI | `/super-dev 需求` | `super-dev` |
  410. | CodeBuddy CLI | `/super-dev 需求` | `super-dev` |
  411. | Kimi Code | `super-dev: 需求`;显式入口 `/skill:super-dev 需求` | `super-dev` |
  412. | Qwen Code | `/super-dev 需求` | `super-dev` |
  413. ### IDE 宿主(9 个)
  414. | 宿主 | 触发方式 | 终端入口 |
  415. |------|----------|----------|
  416. | Antigravity | `/super-dev 需求` | `super-dev` |
  417. | Cursor | `/super-dev 需求` | `super-dev` |
  418. | Windsurf | `/super-dev 需求` | `super-dev` |
  419. | Kiro | `/super-dev 需求` | `super-dev` |
  420. | Trae IDE | `super-dev: 需求` | `super-dev` |
  421. | TraeCN | `super-dev: 需求` | `super-dev` |
  422. | CodeBuddy | `/super-dev 需求` | `super-dev` |
  423. | CodeBuddyCN | `/super-dev 需求` | `super-dev` |
  424. | Qoder | `/super-dev 需求` | `super-dev` |
  425. ### 桌面助手(5 个)
  426. | 宿主 | 触发方式 | 终端入口 |
  427. |------|----------|----------|
  428. | Claude | `super-dev: 需求` | `super-dev` |
  429. | Codex | App/Desktop: 在 `/` 列表里选择 `super-dev` | `super-dev` |
  430. | WorkBuddy | `super-dev: 需求` | `super-dev` |
  431. | Trae SOLO | `/super-dev 需求` | `super-dev` |
  432. | Trae SOLOCN | `super-dev: 需求` | `super-dev` |
  433. ---
  434. ### 每个宿主如何使用
  435. #### 1. Claude Code
  436. 安装:
  437. ```bash
  438. super-dev
  439. ```
  440. 触发位置:
  441. 在项目目录启动 Claude Code 当前会话后,直接在同一会话里触发。
  442. 触发命令:
  443. ```text
  444. /super-dev 你的需求
  445. ```
  446. 比赛模式:
  447. ```text
  448. /super-dev-seeai 比赛需求
  449. ```
  450. 自然语言回退:
  451. ```text
  452. super-dev: 你的需求
  453. ```
  454. 接入后是否需要重启:否
  455. 补充说明:
  456. 1. 推荐作为首选 CLI 宿主。
  457. 2. 维护者如需核对接入面,可执行 `super-dev doctor --host claude-code`,确认项目根 `CLAUDE.md`、项目级 `.claude/CLAUDE.md`、可选 `.claude/settings*.json`、项目/用户级 skills 与 agents 一起生效。
  458. 3. Claude Code 当前按官方 `CLAUDE.md + settings + project/user skills + subagents` 模型对齐;`.claude/commands/` 仅作为兼容增强面保留,不再当主协议面。
  459. 4. 如需增强层,Super Dev 还会补齐 `.claude-plugin/marketplace.json` 与 `plugins/super-dev-claude/.claude-plugin/plugin.json`。
  460. #### 2. Codex
  461. 安装:
  462. ```bash
  463. super-dev
  464. ```
  465. 触发位置:
  466. 在项目目录完成接入后,重启 `codex`,然后在新的 Codex 会话里触发。
  467. 触发命令:
  468. ```text
  469. Codex App/Desktop: 在 `/` 列表里选择 super-dev
  470. Codex CLI: $super-dev
  471. 回退入口: super-dev: 你的需求
  472. ```
  473. 接入后是否需要重启:是
  474. 补充说明:
  475. 1. Codex App/Desktop 优先从 `/` 列表里直接选择 `super-dev`;这是已启用 Skill 的官方入口,不是项目级自定义 slash 文件。
  476. 2. Codex CLI 优先显式输入 `$super-dev`。
  477. 3. 如果当前已经在自然语言上下文里继续流程,也可以直接输入 `super-dev: 你的需求`。
  478. 4. 默认基础接入面是项目根 `AGENTS.md` 与项目级 `.agents/skills/super-dev/SKILL.md`;官方用户级 Skill `~/.agents/skills/super-dev/SKILL.md` 仍会安装,`CODEX_HOME/AGENTS.md`(默认 `~/.codex/AGENTS.md`)改为显式 `--with-user-surfaces` 时才写入。
  479. 5. 同时会额外生成可选的 repo plugin 增强层:`.agents/plugins/marketplace.json` + `plugins/super-dev-codex/.codex-plugin/plugin.json`,让 Codex App/Desktop 在 AGENTS + Skills 之外还能看到更完整的本地 plugin 面。
  480. 6. 历史安装会在升级时自动迁移到统一的 `super-dev` 命名。
  481. 7. 如果旧会话没加载新 Skill,重启 `codex` 再试。
  482. 8. 无论使用 `/super-dev`、`$super-dev` 还是 `super-dev:`,都必须进入同一条 Super Dev 流程;长流程里继续修改、补充、确认或恢复时,优先沿用当前入口面。
  483. #### 3. Gemini CLI
  484. 安装:
  485. ```bash
  486. super-dev
  487. ```
  488. 触发位置:
  489. 在项目目录启动 Gemini CLI 会话后触发。
  490. 触发命令:
  491. ```text
  492. /super-dev 你的需求
  493. ```
  494. 接入后是否需要重启:否
  495. 补充说明:
  496. 1. 官方主面已经收口到 `GEMINI.md + settings + custom commands`;项目内优先检查 `GEMINI.md`、可选 `.gemini/settings.json` 和 `.gemini/commands/*.toml`。
  497. 2. `/super-dev` 是 Super Dev 注入后的自定义命令面,不是 Gemini CLI 自带内建命令;若命令未刷新,优先重开当前 Gemini CLI 会话。
  498. 3. `~/.gemini/skills/` 只作为兼容增强面保留,不再当默认主协议面。
  499. 4. 优先在同一会话中完成 research -> 三文档 -> 用户确认 -> Spec -> 前端运行验证 -> 后端/交付;若宿主支持联网,先让它完成同类产品研究。
  500. #### 4. OpenCode
  501. 安装:
  502. ```bash
  503. super-dev
  504. ```
  505. 触发位置:
  506. 在项目目录启动 OpenCode 会话后触发。
  507. 触发命令:
  508. ```text
  509. /super-dev 你的需求
  510. ```
  511. 接入后是否需要重启:否
  512. 补充说明:
  513. 1. 按 CLI slash 模式使用。
  514. 2. 若你使用全局命令目录,也建议保留项目级接入文件。
  515. #### 5. Kiro CLI
  516. 安装:
  517. ```bash
  518. super-dev
  519. ```
  520. 触发位置:
  521. 在项目目录启动 Kiro CLI 会话后触发。
  522. 触发命令:
  523. ```text
  524. /super-dev 你的需求
  525. ```
  526. 接入后是否需要重启:是
  527. 补充说明:
  528. 1. Kiro CLI 当前优先使用宿主已暴露的 `/super-dev` 入口;如果当前会话只接受自然语言,再回退到 `super-dev: 需求`。
  529. 2. 官方接入面是 `AGENTS.md` + `.kiro/steering/super-dev.md` + `.kiro/skills/super-dev/SKILL.md`;全局增强面是 `~/.kiro/steering/super-dev.md` 与 `~/.kiro/skills/super-dev/SKILL.md`。
  530. 3. 完成接入后建议重开 Kiro CLI,让 steering 上下文与 skills 在新会话里一起生效。
  531. #### 6. Cursor CLI
  532. 安装:
  533. ```bash
  534. super-dev
  535. ```
  536. 触发位置:
  537. 在项目目录启动 Cursor CLI 当前会话后触发。
  538. 触发命令:
  539. ```text
  540. super-dev: 你的需求
  541. ```
  542. 接入后是否需要重启:否
  543. 补充说明:
  544. 1. 适合终端内连续执行研究、文档和编码。
  545. 2. 官方项目上下文面是项目根 `AGENTS.md` 与 `.cursor/rules/`;根 `CLAUDE.md` 只继续作为兼容上下文,不再当默认主协议面。
  546. 3. 若项目上下文或规则面未刷新,可重开一次 Cursor CLI 会话;恢复已有流程时优先使用 Cursor CLI 自身的会话连续性。
  547. #### 7. Qoder CLI
  548. 安装:
  549. ```bash
  550. super-dev
  551. ```
  552. 触发位置:
  553. 在项目目录启动 Qoder CLI 会话后触发。
  554. 触发命令:
  555. ```text
  556. /super-dev 你的需求
  557. ```
  558. 接入后是否需要重启:否
  559. 补充说明:
  560. 1. 适合命令行流水线开发。
  561. 2. 若 slash 未生效,先确认 `AGENTS.md`、`.qoder/commands/super-dev.md` 已生成,并检查 `.qoder/rules/` 目录是否存在。
  562. 3. 官方接入面已切到 `AGENTS.md` + `.qoder/rules/super-dev.md` + `.qoder/commands/super-dev.md` + `.qoder/skills/` / `~/.qoder/AGENTS.md` + `~/.qoder/commands/` + `~/.qoder/skills/`;`.qoder/agents/` 继续只作为增强面。
  563. #### 8. Copilot CLI
  564. 安装:
  565. ```bash
  566. super-dev
  567. ```
  568. 触发位置:
  569. 在项目目录启动 Copilot CLI 会话后触发。
  570. 触发命令:
  571. ```text
  572. super-dev: 你的需求
  573. ```
  574. 接入后是否需要重启:否
  575. 补充说明:
  576. 1. 官方主面是 `AGENTS.md`、`.github/copilot-instructions.md`、`.github/skills/` 与 `.github/agents/`;显式启用用户级 surface 时,再确认 `~/.copilot/skills/`、`~/.copilot/agents/` 与 `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` 也已被会话读取。
  577. 2. 当前使用 `super-dev: 你的需求` 作为主触发方式,不走项目级 `/super-dev` 自定义 slash。
  578. 3. 若维护者需要排障或补齐接入面,再用 `super-dev doctor --host copilot-cli` 做确认。
  579. #### 9. CodeBuddy CLI
  580. 安装:
  581. ```bash
  582. super-dev
  583. ```
  584. 触发位置:
  585. 在项目目录启动 CodeBuddy CLI 会话后触发。
  586. 触发命令:
  587. ```text
  588. /super-dev 你的需求
  589. ```
  590. 接入后是否需要重启:否
  591. 补充说明:
  592. 1. 在当前 CLI 会话中直接输入即可。
  593. 2. 官方主面是 `CODEBUDDY.md` + `.codebuddy/rules/` + `.codebuddy/commands/` + `.codebuddy/skills/` + `.codebuddy/agents/`,并补充 `~/.codebuddy/CODEBUDDY.md`。
  594. 3. 如果会话已提前打开,建议重新加载项目规则后再试。
  595. 4. 黑客松/比赛场景优先使用 `/super-dev-seeai`,让宿主按半小时节奏压缩 research、三文档、Spec 和一体化开发。
  596. #### 10. Antigravity
  597. 安装:
  598. ```bash
  599. super-dev
  600. ```
  601. 触发位置:
  602. 打开 Antigravity 的 Agent Chat / Prompt 面板,并确保当前工作区就是目标项目。
  603. 触发命令:
  604. ```text
  605. /super-dev 你的需求
  606. ```
  607. 接入后是否需要重启:是
  608. 补充说明:
  609. 1. Antigravity 当前按 `GEMINI.md + custom commands` 模式接入,`.agent/workflows` 继续作为推荐增强面。
  610. 2. 接入会写入项目级 `GEMINI.md`、`.gemini/commands/super-dev.toml`、`.agent/workflows/super-dev.md`。
  611. 3. 默认只写项目级 `GEMINI.md` 与项目内命令面;用户级 `~/.gemini/GEMINI.md` 与 `~/.gemini/commands/` 仅在显式 `--with-user-surfaces` 时写入,`~/.gemini/skills/` 继续只作为兼容增强层。
  612. 4. 完成接入后请重开 Antigravity 或至少新开一个 Agent Chat,再输入 `/super-dev 你的需求`。
  613. #### 11. Cursor
  614. 安装:
  615. ```bash
  616. super-dev
  617. ```
  618. 触发位置:
  619. 打开 Cursor 的 Agent Chat,并确保当前工作区就是目标项目。
  620. 触发命令:
  621. ```text
  622. /super-dev 你的需求
  623. ```
  624. 比赛模式:
  625. ```text
  626. /super-dev-seeai 比赛需求
  627. ```
  628. 接入后是否需要重启:否
  629. 补充说明:
  630. 1. 建议固定在同一个 Agent Chat 会话里完成整条流水线。
  631. 2. 如果项目规则没加载,先重新打开工作区或重新发起聊天。
  632. #### 12. Windsurf
  633. 安装:
  634. ```bash
  635. super-dev
  636. ```
  637. 触发位置:
  638. 打开 Windsurf 的 Agent Chat / Workflow 入口,在项目上下文内触发。
  639. 触发命令:
  640. ```text
  641. /super-dev 你的需求
  642. ```
  643. 接入后是否需要重启:否
  644. 补充说明:
  645. 1. 当前按 `AGENTS.md + rules + workflow + skills` 模式适配。
  646. 2. 更适合在同一个 Workflow 里连续完成研究、文档、Spec 和编码。
  647. 3. 官方文档公开 `AGENTS.md`、`.windsurf/workflows/` 与 `.windsurf/skills/`;仓库继续把 `.windsurf/rules/` 保留为项目约束面。
  648. #### 13. Kiro
  649. 安装:
  650. ```bash
  651. super-dev
  652. ```
  653. 触发位置:
  654. 打开 Kiro IDE 的 Agent Chat / AI 面板,在项目上下文内触发。
  655. 触发命令:
  656. ```text
  657. /super-dev 你的需求
  658. ```
  659. 接入后是否需要重启:是
  660. 补充说明:
  661. 1. Kiro IDE 当前优先使用宿主已暴露的 `/super-dev` 入口;如果当前会话只接受自然语言,再回退到 `super-dev: 你的需求`。
  662. 2. 接入会写入项目级 `AGENTS.md`、`.kiro/steering/super-dev.md`、`.kiro/skills/super-dev/SKILL.md`,并补充全局 `~/.kiro/steering/super-dev.md` 与 `~/.kiro/skills/super-dev/SKILL.md`;旧 `~/.kiro/steering/AGENTS.md` 仍作为兼容面保留。
  663. 3. 如果 steering 或 skills 未加载,先重开项目窗口或新开一个 Agent Chat。
  664. #### 14. Qoder
  665. 安装:
  666. ```bash
  667. super-dev
  668. ```
  669. 触发位置:
  670. 打开 Qoder IDE 的 Agent Chat,在当前项目内触发。
  671. 触发命令:
  672. ```text
  673. /super-dev 你的需求
  674. ```
  675. 接入后是否需要重启:否
  676. 补充说明:
  677. 1. Qoder IDE 当前优先使用项目级 `AGENTS.md + commands + rules + skills` 模式,直接在 Agent Chat 输入 `/super-dev 你的需求`。
  678. 2. 若新增命令未出现,先确认 `AGENTS.md`、`.qoder/commands/super-dev.md` 已生成,并检查 `.qoder/rules/super-dev.md` 是否存在,再重新打开项目或新开一个 Agent Chat。
  679. 3. 官方接入面已切到 `AGENTS.md` + `.qoder/rules/super-dev.md` + `.qoder/commands/super-dev.md` + `.qoder/skills/` / `~/.qoder/AGENTS.md` + `~/.qoder/commands/` + `~/.qoder/skills/`;`.qoder/agents/` 继续只作为增强面。
  680. #### 15. Trae IDE
  681. 安装:
  682. ```bash
  683. super-dev
  684. ```
  685. 触发位置:
  686. 打开 Trae IDE 的 Agent Chat,在当前项目上下文内直接触发。
  687. 触发命令:
  688. ```text
  689. super-dev: 你的需求
  690. ```
  691. 接入后是否需要重启:否
  692. 补充说明:
  693. 1. Trae 当前使用 `super-dev: 你的需求` 作为主触发方式。
  694. 2. 默认只写项目级 `.trae/project_rules.md`、`.trae/rules.md`;用户级 `~/.trae/user_rules.md`、`~/.trae/rules.md` 改成显式 `--with-user-surfaces` 才写入;如果检测到兼容技能目录,也会增强安装 `~/.trae/skills/super-dev/SKILL.md`。
  695. 3. 完成接入后建议重开 Trae 或至少新开一个 Agent Chat,使规则生效;如果兼容 Skill 已安装,也会一起生效。
  696. 4. 随后按 `output/*` 与 `.super-dev/changes/*/tasks.md` 推进开发。
  697. #### 16. CodeBuddy
  698. 安装:
  699. ```bash
  700. super-dev
  701. ```
  702. 触发位置:
  703. 打开 CodeBuddy 的 Agent Chat,在项目上下文内触发。
  704. 触发命令:
  705. ```text
  706. /super-dev 你的需求
  707. ```
  708. 接入后是否需要重启:否
  709. 补充说明:
  710. 1. 建议在项目级 Agent Chat 中使用,不要脱离项目上下文。
  711. 2. 先让宿主完成 research,再继续文档和编码。
  712. 3. 当前按 `CODEBUDDY.md` + `.codebuddy/rules/super-dev/RULE.mdc` + `.codebuddy/commands/` + `.codebuddy/agents/` + `.codebuddy/skills/` 接入。
  713. 4. 比赛场景建议固定在同一个 Agent Chat,会比频繁切换子会话更稳。
  714. #### 17. Copilot (VS Code)
  715. 安装:
  716. ```bash
  717. super-dev
  718. ```
  719. 触发位置:
  720. 打开 VS Code 的 Copilot Chat 面板,在项目上下文内触发。
  721. 触发命令:
  722. ```text
  723. super-dev: 你的需求
  724. ```
  725. 接入后是否需要重启:否
  726. 补充说明:
  727. 1. 当前使用 `super-dev: 你的需求` 作为主触发方式,通过项目规则文件驱动流程。
  728. 2. 若维护者需要排障或核对接入面,再用 `super-dev doctor --host vscode-copilot` 做确认。
  729. 3. 在同一个 Copilot Chat 会话里完成整条流水线效果最佳。
  730. #### 18. Roo Code
  731. 安装:
  732. ```bash
  733. super-dev
  734. ```
  735. 触发位置:
  736. 打开 Roo Code 的 Agent Chat / AI 面板,在项目上下文内触发。
  737. 触发命令:
  738. ```text
  739. super-dev: 你的需求
  740. ```
  741. 接入后是否需要重启:否
  742. 补充说明:
  743. 1. 当前使用 `super-dev: 你的需求` 作为主触发方式。
  744. 2. 默认写入项目级规则文件;若宿主提供官方用户级 Skill 目录,会同步增强安装 Skill,如需用户级协议/命令面再显式启用 `--with-user-surfaces`。
  745. 3. 若维护者需要排障或核对接入面,再用 `super-dev doctor --host roo-code` 做确认。
  746. #### 19. Kilo Code
  747. 安装:
  748. ```bash
  749. super-dev
  750. ```
  751. 触发位置:
  752. 打开 Kilo Code 的 Agent Chat / AI 面板,在项目上下文内触发。
  753. 触发命令:
  754. ```text
  755. super-dev: 你的需求
  756. ```
  757. 接入后是否需要重启:否
  758. 补充说明:
  759. 1. 当前使用 `super-dev: 你的需求` 作为主触发方式。
  760. 2. 默认写入项目级规则文件;若宿主提供官方用户级 Skill 目录,会同步增强安装 Skill,如需用户级协议/命令面再显式启用 `--with-user-surfaces`。
  761. 3. 如果规则未加载,先重开项目窗口或新开一个 Agent Chat。
  762. #### 20. Cline
  763. 安装:
  764. ```bash
  765. super-dev
  766. ```
  767. 触发位置:
  768. 打开 Cline 的 Agent Chat 面板,在项目上下文内触发。
  769. 触发命令:
  770. ```text
  771. super-dev: 你的需求
  772. ```
  773. 接入后是否需要重启:否
  774. 补充说明:
  775. 1. 当前使用 `super-dev: 你的需求` 作为主触发方式。
  776. 2. 接入会写入项目级 `.clinerules/` 目录下的规则文件。
  777. 3. 若维护者需要排障或核对接入面,再用 `super-dev doctor --host cline` 做确认。
  778. 4. 在同一个 Agent Chat 会话里完成整条流水线效果最佳。
  779. #### 21. Droid CLI
  780. Droid CLI 走 Factory 官方宿主模型,无需额外插件包。核心接入面是:
  781. - 项目根 `AGENTS.md`
  782. - `.factory/rules/super-dev.md`
  783. - `.factory/skills/super-dev/SKILL.md`
  784. - `.factory/skills/super-dev-seeai/SKILL.md`
  785. - 兼容增强面:`.factory/commands/super-dev.md`、`.factory/commands/super-dev-seeai.md`
  786. - 用户级 `~/.factory/AGENTS.md` / `~/.factory/commands/` / `~/.factory/skills/`(默认不写;仅在显式 `--with-user-surfaces` 时补齐)
  787. 安装:
  788. ```bash
  789. super-dev
  790. ```
  791. 在安装器里选择 `Droid CLI` 后,回到当前项目的 Droid 会话触发。
  792. 触发命令:
  793. ```text
  794. /super-dev 你的需求
  795. ```
  796. 回退入口:
  797. ```text
  798. super-dev: 你的需求
  799. ```
  800. 比赛模式:
  801. ```text
  802. /super-dev-seeai 比赛需求
  803. ```
  804. 需要 headless 续跑时:
  805. ```bash
  806. droid exec --session-id <id> "continue with next steps"
  807. ```
  808. 补充说明:
  809. 1. Droid CLI 需要在目标项目目录里启动,让当前 session 先读取项目根 `AGENTS.md`。
  810. 2. `.factory/rules/` 与 `.factory/skills/` 是主协议面;`.factory/commands/` 继续作为兼容增强面承担 slash 触发补充,不再需要额外插件。
  811. 3. 比赛场景优先使用 `/super-dev-seeai`;如果 slash 面板刷新慢,再回退到 `super-dev-seeai:`。
  812. 4. 恢复已有流程时优先保持同一 Droid session,不要重新开题。
  813. ---
  814. ## 关键文档
  815. - [文档总览](docs/README.md)
  816. - [快速开始](docs/QUICKSTART.md)
  817. - [安装方式](docs/INSTALL_OPTIONS.md)
  818. - [宿主使用指南](docs/HOST_USAGE_GUIDE.md)
  819. - [宿主能力审计](docs/HOST_CAPABILITY_AUDIT.md)
  820. - [宿主运行时验收矩阵](docs/HOST_RUNTIME_VALIDATION.md)
  821. - [宿主接入面说明](docs/HOST_INSTALL_SURFACES.md)
  822. - [工作流指南](docs/WORKFLOW_GUIDE.md)
  823. - [集成指南](docs/INTEGRATION_GUIDE.md)
  824. - [产品审查](docs/PRODUCT_AUDIT.md)
  825. 执行原则:
  826. - 宿主负责"写代码"
  827. - `Super Dev` 负责"把开发过程做对、做全、可审计"
  828. ---
  829. ## 关注我们
  830. <div align="center">
  831. <img src="super-dev-website/public/logo.png" alt="微信公众号" width="100%">
  832. </div>
  833. ---
  834. ## License
  835. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.