@aipper/aiws-spec 0.0.51 → 0.0.53

package/templates/workspace/.opencode/skills/ws-dev/SKILL.md

@@ -28,9 +28,30 @@ description: 使用时机：需要修改代码、配置、测试时。触发词
 
 ## TDD 约束（强制）
 
-新代码/业务逻辑改动必须 RED-GREEN-REFACTOR：
-1. **RED**：先写测试并确认失败 → 2. **GREEN**：最小实现通过 → 3. **REFACTOR**：保持绿
-禁止先实现后补测 / 跳过测试提交。改后自检：`lint → typecheck → test`（无脚本则跳过）。
+新代码/业务逻辑改动必须走 TDD 循环。以下参考自 `tdd` skill（已作为模板 skill 安装）。
+
+### 好测试的定义
+
+测试通过**公开接口**验证行为，而非实现细节。好的测试读起来像规范——"用户可以带着有效购物车结账"精确描述了功能——并且在重构后依然存活，因为它不关心内部结构。
+
+### Seams — 测试在哪写
+
+**Seam** 是你测试的公开边界：在不深入内部的前提下观察行为的接口。测试只写在 seam 处，绝不针对内部实现。
+
+**只在预先约定的 seam 处测试。** 写任何测试前，先写下测试的 seam 并与用户确认。没有测试写在未确认的 seam 上。事前约定 seams 让测试精力落在关键路径和复杂逻辑上，而不是每个边缘情况。
+
+### 反模式
+
+- **实现耦合** — mock 内部协作者、测试私有方法、或通过侧通道验证（查询数据库而非使用接口）。识别信号：重构时测试断裂但行为不变。
+- **同义反复** — 断言用代码本身的方法重算了预期值（`expect(add(a, b)).toBe(a + b)`），所以测试通过构造必然通过，永远不可能与代码矛盾。预期值必须来自独立真值源——已知正确的字面量、演算示例、spec。
+- **水平切片** — 先写完所有测试，再实现所有代码。批量测试验证的是"想象中"的行为。按**垂直切片**工作——一个测试 → 一段实现 → 重复，每个测试都是一颗响应当前学习成果的**示踪弹**。
+
+### 循环规则
+
+1. **RED**：先写失败测试 → 2. **GREEN**：仅实现足够通过的代码 → 3. **REFACTOR**：保持绿
+- 一次一个切片。一个 seam、一个测试、一次最小实现。
+- **重构不是循环的一部分。** 重构属于 review 阶段（见 `code-review` skill），不属于 RED→GREEN 实现循环。
+- 禁止先实现后补测 / 跳过测试提交。改后自检：`lint → typecheck → test`（无脚本则跳过）。
 
 ## 完成判定
 

package/templates/workspace/.opencode/skills/ws-plan/SKILL.md

@@ -74,7 +74,21 @@ OpenCode + oMo 优先策略：
 7) 若存在 change proposal：回填并对齐 `proposal.md` 的 `Plan_File`（必要时同步 `Contract_Row` / `Evidence_Path`），保证 plan/proposal 一致。
 8) 运行 `$ws-plan-verify` 作为执行前质量门（计划不过长、不跑偏、验证可复现）。
    - 通过后：标记 `[workflow-state:plan:DONE]` 或 `[workflow-state:gate:plan_passed]`，表示 plan 阶段已收敛。
-8a) **Task Granularity Gate（T3）**：在 plan→dev 交接前，逐条验证计划中每步 ≤3 个原子操作（read/edit/write/run）：
+8a) **Optional Spec Phase**：若用户需要正式 spec 文档（PRD），在 plan 文件生成后追加一份 `docs/spec/<feature>.md`，模板如下（来自 to-spec skill）：
+    ```markdown
+    ## Problem Statement
+    用户视角的问题描述。
+    ## User Stories
+    As an <actor>, I want a <feature>, so that <benefit>（编号列表，全面覆盖）
+    ## Implementation Decisions
+    模块/接口/架构/API 合同（不含具体文件路径，避免过期）
+    ## Testing Decisions
+    好测试的定义（仅测试外部行为，非实现细节）+ 需要测试的模块 + 代码库中同类测试的先例
+    ## Out of Scope
+    明确不做的范围
+    ```
+    可选流程：sketch seams（代码库中已有的 seam 优先于新 seam）→ 与用户确认 seam 匹配 → 写 spec → 落盘。
+8b) **Task Granularity Gate（T3）**：在 plan→dev 交接前，逐条验证计划中每步 ≤3 个原子操作（read/edit/write/run）：
     - 若 any 步超限：拆细后再重新通过 ws-plan-verify，**不** 允许带着粗粒度任务进入 ws-dev
     - 仅当全部通过后才可标记 plan 完成并进入 ws-dev
     - 此门禁同样适用于 goal pipeline 的 Granularity Gate（c-i）—— ws-plan 的产出必须能通过下游检查

package/templates/workspace/.opencode/skills/ws-review/SKILL.md

@@ -62,6 +62,28 @@ OpenCode + oMo 优先策略：
       Quality review scope: <what to check> (if required)
       ```
     - Findings 格式要求：每个 finding 必须有 [Critical/Warning/Info] 级别标签 + 归因到 SPEC/QUALITY/REGRESSION 类别
+3a) **Two-Axis Review Methodology**（可选深化）。对于需要深入审查的变更，拆为两个正交维度并行审查（参考自 `code-review` skill）：
+    - **Standards** — 代码是否符合代码库的编码标准？携带下面的 smell baseline 作为默认基准。
+    - **Spec** — 代码是否忠实地实现了源需求/spec？
+    - 两轴并行运行，避免一个轴掩盖另一个。"符合所有标准但实现了错误需求" → Standards pass, Spec fail；"需求实现了但破坏了项目规范" → Spec pass, Standards fail。
+
+3b) **Code Smell Baseline**。Standards 轴在项目自有标准之外，始终携带以下 Fowler 代码坏味作为默认基准（项目标准高于基线）。每个坏味是启发式标签，不是硬性违规——跳过已由工具强制的内容。
+
+    | Smell | 识别信号 | 修复方向 |
+    |---|---|---|
+    | Mysterious Name | 名称不揭示作用 | 重命名；若找不到诚实名称，设计有问题 |
+    | Duplicated Code | 相同逻辑形状出现在多处 | 提取共享形状 |
+    | Feature Envy | 方法存取其他对象数据多于自身 | 把方法移到它嫉妒的数据上 |
+    | Data Clumps | 相同字段/参数反复出现 | 打包为一个类型 |
+    | Primitive Obsession | 原始类型代替领域概念 | 给概念自己的类型 |
+    | Repeated Switches | 对同类型的 switch/if 级联重复 | 多态或共享 map |
+    | Shotgun Surgery | 一个逻辑变更导致多处分散修改 | 聚合到一个模块 |
+    | Divergent Change | 一个文件因多个不相关原因被改 | 拆分，每个模块只为一个原因变 |
+    | Speculative Generality | 加了 spec 不需要的抽象 | 删除，直到真有需求 |
+    | Message Chains | 长链式导航 | 隐藏在第一个对象的方法后 |
+    | Middle Man | 类/函数主要只是委托转发 | 直接调用真正的目标 |
+    | Refused Bequest | 子类忽略大部分继承内容 | 组合替代继承 |
+
 4) 基于 `git status` / `git diff`（以及你实际运行过的测试结果），对照 `AI_PROJECT.md` 与 `REQUIREMENTS.md` 检查：
    - 是否存在越界目录改动/危险操作
    - 是否有可复现验证命令与证据

package/templates/workspace/AGENTS.md

@@ -32,3 +32,16 @@ Red Flags（这些想法都是错的）：
 <!-- AIWS_MANAGED_END:agents -->
 
 你可以在本段下方追加项目自定义说明；`aiws update` 不会改动托管块以外内容。
+
+## Memory Protocol
+
+本仓库使用 `aiws memory` 系统持久化跨会话知识。automation 协议：
+
+1. **自动注入（插件）** — `.opencode/plugins/memory-autoload.js` 在会话首次消息时读取活跃目标、近期决策、项目概览并注入 `<memory-context>`。需依赖：`MEMORY_AUTOLOAD_DISABLE=1` 可关闭
+2. **会话启动时** — 自动读取 `.aiws/memory-bank/.index.yaml` 获取记忆索引，了解已记录的知识领域
+3. **回答前** — 若问题涉及已记忆的领域，先用 `aiws memory search <keywords>` 检索相关记录
+4. **获取新知识后** — 对重要决策、根因分析、架构约定等跨会话有价值的信息，使用 `aiws memory write <domain>://<path>` 写入永久记忆（写入会自动更新索引）。标记 `--disclosure boot` 可让记忆出现在下次插件注入中
+5. **记忆关联** — 对相关记忆使用 `aiws memory link add` 建立关系
+6. **nocturne_memory MCP** — 仓库预配了远程 MCP 服务器（nocturne_memory），作为全局知识层自动可用，两者互补而非替代。当前未集成到 OpenCode 配置中
+
+目标：把关键认知固化到 git-tracked 文件，实现跨机器/跨会话的知识连续性。

package/templates/workspace/manifest.json

@@ -13,57 +13,18 @@
     ".githooks/pre-commit",
     ".githooks/pre-push",
     ".gitignore",
-    ".opencode/command/p-aiws-change-archive.md",
-    ".opencode/command/p-aiws-change-finish.md",
-    ".opencode/command/p-aiws-change-list.md",
-    ".opencode/command/p-aiws-change-new.md",
-    ".opencode/command/p-aiws-change-next.md",
-    ".opencode/command/p-aiws-change-start.md",
-    ".opencode/command/p-aiws-change-status.md",
-    ".opencode/command/p-aiws-change-sync.md",
-    ".opencode/command/p-aiws-change-templates-init.md",
-    ".opencode/command/p-aiws-change-templates-which.md",
-    ".opencode/command/p-aiws-change-validate.md",
-    ".opencode/command/p-aiws-hooks-install.md",
-    ".opencode/command/p-aiws-hooks-status.md",
-    ".opencode/command/p-aiws-init.md",
-    ".opencode/command/p-aiws-rollback.md",
-    ".opencode/command/p-aiws-update.md",
-    ".opencode/command/p-aiws-validate.md",
     ".opencode/command/using-aiws.md",
-    ".opencode/command/ws-analyze.md",
-    ".opencode/command/ws-auto.md",
-    ".opencode/command/ws-autonomy.md",
-    ".opencode/command/ws-bugfix.md",
-    ".opencode/command/ws-commit.md",
-    ".opencode/command/ws-delegate.md",
-    ".opencode/command/ws-deliver.md",
     ".opencode/command/ws-dev-lite.md",
     ".opencode/command/ws-dev.md",
     ".opencode/command/ws-finish.md",
+    ".opencode/command/ws-frontend-design.md",
     ".opencode/command/ws-goal.md",
-    ".opencode/command/ws-handoff.md",
-    ".opencode/command/ws-intake.md",
     ".opencode/command/ws-plan.md",
-    ".opencode/command/ws-plan-verify.md",
-    ".opencode/command/ws-spec-review.md",
-    ".opencode/command/ws-quality-review.md",
-    ".opencode/command/ws-migrate.md",
-    ".opencode/command/ws-preflight.md",
-    ".opencode/command/ws-pull.md",
-    ".opencode/command/ws-push.md",
-    ".opencode/command/ws-req-change.md",
-    ".opencode/command/ws-req-contract-sync.md",
-    ".opencode/command/ws-req-contract-validate.md",
-    ".opencode/command/ws-req-flow-sync.md",
-    ".opencode/command/ws-req-review.md",
     ".opencode/command/ws-review.md",
-    ".opencode/command/ws-rule.md",
-    ".opencode/command/ws-submodule-setup.md",
-    ".opencode/command/ws-verify-before-complete.md",
     ".opencode/plugins/aiws-inject-context.js",
     ".opencode/plugins/aiws-session-start.js",
     ".opencode/plugins/aiws-workflow-state.js",
+    ".opencode/plugins/memory-autoload.js",
     ".opencode/lib/aiws-context.js",
     ".opencode/commands/**",
     ".opencode/skills/**",
@@ -253,33 +214,15 @@
       ".aiws/tools/requirements_contract.py",
       ".aiws/tools/ws_tasks_plan.py",
       ".aiws/tools/ws_resolve_sub_target.sh",
-      ".opencode/command/ws-bugfix.md",
+
       ".opencode/plugins/aiws-inject-context.js",
       ".opencode/plugins/aiws-session-start.js",
       ".opencode/plugins/aiws-workflow-state.js",
+      ".opencode/plugins/memory-autoload.js",
       ".opencode/lib/aiws-context.js",
-      ".opencode/command/p-aiws-change-archive.md",
-      ".opencode/command/p-aiws-change-finish.md",
-      ".opencode/command/p-aiws-change-list.md",
-      ".opencode/command/p-aiws-change-new.md",
-      ".opencode/command/p-aiws-change-next.md",
-      ".opencode/command/p-aiws-change-start.md",
-      ".opencode/command/p-aiws-change-status.md",
-      ".opencode/command/p-aiws-change-sync.md",
-      ".opencode/command/p-aiws-change-templates-init.md",
-      ".opencode/command/p-aiws-change-templates-which.md",
-      ".opencode/command/p-aiws-change-validate.md",
-      ".opencode/command/p-aiws-hooks-install.md",
-      ".opencode/command/p-aiws-hooks-status.md",
       ".opencode/command/using-aiws.md",
-      ".opencode/command/ws-intake.md",
       ".opencode/command/ws-plan.md",
-      ".opencode/command/ws-plan-verify.md",
-      ".opencode/command/ws-bugfix.md",
-      ".opencode/command/ws-spec-review.md",
-      ".opencode/command/ws-quality-review.md",
-      ".opencode/command/ws-verify-before-complete.md",
-      ".opencode/command/ws-goal.md",
+      ".opencode/command/ws-review.md",
       ".opencode/skills/p-aiws-change-archive/SKILL.md",
       ".opencode/skills/p-aiws-change-finish/SKILL.md",
       ".opencode/skills/p-aiws-change-list/SKILL.md",
@@ -302,9 +245,7 @@
       ".opencode/skills/ws-analyze/SKILL.md",
       ".opencode/scripts/ws-plan-setup-worktree.sh",
       ".opencode/scripts/ws-plan-gen-submodule-targets.sh",
-      ".opencode/skills/ws-bugfix/SKILL.md",
       ".opencode/skills/ws-commit/SKILL.md",
-      ".opencode/skills/ws-intake/SKILL.md",
       ".opencode/skills/ws-deliver/SKILL.md",
       ".opencode/skills/ws-dev/SKILL.md",
       ".opencode/skills/ws-dev-lite/SKILL.md",
@@ -320,7 +261,6 @@
       ".opencode/skills/ws-finish/SKILL.md",
       ".opencode/skills/ws-frontend-design/SKILL.md",
       ".opencode/skills/ws-goal/SKILL.md",
-      ".opencode/skills/ws-handoff/SKILL.md",
       ".opencode/skills/ws-migrate/SKILL.md",
       ".opencode/skills/ws-plan/SKILL.md",
       ".opencode/skills/ws-plan-verify/SKILL.md",
@@ -338,18 +278,7 @@
       ".opencode/skills/ws-verify-before-complete/SKILL.md",
       ".opencode/skills/ws-rule/SKILL.md",
       ".opencode/skills/ws-submodule-setup/SKILL.md",
-      ".opencode/command/ws-migrate.md",
-      ".opencode/command/ws-preflight.md",
-      ".opencode/command/ws-pull.md",
-      ".opencode/command/ws-push.md",
-      ".opencode/command/ws-req-change.md",
-      ".opencode/command/ws-req-contract-sync.md",
-      ".opencode/command/ws-req-contract-validate.md",
-      ".opencode/command/ws-req-flow-sync.md",
-      ".opencode/command/ws-req-review.md",
-      ".opencode/command/ws-review.md",
-      ".opencode/command/ws-rule.md",
-      ".opencode/command/ws-submodule-setup.md"
+      ".opencode/command/ws-review.md"
     ],
     "managed_blocks": {
       "AGENTS.md": ["agents"],
@@ -357,54 +286,13 @@
       "AI_WORKSPACE.md": ["ai-workspace:core"],
       "REQUIREMENTS.md": ["requirements:contract"],
       ".gitignore": ["gitignore"],
-      ".opencode/command/p-aiws-init.md": ["opencode:aiws-init"],
-      ".opencode/command/p-aiws-update.md": ["opencode:aiws-update"],
-      ".opencode/command/p-aiws-validate.md": ["opencode:aiws-validate"],
-      ".opencode/command/p-aiws-rollback.md": ["opencode:aiws-rollback"],
-      ".opencode/command/ws-preflight.md": ["opencode:ws-preflight"],
-      ".opencode/command/ws-migrate.md": ["opencode:ws-migrate"],
+      ".opencode/command/using-aiws.md": ["opencode:using-aiws"],
       ".opencode/command/ws-dev.md": ["opencode:ws-dev"],
       ".opencode/command/ws-dev-lite.md": ["opencode:ws-dev-lite"],
-      ".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"],
-      ".opencode/command/p-aiws-change-archive.md": ["opencode:aiws-change-archive"],
-      ".opencode/command/p-aiws-change-finish.md": ["opencode:aiws-change-finish"],
-      ".opencode/command/p-aiws-change-list.md": ["opencode:aiws-change-list"],
-      ".opencode/command/p-aiws-change-new.md": ["opencode:aiws-change-new"],
-      ".opencode/command/p-aiws-change-next.md": ["opencode:aiws-change-next"],
-      ".opencode/command/p-aiws-change-start.md": ["opencode:aiws-change-start"],
-      ".opencode/command/p-aiws-change-status.md": ["opencode:aiws-change-status"],
-      ".opencode/command/p-aiws-change-sync.md": ["opencode:aiws-change-sync"],
-      ".opencode/command/p-aiws-change-templates-init.md": ["opencode:aiws-change-templates-init"],
-      ".opencode/command/p-aiws-change-templates-which.md": ["opencode:aiws-change-templates-which"],
-      ".opencode/command/p-aiws-change-validate.md": ["opencode:aiws-change-validate"],
-      ".opencode/command/p-aiws-hooks-install.md": ["opencode:aiws-hooks-install"],
-      ".opencode/command/p-aiws-hooks-status.md": ["opencode:aiws-hooks-status"],
-      ".opencode/command/using-aiws.md": ["opencode:using-aiws"],
-      ".opencode/command/ws-intake.md": ["opencode:ws-intake"],
-      ".opencode/command/ws-plan.md": ["opencode:ws-plan"],
-      ".opencode/command/ws-delegate.md": ["opencode:ws-delegate"],
-      ".opencode/command/ws-autonomy.md": ["opencode:ws-autonomy"],
-      ".opencode/command/ws-auto.md": ["opencode:ws-auto"],
-      ".opencode/command/ws-plan-verify.md": ["opencode:ws-plan-verify"],
       ".opencode/command/ws-goal.md": ["opencode:ws-goal"],
-      ".opencode/command/ws-handoff.md": ["opencode:ws-handoff"],
-      ".opencode/command/ws-spec-review.md": ["opencode:ws-spec-review"],
-      ".opencode/command/ws-quality-review.md": ["opencode:ws-quality-review"],
-      ".opencode/command/ws-verify-before-complete.md": ["opencode:ws-verify-before-complete"]
+      ".opencode/command/ws-plan.md": ["opencode:ws-plan"],
+      ".opencode/command/ws-review.md": ["opencode:ws-review"]
     }
   }
 }

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

@@ -1,27 +0,0 @@
----
-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/command/p-aiws-change-finish.md

@@ -1,27 +0,0 @@
----
-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/command/p-aiws-change-list.md

@@ -1,26 +0,0 @@
----
-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/command/p-aiws-change-new.md

@@ -1,27 +0,0 @@
----
-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/command/p-aiws-change-next.md

@@ -1,27 +0,0 @@
----
-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/command/p-aiws-change-start.md

@@ -1,27 +0,0 @@
----
-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/command/p-aiws-change-status.md

@@ -1,27 +0,0 @@
----
-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/command/p-aiws-change-sync.md

@@ -1,27 +0,0 @@
----
-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/command/p-aiws-change-templates-init.md

@@ -1,26 +0,0 @@
----
-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/command/p-aiws-change-templates-which.md

@@ -1,26 +0,0 @@
----
-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/command/p-aiws-change-validate.md

@@ -1,27 +0,0 @@
----
-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/command/p-aiws-hooks-install.md

@@ -1,26 +0,0 @@
----
-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 的额外说明（托管块外内容会被保留）。