feat(cli): 默认启用 openspec expanded workflow

sincerely90 · sincerely90 · commit 5bb51bc9af80 · 2026-06-12T15:14:16.000+08:00
diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json
@@ -1,6 +1,6 @@
 {
   "name": "aisee-plugin",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "interface": {
     "displayName": "Aisee Plugin",
     "description": "Aisee plugin marketplace for OpenSpec, project memory, team knowledge, and Compound Engineering workflows."
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,14 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) 的结构，并使用 SemVer 管理版本。
 
+## [0.11.0] - 2026-06-12
+
+### Changed
+
+- `aisee openspec ensure --json` 默认从 OpenSpec `core` workflow 切换为 Aisee 所需的 expanded workflow，会为 Codex 项目安装或刷新完整的 11 个 OpenSpec skills/commands，而不再只生成 `propose/explore/apply/sync/archive` 这 5 个精简项。
+- `aisee openspec ensure --json` 现在会在默认路径下直接写入 OpenSpec 全局 custom workflow 配置，再执行 `openspec init/update`，从而补齐 `/opsx:new`、`/opsx:continue`、`/opsx:verify`、`/opsx:bulk-archive` 和 `/opsx:onboard`。
+- `aisee openspec ensure --profile core --json` 保留为显式回退入口；README、help 和 `aisee:init` 文案同步说明 expanded/core 两条路径。
+
 ## [0.10.0] - 2026-06-12
 
 ### Changed
diff --git a/README.en.md b/README.en.md
@@ -251,14 +251,20 @@ If the project has not initialized OpenSpec yet:
 aisee openspec ensure --json
 ```
 
-This command auto-selects OpenSpec tools from the current agent runtime (`codex` by default in Codex; falls back to `none` when no supported runtime is detected), ensures project-local OpenSpec instructions/skills are installed or refreshed, and aligns the global profile:
+This command auto-selects OpenSpec tools from the current agent runtime (`codex` by default in Codex; falls back to `none` when no supported runtime is detected), enables the expanded workflow that Aisee expects by default, and ensures project-local OpenSpec instructions/skills are installed or refreshed:
 
 ```text
-openspec init . --tools <detected-runtime-or-none> --profile core
-openspec config profile core
+write ~/.config/openspec/config.json   # profile=custom, delivery=both, workflows=expanded set
+openspec init . --tools <detected-runtime-or-none> --profile custom
 openspec update .
 ```
 
+If you want the lean OpenSpec `core` workflow instead, pass:
+
+```bash
+aisee openspec ensure --profile core --json
+```
+
 If you only want the OpenSpec directory layout without installing OpenSpec-provided agent skills/instructions, pass:
 
 ```bash
diff --git a/README.md b/README.md
@@ -251,14 +251,20 @@ aisee plugin inspect --json
 aisee openspec ensure --json
 ```
 
-该命令会按当前 agent runtime 自动选择 OpenSpec tools（Codex 默认是 `codex`；无法识别时回退到 `none`），确保 OpenSpec 的项目内 instructions / skills 已安装或已刷新，并对齐全局 profile：
+该命令会按当前 agent runtime 自动选择 OpenSpec tools（Codex 默认是 `codex`；无法识别时回退到 `none`），并默认启用 Aisee 需要的 expanded workflow，确保 OpenSpec 的项目内 instructions / skills 已安装或已刷新：
 
 ```text
-openspec init . --tools <detected-runtime-or-none> --profile core
-openspec config profile core
+write ~/.config/openspec/config.json   # profile=custom, delivery=both, workflows=expanded set
+openspec init . --tools <detected-runtime-or-none> --profile custom
 openspec update .
 ```
 
+如果只想要 OpenSpec 的精简 `core` workflow，可显式传入：
+
+```bash
+aisee openspec ensure --profile core --json
+```
+
 如果只想创建 OpenSpec 目录而不安装 OpenSpec 提供的 agent skills / instructions，可显式传入：
 
 ```bash
diff --git a/plugins/aisee-plugin/.claude-plugin/plugin.json b/plugins/aisee-plugin/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "aisee-plugin",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "AI-Enhanced Software Engineering plugin for OpenSpec and Compound Engineering workflows.",
   "author": {
     "name": "Fengliang"
diff --git a/plugins/aisee-plugin/.codex-plugin/plugin.json b/plugins/aisee-plugin/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "aisee-plugin",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "AI-Enhanced Software Engineering plugin for OpenSpec and Compound Engineering workflows.",
   "author": {
     "name": "Fengliang"
diff --git a/plugins/aisee-plugin/.cursor-plugin/plugin.json b/plugins/aisee-plugin/.cursor-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "aisee-plugin",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "AI-Enhanced Software Engineering plugin for OpenSpec and Compound Engineering workflows.",
   "author": {
     "name": "Fengliang"
diff --git a/plugins/aisee-plugin/skills/aisee-init/SKILL.md b/plugins/aisee-plugin/skills/aisee-init/SKILL.md
@@ -46,18 +46,18 @@ node -e "const {execSync}=require('child_process'); try { execSync('openspec --v
 
 如果缺少 `openspec/specs/` 或 `openspec/changes/`，先判断用户是否明确要接入 OpenSpec：
 
-- 若用户明确要接入：优先运行 `aisee openspec ensure --json`，并解析 JSON 结果；该命令会按当前 agent runtime 自动选择 OpenSpec tools（Codex 默认是 `codex`；无法识别时回退到 `none`），确保 OpenSpec 的项目内 instructions / skills 已安装或已刷新，并顺带执行全局 `openspec config profile core` 对齐。
+- 若用户明确要接入：优先运行 `aisee openspec ensure --json`，并解析 JSON 结果；该命令会按当前 agent runtime 自动选择 OpenSpec tools（Codex 默认是 `codex`；无法识别时回退到 `none`），默认启用 Aisee 需要的 expanded workflow，确保 OpenSpec 的项目内 instructions / skills 已安装或已刷新。
 - 若用户未明确要接入，或明确表示当前项目不使用 OpenSpec：停止，并说明 `aisee:init` 不适用；不要生成项目级 `AGENTS.md` 或其它 OpenSpec/Aisee 配置文件。
 
 在允许接入但 `aisee openspec ensure --json` 不可用的场景中，停止并提示用户先运行等价 OpenSpec 命令：
 
 ```bash
-openspec init . --tools codex --profile core
-openspec config profile core
+write ~/.config/openspec/config.json   # profile=custom, delivery=both, workflows=expanded set
+openspec init . --tools codex --profile custom
 openspec update .
 ```
 
-如果用户明确只想创建 OpenSpec 目录而不安装 OpenSpec 提供的 agent skills / instructions，再改为 `--tools none`。
+如果用户明确只想要 OpenSpec 的精简 `core` workflow，则改为 `aisee openspec ensure --profile core --json`。如果用户明确只想创建 OpenSpec 目录而不安装 OpenSpec 提供的 agent skills / instructions，再改为 `--tools none`。
 
 不要直接执行交互式 `openspec init` / `openspec config profile`，不要手动替代 OpenSpec CLI 创建或刷新 `openspec/` 与 instruction files。
 
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aisee-plugin"
-version = "0.10.0"
+version = "0.11.0"
 description = "AI-Enhanced Software Engineering plugin for OpenSpec and Compound Engineering workflows."
 readme = "README.md"
 requires-python = ">=3.10"
diff --git a/src/aisee_cli/__init__.py b/src/aisee_cli/__init__.py
@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.10.0"
+__version__ = "0.11.0"
diff --git a/src/aisee_cli/__main__.py b/src/aisee_cli/__main__.py
@@ -50,15 +50,19 @@ def main() -> int:
     openspec_parser.add_argument("--json", action="store_true", help="output JSON")
     openspec_subparsers = openspec_parser.add_subparsers(dest="openspec_command")
     openspec_ensure_parser = openspec_subparsers.add_parser("ensure")
-    openspec_ensure_parser.add_argument("--profile", default="core", help="OpenSpec profile preset; default: core")
+    openspec_ensure_parser.add_argument(
+        "--profile",
+        default="expanded",
+        help="Aisee OpenSpec workflow profile; supported: expanded, core; default: expanded",
+    )
     openspec_ensure_parser.add_argument(
         "--tools",
         help="OpenSpec AI tools value for init; default: auto-detect current agent runtime, fallback: none",
     )
     openspec_ensure_parser.add_argument(
         "--skip-profile",
         action="store_true",
-        help="do not run global openspec config profile alignment",
+        help="do not align the global OpenSpec workflow profile",
     )
     openspec_ensure_parser.add_argument("--skip-update", action="store_true", help="do not run openspec update")
     openspec_ensure_parser.add_argument("--force", action="store_true", help="pass --force to openspec init when initialization is needed")
diff --git a/src/aisee_cli/openspec_init.py b/src/aisee_cli/openspec_init.py
@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+import json
+import os
 import shutil
 import subprocess
 from pathlib import Path
@@ -10,11 +12,25 @@
 from aisee_cli.assets import selected_agent_runtime
 from aisee_cli.output import issue, summarize_issues
 
+EXPANDED_WORKFLOWS = [
+    "propose",
+    "explore",
+    "new",
+    "continue",
+    "apply",
+    "ff",
+    "sync",
+    "archive",
+    "bulk-archive",
+    "verify",
+    "onboard",
+]
+
 
 def run_openspec_init(
     project_root: Path,
     *,
-    profile: str = "core",
+    profile: str = "expanded",
     tools: str | None = None,
     skip_profile: bool = False,
     skip_update: bool = False,
@@ -24,13 +40,15 @@ def run_openspec_init(
     issues: list[dict[str, str]] = []
     operations: list[dict[str, Any]] = []
     resolved_tools, tools_source = resolve_openspec_tools(tools)
+    openspec_profile = resolve_openspec_profile(profile)
 
     openspec_bin = shutil.which("openspec")
     if not openspec_bin:
         issues.append(issue("OPENSPEC_CLI_NOT_FOUND", "blocker", "OpenSpec CLI was not found in PATH"))
         return build_response(
             root,
             profile,
+            openspec_profile,
             resolved_tools,
             tools_source,
             skip_profile,
@@ -40,15 +58,16 @@ def run_openspec_init(
             issues,
         )
 
-    if profile != "core" and not skip_profile:
+    if openspec_profile is None:
         issues.append(issue(
             "UNSUPPORTED_OPENSPEC_PROFILE",
             "blocker",
-            "Only the non-interactive OpenSpec profile preset 'core' is supported by default",
+            "Only Aisee presets 'expanded' and 'core' are supported",
         ))
         return build_response(
             root,
             profile,
+            "invalid",
             resolved_tools,
             tools_source,
             skip_profile,
@@ -68,7 +87,24 @@ def run_openspec_init(
             "reason": "OpenSpec project markers already exist",
         })
     else:
-        init_command = [openspec_bin, "init", ".", "--tools", resolved_tools, "--profile", profile]
+        if not skip_profile and openspec_profile == "custom":
+            profile_operation = ensure_profile_alignment(openspec_profile)
+            operations.append(profile_operation)
+            if profile_operation["status"] != "ok":
+                issues.append(issue("OPENSPEC_PROFILE_FAILED", "blocker", f"OpenSpec profile alignment for {profile} failed"))
+                return build_response(
+                    root,
+                    profile,
+                    openspec_profile,
+                    resolved_tools,
+                    tools_source,
+                    skip_profile,
+                    skip_update,
+                    force,
+                    operations,
+                    issues,
+                )
+        init_command = [openspec_bin, "init", ".", "--tools", resolved_tools, "--profile", openspec_profile]
         if force:
             init_command.append("--force")
         init_result = run_command(init_command, root)
@@ -78,6 +114,7 @@ def run_openspec_init(
             return build_response(
                 root,
                 profile,
+                openspec_profile,
                 resolved_tools,
                 tools_source,
                 skip_profile,
@@ -90,19 +127,38 @@ def run_openspec_init(
     if skip_profile:
         operations.append({
             "kind": "skip",
-            "command": "openspec config profile",
+            "command": "openspec profile alignment",
             "status": "skipped",
             "reason": "--skip-profile was provided",
         })
+    elif openspec_profile == "custom":
+        if not should_run_init:
+            profile_operation = ensure_profile_alignment(openspec_profile)
+            operations.append(profile_operation)
+            if profile_operation["status"] != "ok":
+                issues.append(issue("OPENSPEC_PROFILE_FAILED", "blocker", f"OpenSpec profile alignment for {profile} failed"))
+                return build_response(
+                    root,
+                    profile,
+                    openspec_profile,
+                    resolved_tools,
+                    tools_source,
+                    skip_profile,
+                    skip_update,
+                    force,
+                    operations,
+                    issues,
+                )
     else:
         profile_command = [openspec_bin, "config", "profile", profile]
         profile_result = run_command(profile_command, root)
         operations.append(command_operation("openspec config profile", profile_command, profile_result))
         if profile_result.returncode != 0:
-            issues.append(issue("OPENSPEC_PROFILE_FAILED", "blocker", f"openspec config profile {profile} failed"))
+            issues.append(issue("OPENSPEC_PROFILE_FAILED", "blocker", f"OpenSpec profile alignment for {profile} failed"))
             return build_response(
                 root,
                 profile,
+                openspec_profile,
                 resolved_tools,
                 tools_source,
                 skip_profile,
@@ -129,6 +185,7 @@ def run_openspec_init(
     return build_response(
         root,
         profile,
+        openspec_profile,
         resolved_tools,
         tools_source,
         skip_profile,
@@ -156,6 +213,60 @@ def resolve_openspec_tools(requested: str | None) -> tuple[str, str]:
     return "none", "runtime-default"
 
 
+def resolve_openspec_profile(profile: str) -> str | None:
+    value = profile.strip().lower()
+    if value == "expanded":
+        return "custom"
+    if value == "core":
+        return "core"
+    return None
+
+
+def ensure_profile_alignment(openspec_profile: str) -> dict[str, Any]:
+    if openspec_profile == "core":
+        return {
+            "kind": "run",
+            "command": "openspec config profile core",
+            "label": "openspec config profile",
+            "status": "pending",
+        }
+
+    config_path = openspec_global_config_path()
+    existing = read_json_object(config_path)
+    existing["profile"] = "custom"
+    existing["delivery"] = "both"
+    existing["workflows"] = list(EXPANDED_WORKFLOWS)
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+    config_path.write_text(json.dumps(existing, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+    return {
+        "kind": "write",
+        "command": f"write {config_path.as_posix()}",
+        "label": "openspec custom profile alignment",
+        "status": "ok",
+        "path": config_path.as_posix(),
+        "profile": "custom",
+        "delivery": "both",
+        "workflows": list(EXPANDED_WORKFLOWS),
+    }
+
+
+def openspec_global_config_path() -> Path:
+    xdg_config_home = os.environ.get("XDG_CONFIG_HOME")
+    if xdg_config_home:
+        return Path(xdg_config_home).expanduser() / "openspec" / "config.json"
+    return Path.home() / ".config" / "openspec" / "config.json"
+
+
+def read_json_object(path: Path) -> dict[str, Any]:
+    if not path.is_file():
+        return {}
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+    except Exception:
+        return {}
+    return data if isinstance(data, dict) else {}
+
+
 def run_command(command: list[str], cwd: Path) -> subprocess.CompletedProcess[str]:
     return subprocess.run(
         command,
@@ -195,6 +306,7 @@ def trim_output(text: str, *, limit: int = 4000) -> str:
 def build_response(
     root: Path,
     profile: str,
+    openspec_profile: str,
     tools: str,
     tools_source: str,
     skip_profile: bool,
@@ -214,6 +326,7 @@ def build_response(
         "meta": {
             "command": "aisee openspec ensure --json",
             "profile": profile,
+            "openspec_profile": openspec_profile,
             "profile_scope": "global",
             "profile_default_executes": not skip_profile,
             "update_default_executes": not skip_update,
diff --git a/tests/test_openspec_init.py b/tests/test_openspec_init.py

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "aisee-plugin",`
`3`		`- "version": "0.10.0",`
	`3`	`+ "version": "0.11.0",`
`4`	`4`	`"interface": {`
`5`	`5`	`"displayName": "Aisee Plugin",`
`6`	`6`	`"description": "Aisee plugin marketplace for OpenSpec, project memory, team knowledge, and Compound Engineering workflows."`
Original file line number	Diff line number	Diff line change
`@@ -2,4 +2,4 @@`
`2`	`2`
`3`	`3`	`__all__ = ["__version__"]`
`4`	`4`
`5`		`-__version__ = "0.10.0"`
	`5`	`+__version__ = "0.11.0"`