@aipper/aiws-spec 0.0.24 → 0.0.26

package/templates/workspace/.claude/skills/ws-submodule-setup/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: ws-submodule-setup
+description: 子模块分支对齐（写入 .gitmodules 的 submodule.<name>.branch；减少 detached 与人为差异）
+---
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 为每个 submodule 写入 `.gitmodules` 的 `submodule.<name>.branch`，让 `ws-pull` / `ws-finish` 能确定性地“挂回分支/fast-forward push”，避免 origin 多分支时靠猜导致偏差。
+- 该变更是 **superproject 的团队真值**：需要提交 `.gitmodules`。
+
+安全约束（强制）：
+- 不自动提交、不自动 push（必须先输出 diff 并让用户确认）
+- 不在 submodule 中做破坏性操作（不 `reset --hard` / 不改动远端）
+
+步骤（建议）：
+1) 确认工作区干净（否则停止）：
+```bash
+git status --porcelain
+```
+
+2) 列出 submodules（没有则停止并说明无需配置）：
+```bash
+test -f .gitmodules || { echo "no .gitmodules"; exit 0; }
+git config --file .gitmodules --get-regexp '^submodule\\..*\\.path$'
+```
+
+3) 对每个 submodule，输出当前配置与建议分支（让用户确认每个 submodule 的 branch）：
+```bash
+while read -r key sub_path; do
+  name="${key#submodule.}"; name="${name%.path}"
+  echo "== submodule: ${name} path=${sub_path} =="
+  echo "[current] branch=$(git config --file .gitmodules --get submodule.${name}.branch || true)"
+  echo "[origin]  HEAD=$(git -C \"${sub_path}\" symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null || true)"
+  git -C "${sub_path}" branch -r --list "origin/*" | sed -n '1,30p' || true
+  echo "[choose] set one of:"
+  echo "  - a concrete branch, e.g. main / master / release/x.y"
+  echo "  - '.' to follow superproject current branch name (only if your team uses matching branch names)"
+done < <(git config --file .gitmodules --get-regexp '^submodule\\..*\\.path$')
+```
+
+4) 逐个写入分支配置（每次写完都回显，避免误配）：
+```bash
+# Example:
+# git submodule set-branch --branch main path/to/submodule
+# git submodule set-branch --branch .    path/to/submodule
+```
+
+5) 输出变更并让用户确认是否提交：
+```bash
+git diff -- .gitmodules
+git status --porcelain
+```
+
+6) 若用户确认要提交：
+```bash
+git add .gitmodules
+git commit -m "chore(submodule): set tracking branches"
+```
+
+输出要求：
+- `Submodules:` name/path + 选择的 branch（每个都列出）
+- `Diff:` `.gitmodules` 的 diff（或至少 `git diff -- .gitmodules` 的摘要）
+- `Next:` 提示后续用 `$ws-pull` 拉取可自动减少 detached；`aiws validate` 会检查该配置是否齐全
+

package/templates/workspace/.claude/skills/ws-verify-before-complete/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: ws-verify-before-complete
+description: 完成前验证（finish / handoff 前检查双审查与 validate/evidence 是否齐全）
+---
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 在进入 `$ws-finish` / `$ws-handoff` 前，检查 review、validate stamp 和证据是否齐全
+- 输出明确的 pass/fail 结论，避免“看起来完成了但 gate 没过”的伪完成
+
+阶段定位：
+- finish 前 gate；负责 completion readiness 检查，不直接做 merge / push / handoff。
+
+必需输入：
+- `changes/<change-id>/review/spec-review.md`
+- `changes/<change-id>/review/quality-review.md`
+- `.agentdocs/tmp/aiws-validate/*.json`
+- 若存在：`changes/<change-id>/evidence/...`、`git status`
+
+必需输出：
+- `证据（Evidence）:` `changes/<change-id>/evidence/verify-before-complete.md` 或回退 `.agentdocs/tmp/review/verify-before-complete.md`
+- `结论（Result）:` pass / fail
+- `缺失项（Missing）:` 未满足的 gate
+- `下一步（Next）:` 进入 `$ws-finish` / `$ws-handoff`，或回退前置 gate
+
+阻断条件：
+- 缺少 spec review
+- 缺少 quality review
+- 缺少 validate stamp
+- review 中仍有未关闭 blocker
+- 无法写 verification 证据
+
+完成判定：
+- 已落盘 verify-before-complete 证据，并明确能否进入 `$ws-finish` / `$ws-handoff`。
+
+步骤（建议）：
+1) 识别当前 `change/<change-id>`。
+2) 检查以下最小 gate：
+   - `changes/<change-id>/review/spec-review.md`
+   - `changes/<change-id>/review/quality-review.md`
+   - `.agentdocs/tmp/aiws-validate/*.json`
+3) 若存在 `changes/<change-id>/evidence/`，检查是否已经收敛 review / validate / collaboration summary。
+4) 将结果落盘到：
+   - 默认：`changes/<change-id>/evidence/verify-before-complete.md`
+   - 回退：`.agentdocs/tmp/review/verify-before-complete.md`
+5) 输出：
+   - `证据（Evidence）:`
+   - `结论（Result）: pass|fail`
+   - `缺失项（Missing）:`
+   - `下一步（Next）:`
+
+重点：
+- 这个 gate 不替代 `$ws-finish`；它只判断“是否具备进入 finish / handoff 的前置条件”。
+- 若 fail，必须明确回退到哪个 gate：`$ws-spec-review`、`$ws-quality-review`、`aiws validate . --stamp` 或 `aiws change evidence <change-id>`。
+
+安全：
+- 不打印 secrets。
+- 不执行破坏性命令。

package/templates/workspace/.githooks/commit-msg

@@ -13,6 +13,16 @@ policy="${AIWS_COMMIT_MSG_POLICY:-}"
 if [[ -z "${policy:-}" ]]; then
   policy="$(git config --get aiws.commitMessagePolicy 2>/dev/null || true)"
 fi
+if [[ -z "${policy:-}" ]]; then
+  superproject_root="$(git rev-parse --show-superproject-working-tree 2>/dev/null || true)"
+  if [[ -n "${superproject_root:-}" ]]; then
+    policy="warn"
+  elif [[ -f ".gitmodules" ]]; then
+    policy="off"
+  else
+    policy="warn"
+  fi
+fi
 policy="${policy:-warn}"
 
 case "$policy" in

package/templates/workspace/.opencode/command/using-aiws.md

@@ -0,0 +1,30 @@
+---
+description: 默认 workflow router：先判定阶段，再进入具体 ws-* 入口
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:using-aiws -->
+# using aiws
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 把当前任务先路由到正确的 AIWS workflow，而不是直接跳进实现。
+
+执行建议：
+1) 先读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`。
+   - 若检测到 `.opencode/oh-my-opencode.json`：输出 `OpenCode mode: oMo-enabled`，并注明后续会优先借用 `planner-sisyphus` / `explore` / `librarian` / `oracle`
+   - 若未检测到：输出 `OpenCode mode: standard-opencode`
+2) 若缺失任一真值文件：先 `/ws-preflight`，必要时运行 `aiws init .`，不要继续实现。
+3) 若任务意图、归因或验证入口不明确：先提 1-3 个关键澄清问题并停止。
+4) 路由规则：
+   - 需求/验收/合同变更：`/ws-req-review`
+   - 中大型实现或需要 change/worktree：`/ws-plan`
+   - 小步明确实现：`/ws-dev`（若是 simple/local 单点修复，可显式进入 `/ws-dev-lite`）
+   - 评审/审计：`/ws-review`
+   - finish / merge / push / cleanup：`/ws-finish`
+   - handoff / archive summary：`/ws-handoff`
+5) 输出 `OpenCode mode:` / `Task intent:` / `Binding:` / `Route:` / `Why:` / `Next:`。
+6) 若 `Route: ws-dev` 且任务属于 simple/local 单点修复：`Next` 可显式建议 `/ws-dev-lite`。
+7) 除非用户只要路由判断，否则给出 route 后继续遵循对应入口的契约。
+<!-- AIWS_MANAGED_END:opencode:using-aiws -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/command/ws-delegate.md

@@ -0,0 +1,33 @@
+---
+description: 委托：按 AIWS 合同拆分子任务，并优先借用 oMo agent
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-delegate -->
+# ws delegate
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：先写清 delegation plan，再决定是否优先借用 `oh-my-opencode` 的 `planner-sisyphus` / `explore` / `librarian` / `oracle`；若不可用则回退，不阻断流程。
+
+执行建议：
+1) 先运行 `/ws-preflight`，再读取 `packages/spec/docs/workflow-delegation-contracts.md` 与 `packages/spec/docs/opencode-omo-adapter.md`。
+2) 先写 `Delegation Plan:`，至少包含：
+   - `role`
+   - `preferred agent`
+   - `task`
+   - `readScope`
+   - `writeScope`
+   - `artifactTargets`
+   - `fallback`
+3) 若检测到 `.opencode/oh-my-opencode.json` 或当前会话明确可用相关 agent：
+   - planning 优先 `planner-sisyphus`
+   - 探索优先 `@explore` / `@librarian`
+   - 独立审查优先 `@oracle`
+4) 主 agent 统一收敛结果，并把产物回收到：
+   - `changes/<id>/analysis/`
+   - `changes/<id>/patches/`
+   - `changes/<id>/review/`
+   - `changes/<id>/evidence/`
+5) 若 oMo agent 不可用：明确回退为普通 OpenCode delegation / 单 agent 执行。
+<!-- AIWS_MANAGED_END:opencode:ws-delegate -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/command/ws-dev-lite.md

@@ -0,0 +1,34 @@
+---
+description: 轻量开发：simple/local 单点修复；最小改动 + 最小验证
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-dev-lite -->
+# ws dev lite
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：处理 simple/local 单点修复，走最小改动 + 最小验证，不默认拉起完整重流程。
+
+使用条件：
+- 目标明确、归因明确、验证入口明确
+- 一般只影响单文件或紧密相关的小范围文件
+- 不需要先改 `REQUIREMENTS.md`
+
+强制流程：
+1) 先运行 `/ws-preflight`。
+2) 先说明：
+   - `Goal:`
+   - `Why lite:`
+   - 若说不清，立刻回到 `/ws-dev` 或 `/ws-plan`
+3) 实施最小改动；不要为形式完整额外扩 scope。
+4) 运行最小可复现验证；允许比全量更窄，但必须说明为什么足够。
+5) 输出 `Changed / Verify / Evidence / Next`。
+6) 若准备提交或交付：后续仍进入 `/ws-review`、`/ws-commit`、`/ws-finish`。
+
+边界：
+- 默认不创建 `plan/...`
+- 默认不跑 `ws-plan-verify`
+- 默认不要求先做双 review
+- 一旦复杂度升高，停止 lite，切回主流程
+<!-- AIWS_MANAGED_END:opencode:ws-dev-lite -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/command/ws-finish.md

@@ -61,7 +61,7 @@ fi
 6) 任一 submodule 不满足 fast-forward 条件时立即停止（不要继续 push 主仓库）。
 7) submodules 全部成功后，再回到主仓库执行：
    - `aiws change finish <change-id> --push`
-8) （可选）交付完成后归档变更工件：`aiws change archive <change-id>`。
+8) `aiws change finish --push` 成功后会自动归档并生成 handoff；只有历史/异常场景才需要手工运行 `aiws change archive <change-id>`。
 
 安全：
 - push 前先输出状态并说明远端/分支。

package/templates/workspace/.opencode/command/ws-handoff.md

@@ -1,5 +1,5 @@
 ---
-description: 交接：查看归档 change 的 handoff.md（由 aiws change archive 生成）
+description: 交接：查看归档 change 的 handoff.md（标准由 aiws change finish --push 自动归档生成）
 ---
 <!-- AIWS_MANAGED_BEGIN:opencode:ws-handoff -->
 # ws handoff
@@ -8,10 +8,10 @@ description: 交接：查看归档 change 的 handoff.md（由 aiws change archi
 
 目标：
 - 交接与回放：通过 `handoff.md` 让已归档的 change 可被下一位/下一次会话快速接力。
-- handoff 文件位置：`changes/archive/<date>-<change-id>/handoff.md`（由 `aiws change archive` 自动生成）。
+- handoff 文件位置：`changes/archive/<date>-<change-id>/handoff.md`（默认由 `aiws change finish --push` 自动归档时生成）。
 
 执行建议：
-1) 若 change 已完成并准备归档：运行 `/p-aiws-change-archive`（会先严格校验，再归档并生成 `handoff.md`）。
+1) 先确认 change 已通过 `/ws-finish` 或 `aiws change finish --push` 完成自动归档。
 2) 查看 handoff：
 ```bash
 change_id="<change-id>"
@@ -20,6 +20,7 @@ sed -n '1,160p' changes/archive/*-"${change_id}"/handoff.md
 ```
 3) 依赖提示：
 - 若你在某个 change 的 `proposal.md` 声明了 `Depends_On`，`aiws change start` 会尝试读取依赖 change 的 `handoff.md` 并输出摘要（前提：依赖已归档且 handoff 存在）。
+- 若是历史/异常场景尚未归档，再手工运行 `/p-aiws-change-archive`。
 <!-- AIWS_MANAGED_END:opencode:ws-handoff -->
 
 可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/command/ws-plan.md

@@ -11,6 +11,8 @@ description: 规划：生成可落盘 plan 工件
 
 执行建议：
 1) 先运行 `/ws-preflight`（对齐 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`）。
+   - 若检测到 `.opencode/oh-my-opencode.json` 或当前会话明确可用 `planner-sisyphus` / `explore` / `librarian`：优先按 `packages/spec/docs/opencode-omo-adapter.md` 借用这些 agent。
+   - 计划主框架优先 `planner-sisyphus`；结构探索优先 `@explore`；规范/文档查证优先 `@librarian`。
 2) 若当前不在 `change/<change-id>` 分支 / worktree，先调用 `aiws change start <change-id>` 建立上下文：
    - 仓库已有提交：优先 `aiws change start <change-id> --hooks --worktree`；若声明了 submodules，加 `--submodules`
    - 仓库尚无提交 / 不满足 worktree 前置条件：回退 `aiws change start <change-id> --hooks --no-switch`
@@ -19,6 +21,7 @@ description: 规划：生成可落盘 plan 工件
 5) 计划至少包含：`Bindings`、`Goal`、`Non-goals`、`Scope`、`Plan`、`Verify`、`Risks & Rollback`、`Evidence`。
 6) 若已有 `changes/<change-id>/proposal.md`，对齐 `Plan_File` / `Contract_Row` / `Evidence_Path`。
 7) 完成后先运行 `/ws-plan-verify`，通过再进入 `/ws-dev`。
+8) 若 oMo 不可用：回退为普通 OpenCode `plan` / 当前 agent 本地规划，但仍必须落盘完整 `plan/...`。
 <!-- AIWS_MANAGED_END:opencode:ws-plan -->
 
 可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/command/ws-preflight.md

@@ -20,6 +20,10 @@ description: 预检：读取真值文件并输出约束摘要
    - `Root:` <项目根路径>
    - `Found:` <实际读取到的文件列表>
    - `Missing:` <缺失文件列表>
+   - `OpenCode mode:` 
+     - 若检测到 `.opencode/oh-my-opencode.json`：`oMo-enabled`
+     - 否则：`standard-opencode`
+   - 若为 `oMo-enabled`：附一句说明后续 `ws-plan` / `ws-review` / `ws-spec-review` / `ws-quality-review` / `ws-delegate` 会优先借用 oMo agent
    - `Key rules:` 3–8 条 bullet（范围/禁止项/必须产物/必须验证命令）
 
 安全：

package/templates/workspace/.opencode/command/ws-quality-review.md

@@ -0,0 +1,30 @@
+---
+description: 质量审查：行为回归 / 测试覆盖 / 实现质量
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-quality-review -->
+# ws quality review
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：审查行为回归、边界条件、测试覆盖与实现质量。
+
+步骤（建议）：
+1) 读取 `git diff`、已执行的验证结果和相关代码。
+   - 若检测到 `.opencode/oh-my-opencode.json` 或当前会话明确可用 `oracle` / `explore`：优先按 `packages/spec/docs/opencode-omo-adapter.md` 借用这些 agent。
+   - 质量/回归审查优先 `@oracle`；代码路径与影响面补充优先 `@explore`。
+2) 检查：
+   - 是否存在行为回归或明显 bug 风险
+   - 边界条件 / 失败路径是否覆盖
+   - 测试是否足以支撑当前改动
+3) 将结论落盘到：
+   - 默认：`changes/<change-id>/review/quality-review.md`
+   - 回退：`.agentdocs/tmp/review/quality-review.md`
+4) 输出：
+   - `证据（Evidence）:`
+   - `主要发现（Findings）:`
+   - `测试缺口（Gaps）:`
+   - `下一步（Next）:`
+5) 若 oMo 不可用：回退为当前 agent 本地 quality review。
+<!-- AIWS_MANAGED_END:opencode:ws-quality-review -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/command/ws-review.md

@@ -10,17 +10,20 @@ description: 评审：提交前审计改动并落盘证据
 
 步骤（建议）：
 1) 先运行 `/ws-preflight`。
+   - 若检测到 `.opencode/oh-my-opencode.json` 或当前会话明确可用 `oracle` / `explore` / `librarian`：优先按 `packages/spec/docs/opencode-omo-adapter.md` 借用这些 agent。
+   - 独立审查优先 `@oracle`；diff 影响面优先 `@explore`；规范/文档上下文优先 `@librarian`。
 2) 基于 `git status` / `git diff`（以及你实际运行过的测试结果），对照 `AI_PROJECT.md` 与 `REQUIREMENTS.md` 检查：
    - 是否存在越界目录改动/危险操作
    - 是否有可复现验证命令与证据
    - 是否维护了 `changes/<change-id>/` 或相关 `issues/*.csv`
 3) 将审计落盘到（目录不存在则创建）：
-   - 默认：`changes/<change-id>/review/opencode-review.md`
-   - 回退：`.agentdocs/tmp/review/opencode-review.md`（仅在无法确定 `change-id` 时使用）
+   - 默认：`changes/<change-id>/review/codex-review.md`
+   - 回退：`.agentdocs/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
 4) 回复中输出：
    - `证据（Evidence）:` 证据文件路径
    - `主要风险（Top risks）:` 3–8 条（高→低）
    - `下一步（Next）:` 最小修复清单 + 最小验证命令
+5) 若 oMo 不可用：回退为当前 agent 本地 review，不阻断流程。
 
 安全：
 - 不打印 secrets。

package/templates/workspace/.opencode/command/ws-spec-review.md

@@ -0,0 +1,30 @@
+---
+description: 规范审查：requirements / plan / evidence / gate 完整性
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-spec-review -->
+# ws spec review
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：审查 requirements 归因、plan/change 绑定、evidence 与 workflow gate 完整性。
+
+步骤（建议）：
+1) 先运行 `/ws-preflight`。
+   - 若检测到 `.opencode/oh-my-opencode.json` 或当前会话明确可用 `oracle` / `librarian`：优先按 `packages/spec/docs/opencode-omo-adapter.md` 借用这些 agent。
+   - requirements / gate / evidence 审查优先 `@oracle`；规范与文档真值补充优先 `@librarian`。
+2) 对照 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md` 检查：
+   - 当前改动是否能归因到 `Req_ID` / `Problem_ID`
+   - `plan/...`、`proposal.md`、`tasks.md`、`evidence/` 是否保持一致
+   - 是否存在越界改动、危险操作或缺失 gate
+3) 将结论落盘到：
+   - 默认：`changes/<change-id>/review/spec-review.md`
+   - 回退：`.agentdocs/tmp/review/spec-review.md`
+4) 输出：
+   - `证据（Evidence）:`
+   - `阻断项（Blockers）:`
+   - `警告（Warnings）:`
+   - `下一步（Next）:`
+5) 若 oMo 不可用：回退为当前 agent 本地 spec review。
+<!-- AIWS_MANAGED_END:opencode:ws-spec-review -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/command/ws-verify-before-complete.md

@@ -0,0 +1,27 @@
+---
+description: 完成前验证：finish / handoff 前检查双审查与 validate/evidence
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-verify-before-complete -->
+# ws verify before complete
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：在 `/ws-finish` 或 `/ws-handoff` 前检查双审查、validate stamp 与 evidence 是否齐全。
+
+步骤（建议）：
+1) 检查以下最小 gate：
+   - `changes/<change-id>/review/spec-review.md`
+   - `changes/<change-id>/review/quality-review.md`
+   - `.agentdocs/tmp/aiws-validate/*.json`
+2) 若存在 `changes/<change-id>/evidence/`，检查 review / validate / collaboration summary 是否已收敛。
+3) 将结果落盘到：
+   - 默认：`changes/<change-id>/evidence/verify-before-complete.md`
+   - 回退：`.agentdocs/tmp/review/verify-before-complete.md`
+4) 输出：
+   - `证据（Evidence）:`
+   - `结论（Result）: pass|fail`
+   - `缺失项（Missing）:`
+   - `下一步（Next）:`
+<!-- AIWS_MANAGED_END:opencode:ws-verify-before-complete -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-change-archive.md

@@ -0,0 +1,27 @@
+---
+description: 私有：变更归档：归档已完成的 change 工件并生成 handoff.md
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-archive -->
+# aiws change archive
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 归档已完成 change 工件，并生成交接文档：`changes/archive/.../handoff.md`
+
+执行（在仓库根目录）：
+```bash
+change_id="<change-id>"
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change archive "${change_id}"
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change archive "${change_id}"
+else
+  npx @aipper/aiws change archive "${change_id}"
+fi
+```
+<!-- AIWS_MANAGED_END:opencode:aiws-change-archive -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-change-finish.md

@@ -0,0 +1,27 @@
+---
+description: 私有：变更收尾：安全合并 change 分支回目标分支
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-finish -->
+# aiws change finish
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 将 change/<change-id> 安全 fast-forward 合并回目标分支
+
+执行（在仓库根目录）：
+```bash
+change_id="<change-id>"  # 可留空（若当前分支可推断）
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change finish "${change_id}"
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change finish "${change_id}"
+else
+  npx @aipper/aiws change finish "${change_id}"
+fi
+```
+<!-- AIWS_MANAGED_END:opencode:aiws-change-finish -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-change-list.md

@@ -0,0 +1,26 @@
+---
+description: 私有：变更列表：列出当前仓库 change 工件
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-list -->
+# aiws change list
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 列出当前仓库 change 工件
+
+执行（在仓库根目录）：
+```bash
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change list
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change list
+else
+  npx @aipper/aiws change list
+fi
+```
+<!-- AIWS_MANAGED_END:opencode:aiws-change-list -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-change-new.md

@@ -0,0 +1,27 @@
+---
+description: 私有：变更新建：创建 changes/<change-id> 工件
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-new -->
+# aiws change new
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 创建 changes/<change-id> 工件目录与基础文件
+
+执行（在仓库根目录）：
+```bash
+change_id="<change-id>"
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change new "${change_id}"
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change new "${change_id}"
+else
+  npx @aipper/aiws change new "${change_id}"
+fi
+```
+<!-- AIWS_MANAGED_END:opencode:aiws-change-new -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-change-next.md

@@ -0,0 +1,27 @@
+---
+description: 私有：变更下一步：输出当前 change 的建议动作
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-next -->
+# aiws change next
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 输出 change 下一步建议动作
+
+执行（在仓库根目录）：
+```bash
+change_id="<change-id>"  # 可留空（若当前分支可推断）
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change next "${change_id}"
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change next "${change_id}"
+else
+  npx @aipper/aiws change next "${change_id}"
+fi
+```
+<!-- AIWS_MANAGED_END:opencode:aiws-change-next -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-change-start.md

@@ -0,0 +1,27 @@
+---
+description: 私有：变更开始：切到 change/<change-id> 并初始化工件
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-start -->
+# aiws change start
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 切到 change/<change-id> 并初始化变更工件
+
+执行（在仓库根目录）：
+```bash
+change_id="<change-id>"
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change start "${change_id}"
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change start "${change_id}"
+else
+  npx @aipper/aiws change start "${change_id}"
+fi
+```
+<!-- AIWS_MANAGED_END:opencode:aiws-change-start -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-change-status.md

@@ -0,0 +1,27 @@
+---
+description: 私有：变更状态：查看 change 状态与阻断项
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-status -->
+# aiws change status
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看 change 当前状态与阻断项
+
+执行（在仓库根目录）：
+```bash
+change_id="<change-id>"  # 可留空（若当前分支可推断）
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change status "${change_id}"
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change status "${change_id}"
+else
+  npx @aipper/aiws change status "${change_id}"
+fi
+```
+<!-- AIWS_MANAGED_END:opencode:aiws-change-status -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-change-sync.md

@@ -0,0 +1,27 @@
+---
+description: 私有：变更同步：同步 change 与真值基线
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-sync -->
+# aiws change sync
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 同步当前 change 与真值文件基线
+
+执行（在仓库根目录）：
+```bash
+change_id="<change-id>"
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change sync "${change_id}"
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change sync "${change_id}"
+else
+  npx @aipper/aiws change sync "${change_id}"
+fi
+```
+<!-- AIWS_MANAGED_END:opencode:aiws-change-sync -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。