super-dev 2.0.5__tar.gz → 2.0.7__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. {super_dev-2.0.5/super_dev.egg-info → super_dev-2.0.7}/PKG-INFO +137 -35
  2. {super_dev-2.0.5 → super_dev-2.0.7}/README.md +136 -34
  3. {super_dev-2.0.5 → super_dev-2.0.7}/pyproject.toml +1 -1
  4. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/__init__.py +1 -1
  5. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/catalogs.py +86 -8
  6. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/cli.py +304 -28
  7. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/config/manager.py +2 -2
  8. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/creators/document_generator.py +4 -4
  9. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/deployers/delivery.py +1 -1
  10. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/integrations/manager.py +351 -63
  11. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/release_readiness.py +13 -3
  12. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/skills/manager.py +48 -17
  13. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/web/api.py +26 -11
  14. {super_dev-2.0.5 → super_dev-2.0.7/super_dev.egg-info}/PKG-INFO +137 -35
  15. {super_dev-2.0.5 → super_dev-2.0.7}/LICENSE +0 -0
  16. {super_dev-2.0.5 → super_dev-2.0.7}/setup.cfg +0 -0
  17. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/analyzer/__init__.py +0 -0
  18. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/analyzer/analyzer.py +0 -0
  19. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/analyzer/detectors.py +0 -0
  20. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/analyzer/models.py +0 -0
  21. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/config/__init__.py +0 -0
  22. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/config/frontend.py +0 -0
  23. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/creators/__init__.py +0 -0
  24. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/creators/creator.py +0 -0
  25. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/creators/frontend_builder.py +0 -0
  26. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/creators/implementation_builder.py +0 -0
  27. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/creators/prompt_generator.py +0 -0
  28. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/creators/requirement_parser.py +0 -0
  29. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/creators/spec_builder.py +0 -0
  30. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/creators/task_executor.py +0 -0
  31. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/deployers/__init__.py +0 -0
  32. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/deployers/cicd.py +0 -0
  33. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/deployers/migration.py +0 -0
  34. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/deployers/rehearsal.py +0 -0
  35. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/deployers/rehearsal_runner.py +0 -0
  36. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/__init__.py +0 -0
  37. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/aesthetics.py +0 -0
  38. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/charts.py +0 -0
  39. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/codegen.py +0 -0
  40. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/engine.py +0 -0
  41. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/generator.py +0 -0
  42. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/landing.py +0 -0
  43. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/tech_stack.py +0 -0
  44. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/tokens.py +0 -0
  45. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/ui_intelligence.py +0 -0
  46. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/design/ux_guide.py +0 -0
  47. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/exceptions.py +0 -0
  48. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/experts/__init__.py +0 -0
  49. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/experts/service.py +0 -0
  50. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/integrations/__init__.py +0 -0
  51. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/orchestrator/__init__.py +0 -0
  52. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/orchestrator/contracts.py +0 -0
  53. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/orchestrator/engine.py +0 -0
  54. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/orchestrator/experts.py +0 -0
  55. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/orchestrator/knowledge.py +0 -0
  56. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/orchestrator/quality.py +0 -0
  57. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/orchestrator/telemetry.py +0 -0
  58. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/policy/__init__.py +0 -0
  59. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/policy/manager.py +0 -0
  60. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/review_state.py +0 -0
  61. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/reviewers/__init__.py +0 -0
  62. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/reviewers/code_review.py +0 -0
  63. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/reviewers/quality_gate.py +0 -0
  64. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/reviewers/redteam.py +0 -0
  65. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/reviewers/ui_review.py +0 -0
  66. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/skills/__init__.py +0 -0
  67. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/specs/__init__.py +0 -0
  68. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/specs/generator.py +0 -0
  69. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/specs/manager.py +0 -0
  70. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/specs/models.py +0 -0
  71. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/specs/validator.py +0 -0
  72. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/utils/__init__.py +0 -0
  73. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev/utils/logger.py +0 -0
  74. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev.egg-info/SOURCES.txt +0 -0
  75. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev.egg-info/dependency_links.txt +0 -0
  76. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev.egg-info/entry_points.txt +0 -0
  77. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev.egg-info/requires.txt +0 -0
  78. {super_dev-2.0.5 → super_dev-2.0.7}/super_dev.egg-info/top_level.txt +0 -0
{super_dev-2.0.5/super_dev.egg-info → super_dev-2.0.7}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: super-dev
3
- Version: 2.0.5
3
+ Version: 2.0.7
4
4
  Summary: Super Dev - Pipeline AI Coding Assistant
5
5
  Author-email: Excellent <11964948@qq.com>
6
6
  License-Expression: MIT
@@ -60,18 +60,21 @@ Dynamic: license-file
60
60
 
61
61
  ## 版本
62
62
 
63
- 当前版本：`2.0.5`
63
+ 当前版本：`2.0.7`
64
64
 
65
65
  ---
66
66
 
67
67
  ## 项目介绍
68
68
 
69
- `Super Dev` 是一个面向商业级交付的 AI 开发编排工具，核心目标是辅助用户将项目落地成可执行工程资产：
69
+ `Super Dev` 是一个面向商业级交付的 AI 开发编排工具，用于把宿主里的模型能力组织成一套稳定、清晰、可审计的工程流水线。
70
70
 
71
- - 它不提供自己的大模型能力，也不替代宿主的编码能力
72
- - 宿主负责调用模型、工具与实际编码
71
+ 产品定位：
72
+
73
+ - 宿主负责模型调用、联网搜索、代码产出、终端执行与文件修改
73
74
  - `Super Dev` 负责流程治理、设计约束、质量门禁、审计产物与交付标准
74
75
 
76
+ 它解决的是交付过程问题：
77
+
75
78
  - 将需求沉淀为可落地工件：PRD、架构、UI/UX、Spec、任务清单与交付清单
76
79
  - 将开发过程组织为标准化流水线：可追踪、可恢复、可审计、可复盘
77
80
  - 将质量控制前置到每个阶段：策略治理、红队审查、质量门禁、发布演练
@@ -124,8 +127,8 @@ Dynamic: license-file
124
127
 
125
128
  - 内置 UI/UX 知识库：产品类型、行业语气、信任模块、页面骨架、反模式、信息密度
126
129
  - 内置主流组件生态推荐：React/Next、Vue、Angular、Svelte 等按宿主和场景输出首选与备选方案
127
- - UI/UX 文档会自动给出组件生态、表单/表格/图表/动效/图标基线，而不是只写风格描述
128
- - 宿主提示词与 Skill 会继承这些规则，优先生成现代商业产品界面而不是 AI 模板页面
130
+ - UI/UX 文档会自动给出组件生态、表单/表格/图表/动效/图标基线，直接约束实现阶段
131
+ - 宿主提示词与 Skill 会继承这些规则，输出更接近现代商业产品的界面结果
129
132
  - 新增 `super-dev quality --type ui-review`，可对 `preview.html` / `output/frontend/index.html` 做结构级视觉审查
130
133
 
131
134
  ---
@@ -150,16 +153,38 @@ uv tool upgrade super-dev
150
153
  pip install -U super-dev
151
154
  ```
152
155
 
156
+ 安装完成后，直接运行：
157
+
158
+ ```bash
159
+ super-dev
160
+ ```
161
+
162
+ 默认会进入宿主安装引导：
163
+
164
+ - 顶部显示 `Super Dev` 安装入口
165
+ - `↑ / ↓` 选择宿主
166
+ - `Space` 勾选宿主
167
+ - `Enter` 开始安装
168
+ - `A` 全选
169
+ - `C` 仅选择 CLI 宿主
170
+ - `I` 仅选择 IDE 宿主
171
+ - `R` 清空选择
172
+
173
+ 安装完成后，终端会直接给出该宿主的最终触发方式：
174
+
175
+ - slash 宿主：`/super-dev 你的需求`
176
+ - 非 slash 宿主：`super-dev: 你的需求`
177
+
153
178
  ### 3. 指定版本安装
154
179
 
155
180
  ```bash
156
- pip install super-dev==2.0.5
181
+ pip install super-dev==2.0.7
157
182
  ```
158
183
 
159
184
  ### 4. GitHub 指定标签安装
160
185
 
161
186
  ```bash
162
- pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.5
187
+ pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.7
163
188
  ```
164
189
 
165
190
  ### 5. 源码开发安装
@@ -183,6 +208,80 @@ pip install -e ".[dev]"
183
208
 
184
209
  ---
185
210
 
211
+ ## 依赖安装说明
212
+
213
+ 当用户执行：
214
+
215
+ ```bash
216
+ pip install -U super-dev
217
+ ```
218
+
219
+ 或：
220
+
221
+ ```bash
222
+ uv tool install super-dev
223
+ ```
224
+
225
+ 安装器会自动安装 `pyproject.toml` 中声明的 Python 依赖，例如：
226
+
227
+ - `rich`
228
+ - `pyyaml`
229
+ - `ddgs`
230
+ - `requests`
231
+ - `beautifulsoup4`
232
+ - `fastapi`
233
+ - `uvicorn`
234
+
235
+ 不会自动安装的内容：
236
+
237
+ - Claude Code / Codex CLI / Gemini CLI / Cursor / Trae / Windsurf 等宿主软件本身
238
+ - Node.js、npm、pnpm、Docker、数据库服务这类系统级运行环境
239
+ - 宿主账号登录状态、联网权限、浏览器能力
240
+ - 项目业务依赖以外的前后端运行时
241
+
242
+ 一句话：
243
+
244
+ - `pip` / `uv` 会自动安装 **Super Dev 自己的 Python 依赖**
245
+ - 不会替用户安装 **宿主工具和系统环境**
246
+
247
+ ---
248
+
249
+ ## 整个系统如何工作
250
+
251
+ `Super Dev` 的运行方式可以概括为一条固定链路：
252
+
253
+ 1. 用户在项目目录执行 `super-dev`
254
+ 2. 安装引导把 Super Dev 接入到目标宿主
255
+ 3. 用户在宿主里输入 `/super-dev 需求` 或 `super-dev: 需求`
256
+ 4. 宿主进入 Super Dev 流水线
257
+ 5. 宿主负责联网、推理、编码、运行与修改文件
258
+ 6. Super Dev 负责流程、文档、门禁、审计和交付标准
259
+
260
+ 执行原则：
261
+
262
+ - 宿主负责“写代码”
263
+ - `Super Dev` 负责“把开发过程做对、做全、可审计”
264
+
265
+ ### 一、系统高阶流转架构
266
+
267
+ 展示用户、宿主端工具、Super Dev 编排引擎与最终产物之间的流转关系。
268
+
269
+ ![系统高阶流转架构](docs/assets/architecture/system-overview.png)
270
+
271
+ ### 二、12 阶段核心工作流
272
+
273
+ 详细描绘每次对话触发后，引擎在底层的流转经过。
274
+
275
+ ![12 阶段核心工作流](docs/assets/architecture/pipeline-12-phase.png)
276
+
277
+ ### 三、核心模块调用拓扑
278
+
279
+ 展示 `super_dev` 下核心源码目录的职责边界和调用关系。
280
+
281
+ ![核心模块调用拓扑](docs/assets/architecture/module-topology.png)
282
+
283
+ ---
284
+
186
285
  ## 最简单使用（给最终用户）
187
286
 
188
287
  ### CLI 宿主（Claude Code / CodeBuddy CLI / Codex CLI / Cursor CLI / Gemini CLI / iFlow CLI / Kimi CLI / Kiro CLI / OpenCode CLI / Qoder CLI）
@@ -197,7 +296,7 @@ pip install -e ".[dev]"
197
296
  - `Super Dev` 是当前项目里的本地 Python CLI 工具，加上宿主里的规则文件 / Skill / slash 映射。
198
297
  - 宿主负责模型推理、联网搜索、编码、运行终端与修改文件。
199
298
  - `Super Dev` 负责把宿主拉进固定流水线：research、三文档、确认门、Spec、前端优先、后端联调、质量门禁、交付审计。
200
- - 当用户输入 `/super-dev 需求` 或 `super-dev: 需求` 时，宿主要把它视为“进入 Super Dev 流水线”，而不是普通聊天。
299
+ - 当用户输入 `/super-dev 需求` 或 `super-dev: 需求` 时，宿主要切换到 Super Dev 流水线执行模式。
201
300
  - 需要生成或刷新文档、Spec、质量报告、交付产物时，宿主应优先调用本地 `super-dev` CLI。
202
301
  - 如果项目根目录存在 `knowledge/`，宿主必须优先读取与当前需求相关的知识文件。
203
302
  - 如果已生成 `output/knowledge-cache/*-knowledge-bundle.json`，宿主必须把其中命中的本地知识、研究摘要和场景约束继承到三文档、Spec 和实现阶段。
@@ -207,7 +306,7 @@ pip install -e ".[dev]"
207
306
  1. 进入项目目录执行 `super-dev` 完成接入。
208
307
  2. 打开 IDE 的 Agent Chat 后，按宿主真实入口触发。
209
308
  3. 支持 slash 的 IDE 使用 `/super-dev 你的需求`；不支持 slash 的 IDE 使用 `super-dev: 你的需求`。
210
- 4. 非 slash 宿主仍会通过项目规则、AGENTS 或 Skill 进入同样的 research-first 流程，而不是绕开流水线。
309
+ 4. 非 slash 宿主会通过项目规则、AGENTS 或 Skill 进入同样的 research-first 流程。
211
310
 
212
311
  ### 每个宿主如何使用
213
312
 
@@ -231,6 +330,7 @@ super-dev onboard --host claude-code --force --yes
231
330
  补充说明：
232
331
  1. 推荐作为首选 CLI 宿主。
233
332
  2. 接入后可先执行 `super-dev doctor --host claude-code` 确认 slash 已生效。
333
+ 3. Claude Code 官方已公开 `.claude/agents/` 与 `~/.claude/agents/`，Super Dev 会同步生成 `super-dev-core` subagent。
234
334
 
235
335
  #### 2. CodeBuddy CLI
236
336
 
@@ -376,7 +476,7 @@ super-dev: 你的需求
376
476
  接入后是否需要重启：否
377
477
 
378
478
  补充说明：
379
- 1. 不要输入 `/super-dev`，Kimi CLI 当前优先按 `.kimi/AGENTS.md + 文本触发` 工作。
479
+ 1. Kimi CLI 当前使用 `super-dev: 你的需求`，由 `.kimi/AGENTS.md` 驱动流程。
380
480
  2. 建议先用 `super-dev doctor --host kimi-cli` 做一次确认。
381
481
  3. 尽量保持同一会话完成完整开发流程。
382
482
 
@@ -419,8 +519,9 @@ super-dev: 你的需求
419
519
  接入后是否需要重启：否
420
520
 
421
521
  补充说明：
422
- 1. Kiro IDE 当前优先按 steering/rules 模式触发，不走 `/super-dev`。
423
- 2. 如果 steering/rules 未加载，先重开项目窗口。
522
+ 1. Kiro IDE 当前使用 steering/rules 模式，触发词为 `super-dev: 你的需求`。
523
+ 2. 接入会写入项目级 `.kiro/steering/super-dev.md`，并补充官方全局 steering `~/.kiro/steering/AGENTS.md`。
524
+ 3. 如果 steering/rules 未加载，先重开项目窗口。
424
525
 
425
526
  #### 11. OpenCode
426
527
 
@@ -476,14 +577,14 @@ super-dev onboard --host qoder --force --yes
476
577
 
477
578
  触发命令：
478
579
  ```text
479
- super-dev: 你的需求
580
+ /super-dev 你的需求
480
581
  ```
481
582
 
482
583
  接入后是否需要重启：否
483
584
 
484
585
  补充说明：
485
- 1. Qoder IDE 当前优先按 project rules 模式触发，不走 `/super-dev`。
486
- 2. 若规则未生效，重新打开项目或重新创建聊天。
586
+ 1. Qoder IDE 当前优先使用项目级 commands + rules 模式，直接在 Agent Chat 输入 `/super-dev 你的需求`。
587
+ 2. 若新增命令未出现，先确认 `.qoder/commands/super-dev.md` 已生成，再重新打开项目或新开一个 Agent Chat。
487
588
 
488
589
  #### 14. Windsurf
489
590
 
@@ -524,8 +625,8 @@ super-dev: 你的需求
524
625
  接入后是否需要重启：是
525
626
 
526
627
  补充说明：
527
- 1. 不要输入 `/super-dev`，Codex 当前不走自定义 slash。
528
- 2. 实际依赖 `.codex/AGENTS.md` 和 `.codex/skills/super-dev-core/SKILL.md`。
628
+ 1. Codex CLI 当前使用 `super-dev: 你的需求` 作为主触发方式。
629
+ 2. 实际依赖 `.codex/AGENTS.md` 与官方用户级 Skill `~/.codex/skills/super-dev-core/SKILL.md`。
529
630
  3. 如果旧会话没加载新 Skill，重启 `codex` 再试。
530
631
 
531
632
  #### 16. Trae
@@ -546,9 +647,10 @@ super-dev: 你的需求
546
647
  接入后是否需要重启：否
547
648
 
548
649
  补充说明：
549
- 1. 不要输入 `/super-dev`。
550
- 2. Trae 当前默认按项目 rules 模式工作，无需手动开启 Skill。
551
- 3. 随后按 `output/*` 与 `.super-dev/changes/*/tasks.md` 推进开发。
650
+ 1. Trae 当前使用 `super-dev: 你的需求` 作为主触发方式。
651
+ 2. 接入一定会写入项目级 `.trae/rules.md`；如果检测到兼容技能目录，也会增强安装 `~/.trae/skills/super-dev-core/SKILL.md`。
652
+ 3. 完成接入后建议重开 Trae 或至少新开一个 Agent Chat，使规则生效；如果兼容 Skill 已安装，也会一起生效。
653
+ 4. 随后按 `output/*` 与 `.super-dev/changes/*/tasks.md` 推进开发。
552
654
 
553
655
  ## 快速开始（详细使用说明）
554
656
 
@@ -567,22 +669,22 @@ super-dev: 你的需求
567
669
 
568
670
  | 宿主 | 类型 | 认证等级 | 是否支持 `/super-dev` | 正确触发方式 | 接入后是否需要重启 |
569
671
  | --- | --- | --- | --- | --- | --- |
570
- | Claude Code | CLI | Certified | 支持 | 在 Claude Code 会话中输入 `/super-dev 你的需求` | 否 |
571
- | CodeBuddy CLI | CLI | Compatible | 支持 | 在 CodeBuddy CLI 会话中输入 `/super-dev 你的需求` | 否 |
572
- | CodeBuddy IDE | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求` | 否 |
672
+ | Claude Code | CLI | Certified | 支持 | 在 Claude Code 会话中输入 `/super-dev 你的需求`（由 `.claude/commands/` + `.claude/agents/` / `~/.claude/agents/` 生效） | 否 |
673
+ | CodeBuddy CLI | CLI | Compatible | 支持 | 在 CodeBuddy CLI 会话中输入 `/super-dev 你的需求`（由 `.codebuddy/commands/` + `.codebuddy/skills/` / `~/.codebuddy/skills/` 生效） | 否 |
674
+ | CodeBuddy IDE | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求`（由 `.codebuddy/commands/` + `.codebuddy/skills/` / `~/.codebuddy/skills/` 生效） | 否 |
573
675
  | Cursor CLI | CLI | Compatible | 支持 | 在 Cursor CLI 会话中输入 `/super-dev 你的需求` | 否 |
574
676
  | Cursor IDE | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求` | 否 |
575
677
  | Gemini CLI | CLI | Compatible | 支持 | 在 Gemini CLI 会话中输入 `/super-dev 你的需求` | 否 |
576
678
  | iFlow CLI | CLI | Experimental | 支持 | 在 iFlow CLI 会话中输入 `/super-dev 你的需求` | 否 |
577
679
  | Kimi CLI | CLI | Experimental | 不支持 | 在 Kimi CLI 会话中输入 `super-dev: 你的需求`（由 `.kimi/AGENTS.md` 生效） | 否 |
578
680
  | Kiro CLI | CLI | Compatible | 支持 | 在 Kiro CLI 会话中输入 `/super-dev 你的需求` | 否 |
579
- | Kiro IDE | IDE | Experimental | 不支持 | 在 Kiro IDE Agent Chat 中输入 `super-dev: 你的需求`（由 `.kiro/steering/super-dev.md` 生效） | 否 |
580
- | OpenCode CLI | CLI | Experimental | 支持 | 在 OpenCode CLI 会话中输入 `/super-dev 你的需求` | 否 |
581
- | Qoder CLI | CLI | Compatible | 支持 | 在 Qoder CLI 会话中输入 `/super-dev 你的需求` | 否 |
582
- | Qoder IDE | IDE | Experimental | 不支持 | 在 Qoder IDE Agent Chat 中输入 `super-dev: 你的需求`（由 `.qoder/rules.md` 生效） | 否 |
583
- | Windsurf | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求` | 否 |
584
- | Codex CLI | CLI | Certified | 不支持 | 重启 Codex 后输入 `super-dev: 你的需求`，由 `.codex/AGENTS.md` + `super-dev-core` Skill 生效 | 是 |
585
- | Trae | IDE | Certified | 不支持 | 在 Trae Agent Chat 中输入 `super-dev: 你的需求`（由 `.trae/rules.md` 生效） | 否 |
681
+ | Kiro IDE | IDE | Experimental | 不支持 | 在 Kiro IDE Agent Chat 中输入 `super-dev: 你的需求`（由 `.kiro/steering/super-dev.md` + `~/.kiro/steering/AGENTS.md` 生效） | 否 |
682
+ | OpenCode CLI | CLI | Experimental | 支持 | 在 OpenCode CLI 会话中输入 `/super-dev 你的需求`（由 `.opencode/commands/` + `.opencode/skills/` / `~/.config/opencode/skills/` 生效） | 否 |
683
+ | Qoder CLI | CLI | Compatible | 支持 | 在 Qoder CLI 会话中输入 `/super-dev 你的需求`（由 `.qoder/commands/` + `.qoder/skills/` / `~/.qoder/skills/` 生效） | 否 |
684
+ | Qoder IDE | IDE | Experimental | 支持 | 在 Qoder IDE Agent Chat 中输入 `/super-dev 你的需求`（由 `.qoder/commands/super-dev.md` + `.qoder/rules.md` + `.qoder/skills/` / `~/.qoderwork/skills/` 生效） | 否 |
685
+ | Windsurf | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求`（由 `.windsurf/workflows/` + `.windsurf/skills/` / `~/.codeium/windsurf/skills/` 生效） | 否 |
686
+ | Codex CLI | CLI | Certified | 不支持 | 重启 Codex 后输入 `super-dev: 你的需求`，由 `.codex/AGENTS.md` + 兼容 Skill 生效 | 是 |
687
+ | Trae | IDE | Compatible | 不支持 | 在 Trae Agent Chat 中输入 `super-dev: 你的需求`（由 `.trae/rules.md` 生效；若检测到兼容 Skill `~/.trae/skills/super-dev-core/SKILL.md` 会额外增强） | 是 |
586
688
 
587
689
  ### 1. 安装后直接进入引导
588
690
 
@@ -716,7 +818,7 @@ super-dev review docs --status confirmed --comment "三文档已确认，进入
716
818
  `/super-dev` 会强制执行：先 research -> 再三文档（PRD/架构/UIUX）-> 等待用户确认 -> 再 Spec 与 tasks -> 再编码实现。
717
819
  编码阶段默认遵循商业级 UI/UX 规范，禁止紫/粉渐变主视觉、emoji 功能图标、模板化页面直出，并要求先定义字体系统、token、栅格和组件状态矩阵。
718
820
 
719
- Codex CLI 当前不使用 `/super-dev`，而是依赖 `.codex/AGENTS.md` + `super-dev-core` Skill。在 Codex 会话中输入 `super-dev: 你的需求` 即可。
821
+ Codex CLI 当前通过 `.codex/AGENTS.md` + `super-dev-core` Skill 工作，在 Codex 会话中输入 `super-dev: 你的需求` 即可。
720
822
 
721
823
  若宿主不支持 slash 命令映射，可在同一项目根目录执行终端入口（仅触发 Super Dev 本地流水线编排）：
722
824
 
@@ -808,7 +910,6 @@ super-dev quality --type all
808
910
  - `codebuddy`
809
911
  - `cursor`
810
912
  - `kiro`
811
- - `qoder`
812
913
  - `trae`（Rules-first）
813
914
  - `windsurf`
814
915
 
@@ -817,7 +918,7 @@ super-dev quality --type all
817
918
  - `CLI 宿主（原生 slash）`：在宿主会话内触发 `/super-dev`，由宿主模型执行编码
818
919
  - `CLI 宿主（非 slash）`：在宿主会话内输入 `super-dev: 你的需求`，由 AGENTS / 规则文件驱动执行
819
920
  - `IDE 宿主（原生 slash）`：在 Agent Chat 触发 `/super-dev`，由规则文件与 Skill 约束执行流程
820
- - `IDE 宿主（非 slash）`：在 Agent Chat 输入 `super-dev: 你的需求`，由项目规则驱动执行
921
+ - `IDE 宿主（非 slash）`：在 Agent Chat 输入 `super-dev: 你的需求`，由项目规则或宿主 Skill 驱动执行
821
922
  - `终端入口`：`super-dev "需求"` 仅触发本地流水线编排，不直接调用宿主模型会话
822
923
 
823
924
  查看宿主适配矩阵（官方文档链接、适配模式、注入路径、探测策略）：
@@ -899,6 +1000,7 @@ UV_PUBLISH_TOKEN="<your-token>" uv publish
899
1000
 
900
1001
  ## 相关文档
901
1002
 
1003
+ - [宿主接入面说明](docs/HOST_INSTALL_SURFACES.md)
902
1004
  - [详细工作流指南](docs/WORKFLOW_GUIDE.md)
903
1005
  - [快速开始](docs/QUICKSTART.md)
904
1006
  - [发布指南](docs/PUBLISHING.md)
{super_dev-2.0.5 → super_dev-2.0.7}/README.md RENAMED
@@ -19,18 +19,21 @@
19
19
 
20
20
  ## 版本
21
21
 
22
- 当前版本：`2.0.5`
22
+ 当前版本：`2.0.7`
23
23
 
24
24
  ---
25
25
 
26
26
  ## 项目介绍
27
27
 
28
- `Super Dev` 是一个面向商业级交付的 AI 开发编排工具，核心目标是辅助用户将项目落地成可执行工程资产：
28
+ `Super Dev` 是一个面向商业级交付的 AI 开发编排工具，用于把宿主里的模型能力组织成一套稳定、清晰、可审计的工程流水线。
29
29
 
30
- - 它不提供自己的大模型能力，也不替代宿主的编码能力
31
- - 宿主负责调用模型、工具与实际编码
30
+ 产品定位：
31
+
32
+ - 宿主负责模型调用、联网搜索、代码产出、终端执行与文件修改
32
33
  - `Super Dev` 负责流程治理、设计约束、质量门禁、审计产物与交付标准
33
34
 
35
+ 它解决的是交付过程问题：
36
+
34
37
  - 将需求沉淀为可落地工件：PRD、架构、UI/UX、Spec、任务清单与交付清单
35
38
  - 将开发过程组织为标准化流水线：可追踪、可恢复、可审计、可复盘
36
39
  - 将质量控制前置到每个阶段：策略治理、红队审查、质量门禁、发布演练
@@ -83,8 +86,8 @@
83
86
 
84
87
  - 内置 UI/UX 知识库：产品类型、行业语气、信任模块、页面骨架、反模式、信息密度
85
88
  - 内置主流组件生态推荐：React/Next、Vue、Angular、Svelte 等按宿主和场景输出首选与备选方案
86
- - UI/UX 文档会自动给出组件生态、表单/表格/图表/动效/图标基线，而不是只写风格描述
87
- - 宿主提示词与 Skill 会继承这些规则，优先生成现代商业产品界面而不是 AI 模板页面
89
+ - UI/UX 文档会自动给出组件生态、表单/表格/图表/动效/图标基线，直接约束实现阶段
90
+ - 宿主提示词与 Skill 会继承这些规则，输出更接近现代商业产品的界面结果
88
91
  - 新增 `super-dev quality --type ui-review`，可对 `preview.html` / `output/frontend/index.html` 做结构级视觉审查
89
92
 
90
93
  ---
@@ -109,16 +112,38 @@ uv tool upgrade super-dev
109
112
  pip install -U super-dev
110
113
  ```
111
114
 
115
+ 安装完成后，直接运行：
116
+
117
+ ```bash
118
+ super-dev
119
+ ```
120
+
121
+ 默认会进入宿主安装引导：
122
+
123
+ - 顶部显示 `Super Dev` 安装入口
124
+ - `↑ / ↓` 选择宿主
125
+ - `Space` 勾选宿主
126
+ - `Enter` 开始安装
127
+ - `A` 全选
128
+ - `C` 仅选择 CLI 宿主
129
+ - `I` 仅选择 IDE 宿主
130
+ - `R` 清空选择
131
+
132
+ 安装完成后，终端会直接给出该宿主的最终触发方式：
133
+
134
+ - slash 宿主：`/super-dev 你的需求`
135
+ - 非 slash 宿主：`super-dev: 你的需求`
136
+
112
137
  ### 3. 指定版本安装
113
138
 
114
139
  ```bash
115
- pip install super-dev==2.0.5
140
+ pip install super-dev==2.0.7
116
141
  ```
117
142
 
118
143
  ### 4. GitHub 指定标签安装
119
144
 
120
145
  ```bash
121
- pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.5
146
+ pip install git+https://github.com/shangyankeji/super-dev.git@v2.0.7
122
147
  ```
123
148
 
124
149
  ### 5. 源码开发安装
@@ -142,6 +167,80 @@ pip install -e ".[dev]"
142
167
 
143
168
  ---
144
169
 
170
+ ## 依赖安装说明
171
+
172
+ 当用户执行：
173
+
174
+ ```bash
175
+ pip install -U super-dev
176
+ ```
177
+
178
+ 或：
179
+
180
+ ```bash
181
+ uv tool install super-dev
182
+ ```
183
+
184
+ 安装器会自动安装 `pyproject.toml` 中声明的 Python 依赖，例如：
185
+
186
+ - `rich`
187
+ - `pyyaml`
188
+ - `ddgs`
189
+ - `requests`
190
+ - `beautifulsoup4`
191
+ - `fastapi`
192
+ - `uvicorn`
193
+
194
+ 不会自动安装的内容：
195
+
196
+ - Claude Code / Codex CLI / Gemini CLI / Cursor / Trae / Windsurf 等宿主软件本身
197
+ - Node.js、npm、pnpm、Docker、数据库服务这类系统级运行环境
198
+ - 宿主账号登录状态、联网权限、浏览器能力
199
+ - 项目业务依赖以外的前后端运行时
200
+
201
+ 一句话：
202
+
203
+ - `pip` / `uv` 会自动安装 **Super Dev 自己的 Python 依赖**
204
+ - 不会替用户安装 **宿主工具和系统环境**
205
+
206
+ ---
207
+
208
+ ## 整个系统如何工作
209
+
210
+ `Super Dev` 的运行方式可以概括为一条固定链路：
211
+
212
+ 1. 用户在项目目录执行 `super-dev`
213
+ 2. 安装引导把 Super Dev 接入到目标宿主
214
+ 3. 用户在宿主里输入 `/super-dev 需求` 或 `super-dev: 需求`
215
+ 4. 宿主进入 Super Dev 流水线
216
+ 5. 宿主负责联网、推理、编码、运行与修改文件
217
+ 6. Super Dev 负责流程、文档、门禁、审计和交付标准
218
+
219
+ 执行原则：
220
+
221
+ - 宿主负责“写代码”
222
+ - `Super Dev` 负责“把开发过程做对、做全、可审计”
223
+
224
+ ### 一、系统高阶流转架构
225
+
226
+ 展示用户、宿主端工具、Super Dev 编排引擎与最终产物之间的流转关系。
227
+
228
+ ![系统高阶流转架构](docs/assets/architecture/system-overview.png)
229
+
230
+ ### 二、12 阶段核心工作流
231
+
232
+ 详细描绘每次对话触发后，引擎在底层的流转经过。
233
+
234
+ ![12 阶段核心工作流](docs/assets/architecture/pipeline-12-phase.png)
235
+
236
+ ### 三、核心模块调用拓扑
237
+
238
+ 展示 `super_dev` 下核心源码目录的职责边界和调用关系。
239
+
240
+ ![核心模块调用拓扑](docs/assets/architecture/module-topology.png)
241
+
242
+ ---
243
+
145
244
  ## 最简单使用（给最终用户）
146
245
 
147
246
  ### CLI 宿主（Claude Code / CodeBuddy CLI / Codex CLI / Cursor CLI / Gemini CLI / iFlow CLI / Kimi CLI / Kiro CLI / OpenCode CLI / Qoder CLI）
@@ -156,7 +255,7 @@ pip install -e ".[dev]"
156
255
  - `Super Dev` 是当前项目里的本地 Python CLI 工具，加上宿主里的规则文件 / Skill / slash 映射。
157
256
  - 宿主负责模型推理、联网搜索、编码、运行终端与修改文件。
158
257
  - `Super Dev` 负责把宿主拉进固定流水线：research、三文档、确认门、Spec、前端优先、后端联调、质量门禁、交付审计。
159
- - 当用户输入 `/super-dev 需求` 或 `super-dev: 需求` 时，宿主要把它视为“进入 Super Dev 流水线”，而不是普通聊天。
258
+ - 当用户输入 `/super-dev 需求` 或 `super-dev: 需求` 时，宿主要切换到 Super Dev 流水线执行模式。
160
259
  - 需要生成或刷新文档、Spec、质量报告、交付产物时，宿主应优先调用本地 `super-dev` CLI。
161
260
  - 如果项目根目录存在 `knowledge/`，宿主必须优先读取与当前需求相关的知识文件。
162
261
  - 如果已生成 `output/knowledge-cache/*-knowledge-bundle.json`，宿主必须把其中命中的本地知识、研究摘要和场景约束继承到三文档、Spec 和实现阶段。
@@ -166,7 +265,7 @@ pip install -e ".[dev]"
166
265
  1. 进入项目目录执行 `super-dev` 完成接入。
167
266
  2. 打开 IDE 的 Agent Chat 后，按宿主真实入口触发。
168
267
  3. 支持 slash 的 IDE 使用 `/super-dev 你的需求`；不支持 slash 的 IDE 使用 `super-dev: 你的需求`。
169
- 4. 非 slash 宿主仍会通过项目规则、AGENTS 或 Skill 进入同样的 research-first 流程，而不是绕开流水线。
268
+ 4. 非 slash 宿主会通过项目规则、AGENTS 或 Skill 进入同样的 research-first 流程。
170
269
 
171
270
  ### 每个宿主如何使用
172
271
 
@@ -190,6 +289,7 @@ super-dev onboard --host claude-code --force --yes
190
289
  补充说明：
191
290
  1. 推荐作为首选 CLI 宿主。
192
291
  2. 接入后可先执行 `super-dev doctor --host claude-code` 确认 slash 已生效。
292
+ 3. Claude Code 官方已公开 `.claude/agents/` 与 `~/.claude/agents/`，Super Dev 会同步生成 `super-dev-core` subagent。
193
293
 
194
294
  #### 2. CodeBuddy CLI
195
295
 
@@ -335,7 +435,7 @@ super-dev: 你的需求
335
435
  接入后是否需要重启：否
336
436
 
337
437
  补充说明：
338
- 1. 不要输入 `/super-dev`，Kimi CLI 当前优先按 `.kimi/AGENTS.md + 文本触发` 工作。
438
+ 1. Kimi CLI 当前使用 `super-dev: 你的需求`，由 `.kimi/AGENTS.md` 驱动流程。
339
439
  2. 建议先用 `super-dev doctor --host kimi-cli` 做一次确认。
340
440
  3. 尽量保持同一会话完成完整开发流程。
341
441
 
@@ -378,8 +478,9 @@ super-dev: 你的需求
378
478
  接入后是否需要重启：否
379
479
 
380
480
  补充说明：
381
- 1. Kiro IDE 当前优先按 steering/rules 模式触发，不走 `/super-dev`。
382
- 2. 如果 steering/rules 未加载，先重开项目窗口。
481
+ 1. Kiro IDE 当前使用 steering/rules 模式，触发词为 `super-dev: 你的需求`。
482
+ 2. 接入会写入项目级 `.kiro/steering/super-dev.md`，并补充官方全局 steering `~/.kiro/steering/AGENTS.md`。
483
+ 3. 如果 steering/rules 未加载，先重开项目窗口。
383
484
 
384
485
  #### 11. OpenCode
385
486
 
@@ -435,14 +536,14 @@ super-dev onboard --host qoder --force --yes
435
536
 
436
537
  触发命令：
437
538
  ```text
438
- super-dev: 你的需求
539
+ /super-dev 你的需求
439
540
  ```
440
541
 
441
542
  接入后是否需要重启：否
442
543
 
443
544
  补充说明：
444
- 1. Qoder IDE 当前优先按 project rules 模式触发，不走 `/super-dev`。
445
- 2. 若规则未生效，重新打开项目或重新创建聊天。
545
+ 1. Qoder IDE 当前优先使用项目级 commands + rules 模式，直接在 Agent Chat 输入 `/super-dev 你的需求`。
546
+ 2. 若新增命令未出现，先确认 `.qoder/commands/super-dev.md` 已生成，再重新打开项目或新开一个 Agent Chat。
446
547
 
447
548
  #### 14. Windsurf
448
549
 
@@ -483,8 +584,8 @@ super-dev: 你的需求
483
584
  接入后是否需要重启：是
484
585
 
485
586
  补充说明：
486
- 1. 不要输入 `/super-dev`，Codex 当前不走自定义 slash。
487
- 2. 实际依赖 `.codex/AGENTS.md` 和 `.codex/skills/super-dev-core/SKILL.md`。
587
+ 1. Codex CLI 当前使用 `super-dev: 你的需求` 作为主触发方式。
588
+ 2. 实际依赖 `.codex/AGENTS.md` 与官方用户级 Skill `~/.codex/skills/super-dev-core/SKILL.md`。
488
589
  3. 如果旧会话没加载新 Skill，重启 `codex` 再试。
489
590
 
490
591
  #### 16. Trae
@@ -505,9 +606,10 @@ super-dev: 你的需求
505
606
  接入后是否需要重启：否
506
607
 
507
608
  补充说明：
508
- 1. 不要输入 `/super-dev`。
509
- 2. Trae 当前默认按项目 rules 模式工作，无需手动开启 Skill。
510
- 3. 随后按 `output/*` 与 `.super-dev/changes/*/tasks.md` 推进开发。
609
+ 1. Trae 当前使用 `super-dev: 你的需求` 作为主触发方式。
610
+ 2. 接入一定会写入项目级 `.trae/rules.md`；如果检测到兼容技能目录，也会增强安装 `~/.trae/skills/super-dev-core/SKILL.md`。
611
+ 3. 完成接入后建议重开 Trae 或至少新开一个 Agent Chat，使规则生效；如果兼容 Skill 已安装，也会一起生效。
612
+ 4. 随后按 `output/*` 与 `.super-dev/changes/*/tasks.md` 推进开发。
511
613
 
512
614
  ## 快速开始（详细使用说明）
513
615
 
@@ -526,22 +628,22 @@ super-dev: 你的需求
526
628
 
527
629
  | 宿主 | 类型 | 认证等级 | 是否支持 `/super-dev` | 正确触发方式 | 接入后是否需要重启 |
528
630
  | --- | --- | --- | --- | --- | --- |
529
- | Claude Code | CLI | Certified | 支持 | 在 Claude Code 会话中输入 `/super-dev 你的需求` | 否 |
530
- | CodeBuddy CLI | CLI | Compatible | 支持 | 在 CodeBuddy CLI 会话中输入 `/super-dev 你的需求` | 否 |
531
- | CodeBuddy IDE | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求` | 否 |
631
+ | Claude Code | CLI | Certified | 支持 | 在 Claude Code 会话中输入 `/super-dev 你的需求`（由 `.claude/commands/` + `.claude/agents/` / `~/.claude/agents/` 生效） | 否 |
632
+ | CodeBuddy CLI | CLI | Compatible | 支持 | 在 CodeBuddy CLI 会话中输入 `/super-dev 你的需求`（由 `.codebuddy/commands/` + `.codebuddy/skills/` / `~/.codebuddy/skills/` 生效） | 否 |
633
+ | CodeBuddy IDE | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求`（由 `.codebuddy/commands/` + `.codebuddy/skills/` / `~/.codebuddy/skills/` 生效） | 否 |
532
634
  | Cursor CLI | CLI | Compatible | 支持 | 在 Cursor CLI 会话中输入 `/super-dev 你的需求` | 否 |
533
635
  | Cursor IDE | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求` | 否 |
534
636
  | Gemini CLI | CLI | Compatible | 支持 | 在 Gemini CLI 会话中输入 `/super-dev 你的需求` | 否 |
535
637
  | iFlow CLI | CLI | Experimental | 支持 | 在 iFlow CLI 会话中输入 `/super-dev 你的需求` | 否 |
536
638
  | Kimi CLI | CLI | Experimental | 不支持 | 在 Kimi CLI 会话中输入 `super-dev: 你的需求`（由 `.kimi/AGENTS.md` 生效） | 否 |
537
639
  | Kiro CLI | CLI | Compatible | 支持 | 在 Kiro CLI 会话中输入 `/super-dev 你的需求` | 否 |
538
- | Kiro IDE | IDE | Experimental | 不支持 | 在 Kiro IDE Agent Chat 中输入 `super-dev: 你的需求`（由 `.kiro/steering/super-dev.md` 生效） | 否 |
539
- | OpenCode CLI | CLI | Experimental | 支持 | 在 OpenCode CLI 会话中输入 `/super-dev 你的需求` | 否 |
540
- | Qoder CLI | CLI | Compatible | 支持 | 在 Qoder CLI 会话中输入 `/super-dev 你的需求` | 否 |
541
- | Qoder IDE | IDE | Experimental | 不支持 | 在 Qoder IDE Agent Chat 中输入 `super-dev: 你的需求`（由 `.qoder/rules.md` 生效） | 否 |
542
- | Windsurf | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求` | 否 |
543
- | Codex CLI | CLI | Certified | 不支持 | 重启 Codex 后输入 `super-dev: 你的需求`，由 `.codex/AGENTS.md` + `super-dev-core` Skill 生效 | 是 |
544
- | Trae | IDE | Certified | 不支持 | 在 Trae Agent Chat 中输入 `super-dev: 你的需求`（由 `.trae/rules.md` 生效） | 否 |
640
+ | Kiro IDE | IDE | Experimental | 不支持 | 在 Kiro IDE Agent Chat 中输入 `super-dev: 你的需求`（由 `.kiro/steering/super-dev.md` + `~/.kiro/steering/AGENTS.md` 生效） | 否 |
641
+ | OpenCode CLI | CLI | Experimental | 支持 | 在 OpenCode CLI 会话中输入 `/super-dev 你的需求`（由 `.opencode/commands/` + `.opencode/skills/` / `~/.config/opencode/skills/` 生效） | 否 |
642
+ | Qoder CLI | CLI | Compatible | 支持 | 在 Qoder CLI 会话中输入 `/super-dev 你的需求`（由 `.qoder/commands/` + `.qoder/skills/` / `~/.qoder/skills/` 生效） | 否 |
643
+ | Qoder IDE | IDE | Experimental | 支持 | 在 Qoder IDE Agent Chat 中输入 `/super-dev 你的需求`（由 `.qoder/commands/super-dev.md` + `.qoder/rules.md` + `.qoder/skills/` / `~/.qoderwork/skills/` 生效） | 否 |
644
+ | Windsurf | IDE | Experimental | 支持 | 在 Agent Chat 中输入 `/super-dev 你的需求`（由 `.windsurf/workflows/` + `.windsurf/skills/` / `~/.codeium/windsurf/skills/` 生效） | 否 |
645
+ | Codex CLI | CLI | Certified | 不支持 | 重启 Codex 后输入 `super-dev: 你的需求`，由 `.codex/AGENTS.md` + 兼容 Skill 生效 | 是 |
646
+ | Trae | IDE | Compatible | 不支持 | 在 Trae Agent Chat 中输入 `super-dev: 你的需求`（由 `.trae/rules.md` 生效；若检测到兼容 Skill `~/.trae/skills/super-dev-core/SKILL.md` 会额外增强） | 是 |
545
647
 
546
648
  ### 1. 安装后直接进入引导
547
649
 
@@ -675,7 +777,7 @@ super-dev review docs --status confirmed --comment "三文档已确认，进入
675
777
  `/super-dev` 会强制执行：先 research -> 再三文档（PRD/架构/UIUX）-> 等待用户确认 -> 再 Spec 与 tasks -> 再编码实现。
676
778
  编码阶段默认遵循商业级 UI/UX 规范，禁止紫/粉渐变主视觉、emoji 功能图标、模板化页面直出，并要求先定义字体系统、token、栅格和组件状态矩阵。
677
779
 
678
- Codex CLI 当前不使用 `/super-dev`，而是依赖 `.codex/AGENTS.md` + `super-dev-core` Skill。在 Codex 会话中输入 `super-dev: 你的需求` 即可。
780
+ Codex CLI 当前通过 `.codex/AGENTS.md` + `super-dev-core` Skill 工作，在 Codex 会话中输入 `super-dev: 你的需求` 即可。
679
781
 
680
782
  若宿主不支持 slash 命令映射，可在同一项目根目录执行终端入口（仅触发 Super Dev 本地流水线编排）：
681
783
 
@@ -767,7 +869,6 @@ super-dev quality --type all
767
869
  - `codebuddy`
768
870
  - `cursor`
769
871
  - `kiro`
770
- - `qoder`
771
872
  - `trae`（Rules-first）
772
873
  - `windsurf`
773
874
 
@@ -776,7 +877,7 @@ super-dev quality --type all
776
877
  - `CLI 宿主（原生 slash）`：在宿主会话内触发 `/super-dev`，由宿主模型执行编码
777
878
  - `CLI 宿主（非 slash）`：在宿主会话内输入 `super-dev: 你的需求`，由 AGENTS / 规则文件驱动执行
778
879
  - `IDE 宿主（原生 slash）`：在 Agent Chat 触发 `/super-dev`，由规则文件与 Skill 约束执行流程
779
- - `IDE 宿主（非 slash）`：在 Agent Chat 输入 `super-dev: 你的需求`，由项目规则驱动执行
880
+ - `IDE 宿主（非 slash）`：在 Agent Chat 输入 `super-dev: 你的需求`，由项目规则或宿主 Skill 驱动执行
780
881
  - `终端入口`：`super-dev "需求"` 仅触发本地流水线编排，不直接调用宿主模型会话
781
882
 
782
883
  查看宿主适配矩阵（官方文档链接、适配模式、注入路径、探测策略）：
@@ -858,6 +959,7 @@ UV_PUBLISH_TOKEN="<your-token>" uv publish
858
959
 
859
960
  ## 相关文档
860
961
 
962
+ - [宿主接入面说明](docs/HOST_INSTALL_SURFACES.md)
861
963
  - [详细工作流指南](docs/WORKFLOW_GUIDE.md)
862
964
  - [快速开始](docs/QUICKSTART.md)
863
965
  - [发布指南](docs/PUBLISHING.md)
{super_dev-2.0.5 → super_dev-2.0.7}/pyproject.toml RENAMED
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "super-dev"
7
- version = "2.0.5"
7
+ version = "2.0.7"
8
8
  description = "Super Dev - Pipeline AI Coding Assistant"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
{super_dev-2.0.5 → super_dev-2.0.7}/super_dev/__init__.py RENAMED
@@ -6,6 +6,6 @@
6
6
  最后修改：2025-12-30
7
7
  """
8
8
 
9
- __version__ = "2.0.5"
9
+ __version__ = "2.0.7"
10
10
  __author__ = "Excellent"
11
11
  __description__ = "超级开发战队 - 一个宿主内 AI 开发治理与编排工具"