@aipper/aiws-spec 0.0.18 → 0.0.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipper/aiws-spec",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "description": "AIWS spec and templates (single source of truth).",
   "type": "module",
   "files": [

package/templates/workspace/.claude/commands/aiws-change-archive.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-archive -->
+# aiws change archive
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 归档已完成 change 工件
+
+执行（在仓库根目录）：
+```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:claude:aiws-change-archive -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-finish.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-finish -->
+# aiws change finish
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 将 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:claude:aiws-change-finish -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-list.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-list -->
+# aiws change list
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 列出当前仓库 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:claude:aiws-change-list -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-new.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-new -->
+# aiws change new
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 创建 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:claude:aiws-change-new -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-next.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-next -->
+# aiws change next
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 输出 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:claude:aiws-change-next -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-start.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-start -->
+# aiws change start
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 切到 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:claude:aiws-change-start -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-status.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-status -->
+# aiws change status
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看 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:claude:aiws-change-status -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-sync.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-sync -->
+# aiws change sync
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 同步当前 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:claude:aiws-change-sync -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-templates-init.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-templates-init -->
+# aiws change templates init
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 初始化 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:claude:aiws-change-templates-init -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-templates-which.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-templates-which -->
+# aiws change templates which
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看 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:claude:aiws-change-templates-which -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-validate.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-validate -->
+# aiws change validate
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 按严格模式校验变更工件与绑定关系
+
+执行（在仓库根目录）：
+```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:claude:aiws-change-validate -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-hooks-install.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-hooks-install -->
+# aiws hooks install
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 启用 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:claude:aiws-hooks-install -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-hooks-status.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-hooks-status -->
+# aiws hooks status
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看当前仓库 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:claude:aiws-hooks-status -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

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

@@ -0,0 +1,27 @@
+<!-- AIWS_MANAGED_BEGIN:claude:ws-bugfix -->
+# ws bugfix
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 通过禅道 MCP 拉单、图片证据落盘并汇总 `issues/fix_bus_issues.csv`。
+
+建议流程：
+1) 先运行 `/ws-preflight`。
+2) 建立变更工件（推荐）：`aiws change start <change-id> --hooks`（superproject+submodule 可用 `--worktree --submodules`）。
+3) 通过已配置 zentao MCP 拉取 bug 字段与附件列表。
+4) 落盘证据到 `changes/<change-id>/bug/`：
+   - `zentao-bug-<bug-id>.json`
+   - `zentao-bug-<bug-id>.md`
+   - `images/<bug-id>/...`
+5) upsert `issues/fix_bus_issues.csv`（主键 `Bug_ID`）。
+6) 进入 `/ws-dev` 修复并回填 `Fix_Status/Verify_Command/Updated_At`。
+7) 质量门：`aiws change validate <change-id> --strict` + `aiws validate . --stamp`。
+
+强制约束：
+- 不自动 commit / push。
+- 不写入 secrets（token、cookie、内网地址）。
+- 无法复现时先输出阻塞信息并落盘，不直接改代码。
+<!-- AIWS_MANAGED_END:claude:ws-bugfix -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/ws-plan-verify.md

@@ -0,0 +1,25 @@
+<!-- AIWS_MANAGED_BEGIN:claude:ws-plan-verify -->
+# ws plan verify
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 执行前检查计划是否跑偏，并给出最小修正项。
+
+执行建议：
+1) 先运行 `/ws-preflight`。
+2) 运行严格门禁：
+```bash
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change validate <change-id> --strict
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change validate <change-id> --strict
+else
+  npx @aipper/aiws change validate <change-id> --strict
+fi
+```
+3) 若失败：先修 `proposal.md` / `plan` 的绑定字段与验证命令，再复跑。
+4) 通过后再进入 `/ws-dev`。
+<!-- AIWS_MANAGED_END:claude:ws-plan-verify -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/ws-plan.md

@@ -0,0 +1,17 @@
+<!-- AIWS_MANAGED_BEGIN:claude:ws-plan -->
+# ws plan
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 生成可落盘执行计划（供 /ws-dev 执行）。
+
+执行建议：
+1) 先运行 `/ws-preflight`（对齐 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`）。
+2) 生成或更新计划文件：`plan/YYYY-MM-DD_HH-MM-SS-<slug>.md`。
+3) 计划至少包含：`Bindings`、`Goal`、`Non-goals`、`Scope`、`Plan`、`Verify`、`Risks & Rollback`、`Evidence`。
+4) 若已有 `changes/<change-id>/proposal.md`，对齐 `Plan_File` / `Contract_Row` / `Evidence_Path`。
+5) 完成后先运行 `/ws-plan-verify`，通过再进入 `/ws-dev`。
+<!-- AIWS_MANAGED_END:claude:ws-plan -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/command/aiws-change-archive.md

@@ -0,0 +1,25 @@
+---
+description: 变更归档：归档已完成的 change 工件
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-archive -->
+# aiws change archive
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 归档已完成 change 工件
+
+执行（在仓库根目录）：
+```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/command/aiws-change-finish.md

@@ -0,0 +1,25 @@
+---
+description: 变更收尾：安全合并 change 分支回目标分支
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-finish -->
+# aiws change finish
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 将 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/command/aiws-change-list.md

@@ -0,0 +1,24 @@
+---
+description: 变更列表：列出当前仓库 change 工件
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-list -->
+# aiws change list
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 列出当前仓库 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/command/aiws-change-new.md

@@ -0,0 +1,25 @@
+---
+description: 变更新建：创建 changes/<change-id> 工件
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-new -->
+# aiws change new
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 创建 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/command/aiws-change-next.md

@@ -0,0 +1,25 @@
+---
+description: 变更下一步：输出当前 change 的建议动作
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-next -->
+# aiws change next
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 输出 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/command/aiws-change-start.md

@@ -0,0 +1,25 @@
+---
+description: 变更开始：切到 change/<change-id> 并初始化工件
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-start -->
+# aiws change start
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 切到 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/command/aiws-change-status.md

@@ -0,0 +1,25 @@
+---
+description: 变更状态：查看 change 状态与阻断项
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-status -->
+# aiws change status
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看 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/command/aiws-change-sync.md

@@ -0,0 +1,25 @@
+---
+description: 变更同步：同步 change 与真值基线
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-sync -->
+# aiws change sync
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 同步当前 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/command/aiws-change-templates-init.md

@@ -0,0 +1,24 @@
+---
+description: 模板初始化：初始化 changes/templates 覆盖模板
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-templates-init -->
+# aiws change templates init
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 初始化 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/command/aiws-change-templates-which.md

@@ -0,0 +1,24 @@
+---
+description: 模板来源：查看 change templates 来源
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-templates-which -->
+# aiws change templates which
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看 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/command/aiws-change-validate.md

@@ -0,0 +1,25 @@
+---
+description: 变更校验：按 strict 校验变更工件与绑定
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-change-validate -->
+# aiws change validate
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 按严格模式校验变更工件与绑定关系
+
+执行（在仓库根目录）：
+```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/command/aiws-hooks-install.md

@@ -0,0 +1,24 @@
+---
+description: Hooks 启用：启用 git hooks 门禁
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-hooks-install -->
+# aiws hooks install
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 启用 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/command/aiws-hooks-status.md

@@ -0,0 +1,24 @@
+---
+description: Hooks 状态：查看当前仓库 hooks 门禁状态
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:aiws-hooks-status -->
+# aiws hooks status
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看当前仓库 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/command/ws-bugfix.md

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

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

@@ -0,0 +1,28 @@
+---
+description: 计划质检：执行前检查并给出最小修正项
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-plan-verify -->
+# ws plan verify
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 执行前检查计划是否跑偏，并给出最小修正项。
+
+执行建议：
+1) 先运行 `/ws-preflight`。
+2) 运行严格门禁：
+```bash
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change validate <change-id> --strict
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change validate <change-id> --strict
+else
+  npx @aipper/aiws change validate <change-id> --strict
+fi
+```
+3) 若失败：先修 `proposal.md` / `plan` 的绑定字段与验证命令，再复跑。
+4) 通过后再进入 `/ws-dev`。
+<!-- AIWS_MANAGED_END:opencode:ws-plan-verify -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -0,0 +1,20 @@
+---
+description: 规划：生成可落盘 plan 工件
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-plan -->
+# ws plan
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 生成可落盘执行计划（供 /ws-dev 执行）。
+
+执行建议：
+1) 先运行 `/ws-preflight`（对齐 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`）。
+2) 生成或更新计划文件：`plan/YYYY-MM-DD_HH-MM-SS-<slug>.md`。
+3) 计划至少包含：`Bindings`、`Goal`、`Non-goals`、`Scope`、`Plan`、`Verify`、`Risks & Rollback`、`Evidence`。
+4) 若已有 `changes/<change-id>/proposal.md`，对齐 `Plan_File` / `Contract_Row` / `Evidence_Path`。
+5) 完成后先运行 `/ws-plan-verify`，通过再进入 `/ws-dev`。
+<!-- AIWS_MANAGED_END:opencode:ws-plan -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/manifest.json

@@ -3,7 +3,12 @@
   "template_version": 2,
   "defaults": {
     "include_optional": true,
-    "tools": ["claude", "opencode", "codex", "iflow"]
+    "tools": [
+      "claude",
+      "opencode",
+      "codex",
+      "iflow"
+    ]
   },
   "required": [
     "AGENTS.md",
@@ -51,6 +56,7 @@
     ".opencode/command/ws-dev.md",
     ".opencode/command/ws-deliver.md",
     ".opencode/command/ws-analyze.md",
+    ".opencode/command/ws-bugfix.md",
     ".opencode/command/ws-pull.md",
     ".opencode/command/ws-push.md",
     ".opencode/command/ws-finish.md",
@@ -99,7 +105,38 @@
     ".iflow/commands/ws-req-change.toml",
     ".iflow/commands/ws-req-contract-sync.toml",
     ".iflow/commands/ws-req-contract-validate.toml",
-    ".iflow/commands/ws-req-flow-sync.toml"
+    ".iflow/commands/ws-req-flow-sync.toml",
+    ".claude/commands/aiws-change-archive.md",
+    ".claude/commands/aiws-change-finish.md",
+    ".claude/commands/aiws-change-list.md",
+    ".claude/commands/aiws-change-new.md",
+    ".claude/commands/aiws-change-next.md",
+    ".claude/commands/aiws-change-start.md",
+    ".claude/commands/aiws-change-status.md",
+    ".claude/commands/aiws-change-sync.md",
+    ".claude/commands/aiws-change-templates-init.md",
+    ".claude/commands/aiws-change-templates-which.md",
+    ".claude/commands/aiws-change-validate.md",
+    ".claude/commands/aiws-hooks-install.md",
+    ".claude/commands/aiws-hooks-status.md",
+    ".claude/commands/ws-plan.md",
+    ".claude/commands/ws-plan-verify.md",
+    ".claude/commands/ws-bugfix.md",
+    ".opencode/command/aiws-change-archive.md",
+    ".opencode/command/aiws-change-finish.md",
+    ".opencode/command/aiws-change-list.md",
+    ".opencode/command/aiws-change-new.md",
+    ".opencode/command/aiws-change-next.md",
+    ".opencode/command/aiws-change-start.md",
+    ".opencode/command/aiws-change-status.md",
+    ".opencode/command/aiws-change-sync.md",
+    ".opencode/command/aiws-change-templates-init.md",
+    ".opencode/command/aiws-change-templates-which.md",
+    ".opencode/command/aiws-change-validate.md",
+    ".opencode/command/aiws-hooks-install.md",
+    ".opencode/command/aiws-hooks-status.md",
+    ".opencode/command/ws-plan.md",
+    ".opencode/command/ws-plan-verify.md"
   ],
   "optional": [
     ".iflow/agents/**",
@@ -158,6 +195,7 @@
       ".agents/skills/ws-req-review/SKILL.md",
       ".agents/skills/ws-review/SKILL.md",
       ".agents/skills/ws-rule/SKILL.md",
+      ".opencode/command/ws-bugfix.md",
       ".iflow/commands/aiws-init.toml",
       ".iflow/commands/aiws-update.toml",
       ".iflow/commands/aiws-validate.toml",
@@ -194,56 +232,277 @@
       ".iflow/commands/ws-req-change.toml",
       ".iflow/commands/ws-req-contract-sync.toml",
       ".iflow/commands/ws-req-contract-validate.toml",
-      ".iflow/commands/ws-req-flow-sync.toml"
+      ".iflow/commands/ws-req-flow-sync.toml",
+      ".claude/commands/aiws-change-archive.md",
+      ".claude/commands/aiws-change-finish.md",
+      ".claude/commands/aiws-change-list.md",
+      ".claude/commands/aiws-change-new.md",
+      ".claude/commands/aiws-change-next.md",
+      ".claude/commands/aiws-change-start.md",
+      ".claude/commands/aiws-change-status.md",
+      ".claude/commands/aiws-change-sync.md",
+      ".claude/commands/aiws-change-templates-init.md",
+      ".claude/commands/aiws-change-templates-which.md",
+      ".claude/commands/aiws-change-validate.md",
+      ".claude/commands/aiws-hooks-install.md",
+      ".claude/commands/aiws-hooks-status.md",
+      ".claude/commands/ws-plan.md",
+      ".claude/commands/ws-plan-verify.md",
+      ".claude/commands/ws-bugfix.md",
+      ".opencode/command/aiws-change-archive.md",
+      ".opencode/command/aiws-change-finish.md",
+      ".opencode/command/aiws-change-list.md",
+      ".opencode/command/aiws-change-new.md",
+      ".opencode/command/aiws-change-next.md",
+      ".opencode/command/aiws-change-start.md",
+      ".opencode/command/aiws-change-status.md",
+      ".opencode/command/aiws-change-sync.md",
+      ".opencode/command/aiws-change-templates-init.md",
+      ".opencode/command/aiws-change-templates-which.md",
+      ".opencode/command/aiws-change-validate.md",
+      ".opencode/command/aiws-hooks-install.md",
+      ".opencode/command/aiws-hooks-status.md",
+      ".opencode/command/ws-plan.md",
+      ".opencode/command/ws-plan-verify.md"
     ],
     "managed_blocks": {
-      "AGENTS.md": ["agents"],
-      "AI_PROJECT.md": ["ai-project:core"],
-      "AI_WORKSPACE.md": ["ai-workspace:core"],
-      "REQUIREMENTS.md": ["requirements:contract"],
-      ".gitignore": ["gitignore"],
-      ".claude/commands/aiws-init.md": ["claude:aiws-init"],
-      ".claude/commands/aiws-update.md": ["claude:aiws-update"],
-      ".claude/commands/aiws-validate.md": ["claude:aiws-validate"],
-      ".claude/commands/aiws-rollback.md": ["claude:aiws-rollback"],
-      ".claude/commands/ws-preflight.md": ["claude:ws-preflight"],
-      ".claude/commands/ws-migrate.md": ["claude:ws-migrate"],
-      ".claude/commands/ws-dev.md": ["claude:ws-dev"],
-      ".claude/commands/ws-deliver.md": ["claude:ws-deliver"],
-      ".claude/commands/ws-analyze.md": ["claude:ws-analyze"],
-      ".claude/commands/ws-pull.md": ["claude:ws-pull"],
-      ".claude/commands/ws-push.md": ["claude:ws-push"],
-      ".claude/commands/ws-finish.md": ["claude:ws-finish"],
-      ".claude/commands/ws-submodule-setup.md": ["claude:ws-submodule-setup"],
-      ".claude/commands/ws-review.md": ["claude:ws-review"],
-      ".claude/commands/ws-commit.md": ["claude:ws-commit"],
-      ".claude/commands/ws-rule.md": ["claude:ws-rule"],
-      ".claude/commands/ws-req-review.md": ["claude:ws-req-review"],
-      ".claude/commands/ws-req-change.md": ["claude:ws-req-change"],
-      ".claude/commands/ws-req-contract-sync.md": ["claude:ws-req-contract-sync"],
-      ".claude/commands/ws-req-contract-validate.md": ["claude:ws-req-contract-validate"],
-      ".claude/commands/ws-req-flow-sync.md": ["claude:ws-req-flow-sync"],
-      ".opencode/command/aiws-init.md": ["opencode:aiws-init"],
-      ".opencode/command/aiws-update.md": ["opencode:aiws-update"],
-      ".opencode/command/aiws-validate.md": ["opencode:aiws-validate"],
-      ".opencode/command/aiws-rollback.md": ["opencode:aiws-rollback"],
-      ".opencode/command/ws-preflight.md": ["opencode:ws-preflight"],
-      ".opencode/command/ws-migrate.md": ["opencode:ws-migrate"],
-      ".opencode/command/ws-dev.md": ["opencode:ws-dev"],
-      ".opencode/command/ws-deliver.md": ["opencode:ws-deliver"],
-      ".opencode/command/ws-analyze.md": ["opencode:ws-analyze"],
-      ".opencode/command/ws-pull.md": ["opencode:ws-pull"],
-      ".opencode/command/ws-push.md": ["opencode:ws-push"],
-      ".opencode/command/ws-finish.md": ["opencode:ws-finish"],
-      ".opencode/command/ws-submodule-setup.md": ["opencode:ws-submodule-setup"],
-      ".opencode/command/ws-review.md": ["opencode:ws-review"],
-      ".opencode/command/ws-commit.md": ["opencode:ws-commit"],
-      ".opencode/command/ws-rule.md": ["opencode:ws-rule"],
-      ".opencode/command/ws-req-review.md": ["opencode:ws-req-review"],
-      ".opencode/command/ws-req-change.md": ["opencode:ws-req-change"],
-      ".opencode/command/ws-req-contract-sync.md": ["opencode:ws-req-contract-sync"],
-      ".opencode/command/ws-req-contract-validate.md": ["opencode:ws-req-contract-validate"],
-      ".opencode/command/ws-req-flow-sync.md": ["opencode:ws-req-flow-sync"]
+      "AGENTS.md": [
+        "agents"
+      ],
+      "AI_PROJECT.md": [
+        "ai-project:core"
+      ],
+      "AI_WORKSPACE.md": [
+        "ai-workspace:core"
+      ],
+      "REQUIREMENTS.md": [
+        "requirements:contract"
+      ],
+      ".gitignore": [
+        "gitignore"
+      ],
+      ".claude/commands/aiws-init.md": [
+        "claude:aiws-init"
+      ],
+      ".claude/commands/aiws-update.md": [
+        "claude:aiws-update"
+      ],
+      ".claude/commands/aiws-validate.md": [
+        "claude:aiws-validate"
+      ],
+      ".claude/commands/aiws-rollback.md": [
+        "claude:aiws-rollback"
+      ],
+      ".claude/commands/ws-preflight.md": [
+        "claude:ws-preflight"
+      ],
+      ".claude/commands/ws-migrate.md": [
+        "claude:ws-migrate"
+      ],
+      ".claude/commands/ws-dev.md": [
+        "claude:ws-dev"
+      ],
+      ".claude/commands/ws-deliver.md": [
+        "claude:ws-deliver"
+      ],
+      ".claude/commands/ws-analyze.md": [
+        "claude:ws-analyze"
+      ],
+      ".claude/commands/ws-pull.md": [
+        "claude:ws-pull"
+      ],
+      ".claude/commands/ws-push.md": [
+        "claude:ws-push"
+      ],
+      ".claude/commands/ws-finish.md": [
+        "claude:ws-finish"
+      ],
+      ".claude/commands/ws-submodule-setup.md": [
+        "claude:ws-submodule-setup"
+      ],
+      ".claude/commands/ws-review.md": [
+        "claude:ws-review"
+      ],
+      ".claude/commands/ws-commit.md": [
+        "claude:ws-commit"
+      ],
+      ".claude/commands/ws-rule.md": [
+        "claude:ws-rule"
+      ],
+      ".claude/commands/ws-req-review.md": [
+        "claude:ws-req-review"
+      ],
+      ".claude/commands/ws-req-change.md": [
+        "claude:ws-req-change"
+      ],
+      ".claude/commands/ws-req-contract-sync.md": [
+        "claude:ws-req-contract-sync"
+      ],
+      ".claude/commands/ws-req-contract-validate.md": [
+        "claude:ws-req-contract-validate"
+      ],
+      ".claude/commands/ws-req-flow-sync.md": [
+        "claude:ws-req-flow-sync"
+      ],
+      ".opencode/command/aiws-init.md": [
+        "opencode:aiws-init"
+      ],
+      ".opencode/command/aiws-update.md": [
+        "opencode:aiws-update"
+      ],
+      ".opencode/command/aiws-validate.md": [
+        "opencode:aiws-validate"
+      ],
+      ".opencode/command/aiws-rollback.md": [
+        "opencode:aiws-rollback"
+      ],
+      ".opencode/command/ws-preflight.md": [
+        "opencode:ws-preflight"
+      ],
+      ".opencode/command/ws-migrate.md": [
+        "opencode:ws-migrate"
+      ],
+      ".opencode/command/ws-dev.md": [
+        "opencode:ws-dev"
+      ],
+      ".opencode/command/ws-deliver.md": [
+        "opencode:ws-deliver"
+      ],
+      ".opencode/command/ws-analyze.md": [
+        "opencode:ws-analyze"
+      ],
+      ".opencode/command/ws-bugfix.md": [
+        "opencode:ws-bugfix"
+      ],
+      ".opencode/command/ws-pull.md": [
+        "opencode:ws-pull"
+      ],
+      ".opencode/command/ws-push.md": [
+        "opencode:ws-push"
+      ],
+      ".opencode/command/ws-finish.md": [
+        "opencode:ws-finish"
+      ],
+      ".opencode/command/ws-submodule-setup.md": [
+        "opencode:ws-submodule-setup"
+      ],
+      ".opencode/command/ws-review.md": [
+        "opencode:ws-review"
+      ],
+      ".opencode/command/ws-commit.md": [
+        "opencode:ws-commit"
+      ],
+      ".opencode/command/ws-rule.md": [
+        "opencode:ws-rule"
+      ],
+      ".opencode/command/ws-req-review.md": [
+        "opencode:ws-req-review"
+      ],
+      ".opencode/command/ws-req-change.md": [
+        "opencode:ws-req-change"
+      ],
+      ".opencode/command/ws-req-contract-sync.md": [
+        "opencode:ws-req-contract-sync"
+      ],
+      ".opencode/command/ws-req-contract-validate.md": [
+        "opencode:ws-req-contract-validate"
+      ],
+      ".opencode/command/ws-req-flow-sync.md": [
+        "opencode:ws-req-flow-sync"
+      ],
+      ".claude/commands/aiws-change-archive.md": [
+        "claude:aiws-change-archive"
+      ],
+      ".claude/commands/aiws-change-finish.md": [
+        "claude:aiws-change-finish"
+      ],
+      ".claude/commands/aiws-change-list.md": [
+        "claude:aiws-change-list"
+      ],
+      ".claude/commands/aiws-change-new.md": [
+        "claude:aiws-change-new"
+      ],
+      ".claude/commands/aiws-change-next.md": [
+        "claude:aiws-change-next"
+      ],
+      ".claude/commands/aiws-change-start.md": [
+        "claude:aiws-change-start"
+      ],
+      ".claude/commands/aiws-change-status.md": [
+        "claude:aiws-change-status"
+      ],
+      ".claude/commands/aiws-change-sync.md": [
+        "claude:aiws-change-sync"
+      ],
+      ".claude/commands/aiws-change-templates-init.md": [
+        "claude:aiws-change-templates-init"
+      ],
+      ".claude/commands/aiws-change-templates-which.md": [
+        "claude:aiws-change-templates-which"
+      ],
+      ".claude/commands/aiws-change-validate.md": [
+        "claude:aiws-change-validate"
+      ],
+      ".claude/commands/aiws-hooks-install.md": [
+        "claude:aiws-hooks-install"
+      ],
+      ".claude/commands/aiws-hooks-status.md": [
+        "claude:aiws-hooks-status"
+      ],
+      ".claude/commands/ws-plan.md": [
+        "claude:ws-plan"
+      ],
+      ".claude/commands/ws-plan-verify.md": [
+        "claude:ws-plan-verify"
+      ],
+      ".claude/commands/ws-bugfix.md": [
+        "claude:ws-bugfix"
+      ],
+      ".opencode/command/aiws-change-archive.md": [
+        "opencode:aiws-change-archive"
+      ],
+      ".opencode/command/aiws-change-finish.md": [
+        "opencode:aiws-change-finish"
+      ],
+      ".opencode/command/aiws-change-list.md": [
+        "opencode:aiws-change-list"
+      ],
+      ".opencode/command/aiws-change-new.md": [
+        "opencode:aiws-change-new"
+      ],
+      ".opencode/command/aiws-change-next.md": [
+        "opencode:aiws-change-next"
+      ],
+      ".opencode/command/aiws-change-start.md": [
+        "opencode:aiws-change-start"
+      ],
+      ".opencode/command/aiws-change-status.md": [
+        "opencode:aiws-change-status"
+      ],
+      ".opencode/command/aiws-change-sync.md": [
+        "opencode:aiws-change-sync"
+      ],
+      ".opencode/command/aiws-change-templates-init.md": [
+        "opencode:aiws-change-templates-init"
+      ],
+      ".opencode/command/aiws-change-templates-which.md": [
+        "opencode:aiws-change-templates-which"
+      ],
+      ".opencode/command/aiws-change-validate.md": [
+        "opencode:aiws-change-validate"
+      ],
+      ".opencode/command/aiws-hooks-install.md": [
+        "opencode:aiws-hooks-install"
+      ],
+      ".opencode/command/aiws-hooks-status.md": [
+        "opencode:aiws-hooks-status"
+      ],
+      ".opencode/command/ws-plan.md": [
+        "opencode:ws-plan"
+      ],
+      ".opencode/command/ws-plan-verify.md": [
+        "opencode:ws-plan-verify"
+      ]
     }
   }
 }