super-engineer-workflow 0.1.2 → 0.1.5

package/super-engineer-workflow/references/workflow.md

@@ -161,7 +161,9 @@ OpenSpec change 名称必须通过 `/se:propose <change-name>` 显式指定。
 - `/se:verify` 通过后状态为 `verified`，只允许 `/se:archive-check`
 - `/se:archive-check` 通过后状态为 `archive_ready`，只允许 `/se:archive`
 - 所有阶段推进必须先通过 `run-workflow.py validate-state <command>` 等价校验，不能只依赖 AI 回复
-- 每次执行 `plan` 都必须创建新的 `session_id`
+- `plan` 只有在没有有效计划会话、当前会话已完成/归档/阻塞，或当前会话失效时才创建新的 `session_id`
+- 如果当前 session 已有 `plan.json` 且仍停留在计划确认阶段，重复执行 `plan` 必须复用当前 session，不能创建新 session
+- 如果当前 session 已进入 `implement`、`self_check`、`review`、`verify` 等交付阶段，重复执行 `plan` 必须被脚本拒绝
 - 新会话不能覆盖历史会话目录
 - `current-session.json` 只指向当前正在推进的会话
 - 后续 `start-implement`、`finish-implement`、`review`、`verify`、`status` 都基于当前会话执行

package/super-engineer-workflow/scripts/common.py

@@ -665,6 +665,47 @@ def current_session_meta(config: dict[str, Any]) -> dict[str, Any]:
     return normalized
 
 
+def current_session_status(config: dict[str, Any], session_meta: dict[str, Any] | None = None) -> dict[str, Any]:
+    meta = session_meta or current_session_meta(config)
+    status = read_json(data_artifact_path(config, "status.json", meta), {})
+    return status if isinstance(status, dict) else {}
+
+
+def active_session_for_plan(config: dict[str, Any]) -> dict[str, Any] | None:
+    if current_session_is_stale(config):
+        return None
+    try:
+        session_meta = current_session_meta(config)
+    except FileNotFoundError:
+        return None
+    if not data_artifact_path(config, "plan.json", session_meta).exists():
+        return None
+    status = current_session_status(config, session_meta)
+    status_phase = str(status.get("phase", "") or "").strip()
+    if status_phase in ("done", "archived", "blocked"):
+        return None
+    return {
+        "session": session_meta,
+        "status": status,
+        "phase": status_phase or "plan",
+    }
+
+
+def ensure_plan_can_run(config: dict[str, Any]) -> dict[str, Any] | None:
+    active = active_session_for_plan(config)
+    if not active:
+        return None
+    phase = str(active.get("phase", "")).strip()
+    session = active.get("session", {})
+    if phase in ("plan", "wait_confirm_plan"):
+        return active
+    raise RuntimeError(
+        f"当前已有活跃 session 正在交付中，禁止重新执行 /se:plan："
+        f"session_id={session.get('session_id', '')}, phase={phase}。"
+        "请继续当前 /se:apply 链路，不要创建新的 plan/session。"
+    )
+
+
 def data_artifact_path(config: dict[str, Any], name: str, session_meta: dict[str, Any] | None = None) -> Path:
     meta = _normalize_session_meta(config, session_meta or current_session_meta(config))
     return Path(meta["data_dir"]) / name
@@ -1016,6 +1057,8 @@ def validate_se_state(config: dict[str, Any], run_command: str) -> dict[str, Any
         elif run_command in ("plan", "apply"):
             if not todo_path(config).exists():
                 errors.append("缺少 todo_file，请先执行 /se:init 或补充 todo.md。")
+            if run_command == "plan" and phase in ("implementing", "self_checked", "reviewed"):
+                errors.append("当前已有活跃 session 正在交付中，不能重新执行 /se:plan。请继续当前 /se:apply、/se:review 或 /se:verify。")
         elif run_command == "start-implement":
             if phase not in ("planned", "implementing", "blocked"):
                 errors.append("当前状态不允许进入实现，请先执行 /se:plan。")
@@ -1065,7 +1108,16 @@ def validate_se_state(config: dict[str, Any], run_command: str) -> dict[str, Any
         for key in ("proposal", "design", "tasks"):
             if not _se_state_artifact_exists(str(artifacts.get(key, ""))):
                 errors.append(f"缺少 OpenSpec 产物：{key}")
-    elif se_command in ("/se:plan", "/se:apply"):
+    elif se_command == "/se:plan":
+        if phase not in ("bridged", "planned", "blocked") and se_command not in allowed_next:
+            errors.append("当前状态不允许重新计划，请先完成 /se:bridge，或继续当前活跃交付会话。")
+        if phase in ("implementing", "self_checked", "reviewed", "verified"):
+            errors.append("当前已有活跃 session 正在交付中，不能重新执行 /se:plan。请继续当前 /se:apply、/se:review 或 /se:verify。")
+        if phase == "proposed":
+            errors.append("/se:propose 后不能直接进入交付，必须先执行 /se:bridge。")
+        if not _se_state_artifact_exists(str(artifacts.get("todo", ""))):
+            errors.append("缺少桥接 todo.md，请先执行 /se:bridge。")
+    elif se_command == "/se:apply":
         if phase not in ("bridged", "planned", "implementing", "reviewed", "blocked") and se_command not in allowed_next:
             errors.append("当前状态不允许进入交付，请先完成 /se:bridge 并人工审核 todo.md。")
         if phase == "proposed":
@@ -1151,6 +1203,54 @@ def file_sha256(path: Path) -> str:
     return hashlib.sha256(path.read_bytes()).hexdigest()
 
 
+def markdown_headings(text: str, limit: int = 16) -> list[str]:
+    headings: list[str] = []
+    for line in text.splitlines():
+        stripped = line.strip()
+        if stripped.startswith("#"):
+            headings.append(stripped[:160])
+        if len(headings) >= limit:
+            break
+    return headings
+
+
+def compact_text_excerpt(text: str, keywords: list[str] | None = None, max_chars: int = 6000) -> str:
+    normalized = text.strip()
+    if len(normalized) <= max_chars:
+        return normalized
+
+    keywords = [item.lower() for item in (keywords or []) if item]
+    lines = normalized.splitlines()
+    selected: list[str] = []
+    selected.extend(lines[:60])
+    for index, line in enumerate(lines):
+        lowered = line.lower()
+        if keywords and not any(keyword in lowered for keyword in keywords):
+            continue
+        start = max(0, index - 2)
+        end = min(len(lines), index + 3)
+        selected.append("")
+        selected.extend(lines[start:end])
+        if len("\n".join(selected)) >= max_chars:
+            break
+    excerpt = "\n".join(selected).strip()
+    if len(excerpt) > max_chars:
+        excerpt = excerpt[:max_chars].rstrip()
+    return excerpt + "\n\n...[已摘要，按需读取原文件全文]..."
+
+
+def summarize_markdown_file(path: Path, keywords: list[str] | None = None, max_excerpt_chars: int = 6000) -> dict[str, Any]:
+    text = read_text(path)
+    return {
+        "path": str(path.resolve()),
+        "bytes": path.stat().st_size if path.exists() else 0,
+        "sha256": file_sha256(path),
+        "headings": markdown_headings(text),
+        "excerpt": compact_text_excerpt(text, keywords=keywords, max_chars=max_excerpt_chars),
+        "truncated": len(text.strip()) > max_excerpt_chars,
+    }
+
+
 def write_text(path: Path, content: str) -> None:
     path.parent.mkdir(parents=True, exist_ok=True)
     path.write_text(content, encoding="utf-8")
@@ -1627,6 +1727,8 @@ def build_openspec_bridge_context(config: dict[str, Any], tasks_text: str) -> di
         "spec_reference_files": specs,
         "proposal_headings": extract_headings(proposal_text),
         "design_headings": extract_headings(design_text),
+        "proposal_excerpt": compact_text_excerpt(proposal_text, max_chars=3000) if proposal_text else "",
+        "design_excerpt": compact_text_excerpt(design_text, max_chars=3000) if design_text else "",
         "business_constraints": [
             f"需求来源是 OpenSpec change：{openspec.get('change_name', '')}",
             "优先以 proposal.md、design.md 和 specs/ 下的 delta specs 作为业务边界",

package/super-engineer-workflow/scripts/generate-review-report.py

@@ -64,6 +64,22 @@ def diff_summary(workspace: Path) -> list[str]:
     return lines
 
 
+def compact_lines(lines: list[str], limit: int = 80) -> list[str]:
+    if len(lines) <= limit:
+        return lines
+    head = max(1, limit // 2)
+    tail = max(1, limit - head)
+    return lines[:head] + [f"... 已省略 {len(lines) - limit} 行，详见 git diff。"] + lines[-tail:]
+
+
+def read_plan_context(config: dict, session_meta: dict) -> dict:
+    summary = read_json(data_artifact_path(config, "plan-summary.json", session_meta), {})
+    if summary:
+        summary["compact"] = True
+        return summary
+    return read_json(data_artifact_path(config, "plan.json", session_meta), {})
+
+
 def find_tests(files: list[str]) -> list[str]:
     return [item for item in files if item.endswith("Test.java") or "/test/" in item]
 
@@ -217,7 +233,7 @@ def main() -> None:
     workspace = workspace_root(Path(args.workspace).expanduser() if args.workspace else None)
     config = load_workspace_config(workspace)
     session_meta = current_session_meta(config)
-    plan = read_json(data_artifact_path(config, "plan.json", session_meta), {})
+    plan = read_plan_context(config, session_meta)
     codebases = planned_codebases(config, session_meta)
     target_plans = plan.get("target_codebases", [])
     target_map = {str(item.get("path")): item for item in target_plans}
@@ -230,7 +246,7 @@ def main() -> None:
         plan_files = target_plan.get("impacted_files", [])
         if is_git_repo(codebase):
             changed = changed_files(codebase)
-            summary = diff_summary(codebase)
+            summary = compact_lines(diff_summary(codebase))
             repo_mode = "git"
         else:
             changed = plan_files

package/super-engineer-workflow/scripts/generate-self-check.py

@@ -139,7 +139,7 @@ def main() -> None:
     workspace = workspace_root(Path(args.workspace).expanduser() if args.workspace else None)
     config = load_workspace_config(workspace)
     session_meta = current_session_meta(config)
-    plan = read_json(data_artifact_path(config, "plan.json", session_meta), {})
+    plan = read_json(data_artifact_path(config, "plan-summary.json", session_meta), {}) or read_json(data_artifact_path(config, "plan.json", session_meta), {})
 
     sections: list[dict] = []
     for codebase in planned_codebases(config, session_meta):

package/super-engineer-workflow/scripts/generate-smart-plan.py

@@ -266,6 +266,29 @@ def build_plan_markdown(plan: dict) -> str:
     return "\n".join(lines)
 
 
+def build_plan_summary(plan: dict) -> dict[str, object]:
+    return {
+        "session_id": plan.get("session_id", ""),
+        "source": "run-workflow.py plan-summary",
+        "schema_version": 1,
+        "requirement_summary": plan.get("requirement_summary", ""),
+        "target_codebases": [
+            {
+                "name": item.get("name", ""),
+                "path": item.get("path", ""),
+                "verify_command": (item.get("detected_project") or {}).get("verify_command", ""),
+            }
+            for item in plan.get("target_codebases", [])
+        ],
+        "impacted_files": plan.get("impacted_files", [])[:80],
+        "change_steps": plan.get("change_steps", [])[:20],
+        "acceptance_criteria": plan.get("acceptance_criteria", [])[:40],
+        "test_plan": plan.get("test_plan", [])[:20],
+        "risks": plan.get("risks", [])[:10],
+        "unknowns": plan.get("unknowns", [])[:10],
+    }
+
+
 def collect_target_plan_data(config: dict, codebases: list[Path]) -> tuple[list[dict], list[str], list[str]]:
     targets: list[dict] = []
     all_impacted_files: list[str] = []
@@ -404,6 +427,7 @@ def main() -> None:
     }
 
     write_managed_json(config, data_artifact_path(config, "plan.json", session_meta), plan)
+    write_managed_json(config, data_artifact_path(config, "plan-summary.json", session_meta), build_plan_summary(plan))
     write_managed_text(config, report_artifact_path(config, "plan.md", session_meta), build_plan_markdown(plan) + "\n")
 
     status = ensure_status(config, session_meta, read_json(data_artifact_path(config, "status.json", session_meta), {}))

package/super-engineer-workflow/scripts/propose-openspec.py

@@ -12,9 +12,9 @@ from common import (
     openspec_cli_available,
     openspec_writeback_dir,
     read_demand_source,
-    read_text,
     run_openspec_cli,
     select_openspec_change,
+    summarize_markdown_file,
     update_se_state,
     validate_openspec_change_name,
     workflow_source,
@@ -51,11 +51,9 @@ def main() -> None:
         raise SystemExit(str(error))
     demand_file = str(demand_source.get("source", "")).strip()
     demand_text = str(demand_source.get("content", "")).strip()
+    demand_keywords = [item for item in [change_name, *change_name.replace("-", " ").split()] if item]
     reference_contexts = [
-        {
-            "path": item,
-            "content": read_text(Path(item)),
-        }
+        summarize_markdown_file(Path(item), keywords=demand_keywords)
         for item in existing_reference_files(config)
     ]
 
@@ -92,15 +90,16 @@ def main() -> None:
         "demand_file": demand_file,
         "demand_source_type": demand_source.get("source_type", ""),
         "demand_fetch_command": demand_source.get("command", []),
-        "demand_text": demand_text,
+        "demand_text_available_at": demand_file,
+        "demand_excerpt": demand_text[:12000] + ("\n\n...[已摘要，按需读取 demand_file 全文]..." if len(demand_text) > 12000 else ""),
         "reference_files": reference_contexts,
         "openspec_cli_available": openspec_cli_available(),
         "commands": commands,
-        "next_action": "Use demand_text, reference_files, and OpenSpec instructions to create or update proposal.md, design.md, tasks.md, and specs/.",
+        "next_action": "Use demand_excerpt, reference file summaries, and OpenSpec instructions to create or update proposal.md, design.md, tasks.md, and specs/. Read full source files only when necessary.",
         "workflow_phase_after_completion": "proposed",
         "allowed_next_after_completion": ["/se:bridge"],
         "forbidden_next_after_completion": ["/se:plan", "/se:apply"],
-        "final_reply_constraint": "代码暂未修改。下一步只能执行 /se:bridge，把当前 OpenSpec tasks.md 桥接为待审核 todo.md。",
+        "final_reply_constraint": "代码未修改。下一步只能执行 /se:bridge。",
     }
     write_managed_json(config, writeback_dir / "propose-input.json", payload)
     write_managed_text(
@@ -119,7 +118,7 @@ def main() -> None:
                 "",
                 "## Demand",
                 "",
-                demand_text or "未配置或未找到 demand_file。",
+                payload["demand_excerpt"] or "未配置或未找到 demand_file。",
                 "",
                 "## Reference Files",
                 "",
@@ -129,7 +128,17 @@ def main() -> None:
                             [
                                 f"### {item['path']}",
                                 "",
-                                item["content"] or "文件为空或无法读取。",
+                                f"- bytes: {item.get('bytes', 0)}",
+                                f"- sha256: {item.get('sha256', '')}",
+                                f"- truncated: {item.get('truncated', False)}",
+                                "",
+                                "#### Headings",
+                                "",
+                                "\n".join(f"- {heading}" for heading in item.get("headings", [])) or "暂无标题",
+                                "",
+                                "#### Excerpt",
+                                "",
+                                item.get("excerpt", "") or "文件为空或无法读取。",
                             ]
                         )
                         for item in reference_contexts
@@ -163,7 +172,7 @@ def main() -> None:
     print("workflow_phase_after_completion=proposed")
     print("allowed_next_after_completion=/se:bridge")
     print("forbidden_next_after_completion=/se:plan,/se:apply")
-    print("final_reply_must=代码暂未修改。下一步只能执行 /se:bridge，把当前 OpenSpec tasks.md 桥接为待审核 todo.md。")
+    print("final_reply_must=代码未修改。下一步只能执行 /se:bridge。")
 
 
 if __name__ == "__main__":

package/super-engineer-workflow/scripts/run-verify-and-report.py

@@ -28,6 +28,29 @@ from common import (
     workspace_root,
 )
 
+
+MAX_VERIFY_LOG_CHARS = 12000
+
+
+def compact_command_output(text: str, max_chars: int = MAX_VERIFY_LOG_CHARS) -> str:
+    if len(text) <= max_chars:
+        return text
+    head = max_chars // 2
+    tail = max_chars - head
+    omitted = len(text) - max_chars
+    return text[:head].rstrip() + f"\n\n...[已省略 {omitted} 字符]...\n\n" + text[-tail:].lstrip()
+
+
+def compact_command_records(value):
+    if isinstance(value, dict):
+        return {
+            key: compact_command_output(item) if key in ("stdout", "stderr", "output", "logs") and isinstance(item, str) else compact_command_records(item)
+            for key, item in value.items()
+        }
+    if isinstance(value, list):
+        return [compact_command_records(item) for item in value]
+    return value
+
 VERIFY_BLOCKERS = {"未识别到验证命令", "验证失败", "验证执行超时"}
 
 
@@ -248,7 +271,7 @@ def main() -> None:
     workspace = workspace_root(Path(args.workspace).expanduser() if args.workspace else None)
     config = load_workspace_config(workspace)
     session_meta = current_session_meta(config)
-    plan = read_json(data_artifact_path(config, "plan.json", session_meta), {})
+    plan = read_json(data_artifact_path(config, "plan-summary.json", session_meta), {}) or read_json(data_artifact_path(config, "plan.json", session_meta), {})
     status_path = data_artifact_path(config, "status.json", session_meta)
     existing_status = ensure_status(config, session_meta, read_json(status_path, {}))
     if (
@@ -319,8 +342,8 @@ def main() -> None:
                     "result": repo_result,
                     "exit_code": str(result.returncode),
                     "duration": repo_duration,
-                    "stdout": result.stdout,
-                    "stderr": result.stderr,
+                    "stdout": compact_command_output(result.stdout),
+                    "stderr": compact_command_output(result.stderr),
                 }
             )
             if repo_result != "通过":
@@ -363,8 +386,8 @@ def main() -> None:
                 "result": "超时",
                 "exit_code": "timeout",
                 "duration": duration,
-                "stdout": error.stdout or "",
-                "stderr": error.stderr or "",
+                "stdout": compact_command_output(error.stdout or ""),
+                "stderr": compact_command_output(error.stderr or ""),
             }
         )
         status_for_duration = ensure_status(config, session_meta, read_json(status_path, {}))

package/super-engineer-workflow/scripts/run-workflow.py

@@ -11,6 +11,7 @@ from common import (
     current_session_is_stale,
     current_session_meta,
     data_artifact_path,
+    ensure_plan_can_run,
     ensure_status,
     load_workspace_config,
     now_iso,
@@ -40,19 +41,19 @@ SE_ROUTE_REPLY_CONSTRAINTS: dict[str, dict[str, str]] = {
         "phase": "proposed",
         "allowed_next": "/se:bridge",
         "forbidden_next": "/se:plan,/se:apply",
-        "final_reply_must": "代码暂未修改。下一步只能执行 /se:bridge，把当前 OpenSpec tasks.md 桥接为待审核 todo.md。",
+        "final_reply_must": "代码未修改。下一步只能执行 /se:bridge。",
     },
     "/se:bridge": {
         "phase": "bridged",
         "allowed_next": "人工审核 todo.md 后 /se:apply",
         "forbidden_next": "自动执行 /se:plan,自动执行 /se:apply,代码实现",
-        "final_reply_must": "桥接 todo 已生成。请先人工审核 todo.md，审核通过后再发送 /se:apply。",
+        "final_reply_must": "桥接 todo 已生成。请审核 todo.md，审核通过后发送 /se:apply。",
     },
     "/se:plan": {
         "phase": "planned",
         "allowed_next": "/se:apply",
         "forbidden_next": "代码实现,review,verify",
-        "final_reply_must": "计划已生成。下一步只有在确认计划后执行 /se:apply。",
+        "final_reply_must": "计划已生成。下一步执行 /se:apply。",
     },
 }
 
@@ -287,9 +288,22 @@ def command_archive_openspec(workspace: Path | None) -> None:
 def command_plan(workspace: Path | None) -> None:
     config = load_workspace_config(workspace)
     require_se_state(config, "plan")
+    try:
+        active = ensure_plan_can_run(config)
+    except RuntimeError as error:
+        raise SystemExit(str(error))
+    if active:
+        session = active.get("session", {})
+        print("session_action=reused")
+        print(f"session_id={session.get('session_id', '')}")
+        print(f"phase={active.get('phase', '')}")
+        print("next_action=当前计划已存在，继续执行 /se:apply。")
+        return
     command_init(workspace)
     config = load_workspace_config(workspace)
-    create_session(config)
+    session_meta = create_session(config)
+    print("session_action=created")
+    print(f"session_id={session_meta.get('session_id', '')}")
     command_discover(workspace)
     args = ["--workspace", str(workspace)] if workspace else []
     run_python("generate-smart-plan.py", args)

package/super-engineer-workflow/scripts/writeback-openspec.py

@@ -223,6 +223,14 @@ def build_markdown(payload: dict) -> str:
     return "\n".join(lines)
 
 
+def read_plan_context(config: dict, session_meta: dict) -> dict:
+    summary = read_json(data_artifact_path(config, "plan-summary.json", session_meta), {})
+    if summary:
+        summary["compact"] = True
+        return summary
+    return read_json(data_artifact_path(config, "plan.json", session_meta), {})
+
+
 def main() -> None:
     parser = argparse.ArgumentParser(description="把当前会话执行结果回写到 OpenSpec change 目录。")
     parser.add_argument("--workspace", help="工作空间路径，默认读取当前目录")
@@ -234,7 +242,7 @@ def main() -> None:
         raise SystemExit("当前 workspace.yml 未启用 OpenSpec 模式，无需执行 writeback-openspec。")
 
     session_meta = current_session_meta(config)
-    plan = read_json(data_artifact_path(config, "plan.json", session_meta), {})
+    plan = read_plan_context(config, session_meta)
     review = read_json(data_artifact_path(config, "review.json", session_meta), {})
     verify = read_json(data_artifact_path(config, "verify.json", session_meta), {})
     status = read_json(data_artifact_path(config, "status.json", session_meta), {})

package/templates/workspaces/frontend.yml

@@ -0,0 +1,18 @@
+version: 1
+mode: auto
+workflow_source: openspec
+vars:
+  demand_name: __DEMAND_NAME__
+demand_file: superengineer/${demand_name}/需求.md
+todo_file: superengineer/${demand_name}/todo.md
+reference_files:
+  - docs/需求分析与实现指南.md
+  - docs/前端规范.md
+code_path: __CODE_PATH__
+output_dir: superengineer/${demand_name}/output
+openspec:
+  changes_dir: openspec/changes
+verify_commands:
+  default: pnpm test && pnpm build
+
+# 如果团队使用 npm，可把 verify_commands.default 改成 npm test && npm run build。

package/templates/workspaces/java-microservice.yml

@@ -0,0 +1,19 @@
+version: 1
+mode: auto
+workflow_source: openspec
+vars:
+  demand_name: __DEMAND_NAME__
+demand_file: superengineer/${demand_name}/需求.md
+todo_file: superengineer/${demand_name}/todo.md
+reference_files:
+  - docs/需求分析与实现指南.md
+  - docs/开发规范.md
+  - docs/接口规范.md
+code_path: __CODE_PATH__
+output_dir: superengineer/${demand_name}/output
+openspec:
+  changes_dir: openspec/changes
+verify_commands:
+  default: mvn -q test
+
+# Spring Boot 多模块项目可把 code_path 指向具体服务目录，或使用 multi-repo 模板。

package/templates/workspaces/multi-repo.yml

@@ -0,0 +1,21 @@
+version: 1
+mode: auto
+workflow_source: openspec
+vars:
+  demand_name: __DEMAND_NAME__
+demand_file: superengineer/${demand_name}/需求.md
+todo_file: superengineer/${demand_name}/todo.md
+reference_files:
+  - docs/需求分析与实现指南.md
+  - docs/开发规范.md
+  - docs/系统架构.md
+code_path: __CODE_PATH__
+output_dir: superengineer/${demand_name}/output
+openspec:
+  changes_dir: openspec/changes
+verify_commands:
+  frontend-app: pnpm test && pnpm build
+  user-service: mvn -q test
+  pricing-service: go test ./...
+
+# code_path 指向多个仓库的上层目录时，工作流会结合 todo 与代码结构推断目标仓库。

package/templates/workspaces/openspec-auto.yml

@@ -0,0 +1,18 @@
+version: 1
+mode: auto
+workflow_source: openspec
+vars:
+  demand_name: __DEMAND_NAME__
+demand_file: superengineer/${demand_name}/需求.md
+todo_file: superengineer/${demand_name}/todo.md
+reference_files:
+  - docs/需求分析与实现指南.md
+  - docs/开发规范.md
+code_path: __CODE_PATH__
+output_dir: superengineer/${demand_name}/output
+openspec:
+  changes_dir: openspec/changes
+
+# 可选：自动识别不准确时覆盖验证命令
+# verify_commands:
+#   default: mvn -q test

package/templates/workspaces/openspec-manual.yml

@@ -0,0 +1,16 @@
+version: 1
+mode: manual
+workflow_source: openspec
+vars:
+  demand_name: __DEMAND_NAME__
+demand_file: superengineer/${demand_name}/需求.md
+todo_file: superengineer/${demand_name}/todo.md
+reference_files:
+  - docs/需求分析与实现指南.md
+  - docs/开发规范.md
+code_path: __CODE_PATH__
+output_dir: superengineer/${demand_name}/output
+openspec:
+  changes_dir: openspec/changes
+
+# manual 模式会在 plan、implement、review 等关键阶段停下来等待确认。

package/templates/workspaces/todo-auto.yml

@@ -0,0 +1,13 @@
+version: 1
+mode: auto
+workflow_source: todo
+vars:
+  demand_name: __DEMAND_NAME__
+todo_file: superengineer/${demand_name}/todo.md
+reference_files:
+  - docs/需求分析与实现指南.md
+  - docs/开发规范.md
+code_path: __CODE_PATH__
+output_dir: superengineer/${demand_name}/output
+
+# todo 模式不使用 OpenSpec change，适合任务已经明确的小需求。

package/templates/workspaces/todo-manual.yml

@@ -0,0 +1,13 @@
+version: 1
+mode: manual
+workflow_source: todo
+vars:
+  demand_name: __DEMAND_NAME__
+todo_file: superengineer/${demand_name}/todo.md
+reference_files:
+  - docs/需求分析与实现指南.md
+  - docs/开发规范.md
+code_path: __CODE_PATH__
+output_dir: superengineer/${demand_name}/output
+
+# manual 模式适合首次接入、复杂需求或需要逐步确认的团队。