super-dev 2.3.7__tar.gz → 2.4.0__tar.gz

{super_dev-2.3.7/super_dev.egg-info → super_dev-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: super-dev
-Version: 2.3.7
+Version: 2.4.0
 Summary: Super Dev - Pipeline AI Coding Assistant
 Author-email: Excellent <11964948@qq.com>
 License-Expression: MIT
@@ -24,19 +24,21 @@ Requires-Dist: rich>=13.0.0
 Requires-Dist: pyyaml>=6.0.0
 Requires-Dist: ddgs<10.0.0,>=9.0.0
 Requires-Dist: requests>=2.31.0
-Requires-Dist: beautifulsoup4>=4.12.0
 Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: openai<2.0.0,>=1.0.0
-Requires-Dist: tenacity>=8.2.0
 Requires-Dist: fastapi<1.0.0,>=0.110.0
 Requires-Dist: uvicorn>=0.27.0
 Requires-Dist: tomli>=2.0.0; python_version < "3.11"
 Provides-Extra: dev
+Requires-Dist: pillow>=10.0.0; extra == "dev"
+Requires-Dist: pip-audit>=2.7.0; extra == "dev"
 Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.12; extra == "dev"
 Dynamic: license-file
 
 # Super Dev
@@ -45,7 +47,7 @@ Dynamic: license-file
 
 <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/)
@@ -60,11 +62,32 @@ Dynamic: license-file
 
 ## 版本
 
-当前版本：`2.3.6`
+当前版本：`2.4.0`
 
-- 发布说明：[v2.3.6 更新内容](docs/releases/2.3.6.md)
+- 发布说明：[v2.4.0 更新内容](docs/releases/2.4.0.md)
 - 官网更新历史：[superdev.goder.ai/changelog](https://superdev.goder.ai/changelog)
 
+## 安装
+
+首页安装口径默认使用 uv：
+
+```bash
+uv tool install super-dev
+```
+
+安装完成后执行：
+
+```bash
+super-dev
+```
+
+源码安装、指定版本回滚等次级安装方式保留在 [docs/INSTALL_OPTIONS.md](docs/INSTALL_OPTIONS.md)。
+
+跨平台说明：
+
+- Windows、macOS、Linux 都先安装包，再直接运行 `super-dev`
+- 仓库内的 `install.sh` 只是 macOS/Linux 便捷入口，不是 Windows 唯一入口
+
 ---
 
 ## 演示视频
@@ -92,26 +115,36 @@ Dynamic: license-file
 
 ## 项目介绍
 
-`Super Dev` 是一个面向商业级交付的 AI 开发编排工具，用于把宿主里的模型能力组织成一套稳定、清晰、可审计的工程流水线。
+`Super Dev` 不是再给宿主叠一层命令集合或脚手架壳。它更像一个宿主教练系统，用来把宿主里的模型能力训练成一套稳定、清晰、可审计、能做商业项目的交付流程。
 
 产品定位：
 
 - 宿主负责模型调用、联网搜索、代码产出、终端执行与文件修改
-- `Super Dev` 负责流程治理、设计约束、质量门禁、审计产物与交付标准
+- `Super Dev` 负责图纸生成、流程治理、设计约束、质量门禁、审计产物与交付标准
+
+换句话说：
+
+- 宿主是执行者
+- `Super Dev` 是产品总监、架构师、设计总监、技术教练和 QA 负责人组成的指导系统
 
-它解决的是交付过程问题：
+它解决的是“宿主会写代码，但不一定会稳定交付”的问题：
 
 - 将需求沉淀为可落地工件：PRD、架构、UI/UX、Spec、任务清单与交付清单
 - 将开发过程组织为标准化流水线：可追踪、可恢复、可审计、可复盘
 - 将质量控制前置到每个阶段：策略治理、红队审查、质量门禁、发布演练
-- 将多宿主协作统一到同一套工程规范：CLI 与 IDE 环境共享同一交付标准
+- 将多宿主协作统一到同一套工程规范：12 个 CLI、9 个 IDE、5 个桌面助手按项目优先注入，共享同一交付标准
 - 将知识库与验证规则自动推送到每个阶段：知识驱动治理，而非依赖人工检查
+- 将宿主训练成“能稳定做出精品商业项目”的团队，而不是让用户自己拼流程、拼审美、拼质量门
 
 ---
 
-## 快速开始
+## 5 分钟上手
 
-普通用户只需要记住 2 个终端命令：
+普通用户先记住 1 条安装命令和 3 个终端命令：
+
+```bash
+uv tool install super-dev
+```
 
 ```bash
 # 进入宿主接入引导
@@ -119,31 +152,56 @@ super-dev
 
 # 更新到最新版，并迁移已接入宿主
 super-dev update
+
+# 清理已注入的宿主接入面
+super-dev uninstall
 ```
 
-接入完成后，正常使用都回到宿主里：
+### 5 分钟路径
+
+1. 在项目目录运行 `super-dev`
+2. 让安装器自动检测宿主并写入项目级接入面；只有明确需要跨项目复用时才补用户/全局接入面
+3. 打开 `output/maintenance/host-onboard-smoke-*.md`
+4. 先看 `标准流第一句` / `比赛流第一句`
+5. 再看 `接入后先验`、`框架焦点`、`官方工作流检查`
+6. 回到宿主里触发第一句，观察它是否按 `research -> 三文档 -> 等待确认` 进入流程
+
+如果这 6 步成立，你拿到的不是“装好了一个工具”，而是“把当前宿主训练成了这个项目的交付教练”。
+
+### 终端只做 3 件事
+- 接入
+- 升级
+- 卸载 / 预演清理
+
+接入完成后，正常使用都回到宿主里。普通用户第一眼只需要记住：
 
 ```text
 /super-dev 你的需求
 super-dev: 你的需求
 /super-dev-seeai 比赛需求
-super-dev-seeai: 比赛需求
 ```
 
+更细的入口差异不要靠记忆硬背，直接看安装后生成的 `host-onboard-smoke`，复制里面的 `标准流第一句` 或 `比赛流第一句` 即可。
+
 正确心智：
 
-- 终端只负责接入与升级
-- 宿主才负责 research、三文档、确认门、Spec、实现、质量门禁与交付
+- 终端只负责接入、升级与卸载
+- 宿主才负责 baseline、research、三文档、确认门、Spec、实现、质量门禁与交付
+- 普通开发不要离开宿主主路径；如果不是在做接入、诊断、治理收尾或兼容修复，就不要先回终端找阶段命令
 - 自动判断会在接入/升级阶段发生，但不会在普通开发流程里越层改宿主配置
 - `已接入` 与 `已验证` 是两回事：文件落盘不代表宿主已经真实跑通
+- 已有项目不是直接开干：`evolve / variant / patch` 必须先做 `baseline -> baseline confirmation`，再进入差量 research 和三文档
+- 恢复是默认场景：关窗口、关电脑、第二天继续，都优先按 `.super-dev/` 与 `output/` 工件恢复当前流程
+
+工作模式：
 
-推荐上手顺序：
+- `new`：从 0 到 1 的新项目
+- `evolve`：已有项目增量迭代
+- `variant`：基于现有项目派生 1-N+1 版本
+- `patch`：已有项目缺陷修复
+- `resume`：中断后的恢复继续
 
-1. 终端运行 `super-dev`
-2. 让安装器自动检测宿主并写入项目级/全局级协议面
-3. 打开宿主，在宿主里输入 `/super-dev` 或 `super-dev:`
-4. 让宿主先完成 research、PRD、Architecture、UI/UX
-5. 文档确认后再进入 Spec 与实现
+记住一个原则：安装完成后，终端基本就该退场。真正开发回到宿主里，先复制 `标准流第一句` 或 `比赛流第一句`，再按 smoke guide 做首轮验收。
 
 SEEAI 赛事极速版：
 
@@ -152,62 +210,41 @@ SEEAI 赛事极速版：
 - 但 `spec` 之后直接进入前后端一体化快速开发，不再拆预览确认门
 - 适合 30 分钟左右的官网、小游戏、展示型工具、单页 demo
 
-高级/内部命令仍然保留，但不再是普通用户主路径：
+只有在接入、诊断、兼容修复或治理收尾时，才需要回终端。普通用户只需要记住：
 
 ```bash
-super-dev init
-super-dev onboard             # 宿主接入引导
-super-dev detect              # 自动检测宿主与推荐默认宿主
-super-dev doctor              # 诊断检查（显示认证等级、主修复动作和下一步）
-super-dev run --status        # 查看内部流程状态
-super-dev run frontend        # 强制跳到特定阶段
-super-dev review docs         # 手动更新确认门状态
+super-dev
+super-dev update
+super-dev uninstall
 ```
 
-治理与知识命令（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            # 知识权重自演化
-```
+- 安装/接入后烟测指南会落到 `output/maintenance/host-onboard-smoke-*.md`
+- 如果当前项目已经冻结了 `framework playbook`，安装后烟测指南会直接显示 `框架焦点（Framework Coaching Focus）`、必验场景和交付证据
+- 卸载预演或正式清理会落到 `output/maintenance/host-cleanup-*.json/.md`
+- 如果只是想先看会删什么，用 `super-dev uninstall --dry-run`
+- 升级完成后先重开终端并执行 `super-dev --version`；如果宿主没有进入 `research -> 三文档 -> 等待确认`，再回终端跑 `doctor`
+- 如果第一轮 UI 看起来过平、过空、模板味太重，不要指望“最后再补美化”；截图级 UI gate 会在 UI review、quality gate、proof-pack 和 release readiness 里继续拦截
+- 正式发版文档 `docs/PUBLISHING.md` 与 `docs/RELEASE_RUNBOOK.md` 只属于维护者，不是普通用户上手路径。
 
-治理与执行命令（2.3.0 新增）：
+其余 `detect / doctor / review / quality / release / spec / task` 都属于维护面，只在报告明确要求时由维护者进入。
 
-| 命令 | 功能 |
-|------|------|
-| `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 hooks history` | 查看最近 hook 执行历史 |
-| `super-dev harness status` | 汇总查看 workflow / framework / hook harness 状态，并显示最近关键时间线 |
-| `super-dev harness operational` | 查看统一 operational harness 报告，并直接给出当前治理焦点与建议先做 |
-| `super-dev harness timeline` | 查看 workflow 快照、语义事件与 hook 事件合并后的统一时间线 |
-| `super-dev experts list` | 查看可用专家 |
-| `super-dev compact list` | 查看上下文压缩摘要 |
-| `super-dev generate scaffold` | 生成项目脚手架 |
-| `super-dev generate components` | 生成 UI 组件 |
-| `super-dev generate types` | 生成前后端共享类型 |
-
-常用交付证据命令：
+说明：
+- `skill / integrate` 只用于宿主接入、兼容性审计和真人验收，不属于日常开发主路径
+- `config / enforce / generate` 属于内部维护能力，不是普通用户入口
+- `onboard / detect / doctor / run / review / release` 允许保留，但应视为维护面而不是普通用户心智
+- 真正的项目开发仍应回到宿主里，优先使用 `/super-dev` 或 `super-dev:` 开题，并直接说“继续当前流程”“现在下一步是什么”
+- 如果你在已有项目里做增量开发，不要先在终端里手工跳阶段，先让宿主完成 `baseline -> baseline confirmation`，再进入差量文档和实现
+- 如果只是回来继续昨天的活，不要先回终端找 `run` / `jump` / `confirm`，优先在宿主里直接说“继续当前流程”
 
-```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 "质量门禁未通过，需要整改"
-```
+交付与卡点处理仍然存在治理入口，但它们属于维护面，不应当成普通用户命令目录：
+
+- `product-audit`：范围缺口与实施覆盖率体检
+- `release readiness / proof-pack`：发布证据与交付闭环
+- `review *`：维护者同步 gate 状态或修订状态
+
+普通用户仍应优先回宿主里说“继续当前流程”“现在下一步是什么”。
 
 ---
 
@@ -252,25 +289,26 @@ UI/UX 文档不再只是建议，而是会冻结成一份真正的 UI 契约：
 - `output/*-ui-contract-alignment.md`
 - `output/*-ui-contract-alignment.json`
 
-宿主提示词、前端骨架、后续实现、UI review、frontend runtime、quality gate、proof-pack、release readiness 都会围绕这份 UI 契约继续执行。
+宿主提示词、实现约束、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 review 与 UI contract alignment
+- frontend runtime 运行证据
+- proof-pack 与 release readiness 摘要
 
-来持续检查 UI 契约有没有真的落到源码和交付结果中。
+它们共同用于持续检查 UI 契约有没有真的落到源码和交付结果中。
 
 ### 3. 流水线编排引擎
 
-- **9 阶段标准流水线**：research -> prd -> architecture -> uiux -> spec -> frontend -> backend -> quality -> delivery
+- **新项目主链**：research -> docs -> docs_confirm -> spec -> frontend -> preview_confirm -> backend -> quality -> delivery
+- **已有项目主链**：baseline -> baseline_confirm -> delta research -> docs -> docs_confirm -> spec -> frontend -> preview_confirm -> backend -> quality -> delivery
 - **检查点与中断续传**：流水线中断后可从断点恢复，不丢失进度
 - **阶段超时保护**：每个阶段设有超时机制，防止无限等待
 - **确认门控制**：三文档完成后必须等待用户确认，前端预览完成后必须等待用户确认
-- **阶段跳转**：`super-dev run <阶段>` 可随时跳转到任意阶段
-- **UI 改版回路**：UI 不满意时可发起正式改版回路（`review ui`），先更新 UIUX 文档再重做前端
-- **适配 0-1 与 1-N+1**：新建项目走完整流水线，已有项目走增量分析路径
+- **阶段恢复**：宿主可以通过自然语言恢复到目标阶段，高级阶段跳转只保留给维护场景
+- **UI 改版回路**：UI 不满意时可在宿主里发起正式改版回路，先更新 UIUX 文档再重做前端
+- **适配 0-1 与 1-N+1**：新建项目走完整流水线，已有项目先 baseline 再走增量分析路径
 - **继续当前流程路由**：内部恢复与状态命令共享同一套 workflow state 与 action card
 - **恢复状态卡**：`.super-dev/SESSION_BRIEF.md` 和 `.super-dev/workflow-state.json` 会沉淀“当前动作 / 宿主第一句 / 机器侧动作 / 连续性规则”
 - **关键时间线**：流程快照、语义事件、Hook 事件会汇总成统一的 recent timeline，进入 `SESSION_BRIEF`、Workflow Harness、proof-pack 与 release readiness
@@ -310,37 +348,32 @@ Super Dev 为每个阶段生成初始文档框架，宿主大模型在此基础
 
 ### 6. 宿主接入治理
 
-- 支持 25+ 个主流 CLI/IDE 宿主统一接入（9 CLI + 11 IDE + 扩展宿主）
-- OpenClaw 作为原生插件宿主单独接入，用户自行执行 `openclaw plugins install @super-dev/openclaw-plugin`
+- 支持 26 个主流宿主统一接入（12 CLI + 9 IDE + 5 桌面助手）
+- 新增 `Droid CLI` 官方 `.factory` 宿主接入：`AGENTS.md + .factory/rules + .factory/skills`，`.factory/commands` 仅作为兼容增强面
 - 自动生成宿主规则文件、`/super-dev` 映射、Skill 目录
 - `detect / onboard / doctor / setup / install / start` 形成接入闭环
 - 通过宿主能力边界建模，明确哪些宿主是 `Certified / Compatible / Experimental`
 - `--dry-run` 预览模式与 `--stable-only` 稳定模式
 - `--save-profile` 写入 `super-dev.yaml` 并用于质量门禁
 - `doctor`、`detect`、`start` 默认会输出决策卡：推荐宿主、推荐理由、第一步动作、候选宿主、路径覆盖修复提示
+- 决策卡、安装向导与 runtime 报告会直接给出 `标准流第一句 / 比赛流第一句 / 接入后先验 / 官方工作流检查 / 修复剧本`
+- 宿主准备度会明确区分 `标准流可直接开工` 和 `SEEAI 比赛模式可直接开工`
 - 支持 Windows 注册信息、shim 目录、常见路径和 `SUPER_DEV_HOST_PATH_<HOST>` 自定义路径覆盖
 - 显式指定宿主时，系统会围绕你指定的宿主给建议，不再被自动检测结果带偏
 
-### 7. 代码库理解与变更分析
+### 7. 产品审计与范围缺口
 
-- **repo-map**：生成代码库地图与建议阅读顺序
-- **feature-checklist**：审计 PRD 功能范围覆盖率，区分流程完成与范围完成
-- **dependency-graph**：输出模块依赖关系与关键路径
-- **impact**：分析改动影响范围、风险等级和建议动作
-- **regression-guard**：把影响分析转换成可执行回归清单
+- **product-audit**：从产品、交互、闭环和代码结构角度生成总审查报告
+- 区分“流水线已经走完”和“范围是否真的做完”
+- 为 `proof-pack`、`release readiness`、质量整改提供范围缺口输入
 
 ### 8. 可审计交付
 
-- `pipeline-metrics` 指标报告（2.2.0 新增 DORA 五指标 + Rework Rate）
-- `pipeline-contract` 阶段契约证据
-- `resume-audit` 恢复执行审计
-- `delivery manifest/report/archive` 交付包
-- `proof-pack` 交付证据汇总与 executive summary
-- `release readiness`、`Spec Quality`、`Scope Coverage` 统一发布评分面板
-- `UI Contract Alignment` 进入 proof-pack 与 release readiness，不再只是 UI review 内部提示
-- `ADR 自动生成`：架构决策自动记录到交付证据中（2.2.0 新增）
-- `Spec-Code Consistency Report`：一致性检测报告进入交付闭环（2.2.0 新增）
-- `resume-audit`、`pipeline-contract`、治理快照、frontend runtime、knowledge tracking、validation report 会一起进入交付闭环
+- `proof-pack`：交付证据汇总与 executive summary
+- `release readiness`：发布就绪度检查
+- `frontend runtime / UI Contract Alignment / quality gate`：前端、设计契约与质量门禁闭环
+- `delivery manifest/report/archive`：交付包与归档产物
+- `pipeline metrics / knowledge tracking / validation report`：作为内部证据进入交付闭环，不属于普通用户主入口
 
 ### 9. 知识库系统
 
@@ -355,7 +388,7 @@ Super Dev 内置结构化知识库（`knowledge/` 目录），270+ 个知识文
 - **移动端**：跨平台开发、原生性能优化
 - **更多领域**：CI/CD、测试、产品、低代码、边缘/IoT、区块链、量子计算
 
-知识推送引擎（2.2.0 新增）：
+知识推送引擎：
 
 - **阶段精准映射**：306 个知识文件建立索引，7 个 pipeline 阶段精准推送相关约束
 - **渐进式加载**：L1 索引（目录级快速匹配）/ L2 详情（文件级内容推送）/ L3 深度引用（段落级精准引用），token 预算控制
@@ -365,25 +398,14 @@ Super Dev 内置结构化知识库（`knowledge/` 目录），270+ 个知识文
 - 如果已生成 `output/knowledge-cache/*-knowledge-bundle.json`，宿主会继承其中的本地知识命中结果
 - 同时支持联网研究增强，将 Web 搜索结果与本地知识合并输出
 
-### 10. 策略治理系统
-
-通过 Policy DSL 和 YAML 声明式验证规则引擎实现流程治理的可编程控制：
-
-- **default**：标准预设，适合个人和小团队
-- **balanced**：平衡预设，适合中等规模团队
-- **enterprise**：企业预设，更高质量阈值、宿主画像要求、可按项目配置关键宿主
+### 10. 内部治理能力
 
-策略控制维度：
+这部分属于内部维护与交付保障，不是普通用户日常命令面：
 
-- 25 条 YAML 声明式验证规则（14 默认 + 11 红队），支持项目级自定义覆盖
-- 强制红队 / 质量门禁开关
-- 最低质量阈值设定
-- CI/CD 平台白名单
-- required hosts 与 ready+score 硬校验（按项目启用）
-- 宿主画像自动探测与评分
-- `host-compatibility` 报告与历史记录
-- Pipeline 效能度量（DORA 五指标 + Rework Rate）
-- Prompt 模板版本化，文档生成 Prompt 可迭代优化
+- YAML 验证规则与质量门禁
+- 宿主兼容度探测与接入审计
+- Pipeline 指标、知识跟踪、治理快照
+- Prompt / 文档模板 / 规则版本化
 
 ---
 
@@ -398,14 +420,19 @@ uv tool install super-dev
 升级：
 
 ```bash
-uv tool upgrade super-dev
 super-dev update
 ```
 
-### 2. PyPI 安装
+### 2. 指定版本安装
+
+```bash
+uv tool install super-dev==2.4.0
+```
+
+升级：
 
 ```bash
-pip install -U super-dev
+uv tool upgrade super-dev
 super-dev update
 ```
 
@@ -432,23 +459,15 @@ super-dev
 - slash 宿主：`/super-dev 你的需求`
 - 非 slash 宿主：`super-dev: 你的需求`
 - 比赛极速版：`/super-dev-seeai 比赛需求` 或 `super-dev-seeai: 比赛需求`
-- 需要真人验收时，可执行：`super-dev integrate validate --target <host>`
-
-### 3. 指定版本安装
-
-```bash
-pip install super-dev==2.3.6
-```
+- 需要继续验收或恢复时，优先回到宿主里说“继续当前流程”或“现在下一步是什么”
 
-### 4. GitHub 指定标签安装
+### 3. GitHub 指定标签安装
 
 ```bash
-pip install git+https://github.com/shangyankeji/super-dev.git@v2.3.6
+uv tool install --from git+https://github.com/shangyankeji/super-dev.git@v2.4.0 super-dev
 ```
 
-### 5. 源码开发安装
-
-`uv` 开发环境：
+### 4. 源码开发安装
 
 ```bash
 git clone https://github.com/shangyankeji/super-dev.git
@@ -457,14 +476,6 @@ uv sync
 uv run super-dev --version
 ```
 
-`pip` 开发环境：
-
-```bash
-git clone https://github.com/shangyankeji/super-dev.git
-cd super-dev
-pip install -e ".[dev]"
-```
-
 ---
 
 ## 依赖安装说明
@@ -472,7 +483,7 @@ pip install -e ".[dev]"
 当用户执行：
 
 ```bash
-pip install -U super-dev
+uv tool install super-dev
 ```
 
 或：
@@ -493,7 +504,7 @@ uv tool install super-dev
 
 不会自动安装的内容：
 
-- Claude Code / Codex CLI / Gemini CLI / Cursor / Trae / Windsurf 等宿主软件本身
+- Claude Code / Codex CLI / Gemini CLI / Cursor / Trae / Windsurf / 桌面助手等宿主软件本身
 - Node.js、npm、pnpm、Docker、数据库服务这类系统级运行环境
 - 宿主账号登录状态、联网权限、浏览器能力
 - 项目业务依赖以外的前后端运行时
@@ -512,72 +523,32 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 这会显式生成：
 
 - `.super-dev/WORKFLOW.md`
-- `output/*-bootstrap.md`
 
 用来固定初始化规范、触发方式和阶段顺序。
 
 ---
 
-## 2.2.0 新功能亮点
+## 当前保留的核心增强
 
-### 知识驱动治理
+围绕“宿主接入 + 主流水线 + 交付闭环”，当前重点保留这些增强：
 
-- **知识推送引擎** — 每个 pipeline 阶段自动推送相关知识约束（306 个知识文件索引，7 阶段精准映射）
-- **渐进式加载** — L1 索引 / L2 详情 / L3 深度引用，token 预算控制
-- **知识自演化** — SQLite 追踪使用效果，数据驱动权重优化
-- **270+ 知识文件** — 覆盖 23 个技术领域，15 万行深度内容
+- 宿主接入治理：`detect / onboard / doctor / setup / install / start`
+- 三文档、Spec、前端优先、预览确认、后端、质量门禁、交付证据
+- 专家按阶段注入，知识库在 research / docs / spec / implementation 阶段持续生效
+- Plan-Execute / Overseer / Claude-Codex hybrid mode 仍保留在编排内核
+- Design inspiration workflow 仍保留在 UI/UX 增强链里
+- UI 契约、frontend runtime、UI review、quality gate、proof-pack、release readiness 同一轮证据闭环
+- 交付证据、知识跟踪、Pipeline 指标作为内部治理面持续产出
 
-### 可编程治理
+## 历史能力沉淀
 
-- **验证规则引擎** — 25 条 YAML 声明式规则（14 默认 + 11 红队），支持项目级自定义
-- **质量顾问** — 不只说"不达标"，还给出具体修复建议（Quick Wins 优先）
-- **Spec-Code 一致性检测** — 防止代码偏离 Spec 描述
+下面这些能力仍然是系统底座的一部分，但不再作为单独公开产品面强调：
 
-### 专家系统升级
-
-- **四层武装** — Profile + Knowledge + Rules + Protocol
-- **11 个深度 Playbook** — 每个专家 350+ 行操作手册
-- **交叉审查引擎** — 多专家视角自动审查交付物
-
-### 效能度量
-
-- **Pipeline 效能度量** — DORA 五指标 + Rework Rate
-- **ADR 自动生成** — 架构决策自动记录
-- **Prompt 模板版本化** — 文档生成 Prompt 可迭代优化
-
-### OpenClaw 深度适配
-
-- **20 个 Plugin Tool** — 覆盖全部核心命令
-- **精简 SKILL.md** — 145 行引导，聚焦"调哪个 Tool"
-
----
-
-## 2.3.0 新增能力
-
-- **Enforcement 系统**: 自动配置宿主 hooks，实现编码时实时约束检查
-- **编码前门禁**: 7 步强制确认（技术栈预研→配置→图标→组件→API→token→构建）
-- **技术栈预研**: 通用机制，编码前强制读取 package.json 并查阅官方文档
-- **知识库驱动**: 技术栈规则从 knowledge/ 文件动态加载，不写死在代码中
-- **记忆系统**: 4 种记忆类型 (user/feedback/project/reference) + 自动提取
-- **组件脚手架**: 生成可直接使用的 Button/Card/Input/Modal/Nav/Layout
-- **API 契约生成**: 从架构文档生成前后端共享 TypeScript 类型
-- **对抗性验证**: 独立验证专家，尝试打破实现而非确认有效
-- **三 Agent 审查**: 复用 + 质量 + 效率 + 安全并行审查
-- **Pipeline 品牌输出**: 每个阶段显示进度标识
-- **Pipeline 状态文件**: 每阶段自动写入 `.super-dev/pipeline-state.json`，宿主可读取当前进度
-- **Pipeline 成本追踪**: 每阶段耗时/文件数记录到 `.super-dev/metrics/pipeline-cost.json`，异常中断也会保存
-- **状态变更事件系统**: phase_started / phase_completed / phase_failed / pipeline_completed 自动触发 SessionBrief 更新
-- **CLAUDE.md 知识引用**: 生成的项目根 `CLAUDE.md` 与兼容 `.claude/CLAUDE.md` 会自动包含 `@./knowledge/...` 引用，宿主原生加载技术栈知识
-- **条件规则系统**: `.super-dev/rules/*.md` 条件规则，支持 frontmatter `paths` 过滤和排除模式
-- **项目模板**: `super-dev init --template ecommerce/saas/dashboard/mobile/api/blog/miniapp`
-- **首次使用引导**: 3 步快速开始面板，最多显示 4 次后自动隐藏
-- **Tips 提示系统**: 根据当前阶段显示上下文相关的操作建议
-- **Shell 补全**: `super-dev completion bash/zsh/fish`
-- **版本更新检查**: PyPI 24h 缓存，有新版时提示升级
-- **`doctor --fix`**: 自动修复检测到的安装问题
-- **`super-dev feedback`**: 快速打开 GitHub Issues 反馈
-- **`super-dev migrate`**: 2.2.0 → 2.3.0 一键迁移
-- **验证脚本增强**: 多级输出 (Level 1 阻塞 / Level 2 警告 / Level 3 建议)，新增 console.log / localhost / TODO 检查
+- 知识驱动治理、渐进式知识加载、知识自演化
+- YAML 验证规则、质量顾问、Spec-Code 一致性检测
+- 11 专家 Playbook、交叉审查、Prompt/模板版本化
+- Pipeline 指标、ADR、治理快照等内部证据
+- 宿主深度适配矩阵与多宿主接入治理
 
 ---
 
@@ -592,7 +563,7 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 5. 宿主负责联网、推理、编码、运行与修改文件
 6. Super Dev 负责流程、文档、知识推送、验证规则、门禁、审计和交付标准
 
-标准流水线：`research -> prd -> architecture -> uiux -> 用户确认 -> spec -> frontend -> 预览确认 -> backend -> quality -> delivery`
+标准流水线：`research -> docs -> docs_confirm -> spec -> frontend -> preview_confirm -> backend -> quality -> delivery`
 
 补充说明：
 
@@ -614,7 +585,7 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 
 ## 架构概览
 
-Super Dev 2.3.6 架构由四层组成：**宿主接入层**（20 个统一接入宿主 + 1 个 OpenClaw 手动插件宿主）、**知识治理层**（306 索引 / 渐进式加载 / 自演化）、**编排引擎层**（9 阶段流水线 / 11 专家 + Overseer / 验证规则引擎）、**交付审计层**（DORA 度量 / ADR / 一致性检测 / proof-pack）。
+Super Dev 2.4.0 架构由四层组成：**宿主接入层**（统一宿主矩阵，按 CLI / IDE / 桌面助手分组）、**知识治理层**（306 索引 / 渐进式加载 / 自演化）、**编排引擎层**（9 阶段流水线 / 11 专家 + Overseer / 验证规则引擎）、**交付审计层**（DORA 度量 / ADR / 一致性检测 / proof-pack）。
 
 ### 一、系统高阶流转架构
 
@@ -636,28 +607,32 @@ Super Dev 2.3.6 架构由四层组成：**宿主接入层**（20 个统一接入
 
 ---
 
-## 20 个统一接入宿主 + 1 个手动插件宿主
+## 统一接入宿主矩阵
 
 正式产品口径：
 
-- `20` 个统一接入宿主
-- `OpenClaw` 单独作为原生插件宿主，走 npm / plugin 安装，不走统一 `onboard`
+- 当前矩阵按 `CLI / IDE / 桌面助手` 分组
+- `Codex` 和 `Codex CLI` 是两个不同宿主，`Claude` 和 `Claude Code` 也是两个不同宿主
+- 默认采用项目优先注入：先写项目级接入面，再按需补齐用户 / 全局接入面
 
-### 统一 CLI 宿主（9 个）
+### CLI 宿主（12 个）
 
 | 宿主 | 触发方式 | 终端入口 |
 |------|----------|----------|
 | Claude Code | `/super-dev 需求` | `super-dev` |
-| Codex | App/Desktop: `/super-dev`（skill 入口） / CLI: `$super-dev` / 回退: `super-dev: 需求` | `super-dev` |
-| Gemini CLI | `/super-dev 需求` | `super-dev` |
+| Codex CLI | `$super-dev`；回退 `super-dev: 需求` | `super-dev` |
 | OpenCode | `/super-dev 需求` | `super-dev` |
+| Droid CLI | `/super-dev 需求`；比赛模式 `/super-dev-seeai`；回退 `super-dev: 需求` | `super-dev` |
+| Gemini CLI | `/super-dev 需求` | `super-dev` |
 | Kiro CLI | `/super-dev 需求` | `super-dev` |
-| Cursor CLI | `/super-dev 需求` | `super-dev` |
-| Qoder CLI | `/super-dev 需求` | `super-dev` |
+| Cursor CLI | `super-dev: 需求` | `super-dev` |
 | Copilot CLI | `super-dev: 需求` | `super-dev` |
+| Qoder CLI | `/super-dev 需求` | `super-dev` |
 | CodeBuddy CLI | `/super-dev 需求` | `super-dev` |
+| Kimi Code | `super-dev: 需求`；显式入口 `/skill:super-dev 需求` | `super-dev` |
+| Qwen Code | `/super-dev 需求` | `super-dev` |
 
-### IDE 宿主（11 个）
+### IDE 宿主（9 个）
 
 | 宿主 | 触发方式 | 终端入口 |
 |------|----------|----------|
@@ -665,13 +640,21 @@ Super Dev 2.3.6 架构由四层组成：**宿主接入层**（20 个统一接入
 | Cursor | `/super-dev 需求` | `super-dev` |
 | Windsurf | `/super-dev 需求` | `super-dev` |
 | Kiro | `/super-dev 需求` | `super-dev` |
-| Qoder | `/super-dev 需求` | `super-dev` |
-| Trae | `super-dev: 需求` | `super-dev` |
+| Trae IDE | `super-dev: 需求` | `super-dev` |
+| TraeCN | `super-dev: 需求` | `super-dev` |
 | CodeBuddy | `/super-dev 需求` | `super-dev` |
-| Copilot (VS Code) | `super-dev: 需求` | `super-dev` |
-| Roo Code | `super-dev: 需求` | `super-dev` |
-| Kilo Code | `super-dev: 需求` | `super-dev` |
-| Cline | `super-dev: 需求` | `super-dev` |
+| CodeBuddyCN | `/super-dev 需求` | `super-dev` |
+| Qoder | `/super-dev 需求` | `super-dev` |
+
+### 桌面助手（5 个）
+
+| 宿主 | 触发方式 | 终端入口 |
+|------|----------|----------|
+| Claude | `super-dev: 需求` | `super-dev` |
+| Codex | App/Desktop: 在 `/` 列表里选择 `super-dev` | `super-dev` |
+| WorkBuddy | `super-dev: 需求` | `super-dev` |
+| Trae SOLO | `/super-dev 需求` | `super-dev` |
+| Trae SOLOCN | `super-dev: 需求` | `super-dev` |
 
 ---
 
@@ -696,12 +679,17 @@ super-dev
 /super-dev-seeai 比赛需求
 ```
 
+自然语言回退：
+```text
+super-dev: 你的需求
+```
+
 接入后是否需要重启：否
 
 补充说明：
 1. 推荐作为首选 CLI 宿主。
-2. 接入后可先执行 `super-dev doctor --host claude-code`，确认项目根 `CLAUDE.md`、项目级 `.claude/skills/super-dev/`、用户级 `~/.claude/skills/`、兼容 slash 与可选 plugin enhancement 一起生效。
-3. Claude Code 当前按 skills-first 收敛：主面是 `CLAUDE.md + .claude/skills + ~/.claude/skills`，`.claude/commands/` 与 `.claude/agents/` 仅作为兼容增强面保留。
+2. 维护者如需核对接入面，可执行 `super-dev doctor --host claude-code`，确认项目根 `CLAUDE.md`、项目级 `.claude/CLAUDE.md`、可选 `.claude/settings*.json`、项目/用户级 skills 与 agents 一起生效。
+3. Claude Code 当前按官方 `CLAUDE.md + settings + project/user skills + subagents` 模型对齐；`.claude/commands/` 仅作为兼容增强面保留，不再当主协议面。
 4. 如需增强层，Super Dev 还会补齐 `.claude-plugin/marketplace.json` 与 `plugins/super-dev-claude/.claude-plugin/plugin.json`。
 
 #### 2. Codex
@@ -727,9 +715,9 @@ Codex CLI: $super-dev
 1. Codex App/Desktop 优先从 `/` 列表里直接选择 `super-dev`；这是已启用 Skill 的官方入口，不是项目级自定义 slash 文件。
 2. Codex CLI 优先显式输入 `$super-dev`。
 3. 如果当前已经在自然语言上下文里继续流程，也可以直接输入 `super-dev: 你的需求`。
-4. 基础接入面是项目根 `AGENTS.md`、项目级 `.agents/skills/super-dev/SKILL.md`、全局 `CODEX_HOME/AGENTS.md`（默认 `~/.codex/AGENTS.md`），以及官方用户级 Skill `~/.agents/skills/super-dev/SKILL.md`。
+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` 时才写入。
 5. 同时会额外生成可选的 repo plugin 增强层：`.agents/plugins/marketplace.json` + `plugins/super-dev-codex/.codex-plugin/plugin.json`，让 Codex App/Desktop 在 AGENTS + Skills 之外还能看到更完整的本地 plugin 面。
-6. 为兼容旧安装，仍会保留 `super-dev-core` 作为兼容别名。
+6. 历史安装会在升级时自动迁移到统一的 `super-dev` 命名。
 7. 如果旧会话没加载新 Skill，重启 `codex` 再试。
 8. 无论使用 `/super-dev`、`$super-dev` 还是 `super-dev:`，都必须进入同一条 Super Dev 流程；长流程里继续修改、补充、确认或恢复时，优先沿用当前入口面。
 
@@ -751,8 +739,10 @@ super-dev
 接入后是否需要重启：否
 
 补充说明：
-1. 优先在同一会话中完成 research -> 三文档 -> 用户确认 -> Spec -> 前端运行验证 -> 后端/交付。
-2. 若宿主支持联网，先让它完成同类产品研究。
+1. 官方主面已经收口到 `GEMINI.md + settings + custom commands`；项目内优先检查 `GEMINI.md`、可选 `.gemini/settings.json` 和 `.gemini/commands/*.toml`。
+2. `/super-dev` 是 Super Dev 注入后的自定义命令面，不是 Gemini CLI 自带内建命令；若命令未刷新，优先重开当前 Gemini CLI 会话。
+3. `~/.gemini/skills/` 只作为兼容增强面保留，不再当默认主协议面。
+4. 优先在同一会话中完成 research -> 三文档 -> 用户确认 -> Spec -> 前端运行验证 -> 后端/交付；若宿主支持联网，先让它完成同类产品研究。
 
 #### 4. OpenCode
 
@@ -793,9 +783,9 @@ super-dev
 接入后是否需要重启：是
 
 补充说明：
-1. Kiro CLI 当前优先按官方 steering slash entry 触发；如果当前会话只接受自然语言，再回退到 `super-dev: 需求`。
-2. 官方接入面是 `.kiro/steering/super-dev.md` + `.kiro/skills/super-dev-core/SKILL.md` + `~/.kiro/steering/super-dev.md` + `~/.kiro/skills/super-dev-core/SKILL.md`。
-3. 完成接入后建议重开 Kiro CLI，让 steering slash entry 与 skills 在新会话里一起生效。
+1. Kiro CLI 当前优先使用宿主已暴露的 `/super-dev` 入口；如果当前会话只接受自然语言，再回退到 `super-dev: 需求`。
+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`。
+3. 完成接入后建议重开 Kiro CLI，让 steering 上下文与 skills 在新会话里一起生效。
 
 #### 6. Cursor CLI
 
@@ -809,14 +799,15 @@ super-dev
 
 触发命令：
 ```text
-/super-dev 你的需求
+super-dev: 你的需求
 ```
 
 接入后是否需要重启：否
 
 补充说明：
 1. 适合终端内连续执行研究、文档和编码。
-2. 若命令列表未刷新，可重开一次 Cursor CLI 会话。
+2. 官方项目上下文面是项目根 `AGENTS.md` 与 `.cursor/rules/`；根 `CLAUDE.md` 只继续作为兼容上下文，不再当默认主协议面。
+3. 若项目上下文或规则面未刷新，可重开一次 Cursor CLI 会话；恢复已有流程时优先使用 Cursor CLI 自身的会话连续性。
 
 #### 7. Qoder CLI
 
@@ -838,7 +829,7 @@ super-dev
 补充说明：
 1. 适合命令行流水线开发。
 2. 若 slash 未生效，先确认 `AGENTS.md`、`.qoder/commands/super-dev.md` 已生成，并检查 `.qoder/rules/` 目录是否存在。
-3. 官方接入面已切到 `AGENTS.md` + `.qoder/rules/super-dev.md` + `.qoder/commands/super-dev.md` + `.qoder/skills/` / `~/.qoder/AGENTS.md` + `~/.qoder/skills/`。
+3. 官方接入面已切到 `AGENTS.md` + `.qoder/rules/super-dev.md` + `.qoder/commands/super-dev.md` + `.qoder/skills/` / `~/.qoder/AGENTS.md` + `~/.qoder/commands/` + `~/.qoder/skills/`；`.qoder/agents/` 继续只作为增强面。
 
 #### 8. Copilot CLI
 
@@ -852,14 +843,15 @@ super-dev
 
 触发命令：
 ```text
-/super-dev 你的需求
+super-dev: 你的需求
 ```
 
 接入后是否需要重启：否
 
 补充说明：
-1. 当前使用 `super-dev: 你的需求` 作为主触发方式。
-2. 建议先用 `super-dev doctor --host copilot-cli` 做一次确认。
+1. 官方主面是 `AGENTS.md`、`.github/copilot-instructions.md`、`.github/skills/` 与 `.github/agents/`；显式启用用户级 surface 时，再确认 `~/.copilot/skills/`、`~/.copilot/agents/` 与 `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` 也已被会话读取。
+2. 当前使用 `super-dev: 你的需求` 作为主触发方式，不走项目级 `/super-dev` 自定义 slash。
+3. 若维护者需要排障或补齐接入面，再用 `super-dev doctor --host copilot-cli` 做确认。
 
 #### 9. CodeBuddy CLI
 
@@ -880,7 +872,7 @@ super-dev
 
 补充说明：
 1. 在当前 CLI 会话中直接输入即可。
-2. 官方主面是 `CODEBUDDY.md` + `.codebuddy/commands/` + `.codebuddy/skills/`，并补充 `~/.codebuddy/CODEBUDDY.md`。
+2. 官方主面是 `CODEBUDDY.md` + `.codebuddy/rules/` + `.codebuddy/commands/` + `.codebuddy/skills/` + `.codebuddy/agents/`，并补充 `~/.codebuddy/CODEBUDDY.md`。
 3. 如果会话已提前打开，建议重新加载项目规则后再试。
 4. 黑客松/比赛场景优先使用 `/super-dev-seeai`，让宿主按半小时节奏压缩 research、三文档、Spec 和一体化开发。
 
@@ -902,9 +894,9 @@ super-dev
 接入后是否需要重启：是
 
 补充说明：
-1. Antigravity 当前按 `GEMINI.md + .agent/workflows + /super-dev` 模式接入。
-2. 接入会写入项目级 `GEMINI.md`、`.gemini/commands/super-dev.md`、`.agent/workflows/super-dev.md`。
-3. 同时会写入用户级 `~/.gemini/GEMINI.md`、`~/.gemini/commands/super-dev.md` 与 `~/.gemini/skills/super-dev-core/SKILL.md`。
+1. Antigravity 当前按 `GEMINI.md + custom commands` 模式接入，`.agent/workflows` 继续作为推荐增强面。
+2. 接入会写入项目级 `GEMINI.md`、`.gemini/commands/super-dev.toml`、`.agent/workflows/super-dev.md`。
+3. 默认只写项目级 `GEMINI.md` 与项目内命令面；用户级 `~/.gemini/GEMINI.md` 与 `~/.gemini/commands/` 仅在显式 `--with-user-surfaces` 时写入，`~/.gemini/skills/` 继续只作为兼容增强层。
 4. 完成接入后请重开 Antigravity 或至少新开一个 Agent Chat，再输入 `/super-dev 你的需求`。
 
 #### 11. Cursor
@@ -950,8 +942,9 @@ super-dev
 接入后是否需要重启：否
 
 补充说明：
-1. 当前按 IDE slash/workflow 模式适配。
+1. 当前按 `AGENTS.md + rules + workflow + skills` 模式适配。
 2. 更适合在同一个 Workflow 里连续完成研究、文档、Spec 和编码。
+3. 官方文档公开 `AGENTS.md`、`.windsurf/workflows/` 与 `.windsurf/skills/`；仓库继续把 `.windsurf/rules/` 保留为项目约束面。
 
 #### 13. Kiro
 
@@ -971,8 +964,8 @@ super-dev
 接入后是否需要重启：是
 
 补充说明：
-1. Kiro IDE 当前优先使用官方 steering slash entry，直接在 Agent Chat 输入 `/super-dev 你的需求`；如果当前会话只接受自然语言，再回退到 `super-dev: 你的需求`。
-2. 接入会写入项目级 `.kiro/steering/super-dev.md`、`.kiro/skills/super-dev-core/SKILL.md`，并补充全局 `~/.kiro/steering/super-dev.md` 与 `~/.kiro/skills/super-dev-core/SKILL.md`；旧 `~/.kiro/steering/AGENTS.md` 仍作为兼容面保留。
+1. Kiro IDE 当前优先使用宿主已暴露的 `/super-dev` 入口；如果当前会话只接受自然语言，再回退到 `super-dev: 你的需求`。
+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` 仍作为兼容面保留。
 3. 如果 steering 或 skills 未加载，先重开项目窗口或新开一个 Agent Chat。
 
 #### 14. Qoder
@@ -993,11 +986,11 @@ super-dev
 接入后是否需要重启：否
 
 补充说明：
-1. Qoder IDE 当前优先使用项目级 commands + rules + skills 模式，直接在 Agent Chat 输入 `/super-dev 你的需求`。
+1. Qoder IDE 当前优先使用项目级 `AGENTS.md + commands + rules + skills` 模式，直接在 Agent Chat 输入 `/super-dev 你的需求`。
 2. 若新增命令未出现，先确认 `AGENTS.md`、`.qoder/commands/super-dev.md` 已生成，并检查 `.qoder/rules/super-dev.md` 是否存在，再重新打开项目或新开一个 Agent Chat。
-3. 官方接入面已切到 `AGENTS.md` + `.qoder/rules/super-dev.md` + `.qoder/commands/super-dev.md` + `.qoder/skills/` / `~/.qoder/AGENTS.md` + `~/.qoder/skills/`。
+3. 官方接入面已切到 `AGENTS.md` + `.qoder/rules/super-dev.md` + `.qoder/commands/super-dev.md` + `.qoder/skills/` / `~/.qoder/AGENTS.md` + `~/.qoder/commands/` + `~/.qoder/skills/`；`.qoder/agents/` 继续只作为增强面。
 
-#### 15. Trae
+#### 15. Trae IDE
 
 安装：
 ```bash
@@ -1016,7 +1009,7 @@ super-dev: 你的需求
 
 补充说明：
 1. Trae 当前使用 `super-dev: 你的需求` 作为主触发方式。
-2. 接入一定会写入项目级 `.trae/project_rules.md`、`.trae/rules.md` 和用户级 `~/.trae/user_rules.md`、`~/.trae/rules.md`；如果检测到兼容技能目录，也会增强安装 `~/.trae/skills/super-dev-core/SKILL.md`。
+2. 默认只写项目级 `.trae/project_rules.md`、`.trae/rules.md`；用户级 `~/.trae/user_rules.md`、`~/.trae/rules.md` 改成显式 `--with-user-surfaces` 才写入；如果检测到兼容技能目录，也会增强安装 `~/.trae/skills/super-dev/SKILL.md`。
 3. 完成接入后建议重开 Trae 或至少新开一个 Agent Chat，使规则生效；如果兼容 Skill 已安装，也会一起生效。
 4. 随后按 `output/*` 与 `.super-dev/changes/*/tasks.md` 推进开发。
 
@@ -1028,7 +1021,7 @@ super-dev
 ```
 
 触发位置：
-打开 CodeBuddy IDE 的 Agent Chat，在项目上下文内触发。
+打开 CodeBuddy 的 Agent Chat，在项目上下文内触发。
 
 触发命令：
 ```text
@@ -1062,7 +1055,7 @@ super-dev: 你的需求
 
 补充说明：
 1. 当前使用 `super-dev: 你的需求` 作为主触发方式，通过项目规则文件驱动流程。
-2. 建议先用 `super-dev doctor --host vscode-copilot` 做一次确认。
+2. 若维护者需要排障或核对接入面，再用 `super-dev doctor --host vscode-copilot` 做确认。
 3. 在同一个 Copilot Chat 会话里完成整条流水线效果最佳。
 
 #### 18. Roo Code
@@ -1084,8 +1077,8 @@ super-dev: 你的需求
 
 补充说明：
 1. 当前使用 `super-dev: 你的需求` 作为主触发方式。
-2. 接入会写入项目级规则文件与用户级配置。
-3. 建议先用 `super-dev doctor --host roo-code` 做一次确认。
+2. 默认写入项目级规则文件；若宿主提供官方用户级 Skill 目录，会同步增强安装 Skill，如需用户级协议/命令面再显式启用 `--with-user-surfaces`。
+3. 若维护者需要排障或核对接入面，再用 `super-dev doctor --host roo-code` 做确认。
 
 #### 19. Kilo Code
 
@@ -1106,7 +1099,7 @@ super-dev: 你的需求
 
 补充说明：
 1. 当前使用 `super-dev: 你的需求` 作为主触发方式。
-2. 接入会写入项目级规则文件与用户级配置。
+2. 默认写入项目级规则文件；若宿主提供官方用户级 Skill 目录，会同步增强安装 Skill，如需用户级协议/命令面再显式启用 `--with-user-surfaces`。
 3. 如果规则未加载，先重开项目窗口或新开一个 Agent Chat。
 
 #### 20. Cline
@@ -1129,76 +1122,49 @@ super-dev: 你的需求
 补充说明：
 1. 当前使用 `super-dev: 你的需求` 作为主触发方式。
 2. 接入会写入项目级 `.clinerules/` 目录下的规则文件。
-3. 建议先用 `super-dev doctor --host cline` 做一次确认。
+3. 若维护者需要排障或核对接入面，再用 `super-dev doctor --host cline` 做确认。
 4. 在同一个 Agent Chat 会话里完成整条流水线效果最佳。
 
-#### 21. OpenClaw（手动插件宿主）
+#### 21. Droid CLI
+
+Droid CLI 走 Factory 官方宿主模型，无需额外插件包。核心接入面是：
 
-OpenClaw 通过原生 Plugin SDK 集成，无需 `super-dev onboard`，直接安装 npm 插件即可。
+- 项目根 `AGENTS.md`
+- `.factory/rules/super-dev.md`
+- `.factory/skills/super-dev/SKILL.md`
+- `.factory/skills/super-dev-seeai/SKILL.md`
+- 兼容增强面：`.factory/commands/super-dev.md`、`.factory/commands/super-dev-seeai.md`
+- 用户级 `~/.factory/AGENTS.md` / `~/.factory/commands/` / `~/.factory/skills/`（默认不写；仅在显式 `--with-user-surfaces` 时补齐）
 
 安装：
 ```bash
-# 第一步：安装 super-dev CLI
-pip install super-dev
-
-# 第二步：安装 OpenClaw 插件（二选一）
-openclaw plugins install @super-dev/openclaw-plugin  # npm 插件（含 20 Tool）
-clawhub install super-dev                            # ClawHub Skill（纯指令）
+super-dev
 ```
 
-ClawHub 页面: https://clawhub.ai/shangyankeji/super-dev
-
-触发位置：
-在 OpenClaw Agent 对话面板中，确保当前工作区为目标项目后触发。
+在安装器里选择 `Droid CLI` 后，回到当前项目的 Droid 会话触发。
 
 触发命令：
 ```text
-super-dev: 你的需求
-```
-或
-```text
 /super-dev 你的需求
 ```
-比赛模式：
+回退入口：
 ```text
-super-dev-seeai: 比赛需求
+super-dev: 你的需求
 ```
-或
+比赛模式：
 ```text
 /super-dev-seeai 比赛需求
 ```
-
-插件提供 20 个专用 Tool：
-
-| Tool | 功能 |
-|------|------|
-| `super_dev_pipeline` | 启动完整流水线 |
-| `super_dev_init` | 项目初始化 |
-| `super_dev_status` | 查看流水线状态 |
-| `super_dev_quality` | 质量检查（按类型） |
-| `super_dev_spec` | Spec 管理（propose/list/show/scaffold/validate） |
-| `super_dev_spec_trace` | Spec-Code 追踪 |
-| `super_dev_spec_consistency` | Spec-Code 一致性检测 |
-| `super_dev_spec_acceptance` | Spec 验收检查 |
-| `super_dev_config` | 配置管理（list/get/set） |
-| `super_dev_review` | 审查与门禁确认（docs/ui/architecture/quality） |
-| `super_dev_release` | 发布就绪度 / 交付证明包 |
-| `super_dev_expert` | 专家咨询 (11 角色) |
-| `super_dev_deploy` | CI/CD 配置 / Dockerfile / 发布演练 |
-| `super_dev_analyze` | 项目分析（技术栈/依赖/结构） |
-| `super_dev_doctor` | 环境诊断 |
-| `super_dev_governance` | 治理规则总览 |
-| `super_dev_knowledge_stats` | 知识库使用统计 |
-| `super_dev_knowledge_evolve` | 知识权重自演化 |
-| `super_dev_metrics` | Pipeline 效能度量 |
-| `super_dev_run` | 通用命令透传（可选） |
+需要 headless 续跑时：
+```bash
+droid exec --session-id <id> "continue with next steps"
+```
 
 补充说明：
-1. 插件通过 CLI subprocess 桥接调用 `super-dev`，因此必须先 `pip install super-dev`。
-2. 安装后建议重启 OpenClaw Gateway 或新开会话，让 Plugin 和 Skill 生效。
-3. 插件内嵌 SKILL.md，OpenClaw Agent 会自动理解流水线协议。
-4. 比赛场景优先使用 `super-dev-seeai:` 或 `/super-dev-seeai`，按半小时节奏快速产出可演示作品。
-5. 使用 `super-dev doctor --host openclaw` 检查集成状态。
+1. Droid CLI 需要在目标项目目录里启动，让当前 session 先读取项目根 `AGENTS.md`。
+2. `.factory/rules/` 与 `.factory/skills/` 是主协议面；`.factory/commands/` 继续作为兼容增强面承担 slash 触发补充，不再需要额外插件。
+3. 比赛场景优先使用 `/super-dev-seeai`；如果 slash 面板刷新慢，再回退到 `super-dev-seeai:`。
+4. 恢复已有流程时优先保持同一 Droid session，不要重新开题。
 
 ---