产品定位
Super Dev 负责规范宿主里的 AI 开发过程。
宿主负责模型推理、联网检索、终端调用和真实编码。Super Dev 负责 research、三文档、确认门、Spec、前端验证、质量门禁和交付标准，把整个开发过程拉回同一条流水线。
宿主负责执行
模型、工具、联网、改代码、运行项目，这些都由宿主完成。
Super Dev 负责治理
强制 research、三文档、确认门、前端运行验证、质量门禁和交付标准。
项目产物可审计
research、PRD、Architecture、UI/UX、Spec、运行验证、交付报告都会落到文件。
安装方式
安装方式
先把工具装好，再进入宿主接入引导。安装阶段只需要弄清三件事：会安装什么、不会安装什么、下一步怎么触发宿主开始工作。
安装说明
- pip 或 uv 会自动安装 Super Dev 的 Python 依赖。
- 不会自动安装 Claude Code、Cursor、Trae、Gemini CLI 等宿主本体。
- 终端输入 super-dev 后，会进入宿主安装引导并把协议面写入宿主和项目。
pip install -U super-dev
# 或
uv tool install super-dev
# 打开安装引导
super-dev
# 更新到最新版
super-dev update接入面
宿主接入面
不同宿主会读取不同的官方接入面。安装引导会把这些面写到项目级和用户级路径里，让宿主知道何时进入 Super Dev 流水线。
Python CLI
这是治理内核，负责安装、修复、状态、质量门禁、发布检查和交付逻辑。
- super-dev
- doctor / detect / update
- review / quality / release readiness
宿主协议面
宿主通过 commands、rules、AGENTS、steering、subagents、skills 这些官方机制读懂 Super Dev。
- slash / text trigger
- project-level surfaces
- user-level surfaces
项目产物面
知识库、三文档、Spec、运行验证、交付报告共同构成流水线状态。
- knowledge/
- output/*
- .super-dev/changes/*
触发方式
触发方式
只记住两种触发方式即可。协议细节放在宿主矩阵和接入面一节展开。
Slash 宿主
Slash宿主会通过 commands / workflows / subagents / rules 进入 Super Dev 流水线。
文本触发宿主
文本触发宿主会通过 AGENTS / project rules / steering / compatibility skill 理解这句文本触发词。
宿主矩阵
宿主矩阵
这张矩阵列出每个宿主的触发方式、协议面和成熟度，方便在接入、排障和团队规范时统一判断。
CLI
10IDE
7流水线
流水线
入口命令很短，真正重要的是后面的阶段纪律。宿主接到需求后会按研究、文档、确认、实现、验证和交付推进。
同类产品研究
先使用宿主联网能力研究同类产品、交互模式、差异化机会和商业信号。
需求增强
把边界条件、异常路径、验收口径和优先级补足，避免模糊需求直接进编码。
三份核心文档
生成 PRD、Architecture、UI/UX 三文档，形成可审计的执行基线。
用户确认门
三文档完成后强制暂停，用户确认前不得创建 Spec 或继续编码。
Spec / Tasks
确认通过后生成变更提案与任务清单，收紧范围和顺序。
前端优先
先做前端、先跑起来、先可审查，再进入后端和联调。
后端与联调
完成 API、服务、数据层和真实交互闭环。
质量门禁
执行 UI Review、红队、安全、性能和架构阈值检查。
交付与发布演练
交付包 ready、演练 passed、release readiness 通过后才算完成。
知识与门禁
知识库与门禁
本地知识库、确认门、运行验证和交付标准决定了这条流水线如何执行。
知识库优先
当 knowledge/ 和 knowledge-bundle 存在时，宿主必须先读本地知识，再做外部研究。
- research 前置知识读取
- PRD / Architecture / UI/UX 阶段化映射
- quality / delivery 继续复用基线
改动前先看影响范围
接手旧仓库、修改登录流、重构 API 或动关键状态流前，先跑 impact，把受影响模块和回归重点确认清楚。
- super-dev repo-map
- super-dev impact "变更描述" --files ...
- 先看 blast radius 再动手
前端运行验证门
必须有 frontend-runtime 报告通过，中后段才允许继续。
- preview.html
- frontend-runtime.json
- 运行通过后再进后端
质量与交付门
UI Review、红队、交付包、发布演练和 release readiness 共同定义“是否可交付”。
- UI Review
- delivery ready
- rehearsal passed
常用命令
常用命令
这里整理最常用的命令组：安装与引导、宿主接入、代码库理解、影响分析、确认门、质量检查、发布检查和更新。
安装与引导
pip install -U super-dev
# 或
uv tool install super-dev
# 进入宿主安装引导
super-dev宿主接入与修复
super-dev onboard --host claude-code --force --yes
super-dev doctor --host trae --repair --force
super-dev detect --json代码库理解与影响分析
super-dev repo-map
super-dev impact "修改登录流程" --files services/auth.py确认与恢复
super-dev review docs --status confirmed --comment "三文档已确认"
super-dev run --resume质量 / 发布 / 更新
super-dev quality --type all
super-dev release readiness --verify-tests
super-dev update --check
super-dev update排障
排障
大多数问题都出在宿主没有真正读取接入面。排障时优先确认 commands、rules、AGENTS、steering 或 skills 是否已被宿主加载。
排查顺序
- 1执行 super-dev doctor --host <host> --repair --force。
- 2确认安装引导输出的项目级与用户级接入面真实存在。
- 3完全关闭宿主，重新打开项目，并新建一个会话。
- 4先用 smoke 触发语句。
- 5如果宿主直接开始开发，优先判断当前会话没有重新加载规则。
Smoke 验收
# slash 宿主
/super-dev "请先不要开始编码，只回复 SMOKE_OK，并说明你会先做 research、再写三文档并等待确认。"
# 非 slash 宿主
super-dev: 请先不要开始编码，只回复 SMOKE_OK，并说明你会先做 research、再写三文档并等待确认。