super-dev 2.3.2__tar.gz → 2.3.4__tar.gz

{super_dev-2.3.2/super_dev.egg-info → super_dev-2.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: super-dev
-Version: 2.3.2
+Version: 2.3.4
 Summary: Super Dev - Pipeline AI Coding Assistant
 Author-email: Excellent <11964948@qq.com>
 License-Expression: MIT
@@ -60,7 +60,10 @@ Dynamic: license-file
 
 ## 版本
 
-当前版本：`2.3.2`
+当前版本：`2.3.4`
+
+- 发布说明：[v2.3.4 更新内容](docs/releases/2.3.4.md)
+- 官网更新历史：[superdev.goder.ai/changelog](https://superdev.goder.ai/changelog)
 
 ---
 
@@ -471,13 +474,13 @@ super-dev
 ### 3. 指定版本安装
 
 ```bash
-pip install super-dev==2.3.2
+pip install super-dev==2.3.4
 ```
 
 ### 4. GitHub 指定标签安装
 
 ```bash
-pip install git+https://github.com/shangyankeji/super-dev.git@v2.3.2
+pip install git+https://github.com/shangyankeji/super-dev.git@v2.3.4
 ```
 
 ### 5. 源码开发安装
@@ -648,7 +651,7 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 
 ## 架构概览
 
-Super Dev 2.3.2 架构由四层组成：**宿主接入层**（20 个统一接入宿主 + 1 个 OpenClaw 手动插件宿主）、**知识治理层**（306 索引 / 渐进式加载 / 自演化）、**编排引擎层**（9 阶段流水线 / 11 专家 / 验证规则引擎）、**交付审计层**（DORA 度量 / ADR / 一致性检测 / proof-pack）。
+Super Dev 2.3.4 架构由四层组成：**宿主接入层**（20 个统一接入宿主 + 1 个 OpenClaw 手动插件宿主）、**知识治理层**（306 索引 / 渐进式加载 / 自演化）、**编排引擎层**（9 阶段流水线 / 11 专家 + Overseer / 验证规则引擎）、**交付审计层**（DORA 度量 / ADR / 一致性检测 / proof-pack）。
 
 ### 一、系统高阶流转架构
 
@@ -1250,14 +1253,3 @@ super-dev: 你的需求
 ## License
 
 [MIT](LICENSE)
-## 2.3.2 更新重点
-
-- 21 个宿主口径继续收正：`20` 个统一接入宿主 + `1` 个 OpenClaw 手动插件宿主，安装脚本、README、官网 Docs、能力审计页和站点矩阵统一到同一套真实模型。
-- Claude Code / Codex 继续深适配到官方协议：`CLAUDE.md + skills + optional plugin enhancement`、`AGENTS.md + skills + repo plugin enhancement`，不再停留在旧的 commands-first / skill-only 近似模型。
-- Kiro / Qoder / Cursor / Trae / CodeBuddy 等 IDE 宿主继续按真实 surface 深适配，避免“代码一套、官网一套、安装引导又一套”的漂移。
-- 恢复链继续产品化：`resume / next / continue / doctor / validate / Web API` 统一带现实场景卡，`SESSION_BRIEF` 直接告诉用户“第二天回来继续开发 / 只想知道下一步 / 本地流程中断后恢复”该怎么做。
-- 工作流治理继续加固：`workflow history`、语义事件、hook history、workflow/framework/hook/operational harness、recent operational timeline 现在已经一起进入 proof-pack 和 release readiness。
-- 跨平台框架支持继续深化：`uni-app / Taro / React Native / Flutter / Desktop Web Shell` 的 framework playbook 现在不只进 UI 契约，也进入脚手架、runtime、quality gate、release readiness 和 proof-pack。
-- UI 系统继续强化：emoji 作为功能图标被系统级禁止，UI 契约、token、图标库、组件生态、导航骨架、主题入口、framework harness 一起纳入交付门禁。
-
----

{super_dev-2.3.2 → super_dev-2.3.4}/README.md

@@ -19,7 +19,10 @@
 
 ## 版本
 
-当前版本：`2.3.2`
+当前版本：`2.3.4`
+
+- 发布说明：[v2.3.4 更新内容](docs/releases/2.3.4.md)
+- 官网更新历史：[superdev.goder.ai/changelog](https://superdev.goder.ai/changelog)
 
 ---
 
@@ -430,13 +433,13 @@ super-dev
 ### 3. 指定版本安装
 
 ```bash
-pip install super-dev==2.3.2
+pip install super-dev==2.3.4
 ```
 
 ### 4. GitHub 指定标签安装
 
 ```bash
-pip install git+https://github.com/shangyankeji/super-dev.git@v2.3.2
+pip install git+https://github.com/shangyankeji/super-dev.git@v2.3.4
 ```
 
 ### 5. 源码开发安装
@@ -607,7 +610,7 @@ super-dev bootstrap --name my-project --platform web --frontend next --backend n
 
 ## 架构概览
 
-Super Dev 2.3.2 架构由四层组成：**宿主接入层**（20 个统一接入宿主 + 1 个 OpenClaw 手动插件宿主）、**知识治理层**（306 索引 / 渐进式加载 / 自演化）、**编排引擎层**（9 阶段流水线 / 11 专家 / 验证规则引擎）、**交付审计层**（DORA 度量 / ADR / 一致性检测 / proof-pack）。
+Super Dev 2.3.4 架构由四层组成：**宿主接入层**（20 个统一接入宿主 + 1 个 OpenClaw 手动插件宿主）、**知识治理层**（306 索引 / 渐进式加载 / 自演化）、**编排引擎层**（9 阶段流水线 / 11 专家 + Overseer / 验证规则引擎）、**交付审计层**（DORA 度量 / ADR / 一致性检测 / proof-pack）。
 
 ### 一、系统高阶流转架构
 
@@ -1209,14 +1212,3 @@ super-dev: 你的需求
 ## License
 
 [MIT](LICENSE)
-## 2.3.2 更新重点
-
-- 21 个宿主口径继续收正：`20` 个统一接入宿主 + `1` 个 OpenClaw 手动插件宿主，安装脚本、README、官网 Docs、能力审计页和站点矩阵统一到同一套真实模型。
-- Claude Code / Codex 继续深适配到官方协议：`CLAUDE.md + skills + optional plugin enhancement`、`AGENTS.md + skills + repo plugin enhancement`，不再停留在旧的 commands-first / skill-only 近似模型。
-- Kiro / Qoder / Cursor / Trae / CodeBuddy 等 IDE 宿主继续按真实 surface 深适配，避免“代码一套、官网一套、安装引导又一套”的漂移。
-- 恢复链继续产品化：`resume / next / continue / doctor / validate / Web API` 统一带现实场景卡，`SESSION_BRIEF` 直接告诉用户“第二天回来继续开发 / 只想知道下一步 / 本地流程中断后恢复”该怎么做。
-- 工作流治理继续加固：`workflow history`、语义事件、hook history、workflow/framework/hook/operational harness、recent operational timeline 现在已经一起进入 proof-pack 和 release readiness。
-- 跨平台框架支持继续深化：`uni-app / Taro / React Native / Flutter / Desktop Web Shell` 的 framework playbook 现在不只进 UI 契约，也进入脚手架、runtime、quality gate、release readiness 和 proof-pack。
-- UI 系统继续强化：emoji 作为功能图标被系统级禁止，UI 契约、token、图标库、组件生态、导航骨架、主题入口、framework harness 一起纳入交付门禁。
-
----

{super_dev-2.3.2 → super_dev-2.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "super-dev"
-version = "2.3.2"
+version = "2.3.4"
 description = "Super Dev - Pipeline AI Coding Assistant"
 readme = "README.md"
 requires-python = ">=3.10"

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/__init__.py

@@ -6,6 +6,6 @@
 最后修改：2025-12-30
 """
 
-__version__ = "2.3.2"
+__version__ = "2.3.4"
 __author__ = "Excellent"
 __description__ = "超级开发战队 - 一个宿主内 AI 开发治理与编排工具"

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/branding.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 LOGO_COMPACT = "Super Dev"
-VERSION = "2.3.2"
+VERSION = "2.3.4"
 
 # 阶段编号和名称映射
 PHASE_NAMES: dict[str, str] = {

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/catalogs.py

@@ -233,9 +233,12 @@ HOST_RUNTIME_VALIDATION_OVERRIDES: dict[str, dict[str, list[str]]] = {
             "确认项目根 `CLAUDE.md`、兼容 `.claude/CLAUDE.md`、项目级 `.claude/skills/super-dev/` 与用户级 `~/.claude/skills/` 已被当前会话重新加载。",
             "确认 `/super-dev` 直接进入 Super Dev，而不是普通聊天或旁路兼容命令面。",
             "确认改文档、补充、继续修改等自然语言仍留在当前 Super Dev 流程内。",
+            "若 execution_mode 为 plan-execute，确认 .super-dev/plans/ 目录可写且 PlanExecutor 已初始化。",
+            "若 codex_review_enabled 为 true，确认 codex CLI 可用（运行 which codex 验证）且 Overseer 已启用。",
         ],
         "pass_criteria": [
             "Claude Code 在 `CLAUDE.md + skills` 主模型下进入并保持同一条 Super Dev 流程，兼容 commands/agents 与可选 plugin enhancement 不会造成分叉。",
+            "Plan-Execute 模式下，每个阶段执行前有对应的 execution plan 文件。Overseer 审查报告在 .super-dev/overseer/ 中持续更新。",
         ],
         "resume_checklist": [
             "Claude Code 恢复时不能绕过当前确认门或返工门，并要确认重新打开的会话再次读取了 `CLAUDE.md + skills`。",
@@ -289,6 +292,7 @@ HOST_RUNTIME_VALIDATION_OVERRIDES: dict[str, dict[str, list[str]]] = {
             "确认 Codex App/Desktop 若在 `/` 列表里出现 `super-dev`，它被当作已启用 Skill 入口，而不是项目自定义 slash 文件。",
             "确认 `super-dev:` 仍可作为 AGENTS 驱动的自然语言回退入口，但不是 Codex 官方主触发面。",
             "确认会话没有先解释 skill 或退回普通聊天，而是直接进入 Super Dev 流程。",
+            "若被用于 Claude-Codex 混合模式审查，确认 codex --quiet --prompt 可正常执行。",
         ],
         "pass_criteria": [
             "重开 codex 后的新会话确实加载了项目 AGENTS.md、项目级 `.agents/skills/super-dev/`、全局 AGENTS 与官方 Skills，并识别 repo plugin enhancement。",

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/cli.py

@@ -198,26 +198,16 @@ class SuperDevCLI(
 
         if parsed_args.command is None:
             project_dir = Path.cwd()
-            if self._project_has_super_dev_context(project_dir):
-                resume_args = argparse.Namespace(json=False)
-                return self._cmd_resume(resume_args)
-
-            # Onboarding: show first-run guide if applicable
-            try:
-                from .onboarding import OnboardingGuide
 
-                guide = OnboardingGuide()
-                if guide.should_show(project_dir):
-                    guide.show(self.console)
-                    guide.mark_seen(project_dir)
-            except Exception:
-                pass
+            # Auto-migrate if project config is outdated
+            if self._project_has_super_dev_context(project_dir):
+                self._auto_migrate_if_needed(project_dir)
 
             install_args = argparse.Namespace(
                 host=None,
                 all=False,
                 auto=False,
-                skill_name="super-dev-core",
+                skill_name="super-dev",
                 no_skill=False,
                 skip_integrate=False,
                 skip_slash=False,
@@ -1785,6 +1775,31 @@ class SuperDevCLI(
             "framework_playbook": load_framework_playbook_summary(project_dir),
         }
 
+    def _auto_migrate_if_needed(self, project_dir: Path) -> None:
+        """检测项目配置版本，如果低于当前 CLI 版本则自动迁移。"""
+        try:
+            config_path = project_dir / "super-dev.yaml"
+            if not config_path.exists():
+                return
+            import yaml
+
+            data = yaml.safe_load(config_path.read_text(encoding="utf-8")) or {}
+            project_version = data.get("version", "")
+            if project_version == __version__:
+                return
+            self.console.print(
+                f"[yellow]检测到项目配置版本 {project_version or '未知'}，"
+                f"当前 CLI 版本 {__version__}，正在自动迁移...[/yellow]"
+            )
+            from .migrate import migrate_project
+
+            changes = migrate_project(project_dir)
+            for change in changes:
+                self.console.print(f"  [green]✓[/green] {change}")
+            self.console.print("")
+        except Exception:
+            pass
+
     def _project_has_super_dev_context(self, project_dir: Path) -> bool:
         """只有当前目录有 super-dev.yaml 且不是家目录才算 Super Dev 项目。"""
         project_dir = Path(project_dir).resolve()
@@ -4069,7 +4084,7 @@ class SuperDevCLI(
                         skill_path = skill_manager.install(
                             source="super-dev",
                             target=target,
-                            name="super-dev-core",
+                            name=skill_manager.default_skill_name(target),
                             force=True,
                         ).path
                         skill_install = {
@@ -4107,7 +4122,7 @@ class SuperDevCLI(
             report = self._collect_host_diagnostics(
                 project_dir=project_dir,
                 targets=targets,
-                skill_name="super-dev-core",
+                skill_name="super-dev",
                 check_integrate=True,
                 check_skill=True,
                 check_slash=True,
@@ -4411,7 +4426,7 @@ class SuperDevCLI(
             report = self._collect_host_diagnostics(
                 project_dir=project_dir,
                 targets=targets,
-                skill_name="super-dev-core",
+                skill_name="super-dev",
                 check_integrate=True,
                 check_skill=True,
                 check_slash=True,
@@ -4421,7 +4436,7 @@ class SuperDevCLI(
                 repair_actions = self._repair_host_diagnostics(
                     project_dir=project_dir,
                     report=report,
-                    skill_name="super-dev-core",
+                    skill_name="super-dev",
                     force=bool(args.force),
                     check_integrate=True,
                     check_skill=True,
@@ -4430,7 +4445,7 @@ class SuperDevCLI(
                 report = self._collect_host_diagnostics(
                     project_dir=project_dir,
                     targets=targets,
-                    skill_name="super-dev-core",
+                    skill_name="super-dev",
                     check_integrate=True,
                     check_skill=True,
                     check_slash=True,
@@ -4680,7 +4695,7 @@ class SuperDevCLI(
             report = self._collect_host_diagnostics(
                 project_dir=project_dir,
                 targets=targets,
-                skill_name="super-dev-core",
+                skill_name="super-dev",
                 check_integrate=True,
                 check_skill=True,
                 check_slash=True,

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/cli_governance_mixin.py

@@ -1013,11 +1013,11 @@ class CliGovernanceMixin:
     # ------------------------------------------------------------------
 
     def _cmd_migrate(self, _args: Any) -> int:
-        """执行项目迁移 (2.2.0+ -> 2.3.2)。"""
+        """执行项目迁移 (2.2.0+ -> 2.3.4)。"""
         from .migrate import migrate_project
 
         project_dir = Path.cwd()
-        self.console.print("[cyan]正在执行 2.2.0+ → 2.3.2 迁移...[/cyan]\n")
+        self.console.print("[cyan]正在执行 2.2.0+ → 2.3.4 迁移...[/cyan]\n")
 
         changes = migrate_project(project_dir)
 

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/cli_host_ops_mixin.py

@@ -731,6 +731,23 @@ class CliHostOpsMixin:
 
         return detected, details
 
+    # Families where IDE and CLI targets share the same config directories.
+    # When both are detected, prefer the CLI variant (more complete integration).
+    _HOST_FAMILIES: list[tuple[str, str]] = [
+        ("cursor-cli", "cursor"),
+        ("kiro-cli", "kiro"),
+        ("qoder-cli", "qoder"),
+        ("codebuddy-cli", "codebuddy"),
+    ]
+
+    def _deduplicate_host_family(self, detected: list[str]) -> list[str]:
+        """When both CLI and IDE variants of the same host are detected, keep only CLI."""
+        result = list(detected)
+        for cli_variant, ide_variant in self._HOST_FAMILIES:
+            if cli_variant in result and ide_variant in result:
+                result.remove(ide_variant)
+        return result
+
     def _collect_configured_host_targets(
         self,
         *,
@@ -808,7 +825,7 @@ class CliHostOpsMixin:
         report = self._collect_host_diagnostics(
             project_dir=project_dir,
             targets=candidate_targets,
-            skill_name="super-dev-core",
+            skill_name="super-dev",
             check_integrate=True,
             check_skill=True,
             check_slash=True,
@@ -1599,6 +1616,7 @@ class CliHostOpsMixin:
             host_actions: dict[str, str] = {}
             contract_needs_repair = "contract" in missing
             user_surfaces_need_repair = "user_surfaces" in missing
+            effective_skill_name = SkillManager.default_skill_name(target)
 
             if contract_needs_repair:
                 try:
@@ -1615,7 +1633,7 @@ class CliHostOpsMixin:
                         skill_manager.install(
                             source="super-dev",
                             target=target,
-                            name=skill_name,
+                            name=effective_skill_name,
                             force=True,
                         )
                     host_actions["contract"] = "refreshed"
@@ -1643,7 +1661,7 @@ class CliHostOpsMixin:
                         skill_manager.install(
                             source="super-dev",
                             target=target,
-                            name=skill_name,
+                            name=effective_skill_name,
                             force=True,
                         )
                         repaired_any = True
@@ -1662,7 +1680,7 @@ class CliHostOpsMixin:
                     skill_manager.install(
                         source="super-dev",
                         target=target,
-                        name=skill_name,
+                        name=effective_skill_name,
                         force=force,
                     )
                     host_actions["skill"] = "fixed"
@@ -1714,6 +1732,7 @@ class CliHostOpsMixin:
             targets = available_targets
         elif args.auto:
             targets, detected_meta = self._detect_host_targets(available_targets=available_targets)
+            targets = self._deduplicate_host_family(targets)
             if not targets:
                 self.console.print("[red]未检测到可用宿主，请改用 --host 指定或使用 --all[/red]")
                 self.console.print(f"[dim]{self._custom_host_path_override_hint()}[/dim]")
@@ -1840,16 +1859,17 @@ class CliHostOpsMixin:
                             "  [dim]- 未检测到官方或兼容 Skill 目录，已跳过宿主级 Skill 安装[/dim]"
                         )
                     else:
+                        target_skill_name = SkillManager.default_skill_name(target)
                         installed = set(skill_manager.list_installed(target))
-                        if args.skill_name in installed and not args.force:
+                        if target_skill_name in installed and not args.force:
                             self.console.print(
-                                f"  [dim]- Skill 已存在: {args.skill_name}（可加 --force 重装）[/dim]"
+                                f"  [dim]- Skill 已存在: {target_skill_name}（可加 --force 重装）[/dim]"
                             )
                         else:
                             install_result = skill_manager.install(
                                 source="super-dev",
                                 target=target,
-                                name=args.skill_name,
+                                name=target_skill_name,
                                 force=args.force,
                             )
                             if detail:
@@ -1859,12 +1879,35 @@ class CliHostOpsMixin:
                                 )
                             else:
                                 self.console.print("  [green]✓[/green] Skill: 已安装")
+                        # Clean up legacy super-dev-core for hosts that now use super-dev
+                        if target_skill_name == "super-dev" and "super-dev-core" in installed:
+                            try:
+                                skill_manager.uninstall("super-dev-core", target)
+                                self.console.print(
+                                    "  [green]✓[/green] 已清理旧版 super-dev-core（统一为 super-dev）"
+                                )
+                            except Exception:
+                                pass
                 except Exception as exc:
                     has_error = True
                     self.console.print(f"  [red]✗[/red] Skill 安装失败: {exc}")
             elif not args.skip_skill:
                 self.console.print("  [dim]- 该宿主默认按项目规则运行，已跳过 Skill 安装[/dim]")
 
+            # Clean up legacy agent file for Claude Code
+            if target == "claude-code":
+                legacy_agent = Path.home() / ".claude" / "agents" / "super-dev-core.md"
+                project_agent = project_dir / ".claude" / "agents" / "super-dev-core.md"
+                for legacy_path in [legacy_agent, project_agent]:
+                    if legacy_path.exists():
+                        try:
+                            legacy_path.unlink()
+                            self.console.print(
+                                f"  [green]✓[/green] 已清理旧版: {legacy_path.name}"
+                            )
+                        except Exception:
+                            pass
+
             if not args.skip_slash:
                 try:
                     if integration_manager.supports_slash(target):
@@ -2666,7 +2709,7 @@ class CliHostOpsMixin:
                 host=target,
                 all=False,
                 auto=False,
-                skill_name="super-dev-core",
+                skill_name="super-dev",
                 skip_integrate=False,
                 skip_skill=False,
                 skip_slash=False,
@@ -3153,13 +3196,30 @@ class CliHostOpsMixin:
 
         from rich.panel import Panel
 
+        self.console.print("")
+        self.console.print("[green]✓ 升级完成[/green]")
+
+        # Auto-migrate using the newly installed version (new process)
+        self.console.print("[cyan]正在自动迁移宿主配置到新版...[/cyan]")
+        try:
+            from . import cli as cli_module
+
+            migrate_result = cli_module.subprocess.run(
+                ["super-dev", "migrate"], check=False
+            )
+            if migrate_result.returncode == 0:
+                self.console.print("[green]✓ 宿主配置已迁移到新版[/green]")
+            else:
+                self.console.print("[yellow]自动迁移未完成，可手动执行: super-dev migrate[/yellow]")
+        except Exception:
+            self.console.print("[yellow]自动迁移未执行，可手动执行: super-dev migrate[/yellow]")
+
         self.console.print("")
         self.console.print(
             Panel(
                 "[bold green]升级完成[/bold green]\n\n"
-                "  [bold]请关闭当前终端，重新打开后再使用 super-dev[/bold]\n\n"
-                "  [dim]当前进程仍加载旧版本代码，必须重启终端才能生效[/dim]\n"
-                "  [dim]验证: super-dev --version[/dim]",
+                "  [dim]当前终端进程仍加载旧版代码[/dim]\n"
+                "  [dim]建议重开终端后使用，验证: super-dev --version[/dim]",
                 border_style="green",
                 expand=True,
                 padding=(1, 2),

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/cli_parser_mixin.py

@@ -1887,7 +1887,7 @@ class CliParserMixin:
         subparsers.add_parser(
             "migrate",
             help="迁移项目到最新版本",
-            description="将 2.2.0+ 项目配置迁移到 2.3.2（更新配置、规则文件与 hooks）",
+            description="将 2.2.0+ 项目配置迁移到 2.3.4（更新配置、规则文件与 hooks）",
         )
 
         return parser

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/config/manager.py

@@ -27,7 +27,7 @@ class ProjectConfig:
 
     name: str
     description: str = ""
-    version: str = "2.3.2"
+    version: str = "2.3.4"
     author: str = ""
     license: str = "MIT"
 
@@ -67,6 +67,16 @@ class ProjectConfig:
     host_profile_targets: list[str] = field(default_factory=list)  # 目标宿主画像（用于质量门禁和运营看板）
     host_profile_enforce_selected: bool = False  # 仅按 host_profile_targets 计算宿主兼容性
 
+    # Plan-Execute 与 Overseer 配置
+    execution_mode: str = "standard"  # standard | plan-execute
+    overseer_enabled: bool = False  # 启用 Overseer 质量监督
+    codex_review_enabled: bool = False  # 启用 Codex 独立审查（Claude-Codex 混合模式）
+    codex_review_phases: list[str] = field(default_factory=lambda: [
+        "drafting", "redteam", "qa"
+    ])  # 哪些阶段触发 Codex 审查
+    overseer_halt_on_critical: bool = True  # Overseer 发现 Critical 偏差时暂停流水线
+    plan_failure_budget: int = 3  # Plan-Execute 步骤默认失败预算
+
     # 输出目录
     output_dir: str = "output"
 
@@ -81,7 +91,7 @@ class ConfigManager:
     DEFAULT_CONFIG: dict[str, Any] = {
         "name": "my-project",
         "description": "A Super Dev project",
-        "version": "2.3.2",
+        "version": "2.3.4",
         "platform": "web",
         "frontend": "next",  # 默认使用 Next.js
         "backend": "node",
@@ -95,6 +105,12 @@ class ConfigManager:
         "host_compatibility_min_ready_hosts": 1,
         "host_profile_targets": [],
         "host_profile_enforce_selected": False,
+        "execution_mode": "standard",
+        "overseer_enabled": False,
+        "codex_review_enabled": False,
+        "codex_review_phases": ["drafting", "redteam", "qa"],
+        "overseer_halt_on_critical": True,
+        "plan_failure_budget": 3,
         "output_dir": "output",
         # 前端配置
         "ui_library": None,
@@ -211,6 +227,7 @@ class ConfigManager:
             "knowledge_cache_ttl_seconds": int,
             "host_compatibility_min_score": int,
             "host_compatibility_min_ready_hosts": int,
+            "plan_failure_budget": int,
         }
 
         # 转换类型
@@ -235,6 +252,23 @@ class ConfigManager:
                 lowered = value.strip().lower()
                 converted_kwargs[key] = lowered in {"1", "true", "yes", "y", "on"}
                 continue
+            if key == "overseer_enabled" and isinstance(value, str):
+                lowered = value.strip().lower()
+                converted_kwargs[key] = lowered in {"1", "true", "yes", "y", "on"}
+                continue
+            if key == "codex_review_enabled" and isinstance(value, str):
+                lowered = value.strip().lower()
+                converted_kwargs[key] = lowered in {"1", "true", "yes", "y", "on"}
+                continue
+            if key == "overseer_halt_on_critical" and isinstance(value, str):
+                lowered = value.strip().lower()
+                converted_kwargs[key] = lowered in {"1", "true", "yes", "y", "on"}
+                continue
+            if key == "codex_review_phases" and isinstance(value, str):
+                converted_kwargs[key] = [
+                    item.strip() for item in value.split(",") if item.strip()
+                ]
+                continue
             if key in type_converters and isinstance(value, str):
                 try:
                     converted_kwargs[key] = type_converters[key](value)
@@ -337,6 +371,13 @@ class ConfigManager:
                     + ", ".join(sorted(set(unsupported_targets)))
                 )
 
+        # 验证执行模式
+        valid_execution_modes = ("standard", "plan-execute")
+        if config.execution_mode not in valid_execution_modes:
+            errors.append(f"execution_mode 必须是: {', '.join(valid_execution_modes)}")
+        if config.plan_failure_budget < 1:
+            errors.append("plan_failure_budget 不能小于 1")
+
         # 验证知识增强配置
         if config.knowledge_cache_ttl_seconds < 0:
             errors.append("knowledge_cache_ttl_seconds 不能小于 0")
@@ -374,6 +415,8 @@ class ConfigManager:
         "backend": {"type": "str", "required": True, "allowed": list(PIPELINE_BACKEND_IDS)},
         "database": {"type": "str", "required": False, "allowed": ["postgresql", "mysql", "mongodb", "redis", "sqlite", ""]},
         "quality_gate": {"type": "int", "required": False, "min": 0, "max": 100},
+        "execution_mode": {"type": "str", "required": False, "allowed": ["standard", "plan-execute"]},
+        "plan_failure_budget": {"type": "int", "required": False, "min": 1, "max": 10},
         "host_compatibility_min_score": {"type": "int", "required": False, "min": 0, "max": 100},
         "host_compatibility_min_ready_hosts": {"type": "int", "required": False, "min": 0},
         "knowledge_cache_ttl_seconds": {"type": "int", "required": False, "min": 0},
@@ -529,9 +572,23 @@ class ConfigManager:
             "transforms": {},
             "removals": ["deprecated_field"],
         },
+        {
+            "from_version": "2.2",
+            "to_version": "2.3",
+            "description": "从 v2.2 迁移到 v2.3：新增 Plan-Execute、Overseer 和 Claude-Codex 混合模式配置",
+            "transforms": {
+                "execution_mode": lambda data: data.get("execution_mode", "standard"),
+                "overseer_enabled": lambda data: data.get("overseer_enabled", False),
+                "codex_review_enabled": lambda data: data.get("codex_review_enabled", False),
+                "codex_review_phases": lambda data: data.get("codex_review_phases", ["drafting", "redteam", "qa"]),
+                "overseer_halt_on_critical": lambda data: data.get("overseer_halt_on_critical", True),
+                "plan_failure_budget": lambda data: data.get("plan_failure_budget", 3),
+            },
+            "removals": [],
+        },
     ]
 
-    def migrate_config(self, target_version: str = "2.3.2") -> tuple[bool, list[str]]:
+    def migrate_config(self, target_version: str = "2.3.4") -> tuple[bool, list[str]]:
         """
         将配置文件从当前版本迁移到目标版本。
 

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/creators/document_generator.py

@@ -226,7 +226,7 @@ class DocumentGenerator(DocumentGeneratorContentMixin):
         doc = f"""# {self.name} - 产品需求文档 (PRD)
 
 > **生成时间**: {datetime.now().strftime('%Y-%m-%d %H:%M')}
-> **版本**: v2.3.2
+> **版本**: v2.3.4
 > **状态**: 草稿
 
 ---
@@ -470,7 +470,7 @@ class DocumentGenerator(DocumentGeneratorContentMixin):
 
 | 版本 | 日期 | 变更内容 | 作者 |
 |:---|:---|:---|:---|
-| v2.3.2 | {datetime.now().strftime('%Y-%m-%d')} | 初始版本 | Super Dev |
+| v2.3.4 | {datetime.now().strftime('%Y-%m-%d')} | 初始版本 | Super Dev |
 """
 
         # 追加 Prompt 模板版本标记
@@ -488,7 +488,7 @@ class DocumentGenerator(DocumentGeneratorContentMixin):
         doc = f"""# {self.name} - 架构设计文档
 
 > **生成时间**: {datetime.now().strftime('%Y-%m-%d %H:%M')}
-> **版本**: v2.3.2
+> **版本**: v2.3.4
 > **架构师**: Super Dev ARCHITECT 专家
 
 ---
@@ -944,7 +944,7 @@ jobs:
         doc_parts.append(f"""# {self.name} - UI/UX 设计文档
 
 > **生成时间**: {datetime.now().strftime('%Y-%m-%d %H:%M')}
-> **版本**: v2.3.2
+> **版本**: v2.3.4
 > **设计师**: Super Dev UI/UX 专家
 
 ---

{super_dev-2.3.2 → super_dev-2.3.4}/super_dev/deployers/delivery.py

@@ -26,7 +26,7 @@ class ArtifactSpec:
 class DeliveryPackager:
     """交付包生成器"""
 
-    def __init__(self, project_dir: Path, name: str, version: str = "2.3.2"):
+    def __init__(self, project_dir: Path, name: str, version: str = "2.3.4"):
         self.project_dir = Path(project_dir).resolve()
         self.name = name
         self.version = version