super-dev 2.3.3__tar.gz → 2.3.5__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 (182) hide show
  1. {super_dev-2.3.3/super_dev.egg-info → super_dev-2.3.5}/PKG-INFO +103 -121
  2. {super_dev-2.3.3 → super_dev-2.3.5}/README.md +102 -120
  3. {super_dev-2.3.3 → super_dev-2.3.5}/pyproject.toml +1 -1
  4. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/__init__.py +1 -1
  5. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/branding.py +1 -1
  6. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/catalogs.py +71 -7
  7. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/cli.py +138 -51
  8. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/cli_analysis_mixin.py +7 -26
  9. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/cli_governance_mixin.py +593 -2
  10. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/cli_host_ops_mixin.py +423 -762
  11. super_dev-2.3.5/super_dev/cli_host_report_renderers.py +737 -0
  12. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/cli_parser_mixin.py +101 -3
  13. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/cli_release_quality_mixin.py +389 -0
  14. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/cli_spec_mixin.py +116 -1
  15. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/config/__init__.py +4 -1
  16. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/config/manager.py +225 -94
  17. super_dev-2.3.5/super_dev/config/schema_validator.py +150 -0
  18. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/document_generator.py +4 -4
  19. super_dev-2.3.5/super_dev/creators/requirement_parser.py +975 -0
  20. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/deployers/delivery.py +1 -1
  21. super_dev-2.3.5/super_dev/enforcement/host_hooks.py +451 -0
  22. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/error_handler.py +16 -13
  23. super_dev-2.3.5/super_dev/guard.py +110 -0
  24. super_dev-2.3.5/super_dev/host_adapters.py +564 -0
  25. super_dev-2.3.5/super_dev/host_registry.py +516 -0
  26. super_dev-2.3.5/super_dev/i18n.py +117 -0
  27. super_dev-2.3.5/super_dev/integrations/install_manifest.py +72 -0
  28. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/integrations/manager.py +310 -79
  29. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/integrations/manager_content_mixin.py +239 -23
  30. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/migrate.py +59 -22
  31. super_dev-2.3.5/super_dev/orchestrator/__init__.py +54 -0
  32. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/orchestrator/engine.py +180 -0
  33. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/orchestrator/experts.py +34 -0
  34. super_dev-2.3.5/super_dev/orchestrator/overseer.py +509 -0
  35. super_dev-2.3.5/super_dev/orchestrator/plan_executor.py +647 -0
  36. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/protocols/a2a.py +1 -1
  37. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/quality_gate.py +18 -0
  38. super_dev-2.3.5/super_dev/runtime_evidence.py +203 -0
  39. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/skills/manager.py +78 -10
  40. super_dev-2.3.5/super_dev/skills/skill_template.py +1558 -0
  41. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/tips.py +6 -6
  42. super_dev-2.3.5/super_dev/utils/structured_logging.py +105 -0
  43. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/web/api.py +318 -36
  44. super_dev-2.3.5/super_dev/web/helpers.py +256 -0
  45. super_dev-2.3.5/super_dev/web/rate_limit.py +89 -0
  46. super_dev-2.3.5/super_dev/web/routers/__init__.py +1 -0
  47. super_dev-2.3.5/super_dev/web/routers/config_routes.py +317 -0
  48. super_dev-2.3.5/super_dev/web/routers/experts.py +123 -0
  49. super_dev-2.3.5/super_dev/web/routers/health.py +19 -0
  50. super_dev-2.3.5/super_dev/web/routers/workflow.py +830 -0
  51. super_dev-2.3.5/super_dev/webhooks.py +59 -0
  52. super_dev-2.3.5/super_dev/workflow_contract.py +344 -0
  53. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/workflow_state.py +160 -49
  54. {super_dev-2.3.3 → super_dev-2.3.5/super_dev.egg-info}/PKG-INFO +103 -121
  55. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev.egg-info/SOURCES.txt +21 -1
  56. super_dev-2.3.3/super_dev/creators/requirement_parser.py +0 -418
  57. super_dev-2.3.3/super_dev/enforcement/host_hooks.py +0 -204
  58. super_dev-2.3.3/super_dev/orchestrator/__init__.py +0 -20
  59. super_dev-2.3.3/super_dev/skills/skill_template.py +0 -711
  60. {super_dev-2.3.3 → super_dev-2.3.5}/LICENSE +0 -0
  61. {super_dev-2.3.3 → super_dev-2.3.5}/setup.cfg +0 -0
  62. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/_enforcement_bridge.py +0 -0
  63. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/__init__.py +0 -0
  64. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/analyzer.py +0 -0
  65. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/dependency_graph.py +0 -0
  66. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/detectors.py +0 -0
  67. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/feature_checklist.py +0 -0
  68. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/impact.py +0 -0
  69. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/models.py +0 -0
  70. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/product_audit.py +0 -0
  71. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/regression_guard.py +0 -0
  72. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/analyzer/repo_map.py +0 -0
  73. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/cli_deploy_runtime_mixin.py +0 -0
  74. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/cli_experience_mixin.py +0 -0
  75. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/completion.py +0 -0
  76. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/config/frontend.py +0 -0
  77. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/__init__.py +0 -0
  78. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/adr_generator.py +0 -0
  79. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/api_contract.py +0 -0
  80. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/compact_template.py +0 -0
  81. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/component_scaffold.py +0 -0
  82. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/creator.py +0 -0
  83. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/document_generator_content_mixin.py +0 -0
  84. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/frontend_builder.py +0 -0
  85. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/implementation_builder.py +0 -0
  86. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/nextjs_scaffold.py +0 -0
  87. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/prompt_generator.py +0 -0
  88. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/prompt_sections.py +0 -0
  89. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/prompt_templates.py +0 -0
  90. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/spec_builder.py +0 -0
  91. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/creators/task_executor.py +0 -0
  92. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/deployers/__init__.py +0 -0
  93. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/deployers/cicd.py +0 -0
  94. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/deployers/migration.py +0 -0
  95. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/deployers/rehearsal.py +0 -0
  96. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/deployers/rehearsal_runner.py +0 -0
  97. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/__init__.py +0 -0
  98. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/aesthetics.py +0 -0
  99. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/charts.py +0 -0
  100. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/codegen.py +0 -0
  101. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/engine.py +0 -0
  102. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/generator.py +0 -0
  103. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/landing.py +0 -0
  104. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/tech_stack.py +0 -0
  105. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/tokens.py +0 -0
  106. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/ui_intelligence.py +0 -0
  107. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/design/ux_guide.py +0 -0
  108. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/enforcement/__init__.py +0 -0
  109. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/enforcement/pre_code_gate.py +0 -0
  110. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/enforcement/validation.py +0 -0
  111. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/exceptions.py +0 -0
  112. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/experts/__init__.py +0 -0
  113. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/experts/behavioral_prompts.py +0 -0
  114. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/experts/loader.py +0 -0
  115. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/experts/review_protocol.py +0 -0
  116. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/experts/service.py +0 -0
  117. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/experts/toolkit.py +0 -0
  118. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/framework_harness.py +0 -0
  119. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/frameworks.py +0 -0
  120. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/harness_registry.py +0 -0
  121. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/hook_harness.py +0 -0
  122. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/hooks/__init__.py +0 -0
  123. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/hooks/manager.py +0 -0
  124. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/hooks/models.py +0 -0
  125. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/integrations/__init__.py +0 -0
  126. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/knowledge_evolution.py +0 -0
  127. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/knowledge_tracker.py +0 -0
  128. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/memory/__init__.py +0 -0
  129. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/memory/consolidator.py +0 -0
  130. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/memory/extractor.py +0 -0
  131. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/memory/store.py +0 -0
  132. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/metrics/__init__.py +0 -0
  133. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/metrics/pipeline_metrics.py +0 -0
  134. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/onboarding.py +0 -0
  135. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/operational_harness.py +0 -0
  136. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/orchestrator/context_compact.py +0 -0
  137. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/orchestrator/contracts.py +0 -0
  138. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/orchestrator/governance.py +0 -0
  139. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/orchestrator/knowledge.py +0 -0
  140. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/orchestrator/knowledge_pusher.py +0 -0
  141. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/orchestrator/quality.py +0 -0
  142. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/orchestrator/telemetry.py +0 -0
  143. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/pipeline_cost.py +0 -0
  144. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/policy/__init__.py +0 -0
  145. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/policy/manager.py +0 -0
  146. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/project_templates.py +0 -0
  147. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/proof_pack.py +0 -0
  148. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/protocols/__init__.py +0 -0
  149. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/protocols/output_schemas.py +0 -0
  150. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/release_readiness.py +0 -0
  151. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reminders.py +0 -0
  152. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/review_state.py +0 -0
  153. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/__init__.py +0 -0
  154. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/code_review.py +0 -0
  155. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/external_reviews.py +0 -0
  156. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/quality_advisor.py +0 -0
  157. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/redteam.py +0 -0
  158. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/review_agents.py +0 -0
  159. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/rules/__init__.py +0 -0
  160. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/ui_review.py +0 -0
  161. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/reviewers/validation_rules.py +0 -0
  162. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/rules/__init__.py +0 -0
  163. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/rules/loader.py +0 -0
  164. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/session/__init__.py +0 -0
  165. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/session/brief.py +0 -0
  166. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/skills/__init__.py +0 -0
  167. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/specs/__init__.py +0 -0
  168. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/specs/consistency_checker.py +0 -0
  169. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/specs/generator.py +0 -0
  170. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/specs/manager.py +0 -0
  171. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/specs/models.py +0 -0
  172. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/specs/traceability.py +0 -0
  173. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/specs/validator.py +0 -0
  174. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/terminal.py +0 -0
  175. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/utils/__init__.py +0 -0
  176. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/utils/logger.py +0 -0
  177. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/version_check.py +0 -0
  178. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev/workflow_harness.py +0 -0
  179. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev.egg-info/dependency_links.txt +0 -0
  180. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev.egg-info/entry_points.txt +0 -0
  181. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev.egg-info/requires.txt +0 -0
  182. {super_dev-2.3.3 → super_dev-2.3.5}/super_dev.egg-info/top_level.txt +0 -0
{super_dev-2.3.3/super_dev.egg-info → super_dev-2.3.5}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: super-dev
3
- Version: 2.3.3
3
+ Version: 2.3.5
4
4
  Summary: Super Dev - Pipeline AI Coding Assistant
5
5
  Author-email: Excellent <11964948@qq.com>
6
6
  License-Expression: MIT
@@ -60,9 +60,9 @@ Dynamic: license-file
60
60
 
61
61
  ## 版本
62
62
 
63
- 当前版本：`2.3.3`
63
+ 当前版本：`2.3.5`
64
64
 
65
- - 发布说明：[v2.3.3 更新内容](docs/releases/2.3.3.md)
65
+ - 发布说明：[v2.3.5 更新内容](docs/releases/2.3.5.md)
66
66
  - 官网更新历史：[superdev.goder.ai/changelog](https://superdev.goder.ai/changelog)
67
67
 
68
68
  ---
@@ -111,95 +111,57 @@ Dynamic: license-file
111
111
 
112
112
  ## 快速开始
113
113
 
114
- 先记住这 5 个入口，其中旧的直达写法仍然保留：
114
+ 普通用户只需要记住 2 个终端命令：
115
115
 
116
116
  ```bash
117
- # 安装引导 / 已有项目下一步
117
+ # 进入宿主接入引导
118
118
  super-dev
119
119
 
120
- # 旧写法仍可用：直接从需求描述进入完整流水线
121
- super-dev "做一个在线教育平台"
122
-
123
- # 0-1：为当前机器选择宿主并给出第一句触发词
124
- super-dev start --idea "做一个在线教育平台"
125
-
126
- # 第二天回来 / 重开宿主：恢复当前流程
127
- super-dev resume
128
-
129
- # 已有流程：继续当前流程，而不是重新开始普通聊天
130
- super-dev continue
131
-
132
- # 状态不清楚时：只问系统“下一步”
133
- super-dev next
120
+ # 更新到最新版，并迁移已接入宿主
121
+ super-dev update
134
122
  ```
135
123
 
136
- 使用方式：
137
-
138
- - 当前目录还没接入时，裸跑 `super-dev` 会进入安装引导。
139
- - 当前目录已经有 Super Dev 上下文时，裸跑 `super-dev` 会直接进入“恢复当前流程”路由。
140
- - `super-dev "..."` 仍然是直达完整流水线的快捷入口，适合你已经明确要让 Super Dev 直接开工的场景。
141
- - `super-dev start --idea "..."` 会自动检测宿主、给出推荐宿主、触发词、重开提示和第一句该发什么。
142
- - `super-dev resume` 最适合下班回来、第二天继续、重开电脑、重开宿主后的真实恢复场景。
143
- - `super-dev continue` / `super-dev next` 会直接告诉你当前动作、用户下一步、宿主第一句、机器侧动作。
124
+ 接入完成后，正常使用都回到宿主里：
144
125
 
145
- 现实场景怎么继续：
126
+ ```text
127
+ /super-dev 你的需求
128
+ super-dev: 你的需求
129
+ /super-dev-seeai 比赛需求
130
+ super-dev-seeai: 比赛需求
131
+ ```
146
132
 
147
- | 场景 | 先做什么 | 为什么 |
148
- |------|----------|--------|
149
- | 下班了，第二天回来继续开发 | `super-dev resume` | 直接恢复当前流程、当前动作、宿主第一句和机器侧下一步 |
150
- | 宿主关了、电脑重启了、会话断了 | `super-dev resume` | 重新生成恢复卡，并提醒先看 `.super-dev/SESSION_BRIEF.md` |
151
- | 只是不知道现在卡在哪一步 | `super-dev next` | 只输出当前仓库唯一推荐的下一步 |
152
- | 流水线命令跑到一半被打断 | `super-dev run --resume` | 从上次中断阶段继续执行机器侧流水线 |
153
- | 当前在确认门，想继续补 PRD / 架构 / UI | `super-dev resume` 后按提示继续说自然语言 | 会继续留在当前确认门，而不是开启普通聊天 |
154
- | 明确要返工 UI | 先更新 `output/*-uiux.md`，再 `super-dev resume` | 先改 UI 真源，再让后续前端实现沿同一套 UI 契约继续 |
155
- | 明确要返工架构 | 先更新 `output/*-architecture.md`，再 `super-dev resume` | 先改技术真源，再让 Spec / 实现重新对齐 |
156
- | 只想离开当前流程，重新聊别的 | 明确说“取消当前流程”或“重新开始一条新流程” | 系统只在你明确退出时才离开当前 Super Dev 流程 |
133
+ 正确心智：
157
134
 
158
- 如果你已经明确知道要从哪里接着做，再用这些命令：
135
+ - 终端只负责接入与升级
136
+ - 宿主才负责 research、三文档、确认门、Spec、实现、质量门禁与交付
137
+ - 自动判断会在接入/升级阶段发生，但不会在普通开发流程里越层改宿主配置
138
+ - `已接入` 与 `已验证` 是两回事：文件落盘不代表宿主已经真实跑通
159
139
 
160
- ```bash
161
- # 1-N+1 已有项目：分析现有代码库后接入流水线
162
- super-dev init
140
+ 推荐上手顺序：
163
141
 
164
- # 跳转到任意阶段 / 从中断处继续 / 查看状态
165
- super-dev run frontend # 按名称跳转
166
- super-dev run 6 # 按编号跳转（1-9）
167
- super-dev run --resume # 从中断处继续
168
- super-dev run --status # 查看当前流程状态
169
- ```
142
+ 1. 终端运行 `super-dev`
143
+ 2. 让安装器自动检测宿主并写入项目级/全局级协议面
144
+ 3. 打开宿主，在宿主里输入 `/super-dev` 或 `super-dev:`
145
+ 4. 让宿主先完成 research、PRD、Architecture、UI/UX
146
+ 5. 文档确认后再进入 Spec 与实现
170
147
 
171
- 阶段编号对照：
148
+ SEEAI 赛事极速版：
172
149
 
173
- | 编号 | 阶段 | 说明 |
174
- |------|------|------|
175
- | 1 | research | 同类产品研究 |
176
- | 2 | prd | 产品需求文档 |
177
- | 3 | architecture | 架构设计 |
178
- | 4 | uiux | UI/UX 设计 |
179
- | 5 | spec | 任务规格 |
180
- | 6 | frontend | 前端实现 |
181
- | 7 | backend | 后端实现 |
182
- | 8 | quality | 质量门禁 |
183
- | 9 | delivery | 交付打包 |
150
+ - 入口：`/super-dev-seeai` 或 `super-dev-seeai:`
151
+ - 仍然保留 `research -> 三文档 -> docs confirm -> spec`
152
+ - 但 `spec` 之后直接进入前后端一体化快速开发，不再拆预览确认门
153
+ - 适合 30 分钟左右的官网、小游戏、展示型工具、单页 demo
184
154
 
185
- 辅助命令：
155
+ 高级/内部命令仍然保留，但不再是普通用户主路径：
186
156
 
187
157
  ```bash
158
+ super-dev init
188
159
  super-dev onboard # 宿主接入引导
189
- super-dev onboard --dry-run # 预览接入变更，不实际写入
190
- super-dev onboard --stable-only # 仅接入已认证宿主
191
160
  super-dev detect # 自动检测宿主与推荐默认宿主
192
- super-dev detect --auto # 自动检测并安装到所有宿主
193
161
  super-dev doctor # 诊断检查（显示认证等级、主修复动作和下一步）
194
- ```
195
-
196
- 快速接入（推荐）：
197
-
198
- ```bash
199
- super-dev init my-project
200
- super-dev init --template ecommerce # 使用项目模板 (ecommerce/saas/dashboard/mobile/api/blog/miniapp)
201
- super-dev detect --auto # 自动检测并安装到所有宿主
202
- # 然后按宿主模型触发: Claude 用 /super-dev，Codex App/Desktop 用 / 列表里的 super-dev，Codex CLI 用 $super-dev，其他非 slash 宿主用 super-dev:
162
+ super-dev run --status # 查看内部流程状态
163
+ super-dev run frontend # 强制跳到特定阶段
164
+ super-dev review docs # 手动更新确认门状态
203
165
  ```
204
166
 
205
167
  治理与知识命令（2.2.0 新增）：
@@ -309,7 +271,7 @@ UI/UX 文档不再只是建议，而是会冻结成一份真正的 UI 契约：
309
271
  - **阶段跳转**：`super-dev run <阶段>` 可随时跳转到任意阶段
310
272
  - **UI 改版回路**：UI 不满意时可发起正式改版回路（`review ui`），先更新 UIUX 文档再重做前端
311
273
  - **适配 0-1 与 1-N+1**：新建项目走完整流水线，已有项目走增量分析路径
312
- - **继续当前流程路由**：`super-dev resume` / `super-dev continue` / `super-dev next` / `start --json` / `doctor --json` 都共享同一套 workflow state 与 action card
274
+ - **继续当前流程路由**：内部恢复与状态命令共享同一套 workflow state 与 action card
313
275
  - **恢复状态卡**：`.super-dev/SESSION_BRIEF.md` 和 `.super-dev/workflow-state.json` 会沉淀“当前动作 / 宿主第一句 / 机器侧动作 / 连续性规则”
314
276
  - **关键时间线**：流程快照、语义事件、Hook 事件会汇总成统一的 recent timeline，进入 `SESSION_BRIEF`、Workflow Harness、proof-pack 与 release readiness
315
277
  - **返工优先级**：文档确认门、预览确认门、UI 改版、架构返工、质量整改都进入统一状态机，不再靠用户记命令
@@ -469,18 +431,19 @@ super-dev
469
431
 
470
432
  - slash 宿主：`/super-dev 你的需求`
471
433
  - 非 slash 宿主：`super-dev: 你的需求`
434
+ - 比赛极速版：`/super-dev-seeai 比赛需求` 或 `super-dev-seeai: 比赛需求`
472
435
  - 需要真人验收时，可执行：`super-dev integrate validate --target <host>`
473
436
 
474
437
  ### 3. 指定版本安装
475
438
 
476
439
  ```bash
477
- pip install super-dev==2.3.3
440
+ pip install super-dev==2.3.5
478
441
  ```
479
442
 
480
443
  ### 4. GitHub 指定标签安装
481
444
 
482
445
  ```bash
483
- pip install git+https://github.com/shangyankeji/super-dev.git@v2.3.3
446
+ pip install git+https://github.com/shangyankeji/super-dev.git@v2.3.5
484
447
  ```
485
448
 
486
449
  ### 5. 源码开发安装
@@ -622,7 +585,7 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
622
585
 
623
586
  `Super Dev` 的运行方式可以概括为一条固定链路：
624
587
 
625
- 1. 用户在项目目录执行 `super-dev` 或 `super-dev init`
588
+ 1. 用户在项目目录执行 `super-dev`
626
589
  2. 安装引导把 Super Dev 接入到目标宿主
627
590
  3. 用户在宿主里输入 `/super-dev 需求` 或 `super-dev: 需求`
628
591
  4. 宿主进入 Super Dev 流水线，11 个专家 Agent 按阶段注入，知识推送引擎自动推送相关约束
@@ -651,7 +614,7 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
651
614
 
652
615
  ## 架构概览
653
616
 
654
- Super Dev 2.3.3 架构由四层组成：**宿主接入层**（20 个统一接入宿主 + 1 个 OpenClaw 手动插件宿主）、**知识治理层**（306 索引 / 渐进式加载 / 自演化）、**编排引擎层**（9 阶段流水线 / 11 专家 / 验证规则引擎）、**交付审计层**（DORA 度量 / ADR / 一致性检测 / proof-pack）。
617
+ Super Dev 2.3.5 架构由四层组成：**宿主接入层**（20 个统一接入宿主 + 1 个 OpenClaw 手动插件宿主）、**知识治理层**（306 索引 / 渐进式加载 / 自演化）、**编排引擎层**（9 阶段流水线 / 11 专家 + Overseer / 验证规则引擎）、**交付审计层**（DORA 度量 / ADR / 一致性检测 / proof-pack）。
655
618
 
656
619
  ### 一、系统高阶流转架构
657
620
 
@@ -682,33 +645,33 @@ Super Dev 2.3.3 架构由四层组成：**宿主接入层**（20 个统一接入
682
645
 
683
646
  ### 统一 CLI 宿主（9 个）
684
647
 
685
- | 宿主 | 触发方式 | 安装命令 |
648
+ | 宿主 | 触发方式 | 终端入口 |
686
649
  |------|----------|----------|
687
- | Claude Code | `/super-dev 需求` | `super-dev onboard --host claude-code` |
688
- | Codex | App/Desktop: `/super-dev`（skill 入口） / CLI: `$super-dev` / 回退: `super-dev: 需求` | `super-dev onboard --host codex-cli` |
689
- | Gemini CLI | `/super-dev 需求` | `super-dev onboard --host gemini-cli` |
690
- | OpenCode | `/super-dev 需求` | `super-dev onboard --host opencode` |
691
- | Kiro CLI | `/super-dev 需求` | `super-dev onboard --host kiro-cli` |
692
- | Cursor CLI | `/super-dev 需求` | `super-dev onboard --host cursor-cli` |
693
- | Qoder CLI | `/super-dev 需求` | `super-dev onboard --host qoder-cli` |
694
- | Copilot CLI | `super-dev: 需求` | `super-dev onboard --host copilot-cli` |
695
- | CodeBuddy CLI | `/super-dev 需求` | `super-dev onboard --host codebuddy-cli` |
650
+ | Claude Code | `/super-dev 需求` | `super-dev` |
651
+ | Codex | App/Desktop: `/super-dev`（skill 入口） / CLI: `$super-dev` / 回退: `super-dev: 需求` | `super-dev` |
652
+ | Gemini CLI | `/super-dev 需求` | `super-dev` |
653
+ | OpenCode | `/super-dev 需求` | `super-dev` |
654
+ | Kiro CLI | `/super-dev 需求` | `super-dev` |
655
+ | Cursor CLI | `/super-dev 需求` | `super-dev` |
656
+ | Qoder CLI | `/super-dev 需求` | `super-dev` |
657
+ | Copilot CLI | `super-dev: 需求` | `super-dev` |
658
+ | CodeBuddy CLI | `/super-dev 需求` | `super-dev` |
696
659
 
697
660
  ### IDE 宿主（11 个）
698
661
 
699
- | 宿主 | 触发方式 | 安装命令 |
662
+ | 宿主 | 触发方式 | 终端入口 |
700
663
  |------|----------|----------|
701
- | Antigravity | `/super-dev 需求` | `super-dev onboard --host antigravity` |
702
- | Cursor | `/super-dev 需求` | `super-dev onboard --host cursor` |
703
- | Windsurf | `/super-dev 需求` | `super-dev onboard --host windsurf` |
704
- | Kiro | `/super-dev 需求` | `super-dev onboard --host kiro` |
705
- | Qoder | `/super-dev 需求` | `super-dev onboard --host qoder` |
706
- | Trae | `super-dev: 需求` | `super-dev onboard --host trae` |
707
- | CodeBuddy | `/super-dev 需求` | `super-dev onboard --host codebuddy` |
708
- | Copilot (VS Code) | `super-dev: 需求` | `super-dev onboard --host vscode-copilot` |
709
- | Roo Code | `super-dev: 需求` | `super-dev onboard --host roo-code` |
710
- | Kilo Code | `super-dev: 需求` | `super-dev onboard --host kilo-code` |
711
- | Cline | `super-dev: 需求` | `super-dev onboard --host cline` |
664
+ | Antigravity | `/super-dev 需求` | `super-dev` |
665
+ | Cursor | `/super-dev 需求` | `super-dev` |
666
+ | Windsurf | `/super-dev 需求` | `super-dev` |
667
+ | Kiro | `/super-dev 需求` | `super-dev` |
668
+ | Qoder | `/super-dev 需求` | `super-dev` |
669
+ | Trae | `super-dev: 需求` | `super-dev` |
670
+ | CodeBuddy | `/super-dev 需求` | `super-dev` |
671
+ | Copilot (VS Code) | `super-dev: 需求` | `super-dev` |
672
+ | Roo Code | `super-dev: 需求` | `super-dev` |
673
+ | Kilo Code | `super-dev: 需求` | `super-dev` |
674
+ | Cline | `super-dev: 需求` | `super-dev` |
712
675
 
713
676
  ---
714
677
 
@@ -718,7 +681,7 @@ Super Dev 2.3.3 架构由四层组成：**宿主接入层**（20 个统一接入
718
681
 
719
682
  安装：
720
683
  ```bash
721
- super-dev onboard --host claude-code --force --yes
684
+ super-dev
722
685
  ```
723
686
 
724
687
  触发位置：
@@ -728,6 +691,10 @@ super-dev onboard --host claude-code --force --yes
728
691
  ```text
729
692
  /super-dev 你的需求
730
693
  ```
694
+ 比赛模式：
695
+ ```text
696
+ /super-dev-seeai 比赛需求
697
+ ```
731
698
 
732
699
  接入后是否需要重启：否
733
700
 
@@ -741,7 +708,7 @@ super-dev onboard --host claude-code --force --yes
741
708
 
742
709
  安装：
743
710
  ```bash
744
- super-dev onboard --host codex-cli --force --yes
711
+ super-dev
745
712
  ```
746
713
 
747
714
  触发位置：
@@ -770,7 +737,7 @@ Codex CLI: $super-dev
770
737
 
771
738
  安装：
772
739
  ```bash
773
- super-dev onboard --host gemini-cli --force --yes
740
+ super-dev
774
741
  ```
775
742
 
776
743
  触发位置：
@@ -791,7 +758,7 @@ super-dev onboard --host gemini-cli --force --yes
791
758
 
792
759
  安装：
793
760
  ```bash
794
- super-dev onboard --host opencode --force --yes
761
+ super-dev
795
762
  ```
796
763
 
797
764
  触发位置：
@@ -812,7 +779,7 @@ super-dev onboard --host opencode --force --yes
812
779
 
813
780
  安装：
814
781
  ```bash
815
- super-dev onboard --host kiro-cli --force --yes
782
+ super-dev
816
783
  ```
817
784
 
818
785
  触发位置：
@@ -834,7 +801,7 @@ super-dev onboard --host kiro-cli --force --yes
834
801
 
835
802
  安装：
836
803
  ```bash
837
- super-dev onboard --host cursor-cli --force --yes
804
+ super-dev
838
805
  ```
839
806
 
840
807
  触发位置：
@@ -855,7 +822,7 @@ super-dev onboard --host cursor-cli --force --yes
855
822
 
856
823
  安装：
857
824
  ```bash
858
- super-dev onboard --host qoder-cli --force --yes
825
+ super-dev
859
826
  ```
860
827
 
861
828
  触发位置：
@@ -877,7 +844,7 @@ super-dev onboard --host qoder-cli --force --yes
877
844
 
878
845
  安装：
879
846
  ```bash
880
- super-dev onboard --host copilot-cli --force --yes
847
+ super-dev
881
848
  ```
882
849
 
883
850
  触发位置：
@@ -898,7 +865,7 @@ super-dev onboard --host copilot-cli --force --yes
898
865
 
899
866
  安装：
900
867
  ```bash
901
- super-dev onboard --host codebuddy-cli --force --yes
868
+ super-dev
902
869
  ```
903
870
 
904
871
  触发位置：
@@ -915,12 +882,13 @@ super-dev onboard --host codebuddy-cli --force --yes
915
882
  1. 在当前 CLI 会话中直接输入即可。
916
883
  2. 官方主面是 `CODEBUDDY.md` + `.codebuddy/commands/` + `.codebuddy/skills/`，并补充 `~/.codebuddy/CODEBUDDY.md`。
917
884
  3. 如果会话已提前打开，建议重新加载项目规则后再试。
885
+ 4. 黑客松/比赛场景优先使用 `/super-dev-seeai`，让宿主按半小时节奏压缩 research、三文档、Spec 和一体化开发。
918
886
 
919
887
  #### 10. Antigravity
920
888
 
921
889
  安装：
922
890
  ```bash
923
- super-dev onboard --host antigravity --force --yes
891
+ super-dev
924
892
  ```
925
893
 
926
894
  触发位置：
@@ -943,7 +911,7 @@ super-dev onboard --host antigravity --force --yes
943
911
 
944
912
  安装：
945
913
  ```bash
946
- super-dev onboard --host cursor --force --yes
914
+ super-dev
947
915
  ```
948
916
 
949
917
  触发位置：
@@ -953,6 +921,10 @@ super-dev onboard --host cursor --force --yes
953
921
  ```text
954
922
  /super-dev 你的需求
955
923
  ```
924
+ 比赛模式：
925
+ ```text
926
+ /super-dev-seeai 比赛需求
927
+ ```
956
928
 
957
929
  接入后是否需要重启：否
958
930
 
@@ -964,7 +936,7 @@ super-dev onboard --host cursor --force --yes
964
936
 
965
937
  安装：
966
938
  ```bash
967
- super-dev onboard --host windsurf --force --yes
939
+ super-dev
968
940
  ```
969
941
 
970
942
  触发位置：
@@ -985,7 +957,7 @@ super-dev onboard --host windsurf --force --yes
985
957
 
986
958
  安装：
987
959
  ```bash
988
- super-dev onboard --host kiro --force --yes
960
+ super-dev
989
961
  ```
990
962
 
991
963
  触发位置：
@@ -1007,7 +979,7 @@ super-dev onboard --host kiro --force --yes
1007
979
 
1008
980
  安装：
1009
981
  ```bash
1010
- super-dev onboard --host qoder --force --yes
982
+ super-dev
1011
983
  ```
1012
984
 
1013
985
  触发位置：
@@ -1029,7 +1001,7 @@ super-dev onboard --host qoder --force --yes
1029
1001
 
1030
1002
  安装：
1031
1003
  ```bash
1032
- super-dev onboard --host trae --force --yes
1004
+ super-dev
1033
1005
  ```
1034
1006
 
1035
1007
  触发位置：
@@ -1052,7 +1024,7 @@ super-dev: 你的需求
1052
1024
 
1053
1025
  安装：
1054
1026
  ```bash
1055
- super-dev onboard --host codebuddy --force --yes
1027
+ super-dev
1056
1028
  ```
1057
1029
 
1058
1030
  触发位置：
@@ -1069,12 +1041,13 @@ super-dev onboard --host codebuddy --force --yes
1069
1041
  1. 建议在项目级 Agent Chat 中使用，不要脱离项目上下文。
1070
1042
  2. 先让宿主完成 research，再继续文档和编码。
1071
1043
  3. 当前按 `CODEBUDDY.md` + `.codebuddy/rules/super-dev/RULE.mdc` + `.codebuddy/commands/` + `.codebuddy/agents/` + `.codebuddy/skills/` 接入。
1044
+ 4. 比赛场景建议固定在同一个 Agent Chat，会比频繁切换子会话更稳。
1072
1045
 
1073
1046
  #### 17. Copilot (VS Code)
1074
1047
 
1075
1048
  安装：
1076
1049
  ```bash
1077
- super-dev onboard --host vscode-copilot --force --yes
1050
+ super-dev
1078
1051
  ```
1079
1052
 
1080
1053
  触发位置：
@@ -1096,7 +1069,7 @@ super-dev: 你的需求
1096
1069
 
1097
1070
  安装：
1098
1071
  ```bash
1099
- super-dev onboard --host roo-code --force --yes
1072
+ super-dev
1100
1073
  ```
1101
1074
 
1102
1075
  触发位置：
@@ -1118,7 +1091,7 @@ super-dev: 你的需求
1118
1091
 
1119
1092
  安装：
1120
1093
  ```bash
1121
- super-dev onboard --host kilo-code --force --yes
1094
+ super-dev
1122
1095
  ```
1123
1096
 
1124
1097
  触发位置：
@@ -1140,7 +1113,7 @@ super-dev: 你的需求
1140
1113
 
1141
1114
  安装：
1142
1115
  ```bash
1143
- super-dev onboard --host cline --force --yes
1116
+ super-dev
1144
1117
  ```
1145
1118
 
1146
1119
  触发位置：
@@ -1186,6 +1159,14 @@ super-dev: 你的需求
1186
1159
  ```text
1187
1160
  /super-dev 你的需求
1188
1161
  ```
1162
+ 比赛模式：
1163
+ ```text
1164
+ super-dev-seeai: 比赛需求
1165
+ ```
1166
+ 或
1167
+ ```text
1168
+ /super-dev-seeai 比赛需求
1169
+ ```
1189
1170
 
1190
1171
  插件提供 20 个专用 Tool：
1191
1172
 
@@ -1216,7 +1197,8 @@ super-dev: 你的需求
1216
1197
  1. 插件通过 CLI subprocess 桥接调用 `super-dev`，因此必须先 `pip install super-dev`。
1217
1198
  2. 安装后建议重启 OpenClaw Gateway 或新开会话，让 Plugin 和 Skill 生效。
1218
1199
  3. 插件内嵌 SKILL.md，OpenClaw Agent 会自动理解流水线协议。
1219
- 4. 使用 `super-dev doctor --host openclaw` 检查集成状态。
1200
+ 4. 比赛场景优先使用 `super-dev-seeai:` 或 `/super-dev-seeai`，按半小时节奏快速产出可演示作品。
1201
+ 5. 使用 `super-dev doctor --host openclaw` 检查集成状态。
1220
1202
 
1221
1203
  ---
1222
1204