@aipper/aiws-spec 0.0.52 → 0.0.53

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

@@ -1,23 +0,0 @@
----
-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

@@ -1,16 +0,0 @@
----
-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

@@ -1,22 +0,0 @@
----
-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

@@ -1,17 +0,0 @@
----
-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/ws-analyze.md

@@ -1,30 +0,0 @@
----
-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-auto.md

@@ -1,33 +0,0 @@
----
-description: 自动 bootstrap：检查 update、确保 watchdog 已启动，并给出下一步
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-auto -->
-# ws auto
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：为当前 OpenCode 工作区执行一次显式 auto bootstrap，先补齐托管内容，再按条件启动 watchdog。
-
-执行建议：
-1) 先运行 `/ws-preflight`，确认 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md` 已读取。
-2) 在项目根运行 `aiws opencode auto .`。
-3) 输出：
-   - `Auto Bootstrap:`
-   - `Update:`
-   - `OpenCode mode:`
-   - `Watchdog:`
-   - `Next:`
-4) 若输出 `watchdog:` 为已启动状态：
-   - 若当前任务意图明确：继续 `/using-aiws`、`/ws-plan`、`/ws-dev` 或 `/ws-review`
-   - 若当前只是要声明自主协作合同：继续 `/ws-autonomy`
-5) 若输出 `watchdog: skipped (...)`：
-   - 明确写出原因
-   - 不要假装已经进入 autonomous 模式
-
-边界：
-- 允许通过 `aiws update .` 刷新 AIWS 托管内容。
-- 不自动复制 `.opencode/oh-my-opencode.json.example` 成真实配置。
-- 不自动批准 host permission，不自动执行 tmux rescue。
-<!-- AIWS_MANAGED_END:opencode:ws-auto -->
-
-可在下方追加本项目对 auto bootstrap 的额外说明（托管块外内容会被保留）。

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

@@ -1,25 +0,0 @@
----
-description: 自主协作实验：声明 completion/retry/rescue 合同，并按需启用 tmux helper
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-autonomy -->
-# ws autonomy
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：声明当前 OpenCode/oMo 任务的 autonomous execution mode，并写清 completion/retry/rescue 合同。
-
-执行建议：
-1) 先运行 `/ws-preflight`，再读取 `packages/spec/docs/opencode-autonomous-swarm.md` 与 `packages/spec/docs/opencode-omo-adapter.md`。
-2) 输出：
-   - `Execution Mode: single-agent / omo-native / omo-native + tmux-swarm`
-   - `Completion Contract:`
-   - `Retry Contract:`
-   - `Rescue Policy:`
-   - `Evidence:`
-3) 若选择 `omo-native + tmux-swarm`：
-   - 先运行 `.opencode/helpers/tmux-swarm-scan.sh`
-   - 仅在需要安全白名单救援时运行 `.opencode/helpers/tmux-swarm-rescue.sh`
-4) 明确这是实验层，不接管 runtime controller，不替代 `ws-plan` / `ws-dev` / `ws-review`。
-<!-- AIWS_MANAGED_END:opencode:ws-autonomy -->
-
-可在下方追加本项目对 autonomous swarm 的额外说明（托管块外内容会被保留）。

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

@@ -1,35 +0,0 @@
----
-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 --switch`
-   - superproject + submodule：优先 `aiws change start <change-id> --hooks --switch`
-   - 仓库尚无提交 / 不满足 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 的额外说明（托管块外内容会被保留）。

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

@@ -1,18 +0,0 @@
----
-description: 提交：门禁/审计后提交（submodule 感知）
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-commit -->
-# ws commit
-
-Thin CLI wrapper. Delegates to `aiws commit`.
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws commit -m "<message>"
-elif command -v aiws >/dev/null 2>&1; then
-  aiws commit -m "<message>"
-else
-  npx @aipper/aiws commit -m "<message>"
-fi
-```
-<!-- AIWS_MANAGED_END:opencode:ws-commit -->

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

@@ -1,33 +0,0 @@
----
-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/commands/ws-deliver.md

@@ -1,18 +0,0 @@
----
-description: 交付：submodules+superproject 分步提交并安全合并回 base
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-deliver -->
-# ws deliver
-
-Thin CLI wrapper. Delegates to `aiws deliver`.
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws deliver -m "<message>"
-elif command -v aiws >/dev/null 2>&1; then
-  aiws deliver -m "<message>"
-else
-  npx @aipper/aiws deliver -m "<message>"
-fi
-```
-<!-- AIWS_MANAGED_END:opencode:ws-deliver -->

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

@@ -1,18 +0,0 @@
----
-description: 交接：查看归档 change 的 handoff.md
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-handoff -->
-# ws handoff
-
-Thin CLI wrapper. Delegates to `aiws handoff`.
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws handoff
-elif command -v aiws >/dev/null 2>&1; then
-  aiws handoff
-else
-  npx @aipper/aiws handoff
-fi
-```
-<!-- AIWS_MANAGED_END:opencode:ws-handoff -->

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

@@ -1,22 +0,0 @@
----
-description: 计划前置澄清：逐条冻结问题并写入 intake 草案，再交给 ws-plan
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-intake -->
-# ws intake
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：
-- 在正式 `/ws-plan` 前，先把需求里的待确认问题逐条澄清并冻结。
-
-执行建议：
-1) 先读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`。
-2) 若存在最新 `plan/*.intake.md`，先续写；否则创建新的 intake 草案。
-3) 把问题写成 `Open Questions`，状态只允许 `open / in_discussion / frozen / deferred`。
-4) 每次只推进 1 条 `Current question`，允许围绕这 1 条问题多轮沟通。
-5) 当前问题未标记为 `frozen` 或 `deferred` 前，不进入下一题。
-6) 每轮都要把结论落到 `plan/<timestamp>-<slug>.intake.md`，并输出 `Ready for ws-plan: yes/no`。
-7) 只有关键问题已冻结时，`Next` 才能进入 `/ws-plan`；否则继续 `/ws-intake`。
-<!-- AIWS_MANAGED_END:opencode:ws-intake -->
-
-可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -1,18 +0,0 @@
----
-description: 迁移：把仓库对齐到 aiws workspace 模板
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-migrate -->
-# ws migrate
-
-Thin CLI wrapper. Delegates to `aiws migrate`.
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws migrate
-elif command -v aiws >/dev/null 2>&1; then
-  aiws migrate
-else
-  npx @aipper/aiws migrate
-fi
-```
-<!-- AIWS_MANAGED_END:opencode:ws-migrate -->

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

@@ -1,18 +0,0 @@
----
-description: 计划质检：执行前检查并给出最小修正项。通过后标记 plan 阶段为 DONE
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-plan-verify -->
-# ws plan verify
-
-Thin CLI wrapper. Delegates to `aiws plan-verify`.
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws plan-verify
-elif command -v aiws >/dev/null 2>&1; then
-  aiws plan-verify
-else
-  npx @aipper/aiws plan-verify
-fi
-```
-<!-- AIWS_MANAGED_END:opencode:ws-plan-verify -->

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

@@ -1,35 +0,0 @@
----
-description: 预检：读取真值文件并输出约束摘要
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-preflight -->
-# ws preflight
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在开始任何“写代码/改配置/落盘文件”之前，对齐工作区真值文件，避免规则漂移。
-
-执行步骤（强制）：
-1) 定位项目根目录（submodule 感知）：
-   - 优先：`git rev-parse --show-superproject-working-tree`（submodule 内上溯到 superproject 根）
-   - 若为空：`git rev-parse --show-toplevel`
-   - 若两者都失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
-2) 在项目根目录读取以下文件（存在则必须读取；缺失则明确报告缺失项，不要臆测内容）：
-   - `AI_PROJECT.md`
-   - `REQUIREMENTS.md`
-   - `AI_WORKSPACE.md`
-3) 输出：
-   - `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（范围/禁止项/必须产物/必须验证命令）
-
-安全：
-- 不打印 secrets；遇到疑似敏感值只提示“存在风险”但不要复述原文。
-- 不执行破坏性命令。
-<!-- AIWS_MANAGED_END:opencode:ws-preflight -->
-
-可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -1,18 +0,0 @@
----
-description: 拉取：fast-forward 拉取并对齐 submodules（尽量避免 detached）
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-pull -->
-# ws pull
-
-Thin CLI wrapper. Delegates to `aiws pull`.
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws pull
-elif command -v aiws >/dev/null 2>&1; then
-  aiws pull
-else
-  npx @aipper/aiws pull
-fi
-```
-<!-- AIWS_MANAGED_END:opencode:ws-pull -->

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

@@ -1,18 +0,0 @@
----
-description: 推送：submodule 感知（先 submodules 后 superproject；fast-forward；不 force）
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-push -->
-# ws push
-
-Thin CLI wrapper. Delegates to `aiws push`.
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws push
-elif command -v aiws >/dev/null 2>&1; then
-  aiws push
-else
-  npx @aipper/aiws push
-fi
-```
-<!-- AIWS_MANAGED_END:opencode:ws-push -->

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

@@ -1,30 +0,0 @@
----
-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/commands/ws-req-change.md

@@ -1,45 +0,0 @@
----
-description: 需求变更：更新 REQUIREMENTS 并同步执行合同
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-req-change -->
-# ws req change
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：记录需求变更（更新 `REQUIREMENTS.md` + 追加 `requirements/CHANGELOG.md`），并同步/校验执行合同 `requirements/requirements-issues.csv`。
-
-步骤（必须按顺序）：
-1) 读取：`AI_PROJECT.md`、`REQUIREMENTS.md`、`AI_WORKSPACE.md`、`requirements/CHANGELOG.md`（缺失则创建目录与文件）。
-2) 先产出“拟变更方案”（不要立刻写文件）：
-   - 变更摘要（1–5 条）
-   - 影响范围（API/鉴权/字段/状态码/测试边界）
-   - 回滚思路（1–2 条）
-3) 对比与冲突检查（强制，不写文件）：
-   - 对比“变更前 vs 拟变更后”的差异清单（新增/删除/语义变化）
-   - 整理潜在冲突/不确定点（只列“最可能影响验收/实现”的，避免噪音）
-4) 逐条澄清（强制，避免一次问完）：
-   - 若存在潜在冲突/不确定点：**本轮只问 1 个**最高优先级问题（给出 2–4 个可选答案或二选一），然后停止，等待用户回复；不要继续问下一题，也不要写文件。
-   - 收到用户回复后：更新“拟变更方案”，回到步骤 3) 重新对比，直至没有未决问题。
-5) 强制停下来让用户确认：是否继续落盘？(Y/N)
-6) 用户确认 Y 后再写入：
-   - 更新 `REQUIREMENTS.md`（只保留当前有效版本，不在此堆历史）
-   - 追加 `requirements/CHANGELOG.md`
-7) 同步/补齐需求执行合同（强制，自动处理 FlowSpec 有/无两种情况）：
-   - `python3 tools/requirements_contract_sync.py --workspace .`
-   - 说明：若 `REQUIREMENTS.md` 中不存在 FlowSpec（或 flows 为空），该命令只会确保 `requirements/requirements-issues.csv` 表头存在并给出 WARN（这是预期行为，不要当成失败）。
-8) 校验需求执行合同（强制）：`python3 tools/requirements_contract.py validate`
-9) 同步场景合同（可选，但若存在 FlowSpec 则强烈建议自动执行）：
-   - 若 `REQUIREMENTS.md` 同时包含 `<!-- FLOW_SPEC_BEGIN -->` 与 `<!-- FLOW_SPEC_END -->`：运行 `/ws-req-flow-sync`
-   - 否则：跳过，并提示用户“可以先不维护 FlowSpec；后续需要场景回归时再补”
-
-输出必须包含：
-- 本次更新的文件清单（路径）
-- 回滚方案（如何撤销本次需求变更）
-- 下一步建议命令
-
-安全：
-- 不打印 `secrets/test-accounts.json`
-- 不引入任何 token/密钥到仓库
-<!-- AIWS_MANAGED_END:opencode:ws-req-change -->
-
-可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/ws-req-contract-sync.md

@@ -1,21 +0,0 @@
----
-description: 合同同步：把 REQUIREMENTS FlowSpec 同步到 requirements-issues.csv
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-req-contract-sync -->
-# ws req contract sync
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-用途：从 `REQUIREMENTS.md` 的 FlowSpec 补齐 `requirements/requirements-issues.csv`（只生成骨架，不猜测完成状态）。
-
-执行（在 workspace 根目录）：
-- `python3 tools/requirements_contract_sync.py --workspace .`
-
-输出要求：
-- 说明新增/更新了多少条
-- 明确下一步：手工补齐 CRUD/Inputs/Outputs/Business_Logic/Tests，并将可开工条目标为 `Spec_Status=READY`
-
-下一步建议：`/ws-req-contract-validate`
-<!-- AIWS_MANAGED_END:opencode:ws-req-contract-sync -->
-
-可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/ws-req-contract-validate.md

@@ -1,16 +0,0 @@
----
-description: 合同校验：校验 requirements-issues.csv 字段完整性
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-req-contract-validate -->
-# ws req contract validate
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-执行（失败则修正 CSV 后重试）：
-- `python3 tools/requirements_contract.py validate`
-
-输出要求：
-- 若失败：列出前 20 条缺失字段（Req_ID + field），并给出最小补齐建议
-<!-- AIWS_MANAGED_END:opencode:ws-req-contract-validate -->
-
-可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/ws-req-flow-sync.md

@@ -1,23 +0,0 @@
----
-description: Flow 同步：从 REQUIREMENTS 生成 api-flow 与场景执行合同
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-req-flow-sync -->
-# ws req flow sync
-
-用中文输出；命令与路径保持原样不翻译。
-
-目标：基于 `REQUIREMENTS.md` 的 FlowSpec 生成：
-- `docs/api-flow.mmd`（简短逻辑图，Mermaid）
-- `issues/server-scenario-issues.csv`（场景执行合同：TODO/DONE/BLOCKED）
-
-执行（在 workspace 根目录）：
-`python3 tools/requirements_flow_gen.py --workspace .`
-
-若缺少工具 `tools/requirements_flow_gen.py`：提示用户先运行 `npx @aipper/aiws init .`（默认会安装 optional tools）。
-
-输出要求：只打印生成的文件路径与下一步命令：
-- 查看逻辑图：`cat docs/api-flow.mmd`
-- 查看场景合同：`cat issues/server-scenario-issues.csv`
-<!-- AIWS_MANAGED_END:opencode:ws-req-flow-sync -->
-
-可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/ws-req-review.md

@@ -1,36 +0,0 @@
----
-description: 需求评审：对 REQUIREMENTS 做整体 QA（不改文件）
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-req-review -->
-# ws req review
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在不修改任何文件的前提下，对 `REQUIREMENTS.md` 做一次整体 QA，输出缺口/冲突/风险，减少实现漂移。
-
-执行步骤（强制）：
-1) 定位项目根目录：先尝试 `git rev-parse --show-superproject-working-tree`（submodule 感知上溯）；若为空再用 `git rev-parse --show-toplevel`。都失败则停止并让用户确认根目录。
-2) 读取（存在则必须读取；缺失则明确列出，不要臆测）：
-   - `AI_PROJECT.md`
-   - `REQUIREMENTS.md`
-   - `AI_WORKSPACE.md`
-   - `requirements/CHANGELOG.md`（若存在）
-   - `requirements/requirements-issues.csv`（若存在）
-3) 输出固定结构的报告：
-
-## Requirements QA
-- 结论：是否可进入实现（是/否/有条件）
-- 漂移风险：最容易导致不一致的点
-- 可验收性缺口：缺少输入/输出/错误码/边界/示例的条目
-- 完整性：Non-goals/兼容性/鉴权/重试/并发/观测性/性能
-- 一致性：与 `AI_PROJECT.md` 约束冲突点
-- 可测试性与证据：最小验证命令 + 期望结果 + 证据路径
-- 风险清单：3–8 条
-- 需要澄清的问题：5–12 个（按优先级）
-
-4) 最后询问用户：是否进入需求落盘流程 `/ws-req-change`？(Y/N)
-
-安全：不打印 `secrets/test-accounts.json`。
-<!-- AIWS_MANAGED_END:opencode:ws-req-review -->
-
-可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -1,27 +0,0 @@
----
-description: 规则：把口述规则整理并写入 AI_PROJECT.md 托管段
----
-<!-- AIWS_MANAGED_BEGIN:opencode:ws-rule -->
-# ws rule
-
-     用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-     目标：把用户口述的“项目特有规则”整理成可执行条款，并写入 `AI_PROJECT.md` 的 `AI_PROJECT_RULES_BEGIN/END` 段（托管块外内容会被保留）。
-
-     安全规则（强制）：
-     - 不打印/不写入 secrets（token、密钥、内网地址、账号密码）。
-     - 不执行破坏性命令。
-
-     工作流：
-     1) 先运行 `/ws-preflight`；若缺失 `AI_PROJECT.md`：提示用户先 `/ws-migrate` 或运行 `npx @aipper/aiws init .`。
-     2) 写入前创建备份（必须）：
-`ts="$(date +%Y%m%d-%H%M%S)"; mkdir -p .aiws/backups/manual; cp -a AI_PROJECT.md .aiws/backups/manual/AI_PROJECT.md.bak.${ts}`
-     3) 先输出“将写入的规则清单”（3–12 条），并要求用户回复 `CONFIRM` 后再落盘。
-     4) 用户确认后，**仅更新** BEGIN/END 段内内容（合并去重；写成可检查条款：目录白名单/必须验证命令/禁止项/产物要求）。
-     5) 输出必须包含：
-        - 更新了哪些文件（路径）
-        - 回滚方式（恢复备份文件）
-        - 下一步建议：`aiws validate .`
-<!-- AIWS_MANAGED_END:opencode:ws-rule -->
-
-可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。