feat(cli): 修复 openspec ensure 并升级到 0.10.0

Author: sincerely90

.agents/plugins/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "aisee-plugin",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "interface": {
     "displayName": "Aisee Plugin",
     "description": "Aisee plugin marketplace for OpenSpec, project memory, team knowledge, and Compound Engineering workflows."

CHANGELOG.md

@@ -2,7 +2,14 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) 的结构，并使用 SemVer 管理版本。
 
-## [Unreleased]
+## [0.10.0] - 2026-06-12
+
+### Changed
+
+- `aisee openspec ensure --json` 改为默认按当前 agent runtime 自动选择 OpenSpec `--tools`，在 Codex 下会安装或刷新项目目录内的 `.codex/skills`，不再默认走 `--tools none`。
+- `aisee openspec ensure --json` 的初始化检测兼容新版 OpenSpec 目录结构；已有 `openspec/specs` 与 `openspec/changes` 的项目现在也能正确补装项目内 OpenSpec instructions / skills。
+- `aisee openspec ensure --json` 的文档、help 和 workflow 说明统一明确：`openspec config profile` 只负责全局配置对齐，项目目录写入由 `openspec init/update` 完成。
+- 版本治理说明收敛到 `CHANGELOG.md`、`docs/compatibility-policy.md` 与 `CONTRIBUTING.md`；删除 `docs/release.md`，并移除 `Unreleased` 段，避免双重维护和发布后漏改文档。
 
 ## [0.9.1] - 2026-06-11
 

CONTRIBUTING.md

@@ -23,7 +23,14 @@ python -m pytest
 python scripts/check_versions.py
 ```
 
-发布前 smoke test 见 [docs/release.md](docs/release.md)。
+发布前最小 smoke test：
+
+```bash
+python scripts/sync_versions.py
+python scripts/check_versions.py
+pytest -q
+python scripts/smoke_release.py
+```
 
 ## 设计边界
 
@@ -94,7 +101,7 @@ python scripts/sync_versions.py
 python scripts/check_versions.py
 ```
 
-版本规则见 [docs/release.md](docs/release.md)。
+版本规则见 [docs/compatibility-policy.md](docs/compatibility-policy.md)，已发布版本的变更说明统一写入 [CHANGELOG.md](CHANGELOG.md)。
 
 ## 提交规范
 

README.en.md

@@ -251,14 +251,20 @@ If the project has not initialized OpenSpec yet:
 aisee openspec ensure --json
 ```
 
-This command bridges OpenSpec initialization with conservative defaults:
+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:
 
 ```text
-openspec init . --tools none --profile core
+openspec init . --tools <detected-runtime-or-none> --profile core
 openspec config profile core
 openspec update .
 ```
 
+If you only want the OpenSpec directory layout without installing OpenSpec-provided agent skills/instructions, pass:
+
+```bash
+aisee openspec ensure --tools none --json
+```
+
 Schema packs come from the marketplace-installed plugin. `aisee schemas list/check` only reports project-installed schema state or source-checkout development schema state; it does not install schemas automatically.
 
 Check the project state again:
@@ -279,7 +285,7 @@ aisee doctor --json
 - [Schema Packs](docs/schema-packs.md): schema selection, app schema artifact DAG, source-map/numbering rules, and contract attachment boundaries.
 - [Aisee / OpenSpec / Compound Engineering Integration](docs/architecture/aisee-openspec-compound-integration.md): high-level responsibility boundaries and historical decisions.
 - [OpenSpec Multi-Schema Best Practices](docs/architecture/openspec-multi-schema-best-practices.md): multi-schema coexistence, conflict handling, and management rules.
-- [Release And Version Governance](docs/release.md): single version source, release checks, and tag rules.
+- [CHANGELOG.md](CHANGELOG.md): release history, shipped notes, and user-visible changes for published versions.
 
 ## Typical Workflow
 
@@ -408,7 +414,7 @@ Key CLI rules:
 - `aisee knowledge promote-batch` only writes the local team knowledge worktree; it does not commit, push, or create PRs.
 - OpenSpec artifacts and `source-map.md` are formal inputs for context packs.
 - `bootstrap --plan` is a read-only plan and does not perform broad initialization writes.
-- `aisee openspec ensure` only bridges OpenSpec initialization, profile setup, and instruction file refresh. It does not replace `aisee:init`.
+- `aisee openspec ensure` installs or refreshes project-local OpenSpec instructions/skills and also aligns the global profile. It does not replace `aisee:init`.
 - `aisee knowledge query` returns only a small number of guardrails. By default it reads pack manifests and card frontmatter; `--debug` is required for matched card body excerpts.
 
 ### Project Memory

README.md

@@ -251,14 +251,20 @@ aisee plugin inspect --json
 aisee openspec ensure --json
 ```
 
-该命令使用保守默认值桥接 OpenSpec 初始化：
+该命令会按当前 agent runtime 自动选择 OpenSpec tools（Codex 默认是 `codex`；无法识别时回退到 `none`），确保 OpenSpec 的项目内 instructions / skills 已安装或已刷新，并对齐全局 profile：
 
 ```text
-openspec init . --tools none --profile core
+openspec init . --tools <detected-runtime-or-none> --profile core
 openspec config profile core
 openspec update .
 ```
 
+如果只想创建 OpenSpec 目录而不安装 OpenSpec 提供的 agent skills / instructions，可显式传入：
+
+```bash
+aisee openspec ensure --tools none --json
+```
+
 Schema packs 来自 marketplace-installed plugin。`aisee schemas list/check` 只报告项目已安装 schema 状态或开发期源码 schema 状态；不会由 CLI 自动安装 schema。
 
 再次检查项目状态：
@@ -279,7 +285,7 @@ aisee doctor --json
 - [Schema Packs](docs/schema-packs.md)：说明 schema 选择、app schema artifact DAG、source-map/编号规则和契约附件边界。
 - [Aisee / OpenSpec / Compound Engineering 融合方案](docs/architecture/aisee-openspec-compound-integration.md)：高层职责边界和历史决策快照。
 - [OpenSpec 多 Schema 最佳实践](docs/architecture/openspec-multi-schema-best-practices.md)：多 schema 共存、冲突和管理规则。
-- [Release And Version Governance](docs/release.md)：版本号单一事实源、发布检查和 tag 规则。
+- [CHANGELOG.md](CHANGELOG.md)：版本历史、发布说明和已发布版本的用户可见变更。
 
 ## 典型流程
 
@@ -407,7 +413,7 @@ CLI 关键规则：
 - `aisee knowledge promote-batch` 只写本地 team knowledge worktree，不自动 commit、push 或创建 PR。
 - OpenSpec artifacts 和 `source-map.md` 是 context pack 的正式输入。
 - `bootstrap --plan` 是只读计划，不做大而全初始化写入。
-- `aisee openspec ensure` 只桥接 OpenSpec 初始化、profile 设置和 instruction files 刷新，不替代 `aisee:init`。
+- `aisee openspec ensure` 负责项目目录内 OpenSpec instructions / skills 的安装或刷新，并顺带对齐全局 profile；它不替代 `aisee:init`。
 - `aisee knowledge query` 只返回少量 guardrails；默认只读 pack manifest 和 card frontmatter，`--debug` 才包含命中 card 的正文摘要。
 
 ### 项目记忆

aisee/memory/arch/2026-06-07-version-governance.md

@@ -15,7 +15,7 @@ Aisee Plugin 的版本号必须以 `pyproject.toml [project].version` 为唯一
 - 同步脚本：`python scripts/sync_versions.py`。
 - 检查脚本：`python scripts/check_versions.py`。
 - CI/本地测试：`tests/test_version_consistency.py`。
-- 发布说明：`docs/release.md`。
+- 发布说明：`CHANGELOG.md`。
 
 版本号分布文件：
 
@@ -41,4 +41,4 @@ pytest -q
 - `scripts/check_versions.py`
 - `scripts/sync_versions.py`
 - `tests/test_version_consistency.py`
-- `docs/release.md`
+- `CHANGELOG.md`

docs/release.md

@@ -28,6 +28,8 @@ codex plugin add aisee-plugin@aisee-plugin
 aisee doctor --json
 ```
 
+Boundary note: `aisee openspec ensure` is the step that writes OpenSpec instructions/skills into the current project directory and also aligns global `openspec config profile`; do not treat `config profile` itself as the project-local installation step.
+
 Use `aisee:init` to audit or create:
 
 - `AGENTS.md`