@aipper/aiws-spec 0.0.24 → 0.0.25

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,6 +10,8 @@ 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` 检查：
    - 是否存在越界目录改动/危险操作
    - 是否有可复现验证命令与证据
@@ -21,6 +23,7 @@ description: 评审：提交前审计改动并落盘证据
    - `证据（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 的额外说明（托管块外内容会被保留）。

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

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

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

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

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

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

package/templates/workspace/.opencode/commands/p-aiws-hooks-install.md

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

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

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

package/templates/workspace/.opencode/commands/p-aiws-init.md

@@ -0,0 +1,23 @@
+---
+description: 私有：初始化：落盘 AIWS 真值与门禁文件
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-init -->
+# aiws init
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+目标：
+- 生成/补齐真值文件与门禁文件（以 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md` 为准）
+- 写入/更新 `.gitignore` 的 aiws 托管块
+- 生成/更新 `.aiws/manifest.json`（用于漂移检测）
+
+建议执行：
+1) `npx @aipper/aiws init`
+2) `npx @aipper/aiws validate`
+
+约束：
+- 不写入任何 secrets
+- 只允许更新托管块（`AIWS_MANAGED_BEGIN/END`）或 spec 指定的 `replace_file` 文件
+<!-- AIWS_MANAGED_END:opencode:aiws-init -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-rollback.md

@@ -0,0 +1,16 @@
+---
+description: 私有：回滚：从 .aiws/backups 恢复快照
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-rollback -->
+# aiws rollback
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+目标：
+- 从 `.aiws/backups/` 恢复到某次备份快照
+
+建议执行：
+- `npx @aipper/aiws rollback latest`
+<!-- AIWS_MANAGED_END:opencode:aiws-rollback -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-update.md

@@ -0,0 +1,22 @@
+---
+description: 私有：更新：刷新模板与 tool-native 文件（先备份）
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-update -->
+# aiws update
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+目标：
+- 基于当前 `@aipper/aiws-spec` 刷新模板与 tool-native 文件
+- 更新前备份到 `.aiws/backups/<timestamp>/`
+
+建议执行：
+1) `npx @aipper/aiws update`
+2) `npx @aipper/aiws validate`
+
+约束：
+- 不写入任何 secrets
+- 只更新托管块或 spec 指定的 `replace_file` 文件
+<!-- AIWS_MANAGED_END:opencode:aiws-update -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/p-aiws-validate.md

@@ -0,0 +1,17 @@
+---
+description: 私有：门禁：校验 required/托管块/漂移（可落盘 stamp）
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-validate -->
+# aiws validate
+
+（私有原子入口；日常优先用 ws-* 链路。）
+
+目标：
+- 作为 CI/本地门禁：校验 required 文件结构、托管块、`.aiws/manifest.json` 漂移
+- 强门禁：缺 `python3`/缺 required 脚本也应失败
+
+建议执行：
+- `npx @aipper/aiws validate`
+<!-- AIWS_MANAGED_END:opencode:aiws-validate -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -0,0 +1,29 @@
+---
+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`
+   - 评审/审计：`/ws-review`
+   - finish / merge / push / cleanup：`/ws-finish`
+   - handoff / archive summary：`/ws-handoff`
+5) 输出 `OpenCode mode:` / `Task intent:` / `Binding:` / `Route:` / `Why:` / `Next:`。
+6) 除非用户只要路由判断，否则给出 route 后继续遵循对应入口的契约。
+<!-- AIWS_MANAGED_END:opencode:using-aiws -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/ws-analyze.md

@@ -0,0 +1,30 @@
+---
+description: 分析：实现前技术分析并落盘证据
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-analyze -->
+# ws analyze
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：在开始实现/修复前做一次技术分析，产出可执行的最小行动清单，并把证据落盘到 `.agentdocs/tmp/analyze/`。
+
+输入：
+- 主题/需求：`$ARGUMENTS`（若为空，先问用户一句“本次分析主题是什么？”）
+
+步骤（建议）：
+1) 先运行 `/ws-preflight`。
+2) 基于真值文件与当前代码现状，输出：
+   - 目标 / 非目标
+   - 现状证据（文件路径/接口路径）
+   - 推荐方案（1 个）+ 备选（可选）
+   - 风险与回滚（3–8 条）
+   - 最小验证命令（可复现）
+3) 将分析落盘到：`.agentdocs/tmp/analyze/opencode-analysis.md`（目录不存在则创建）。
+4) 回复中必须包含：`Evidence:` 证据文件路径。
+
+安全：
+- 不打印 secrets（尤其 `secrets/test-accounts.json`）。
+- 不执行破坏性命令。
+<!-- AIWS_MANAGED_END:opencode:ws-analyze -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/ws-bugfix.md

@@ -0,0 +1,35 @@
+---
+description: 缺陷修复：禅道 MCP 拉单、图片证据落盘并汇总 fix_bus_issues.csv
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-bugfix -->
+# ws bugfix
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 通过禅道 MCP 拉单、图片证据落盘并汇总 `issues/fix_bus_issues.csv`。
+
+建议流程：
+1) 先运行 `/ws-preflight`。
+2) 若当前不在 `change/<change-id>` 分支 / worktree，先建立 change 上下文：
+   - 工作区先保持干净
+   - 仓库已有提交：优先 `aiws change start <change-id> --hooks --worktree`
+   - superproject + submodule：优先 `aiws change start <change-id> --hooks --worktree --submodules`
+   - 仓库尚无提交 / 不满足 worktree 前置条件：回退 `aiws change start <change-id> --hooks --no-switch`
+3) 若上一步创建了 worktree：后续 bug 证据、CSV 更新、`/ws-dev` 修复都必须在该 worktree 中继续。
+4) 通过已配置 zentao MCP 拉取 bug 字段与附件列表。
+5) 落盘证据到当前 active change 上下文的 `changes/<change-id>/bug/`：
+   - `zentao-bug-<bug-id>.json`
+   - `zentao-bug-<bug-id>.md`
+   - `images/<bug-id>/...`
+6) upsert 当前 active change 上下文中的 `issues/fix_bus_issues.csv`（主键 `Bug_ID`）。
+7) 进入 `/ws-dev` 修复并回填 `Fix_Status/Verify_Command/Updated_At`。
+8) 质量门：`aiws change validate <change-id> --strict` + `aiws validate . --stamp`。
+
+强制约束：
+- 不自动 commit / push。
+- 不写入 secrets（token、cookie、内网地址）。
+- 无法复现时先输出阻塞信息并落盘，不直接改代码。
+<!-- AIWS_MANAGED_END:opencode:ws-bugfix -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。