super-engineer-workflow 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 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 项目定位：适用于新系统开发和存量系统迭代，强调存量系统长期需求迭代优势更明显。
+- 调整 npm 包描述，避免将适用场景限定为存量系统。
+
 ## 0.1.0
 
 - 增加 `se` / `super-engineer` npm CLI 入口。

package/README.md

@@ -1,6 +1,6 @@
 # super-engineer
 
-`super-engineer` 是一个面向存量系统交付场景的 AI 工程工作流项目。
+`super-engineer` 是一个面向需求驱动开发的软件工程工作流 skill，适用于新系统开发和存量系统迭代。
 
 它的目标不是让 AI 零散地写代码，而是让 AI 围绕一次真实需求，按稳定阶段推进：
 
@@ -14,12 +14,15 @@
 
 ## 适用场景
 
-- 中大型存量系统
+- 新系统从 0 到 1 的需求交付
+- 中大型存量系统的长期需求迭代
 - 多服务或多仓库工程
 - 需要计划、审查、验证门禁
 - 希望沉淀可回看、可追踪、可归档的交付过程
 - 希望把 OpenSpec 和代码交付流程接起来
 
+相比快速原型或一次性 demo，它更适合需要规格、计划、实现、自查、审查、验证、归档闭环的工程场景。相比从零开始的新项目，它在存量系统、多服务、多仓库、长期需求迭代场景下优势更明显。
+
 ## 当前能力
 
 当前版本已经支持：
@@ -120,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,7 +1,7 @@
 {
   "name": "super-engineer-workflow",
-  "version": "0.1.0",
-  "description": "Super Engineer workflow skill and CLI for legacy-system AI delivery with OpenSpec bridge support.",
+  "version": "0.1.2",
+  "description": "Super Engineer workflow skill and CLI for demand-driven AI delivery with OpenSpec bridge support.",
   "license": "MIT",
   "author": "Gary-Coding",
   "homepage": "https://github.com/Gary-Coding/super-engineer#readme",

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,163 @@ 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:* 工作流命令。
+
+本命令接收到的 OpenSpec change 名称参数是：`$ARGUMENTS`。
+
+如果 `$ARGUMENTS` 为空，先不要执行 `/se:propose`，请直接询问用户：
+
+```text
+请提供 OpenSpec change 名称，例如：demand-to-venus-api。
+```
+
+如果 `$ARGUMENTS` 不为空，请执行：
+
+```text
+python3 ~/.claude/skills/super-engineer-workflow/scripts/run-workflow.py route-se --command-text "/se:propose $ARGUMENTS"
+```
+
+请根据当前 workspace 的 demand_file 生成或完善 OpenSpec change。
+本命令只能生成或完善 OpenSpec change 文档，严禁执行 /se:bridge，严禁生成或修改 todo.md。
+不要改代码。
+过程中请使用中文。
+""",
+    "propose-fix.md": """---
+description: Super Engineer：需求补充后修正当前 OpenSpec change
+argument-hint: <change-name>
+---
+
+请使用 super-engineer-workflow skill 处理下面的 /se:* 工作流命令。
+
+本命令接收到的 OpenSpec change 名称参数是：`$ARGUMENTS`。
+
+如果 `$ARGUMENTS` 为空，先不要执行 `/se:propose`，请直接询问用户：
+
+```text
+请提供要修正的 OpenSpec change 名称，例如：demand-to-venus-api。
+```
+
+如果 `$ARGUMENTS` 不为空，请执行：
+
+```text
+/se:propose $ARGUMENTS
+```
+
+当前需求有补充，请基于修改后的 demand_file 修正当前 OpenSpec change。
+不要创建新的 change。
+不要改代码。
+过程中请使用中文。
+""",
+    "bridge.md": """---
+description: Super Engineer：生成桥接 todo
+---
+
+请使用 super-engineer-workflow skill 处理下面的 /se:* 工作流命令。
+
+请执行：
+
+```text
+python3 ~/.claude/skills/super-engineer-workflow/scripts/run-workflow.py route-se --command-text "/se:bridge"
+```
+
+针对当前 OpenSpec change 生成桥接 todo，并总结待审核项。
+不要改代码，不要进入实现。
+过程中请使用中文。
+""",
+    "plan.md": """---
+description: Super Engineer：只生成实施计划
+---
+
+请使用 super-engineer-workflow skill 处理下面的 /se:* 工作流命令。
+
+/se:plan
+
+基于已审核的 todo.md 生成计划。
+先不要改代码，只总结目标仓库、影响范围、验收标准和主要风险。
+过程中请使用中文。
+""",
+    "apply.md": """---
+description: Super Engineer：审核 todo 后进入交付阶段
+---
+
+请使用 super-engineer-workflow skill 处理下面的 /se:* 工作流命令。
+
+/se:apply
+
+我已审核当前桥接 todo，可以进入交付阶段。
+使用当前工作空间。
+如果没有硬阻塞，自动推进到实现、自查、审查和验证。
+过程中请使用中文。
+""",
+    "archive-check.md": """---
+description: Super Engineer：检查 OpenSpec 归档条件
+---
+
+请使用 super-engineer-workflow skill 处理下面的 /se:* 工作流命令。
+
+/se:archive-check
+
+检查当前 OpenSpec change 是否满足归档条件。
+过程中请使用中文。
+""",
+    "archive.md": """---
+description: Super Engineer：归档 OpenSpec change
+---
+
+请使用 super-engineer-workflow skill 处理下面的 /se:* 工作流命令。
+
+/se:archive
+
+仅在 archive_ready=true、merge_mode=safe_merge、spec_conflicts 为空时执行归档。
+过程中请使用中文。
+""",
+    "status.md": """---
+description: Super Engineer：查看当前工作流状态
+---
+
+请使用 super-engineer-workflow skill 处理下面的 /se:* 工作流命令。
+
+/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()