super-engineer-workflow 0.1.1 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.1.4
+
+- Review 阶段优先读取 `plan-summary.json`，仅在缺失时回退到 `plan.json`。
+- Self-check、verify、OpenSpec writeback 阶段优先读取轻量计划摘要，减少重复加载完整计划。
+- Review 阶段默认压缩过长 diff 摘要，避免对话和报告带入大量无效上下文。
+- Verify 阶段增加命令输出压缩工具，为长日志截断和摘要化提供统一入口。
+
+## 0.1.3
+
+- 压缩 `SKILL.md` 为轻量入口，详细规则改为按需读取 references，降低每次 `/se:*` 固定上下文消耗。
+- 快捷命令模板改为极简形式，减少 Claude / Codex slash command 触发时的重复提示词。
+- `/se:propose` 不再把 `reference_files` 全文复制进 `propose-input.json` / `propose-input.md`，改为路径、sha256、标题和摘要片段。
+- 大型 Markdown 参考文档自动摘要，保留按需读取全文能力。
+- OpenSpec bridge context 增加 proposal/design 摘要片段，避免后续阶段重复读取全文。
+- `plan` 阶段新增 `plan-summary.json`，供后续阶段优先读取轻量计划摘要。
+- 收紧脚本最终回复约束文案，默认输出更 compact。
+
+## 0.1.2
+
+- `se init` 在 `openspec` 模式下默认尝试执行 `openspec init . --tools codex,claude`。
+- `se init` 自动生成工作区 `.claude/commands/se/*` 快捷命令。
+- 当初始化时选择安装 Codex skill，同步生成 `~/.codex/prompts/se-*.md` 快捷提示。
+- 增加 `--skip-openspec-init` 和 `--skip-commands` 以便高级用户跳过对应步骤。
+
 ## 0.1.1
 
 - 调整 README 项目定位：适用于新系统开发和存量系统迭代，强调存量系统长期需求迭代优势更明显。

package/README.md

@@ -123,7 +123,9 @@ se version   # 查看版本
 python3 scripts/se-setup.py
 ```
 
-脚本会依次完成环境检查、安装目标选择、工作区选择、代码目录配置、需求目录配置、工作流模式选择、OpenSpec 初始化确认，并在执行前展示摘要。最终会创建 `workspace.yml`、`openspec/`、`superengineer/<demand_name>/需求.md`，并可选安装 skill 到 Codex / Claude 本机目录。
+脚本会依次完成环境检查、安装目标选择、工作区选择、代码目录配置、需求目录配置、工作流模式选择、OpenSpec 初始化确认、快捷命令生成，并在执行前展示摘要。最终会创建 `workspace.yml`、`openspec/`、`superengineer/<demand_name>/需求.md`、`.claude/commands/se/*`，并可选安装 skill 到 Codex / Claude 本机目录。
+
+当选择 `openspec` 模式时，`se init` 默认会尝试在工作区根目录执行 `openspec init . --tools codex,claude`。如果本机未安装 OpenSpec CLI，会跳过并给出提示；如果你希望跳过该步骤，可以使用 `--skip-openspec-init`。
 
 如果需要非交互初始化：
 

package/docs//345/277/253/351/200/237/345/210/235/345/247/213/345/214/226/345/267/245/344/275/234/345/214/272.md

@@ -112,7 +112,28 @@ python3 scripts/se-setup.py
 4. 配置代码目录 `code_path` 和当前需求目录名。
 5. 选择输入模式：`openspec` 或 `todo`。
 6. 选择是否尝试执行 `openspec init`。
-7. 展示初始化摘要，确认后再真正写入文件。
+7. 选择是否生成 Claude / Codex 快捷命令。
+8. 展示初始化摘要，确认后再真正写入文件。
+
+当输入模式为 `openspec` 时，默认会在工作区根目录尝试执行：
+
+```bash
+openspec init . --tools codex,claude
+```
+
+如果本机没有安装 OpenSpec CLI，会跳过并提示。高级用户可以使用 `--skip-openspec-init` 跳过。
+
+初始化会自动生成工作区 Claude Code 快捷命令：
+
+```text
+ai-workspace/.claude/commands/se/
+```
+
+如果初始化时选择安装到 Codex，也会同步生成：
+
+```text
+~/.codex/prompts/se-*.md
+```
 
 如果需要非交互初始化：
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-engineer-workflow",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "Super Engineer workflow skill and CLI for demand-driven AI delivery with OpenSpec bridge support.",
   "license": "MIT",
   "author": "Gary-Coding",

package/scripts/se-setup.py

@@ -28,7 +28,9 @@ def main() -> None:
         help="安装 skill 到本机目录。默认：none",
     )
     parser.add_argument("--force-skill", action="store_true", help="安装 skill 时先删除已有目录。")
-    parser.add_argument("--openspec-init", action="store_true", help="如果安装了 openspec CLI，尝试执行 openspec init。")
+    parser.add_argument("--openspec-init", action="store_true", help="如果安装了 openspec CLI，尝试执行 openspec init。openspec 模式默认启用。")
+    parser.add_argument("--skip-openspec-init", action="store_true", help="openspec 模式下也跳过 openspec init。")
+    parser.add_argument("--skip-commands", action="store_true", help="跳过生成 Claude / Codex 快捷命令。")
     parser.add_argument("--yes", action="store_true", help="非交互模式，全部使用参数或默认值。")
     args = parser.parse_args()
 
@@ -55,7 +57,9 @@ def main() -> None:
         demand_name=demand_name,
         source=source,
         mode=mode,
-        openspec_init=args.openspec_init,
+        openspec_init=should_init_openspec(source, args.openspec_init, args.skip_openspec_init),
+        install_target=install,
+        skip_commands=args.skip_commands,
     )
     print_summary(workspace, demand_name, source, mode)
 
@@ -73,6 +77,8 @@ def should_prompt(args: argparse.Namespace) -> bool:
             args.install,
             args.force_skill,
             args.openspec_init,
+            args.skip_openspec_init,
+            args.skip_commands,
         ]
     )
     return not provided and sys.stdin.isatty()
@@ -129,8 +135,10 @@ def prompt_args(args: argparse.Namespace) -> argparse.Namespace:
         },
     )
     print("")
-    print("Step 6/7 OpenSpec 初始化")
-    args.openspec_init = prompt_bool("是否尝试执行 openspec init", default=False)
+    print("Step 6/7 OpenSpec 初始化与快捷命令")
+    args.openspec_init = prompt_bool("是否尝试执行 openspec init", default=True)
+    args.skip_openspec_init = not args.openspec_init
+    args.skip_commands = not prompt_bool("是否生成 Claude / Codex 快捷命令", default=True)
     print("")
     print("Step 7/7 执行前确认")
     print(f"  install:       {args.install}")
@@ -141,6 +149,7 @@ def prompt_args(args: argparse.Namespace) -> argparse.Namespace:
     print(f"  source:        {args.source}")
     print(f"  mode:          {args.mode}")
     print(f"  openspec_init: {args.openspec_init}")
+    print(f"  skip_commands: {args.skip_commands}")
     if not prompt_bool("确认开始初始化", default=True):
         raise SystemExit("已取消初始化。")
     print("")
@@ -218,6 +227,8 @@ def init_workspace(
     source: str,
     mode: str,
     openspec_init: bool,
+    install_target: str,
+    skip_commands: bool,
 ) -> None:
     (workspace / "docs").mkdir(parents=True, exist_ok=True)
     (workspace / "openspec" / "changes").mkdir(parents=True, exist_ok=True)
@@ -255,6 +266,16 @@ def init_workspace(
 
     if openspec_init:
         try_init_openspec(workspace)
+    if not skip_commands:
+        install_workspace_commands(workspace)
+        if install_target in ("codex", "both"):
+            install_codex_prompts()
+
+
+def should_init_openspec(source: str, openspec_init: bool, skip_openspec_init: bool) -> bool:
+    if skip_openspec_init:
+        return False
+    return source == "openspec" or openspec_init
 
 
 def build_workspace_yml(code_path: str, demand_name: str, source: str, mode: str) -> str:
@@ -292,8 +313,7 @@ def try_init_openspec(workspace: Path) -> None:
     if not shutil.which("openspec"):
         print("openspec_init=skipped:openspec CLI not found")
         return
-    config_file = workspace / "openspec" / "config.yaml"
-    if config_file.exists():
+    if openspec_initialized(workspace):
         print("openspec_init=skipped:already initialized")
         return
     result = subprocess.run(
@@ -308,6 +328,92 @@ def try_init_openspec(workspace: Path) -> None:
     print(f"openspec_init={'ok' if result.returncode == 0 else 'failed'}")
 
 
+def openspec_initialized(workspace: Path) -> bool:
+    markers = [
+        workspace / "openspec" / "config.yaml",
+        workspace / ".claude" / "commands" / "opsx" / "propose.md",
+        workspace / ".codex" / "skills" / "openspec-propose" / "SKILL.md",
+    ]
+    return any(path.exists() for path in markers)
+
+
+SE_COMMANDS: dict[str, str] = {
+    "propose.md": """---
+description: Super Engineer：生成或完善 OpenSpec change
+argument-hint: <change-name>
+---
+
+请使用 super-engineer-workflow skill 执行：`/se:propose $ARGUMENTS`。
+如果 `$ARGUMENTS` 为空，请先询问用户提供 OpenSpec change 名称。
+""",
+    "propose-fix.md": """---
+description: Super Engineer：需求补充后修正当前 OpenSpec change
+argument-hint: <change-name>
+---
+
+请使用 super-engineer-workflow skill 执行：`/se:propose $ARGUMENTS`。
+当前需求有补充，请修正当前 OpenSpec change；不要创建新的 change，不要改代码。
+""",
+    "bridge.md": """---
+description: Super Engineer：生成桥接 todo
+---
+
+请使用 super-engineer-workflow skill 执行：`/se:bridge`。
+生成桥接 todo 并总结待审核项，不要改代码，不要进入实现。
+""",
+    "plan.md": """---
+description: Super Engineer：只生成实施计划
+---
+
+请使用 super-engineer-workflow skill 执行：`/se:plan`。
+只生成计划，不要改代码。
+""",
+    "apply.md": """---
+description: Super Engineer：审核 todo 后进入交付阶段
+---
+
+请使用 super-engineer-workflow skill 执行：`/se:apply`。
+我已审核当前桥接 todo，可以进入交付阶段。
+""",
+    "archive-check.md": """---
+description: Super Engineer：检查 OpenSpec 归档条件
+---
+
+请使用 super-engineer-workflow skill 执行：`/se:archive-check`。
+""",
+    "archive.md": """---
+description: Super Engineer：归档 OpenSpec change
+---
+
+请使用 super-engineer-workflow skill 执行：`/se:archive`。
+""",
+    "status.md": """---
+description: Super Engineer：查看当前工作流状态
+---
+
+请使用 super-engineer-workflow skill 执行：`/se:status`。
+""",
+}
+
+
+def install_workspace_commands(workspace: Path) -> None:
+    command_dir = workspace / ".claude" / "commands" / "se"
+    command_dir.mkdir(parents=True, exist_ok=True)
+    for name, content in SE_COMMANDS.items():
+        (command_dir / name).write_text(content, encoding="utf-8")
+    print(f"claude_commands=created:{command_dir}")
+
+
+def install_codex_prompts() -> None:
+    prompt_dir = Path(os.environ.get("CODEX_HOME", "~/.codex")).expanduser() / "prompts"
+    prompt_dir.mkdir(parents=True, exist_ok=True)
+    for name, content in SE_COMMANDS.items():
+        codex_name = f"se-{name}"
+        codex_content = content.replace("~/.claude/skills/", "~/.codex/skills/")
+        (prompt_dir / codex_name).write_text(codex_content, encoding="utf-8")
+    print(f"codex_prompts=created:{prompt_dir}")
+
+
 def print_summary(workspace: Path, demand_name: str, source: str, mode: str) -> None:
     print("")
     print("初始化完成。")

package/scripts/se-smoke-test.py

@@ -44,6 +44,8 @@ def main() -> None:
         assert_file(workspace / "workspace.yml")
         assert_file(workspace / "superengineer" / "1-demo" / "需求.md")
         assert_dir(workspace / "openspec" / "changes")
+        assert_file(workspace / ".claude" / "commands" / "se" / "propose.md")
+        assert_file(workspace / ".claude" / "commands" / "se" / "bridge.md")
 
         legacy = root / "legacy-workspace"
         legacy.mkdir()

package/super-engineer-workflow/SKILL.md

@@ -1,37 +1,17 @@
 ---
 name: super-engineer-workflow
-description: Mandatory for any user message that starts with `/se:` or asks to run a super-engineer workflow. Treat `/se:*` strings such as `/se:init`, `/se:propose <change-name>`, `/se:bridge`, `/se:plan`, `/se:apply`, `/se:review`, `/se:verify`, `/se:archive-check`, `/se:archive`, and `/se:status` as super-engineer workflow commands, not chat text, not shell commands, and not OpenSpec `/opsx:*` commands. The skill supports todo mode and OpenSpec-bridged mode via `workspace.yml`, reads configured demand/todo/reference/code/output paths, creates archived sessions in `.super-engineer`, enforces `se-state.json`, writes Markdown reports, supports OpenSpec writeback/archive, and runs verification.
+description: Mandatory for `/se:*` super-engineer workflow commands. Treat `/se:*` as AI workflow commands, not shell text and not OpenSpec `/opsx:*`. Supports todo and OpenSpec-bridged delivery through workspace.yml, script-managed state, reports, verification, notifications, and archive.
 ---
 
 # Super Engineer Workflow
 
-当用户希望把工作空间里的 `todo.md` 变成一个可持续推进、可回看、可协作的工程工作流时，使用这个 skill。
+Use this skill when the user sends `/se:*` or asks to run the super-engineer workflow.
 
-## `/se:*` 专属命令协议
+## Command Routing
 
-如果用户消息以 `/se:` 开头，或者消息中明确要求处理 `/se:*`，必须立即使用本 skill。
+`/se:*` is a workflow instruction for AI. It is not a shell command and must not be mapped to OpenSpec `/opsx:*`.
 
-识别规则：
-
-- `/se:*` 是 super-engineer 的 AI 工作流命令
-- `/se:*` 不是普通聊天文本
-- `/se:*` 不是 shell 命令
-- `/se:*` 不是 OpenSpec 官方 `/opsx:*` 命令
-- 不要回复“有什么可以帮你”这类泛化聊天
-- 不要要求用户解释 `/se:*` 是什么
-- 不要把 `/se:*` 翻译成其他命令前缀
-- 必须按 [references/se-commands.md](references/se-commands.md) 解释并推进
-
-`/se:*` 是用户发给 AI 的工作流指令，不是 shell 命令。AI 必须：
-
-1. 识别命令名和用户补充说明
-2. 读取 `<workspace>/workspace.yml`
-3. 判断 `workflow_source`、`mode`、当前会话状态和 OpenSpec change 状态
-4. 检查命令前置条件
-5. 调用本 skill 的内部 workflow 推进阶段
-6. 把结果、阻塞项和下一步建议汇报给用户
-
-支持的命令：
+Supported commands:
 
 - `/se:init`
 - `/se:propose <change-name>`
@@ -44,396 +24,61 @@ description: Mandatory for any user message that starts with `/se:` or asks to r
 - `/se:archive`
 - `/se:status`
 
-命令处理硬约束：
-
-- 不要把 `/se:*` 映射为 OpenSpec 官方 `/opsx:*`
-- 不要要求用户自己执行底层脚本
-- 禁止 AI 编辑 `<workspace>/workspace.yml`；`workspace.yml` 是用户维护的工作空间契约，只能读取和校验，不能自动修改
-- 禁止 AI 直接创建、修改或伪造 `.super-engineer/current-session.json`、`.super-engineer/sessions/**/status.json`、`plan.json`、`review.json`、`verify.json`、`notification.json` 等工作流状态产物；这些文件只能由本 skill 脚本写入
-- 禁止 AI 直接在 `output_dir/<session_id>/` 下手工补写 `discovery.md`、`plan.md`、`self-check.md`、`review.md`、`verify.md` 等标准报告；这些标准报告只能由对应脚本生成
-- 如果发现当前 session 缺少标准 JSON 或 Markdown 产物，不得手工补文件；必须通过 `/se:plan`、`/se:review`、`/se:verify` 或重新创建标准 session 来恢复
-- 每次只能执行用户当前消息中明确请求的 `/se:*` 命令；“下一步建议”只能作为文字建议，绝不能自动执行下一步命令
-- `openspec` 模式下，`/se:bridge` 生成的桥接 todo 必须先经过人工审核；用户审核后直接发送 `/se:apply` 进入交付阶段
-- `openspec` 模式下，只有用户显式发送 `/se:bridge` 时才允许生成或重写 `todo_file`；`/se:propose`、`/se:init`、`/se:plan`、`/se:apply` 都严禁自动桥接
-- 桥接 todo 的实际路径由 `workspace.yml.todo_file` 决定，不要假设固定文件名；如果用户没有特殊要求，推荐使用 `todo.md`
-- `manual` 模式下，计划、实现、审查后按门禁停留
-- `auto` 模式下，除非出现硬阻塞，否则连续推进
-- `auto` 模式只在 `/se:apply` 命令内部生效；`/se:init`、`/se:propose`、`/se:bridge`、`/se:plan` 都必须在各自阶段完成后停止
-- `/se:archive` 只能在 `archive_ready=true`、`merge_mode=safe_merge`、`spec_conflicts=[]` 时继续
-- 当前置条件不满足时，停止该命令并明确说明缺少什么、应该先执行哪个 `/se:*` 命令
-- `/se:propose` 必须显式携带 OpenSpec change 名称，例如 `/se:propose demand-addition-rate`；AI 不得根据需求标题或 `demand_name` 自行推导 change 名称
-- `/se:propose <change-name>` 应先执行 `python3 scripts/run-workflow.py route-se --command-text "/se:propose <change-name>"`，优先使用 OpenSpec CLI 创建 change、读取 status 和 artifact instructions；随后 AI 根据 `propose-input.json`、`demand_file` 和 `reference_files` 生成或完善 OpenSpec artifacts
-- `/se:propose` 执行全过程禁止调用 `bootstrap-openspec.py`、`run-workflow.py bootstrap-openspec`，禁止创建或修改 `workspace.yml.todo_file` 指向的文件；完成后 `se-state.phase` 必须是 `proposed`
-- `/se:propose` 完成后只能提示下一步 `/se:bridge`，禁止提示 `/se:apply`
-- `/se:propose` 的完成回复中禁止出现“确认无误后执行 `/se:apply`”“通过 `/se:apply` 进入实现阶段”等表达；如果需要提示后续，只能写“下一步：执行 `/se:bridge` 生成待审核 todo”
-- `/se:bridge` 完成后只能提示人工审核 todo，审核通过后发送 `/se:apply`；禁止自动执行 `/se:apply`
-- `/se:bridge` 必须通过 `python3 scripts/run-workflow.py route-se --command-text "/se:bridge"` 或带 `--explicit-se-bridge` 的受控入口执行；直接调用 `bootstrap-openspec` 且没有显式桥接标记时应视为错误流程
-- 在进入 `/se:apply` 前，如果人工审核发现需求或 todo 有偏差，允许重新执行 `/se:propose <change-name>` 修正当前 change，然后再次执行 `/se:bridge` 重建待审核 todo；AI 禁止手工同步 `tasks.md` 到 `todo.md`
-- `/se:bridge` 完成后禁止自动调用 plan、apply、start-implement、review、verify 或修改代码
-- `/se:apply` 必须通过标准脚本序列推进：必要时先 `python3 scripts/run-workflow.py plan`，然后 `start-implement`，代码实现完成后 `finish-implement`，`auto` 模式下继续 `review` 和 `verify`；禁止只手工写状态或只手工发送通知后宣布完成
-- `/se:verify` 通过前禁止提示 `/se:archive-check`
-- `/se:archive-check` 未满足 `safe_merge` 前禁止提示 `/se:archive`
-- 工作流完成通知必须由 `python3 scripts/run-workflow.py verify` 触发，禁止 AI 直接调用飞书 webhook，禁止 AI 手工拼接飞书卡片 JSON
-- `notification.json` 是唯一通知证据；启用飞书时，只有 `notification.json` 中存在 `source=run-workflow.py verify`、fingerprint 匹配、`route=feishu`、`template=interactive`、`status=sent` 的结果，才算飞书通知成功
-- `status.json` 中的 `notification_status=sent` 不能单独作为通知成功依据
-- 如果 workflow 已完成但缺少 `notification.json`、`verify.json` 或输出目录下的 Markdown 报告，必须通过 `/se:verify` 重新走标准验证收口；不要新增独立收口命令，也不要手工拼接通知
-- OpenSpec 模式必须使用 `<workspace>/.super-engineer/se-state.json` 作为阶段状态机；执行 `/se:bridge`、`/se:plan`、`/se:apply`、`/se:verify`、`/se:archive-check`、`/se:archive` 前必须通过脚本状态校验
-- AI 不能自行决定下一步命令，只能依据 `se-state.json.allowed_next` 汇报下一步；如果用户请求的命令不在允许范围内，必须停止并说明当前 `phase` 和允许命令
-- 当脚本输出 `final_reply_must` 或 `se_reply_constraint_begin` / `se_reply_constraint_end` 时，AI 最终回复必须遵守该约束；禁止在最终回复中追加与 `allowed_next` 冲突的 `/se:*` 命令
-
-门禁命令停止规则：
-
-- `/se:init`：完成初始化后停止
-- `/se:propose <change-name>`：完成规格产物后停止
-- `/se:bridge`：生成桥接 todo 后停止
-- `/se:plan`：生成计划后停止，除非用户当前命令就是 `/se:apply`
-- `/se:archive-check`：完成归档检查后停止
-
-## 先读取这些输入
-
-1. 工作空间配置：`<workspace>/workspace.yml`
-2. Skill 配置：`~/.super-engineer/skill-config.yml`
-3. `workspace.yml` 中配置的 `workflow_source`
-4. `workspace.yml` 中配置的 `todo_file`
-5. `workspace.yml` 中配置的 `demand_file`
-6. `workspace.yml` 中配置的 `reference_files`
-7. `workspace.yml` 中配置的 `code_path`
-8. `workspace.yml` 中配置的 `output_dir`
-9. 如果 `workflow_source=openspec`，继续读取 `workspace.yml` 中的 `openspec`
-
-这里的 `<workspace>` 就是当前使用这个 skill 的目录。
-
-## 强约束
-
-- 工作空间根目录必须存在 `workspace.yml`
-- AI 只能读取和校验 `workspace.yml`，禁止自动编辑、重写或格式化该文件；如果配置需要变更，必须停下并让用户处理
-- `todo_file`、`reference_files`、`code_path`、`output_dir` 可以使用相对路径或绝对路径；相对路径按当前工作空间根目录解析
-- `demand_file` 是可选原始需求输入，主要给 `/se:propose` 使用；如果配置了，`/se:propose` 必须优先读取它
-- `demand_file` 支持本地 Markdown 路径或飞书/Lark 云文档 URL；云文档 URL 必须通过官方 `lark-cli` 读取，禁止 AI 手工复制云文档内容
-- 当 `demand_file` 是飞书/Lark 云文档 URL 时，脚本会检查 `lark-cli` 是否可用；未安装时必须停止并提示用户执行 `npx @larksuite/cli@latest install`、`lark-cli config init --new`、`lark-cli auth login --recommend`
-- `reference_files` 是 `/se:propose`、`/se:plan`、review 的强上下文；如果配置了，`/se:propose` 必须读取真实存在的参考文件并写入 `propose-input.json`
-- `workspace.yml` 支持 `vars` 变量；路径字段可以使用 `${name}` 或 `${vars.name}` 引用变量，例如 `${demand_name}`
-- `/se:bridge` 支持相对路径、绝对路径、`${demand_name}` 变量和 `openspec.changes_dir`；AI 禁止声称桥接脚本要求绝对路径或必须显式配置 `openspec.change_dir`
-- 如果 `/se:bridge` 找不到当前 change，正确处理是提示先执行 `/se:propose <change-name>` 记录 active change，禁止要求用户改 `workspace.yml` 为绝对路径或新增 `openspec.change_dir`
-- `workflow_source=todo` 时，`todo_file` 是用户维护的真实输入
-- `workflow_source=openspec` 时，`todo_file` 是桥接后的执行入口，内容来自 OpenSpec `tasks.md`
-- `workflow_source=openspec` 时，只有显式执行 `/se:bridge` 才允许重写 `todo_file`；`/se:init`、`/se:plan`、`/se:apply` 内部初始化只能校验已有 `todo_file`，不能覆盖人工审核后的 todo
-- `workflow_source=openspec` 时，OpenSpec change 名称只能由 `/se:propose <change-name>` 显式指定；不得从 `vars.demand_name` 或需求标题推导
-- `workspace.yml.verify_commands` 可覆盖自动识别出的验证命令；当存在覆盖命令时，verify 阶段必须优先使用覆盖命令
-- 项目识别优先使用 `adapters/*.yml` 语言适配器，并保留内置 Maven、Gradle、Node、Go、Python、Rust、.NET、PHP、Ruby、Make、CMake 识别兜底
-- 用户真实 Skill 配置位于 `~/.super-engineer/skill-config.yml`
-- 如果启用了 `notification.pushplus.ordinary`，其中的 `token` 必须合法
-- 如果启用了 `notification.feishu`，必须提供合法的飞书机器人 `webhook_url`
-- 如果 `workspace.yml` 缺失，立即停止，并提示用户先补齐配置
-- 不允许写回全局配置
-- 如果 `code_path` 是多个服务的聚合目录，应优先从 todo 中识别“修改的服务是 xxx”或“修改的服务包括 xxx、yyy”这一类约束，并自动定位一个或多个目标仓库
-- 如果 todo 中存在 `# 限制条件` 和 `# 待办` 章节，应把限制条件与真实需求分开解析
-- 如果 todo 中存在 `##` 模块标题、`- [ ]` 未完成任务、`- [x]` 已完成任务和编号子要求，应按结构化任务模型解析
-
-## 运行时目录约定
-
-工作空间内只保存给 AI 持续推进流程所需的数据：
-
-- `<workspace>/.super-engineer/current-session.json`
-- `<workspace>/.super-engineer/se-state.json`
-- `<workspace>/.super-engineer/todo-state.json`
-- `<workspace>/.super-engineer/sessions/<session_id>/discovery.json`
-- `<workspace>/.super-engineer/sessions/<session_id>/plan.json`
-- `<workspace>/.super-engineer/sessions/<session_id>/self-check.json`
-- `<workspace>/.super-engineer/sessions/<session_id>/review.json`
-- `<workspace>/.super-engineer/sessions/<session_id>/verify.json`
-- `<workspace>/.super-engineer/sessions/<session_id>/status.json`
-
-给人看的 Markdown 产物写到 `output_dir` 下，并按会话归档：
-
-- `<output_dir>/<session_id>/discovery.md`
-- `<output_dir>/<session_id>/plan.md`
-- `<output_dir>/<session_id>/self-check.md`
-- `<output_dir>/<session_id>/review.md`
-- `<output_dir>/<session_id>/verify.md`
-
-每次新的 `plan` 都必须创建新的 `session_id`，不能覆盖历史会话。
-
-OpenSpec 模式下，`se-state.json` 是命令状态机：
-
-- `/se:propose` 后：`phase=proposed`，只允许 `/se:bridge`
-- `/se:bridge` 后：`phase=bridged`，允许 `/se:apply` 或 `/se:plan`
-- `/se:plan` 后：`phase=planned`，只允许 `/se:apply`
-- `/se:verify` 通过后：`phase=verified`，只允许 `/se:archive-check`
-- `/se:archive-check` 通过后：`phase=archive_ready`，只允许 `/se:archive`
-
-状态机由脚本写入和校验，AI 禁止手工编辑。
-
-todo 模式下，也必须以当前 session 的 `status.json`、`todo-state.json` 和标准产物校验作为状态依据；todo 状态不能写入 OpenSpec 专用的 `se-state.json`：
-
-- 未创建 session：允许 `/se:init`、`/se:plan`、`/se:apply`
-- `plan` / `wait_confirm_plan`：允许 `/se:apply`
-- `implement`：只允许 AI 修改代码，完成后必须由脚本执行 `finish-implement`
-- `self_check` / `wait_confirm_implement`：允许 `/se:review`
-- `review` / `wait_confirm_review`：允许 `/se:verify`
-- `done`：不再自动推进
-- `blocked`：允许修复后重新 `/se:apply` 或 `/se:verify`
-
-todo 模式下如果 `current-session.json` 指向旧 `output_dir`，或当前 session 缺少标准 `status.json` / `plan.json`，必须重新创建标准 session；禁止复用旧需求的会话状态。
-
-工作流耗时和通知结果写回当前会话的 `status.json`，通知明细写入：
-
-- `<workspace>/.super-engineer/sessions/<session_id>/notification.json`
-
-`notification.json` 是通知是否成功的唯一证据。聊天记录、截图和 `status.json.notification_status` 都不能单独证明飞书通知合规。
-
-标准 JSON 产物必须带有脚本来源标识：
-
-- `plan.json`：`source=run-workflow.py plan`
-- `self-check.json`：`source=run-workflow.py self-check`
-- `review.json`：`source=run-workflow.py review`
-- `verify.json`：`source=run-workflow.py verify`
-- `notification.json`：`source=run-workflow.py verify`
-
-缺少上述来源标识的产物视为非标准产物，不能作为工作流完成依据。
-
-## 执行模式
-
-先阅读 [references/execution-modes.md](references/execution-modes.md)。
-
-- `manual`：在计划、实现、审查三个检查点等待用户确认
-- `auto`：除非阻塞，否则沿工作流自动推进
-
-始终保持 `status.json` 为当前会话的真实状态。`status.json` 是脚本管理文件，AI 不能直接编辑它，只能通过 `scripts/run-workflow.py` 或被该入口调用的脚本更新。
-
-`auto` 模式下的执行纪律：
-
-- 不要在正常推进阶段请求用户批准
-- 不要说“批准 plan 后我再继续”
-- 如果计划不够精确，应直接去代码里定位，再补充计划并继续
-- 只有遇到 [references/workflow.md](references/workflow.md) 中定义的硬阻塞，才允许停下来询问用户
-- 如果没有硬阻塞，就继续推进到实现、审查、验证，而不是把决策留在对话里
-
-## 输入模式
-
-`workspace.yml` 用 `workflow_source` 控制输入来源：
-
-- `todo`：沿用当前模式，直接读取 `todo_file`
-- `openspec`：从当前 active OpenSpec change 的 `tasks.md` 生成桥接 `todo_file`，并把 `proposal.md`、`design.md`、`specs/` 下的 markdown 自动并入参考上下文
-
-OpenSpec 模式底层脚本只允许在对应 `/se:*` 阶段由受控入口执行：
-
-- `python3 scripts/run-workflow.py propose-openspec`
-- `python3 scripts/run-workflow.py bootstrap-openspec --explicit-se-bridge`
-- `python3 scripts/run-workflow.py writeback-openspec`
-- `python3 scripts/run-workflow.py prepare-archive-openspec`
-- `python3 scripts/run-workflow.py archive-openspec`
-
-`init` 和 `plan` 只校验已有桥接 todo，不能自动完成桥接。
-`review` 和 `verify` 完成后会自动把执行摘要回写到 `openspec.writeback_dir`。
-`archive-openspec` 只在 `prepare-archive-openspec` 产出的 `merge_mode=safe_merge` 时允许自动执行。
-
-`openspec` 模式下，如果用户通过 `/se:*` 使用工作流，推荐阶段顺序是：
-
-1. `/se:propose <change-name>`
-2. `/se:bridge`
-3. 人工审核 `todo.md`
-4. `/se:apply`
-5. `/se:archive-check`
-6. `/se:archive`
-
-`todo` 模式下，如果用户通过 `/se:*` 使用工作流，推荐阶段顺序是：
-
-1. `/se:init`
-2. `/se:plan`
-3. `/se:apply`
-4. `/se:review`
-5. `/se:verify`
-
-## 必走工作流
-
-必须使用统一入口 [`scripts/run-workflow.py`](scripts/run-workflow.py) 推进工作流状态，不要在对话里手工拼工作流状态。
-
-### 1. 初始化上下文
-
-- 读取并校验 `<workspace>/workspace.yml`
-- 读取并校验 `~/.super-engineer/skill-config.yml`
-- 执行 `python3 scripts/run-workflow.py init`
-- 读取 todo 和参考文件
-- 检查代码目录，尽量识别语言、构建方式和可安全执行的验证命令
-
-如果 `~/.super-engineer/skill-config.yml` 不存在，初始化阶段必须自动生成该文件，然后立即停止当前工作流，并明确提示用户：
-
-- 已生成的配置文件路径
-- 请先完善配置后再重新继续
-
-如果 `todo_file` 指向的文件不存在，初始化阶段必须自动创建一个带示例结构的 `todo.md` 模板，方便用户直接填写。
-
-创建模板后的行为约束：
-
-- 执行 `init` 时：创建模板后停止在初始化阶段，并提示用户先完善 todo
-- 执行 `plan` 时：如果检测到 todo 仍然是模板示例内容，必须停止，不允许继续基于模板内容生成计划
-
-参考：
-
-- [references/workflow.md](references/workflow.md)
-- [references/project-docs.md](references/project-docs.md)
-- [references/java.md](references/java.md)
-
-### 2. 上下文定位
-
-使用 `python3 scripts/run-workflow.py discover`。
-
-这一步会从 todo 中提取服务名、接口名、字段名、类名、表名等关键词，逐仓执行代码定位，写入：
-
-- `discovery.json`
-- `discovery.md`
-
-`plan` 命令会自动先执行 discover。通常不需要单独运行，除非 todo 或目标仓库发生变化。
-
-### 3. 生成计划
-
-使用 `python3 scripts/run-workflow.py plan`。
-
-这一步必须：
-
-- 创建新的会话目录
-- 更新 `<workspace>/.super-engineer/current-session.json`
-- 写入当前会话的 `plan.json`
-- 写入当前会话对应输出目录的 `plan.md`
-- 初始化当前会话的 `status.json`
-
-`auto` 模式下，计划生成后不能因为“影响文件尚未精确到具体代码位置”而停下来要求批准，应直接继续做代码定位。
-
-todo 解析规则：
-
-- `# 限制条件`：约束信息
-- `# 待办` 或 `# 待办事项`：任务入口
-- `## 模块标题`：大需求模块
-- `- [ ] 任务`：本轮待执行任务
-- `- [x] 任务`：已完成任务，不进入本轮计划
-- `1.` `2.` 或普通说明行：挂到上一个任务下面作为子要求
-
-如果 todo 中所有任务都已经标记完成，应停止生成新计划，并明确提示当前没有未完成任务。
-
-计划至少要覆盖：
-
-- 需求摘要
-- todo 完成进度
-- 任务模块与子任务拆解
-- 上下文定位证据
-- 计划置信度
-- 实际命中的目标代码目录
-- 实际命中的目标仓库列表
-- 关键假设
-- 识别到的项目技术栈
-- 影响模块
-- 影响文件
-- 每个任务的验收标准
-- 可独立推进的实施切片
-- 有序修改步骤
-- 测试计划
-- 风险
-- 未知项
-
-`plan.json` 必须兼容 [assets/plan-schema.json](assets/plan-schema.json)。
-
-### 4. 按计划实施修改
-
-把当前会话的 `plan.json` 作为唯一计划基线，并优先参考 `discovery.json` 中的代码证据。
-
-- 严格围绕计划推进实现
-- 如果代码现实与计划冲突，先修正计划再继续
-- 用 [`scripts/update-status.py`](scripts/update-status.py) 更新当前会话的 `status.json`
-- 如果遇到阻塞，把阻塞原因写入状态，不要在聊天里悄悄跳过
-- `auto` 模式下，如果只是需要进一步定位控制器、校验逻辑、调用链或测试入口，这不是阻塞，应直接继续
-
-推荐阶段切换：
-
-- 开始实现前：`python3 scripts/run-workflow.py start-implement`
-- 实现完成后：`python3 scripts/run-workflow.py finish-implement`
-
-`finish-implement` 会自动执行实现自查并生成：
-
-- `self-check.json`
-- `self-check.md`
-
-自查发现阻塞项时，不进入 review。
-
-`manual` 模式下，实现后要停下来等用户确认。
-
-`auto` 模式下，不要在实现开始前再发起额外确认。
-
-### 5. 审查改动
-
-用真实代码差异对照当前会话计划做审查。
-
-如果当前会话包含多个独立仓库，必须逐仓读取 Git 差异并汇总审查结论。
-
-使用：
-
-- `python3 scripts/run-workflow.py review`
-- [references/review-checklist.md](references/review-checklist.md)
-
-输出写到当前会话对应的 `review.md`。
-
-同时写入结构化门禁结果 `review.json`。如果存在 `blocking=true` 的 finding，工作流进入 `blocked`，不得继续执行 verify。
-
-`manual` 模式下，审查后要停下来等用户确认。
-
-`auto` 模式下，review 发现计划需要补充时，应先补计划再继续，不要请求批准。
-
-### 6. 执行验证
+For command details, read only the relevant section in [references/se-commands.md](references/se-commands.md).
+For mode and artifact details, use [references/workflow.md](references/workflow.md) and [references/execution-modes.md](references/execution-modes.md) only when needed.
 
-使用：
+## Minimal Required Steps
 
-- `python3 scripts/run-workflow.py verify`
-- [references/verify-checklist.md](references/verify-checklist.md)
+1. Read `<workspace>/workspace.yml`.
+2. Identify `workflow_source`, `mode`, `todo_file`, `demand_file`, `reference_files`, `code_path`, `output_dir`, and optional `openspec` fields.
+3. Route the current command through `python3 scripts/run-workflow.py route-se --command-text "<command>"` when possible.
+4. Obey script state validation and script reply constraints.
+5. Report compactly: result, blockers, allowed next command, and key artifact paths.
 
-优先使用仓库中识别出来的验证命令，不要凭空猜测。验证结果写到当前会话对应的 `verify.md`，同时收敛 `status.json`。
+## Hard Constraints
 
-项目识别应覆盖主流技术栈，包括 Java、Node.js / Vue / React、Go、Python、Rust、.NET、PHP、Ruby、Make / CMake。自动识别不可靠时，优先读取 `workspace.yml.verify_commands`。
+- Never edit `<workspace>/workspace.yml`; it is a user-maintained contract.
+- Never manually create, edit, or fake `.super-engineer/current-session.json`, `.super-engineer/se-state.json`, `.super-engineer/sessions/**/status.json`, `plan.json`, `review.json`, `verify.json`, `notification.json`, or standard output reports.
+- Standard JSON and Markdown artifacts must be generated by workflow scripts.
+- Execute only the `/se:*` command explicitly requested by the current user message. Suggested next commands are text only.
+- If a script prints `final_reply_must` or `se_reply_constraint_begin` / `se_reply_constraint_end`, the final reply must obey it.
+- `auto` only applies inside `/se:apply`; `/se:init`, `/se:propose`, `/se:bridge`, and `/se:plan` stop after their own stage.
+- In `openspec` mode, `/se:propose <change-name>` requires an explicit change name. Do not infer it from demand title or `demand_name`.
+- In `openspec` mode, only explicit `/se:bridge` may generate or overwrite `todo_file`.
+- `/se:bridge` output must be reviewed by the user before `/se:apply`.
+- `/se:propose` must not call bridge or modify `todo_file`; its next allowed command is `/se:bridge`.
+- `/se:bridge` must not call plan/apply/review/verify or modify code.
+- `/se:verify` must pass before suggesting `/se:archive-check`.
+- `/se:archive-check` must report `safe_merge` before suggesting `/se:archive`.
+- Notifications must be sent only by `python3 scripts/run-workflow.py verify`; AI must not call Feishu/PushPlus webhooks directly.
+- `notification.json` is the only notification success evidence.
 
-同时写入 `verify.json`，记录逐仓命令、退出码、耗时、结果和摘要。验证失败时进入 `blocked`，修复后重新执行 verify。
+## Context Discipline
 
-如果当前会话包含多个独立仓库，必须逐仓执行验证并汇总结果。
+- Prefer compact summaries and artifact paths over pasting full files into replies.
+- `reference_files` are strong context, but scripts summarize large files by default; read full files only when necessary for the current command.
+- In OpenSpec mode, avoid rereading `proposal.md`, `design.md`, and `specs/**/*.md` unless the current stage needs them.
+- Prefer `plan-summary.json` for downstream context; use `plan.json` only when detailed planning data is required.
+- Final replies should be compact. Detailed reports belong in `output_dir/<session_id>/`.
 
-`auto` 模式下，verify 前也不要因为“建议先确认”而暂停。
+## State Summary
 
-verify 收口时还必须：
+OpenSpec mode state is script-managed in `<workspace>/.super-engineer/se-state.json`:
 
-- 记录从当前会话开始到 verify 完成的整个工作流耗时
-- 把耗时写回 `status.json`
-- 如果 `~/.super-engineer/skill-config.yml` 中配置了通知，在工作流完成后自动推送结果通知
-- 支持 PushPlus 原生消息和飞书原生 webhook 两条路由独立启停
-- 普通消息默认走 `wechat`
-- 飞书消息走飞书原生自定义机器人 webhook
-- 不允许 AI 直接调用 webhook 或手工构造飞书卡片；所有飞书通知必须通过 `python3 scripts/run-workflow.py verify` 调用脚本统一模板发送
-- 飞书通知合规性只以当前 session 的 `notification.json` 为准；启用飞书时必须存在 `route=feishu`、`template=interactive`、`status=sent` 的标准结果
+- after `/se:propose`: only `/se:bridge`
+- after `/se:bridge`: `/se:apply` or `/se:plan`
+- after `/se:plan`: only `/se:apply`
+- after successful `/se:verify`: only `/se:archive-check`
+- after safe `/se:archive-check`: only `/se:archive`
 
-## 资源导航
+Todo mode uses current session `status.json` and `todo-state.json`; do not write OpenSpec `se-state.json` for todo mode.
 
-- [references/se-commands.md](references/se-commands.md)：`/se:*` 专属命令协议
-- [references/workflow.md](references/workflow.md)：工作空间契约与产物目录规则
-- [references/contracts.md](references/contracts.md)：输入输出契约与归档顺序
-- [references/execution-modes.md](references/execution-modes.md)：`manual` 与 `auto` 行为
-- [references/planning.md](references/planning.md)：上下文定位与计划质量规则
-- [references/project-docs.md](references/project-docs.md)：参考文件的使用方式
-- [references/java.md](references/java.md)：Java 项目识别与计划提示
-- [references/review-checklist.md](references/review-checklist.md)：代码审查核对项
-- [references/verify-checklist.md](references/verify-checklist.md)：验证核对项
-- [references/platform-openclaw.md](references/platform-openclaw.md)：面向 OpenClaw 的后续接入约束
-- [scripts/init-workspace.py](scripts/init-workspace.py)：初始化工作空间基础目录
-- [scripts/run-workflow.py](scripts/run-workflow.py)：统一入口
-- `python3 scripts/run-workflow.py validate-state <command>`：校验当前 OpenSpec 状态是否允许执行指定内部命令
-- [scripts/bootstrap-openspec.py](scripts/bootstrap-openspec.py)：OpenSpec `tasks.md` 到桥接 `todo` 的输入适配
-- [scripts/writeback-openspec.py](scripts/writeback-openspec.py)：执行摘要回写到 OpenSpec change
-- [scripts/prepare-archive-openspec.py](scripts/prepare-archive-openspec.py)：生成归档输入与 merge preview
-- [scripts/archive-openspec.py](scripts/archive-openspec.py)：归档 change 并合并 delta specs
-- [scripts/generate-smart-plan.py](scripts/generate-smart-plan.py)：生成计划
-- [scripts/update-status.py](scripts/update-status.py)：更新状态
-- [scripts/generate-review-report.py](scripts/generate-review-report.py)：生成代码审查报告
-- [scripts/run-verify-and-report.py](scripts/run-verify-and-report.py)：执行验证并生成报告
+## Script Entry Points
 
-## 工作方式
+- Main router: `python3 scripts/run-workflow.py route-se --command-text "<command>"`
+- Status: `python3 scripts/run-workflow.py status`
+- Plan: `python3 scripts/run-workflow.py plan`
+- Review: `python3 scripts/run-workflow.py review`
+- Verify: `python3 scripts/run-workflow.py verify`
 
-- 产物要短、清晰、稳定，方便 AI 和人同时使用
-- 属于工作流状态的信息必须写进 `status.json`，不要只留在聊天上下文里
-- 不要覆盖用户写的 todo 内容
-- 优先相信仓库现实，其次才是参考文件
-- 参考文件是强上下文，但不是不可质疑的真理
+OpenSpec-specific internal commands are listed in [references/se-commands.md](references/se-commands.md).

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

@@ -1151,6 +1151,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 +1675,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

@@ -40,19 +40,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。",
     },
 }
 

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), {})