@aipper/aiws-spec 0.0.25 → 0.0.27

package/templates/workspace/.opencode/skills/using-aiws/SKILL.md

@@ -56,7 +56,7 @@ description: 默认 workflow bootstrap/router：先读真值，再路由到正
    - finish / merge / push / cleanup：`$ws-finish`
    - handoff / archive summary：`$ws-handoff`
    - 中大型实现、需要方案、需要 change/worktree：`$ws-plan`
-   - 小步明确实现/修复/配置调整：`$ws-dev`
+   - 小步明确实现/修复/配置调整：`$ws-dev`（若是 simple/local 单点修复，且用户明确希望走轻量入口，可显式进入 `$ws-dev-lite`）
 4) 若任务意图或归因不明确：
    - 只问 1-3 个关键澄清问题
    - 明确写出缺的是什么：意图、`Req_ID` / `Problem_ID`、verify、change 上下文
@@ -67,6 +67,10 @@ description: 默认 workflow bootstrap/router：先读真值，再路由到正
      - `Binding:`
      - `Route:`
      - `Why:`
+   - 若 `Route: $ws-dev` 且任务属于 simple/local 单点修复：
+     - `Next:` 可优先进入 `$ws-dev-lite`
+   - 否则：
+     - `Next:` 进入对应主 skill
    - 然后在同一轮中继续遵循对应 skill 的契约
 6) 路由约束：
    - router 自己不是实现阶段；不要在给出 route 之前直接改代码

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

@@ -19,7 +19,10 @@ description: 提交（当前分支可直提；submodule 感知；先审计/门
 - 不写入任何 secrets
 - 检测到 submodule 有未提交改动时，不允许直接提交 superproject（先处理 submodule）
 - commit message 优先使用中文（命令/路径/代码标识符保持原样不翻译）；格式建议：`<类型>: <简述>`（例如 `修复: 登录页空指针`、`功能: 新增 submodule targets 校验`、`重构: 提取共享脚本`）
-- 若启用了 `.githooks/commit-msg`：默认会提示优先中文；只有在 `git config aiws.commitMessagePolicy strict` 时才会拒绝全英文首行（`Merge/Revert/fixup!/squash!` 例外）
+- 若启用了 `.githooks/commit-msg`：默认按仓库角色区分
+  - superproject / root 仓库（存在 `.gitmodules`）默认允许自由 commit message
+  - submodule / 普通仓库默认提示优先中文
+  - 只有在 `git config aiws.commitMessagePolicy strict` 时才会拒绝全英文首行（`Merge/Revert/fixup!/squash!` 例外）
 
 阶段定位：
 - commit gate；负责在提交前收敛 review、validate 和 message 确认，不允许跳过 hooks。

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

@@ -218,10 +218,9 @@ aiws change state "${change_id}" --write
 aiws change finish <change-id> --into <base-branch>
 ```
 
-## F) （可选）归档变更工件
-```bash
-aiws change archive <change-id>
-```
+## F) 归档说明
+- 标准链路下不需要再单独执行 `aiws change archive <change-id>`。
+- 进入 `$ws-finish` 并使用 `aiws change finish --push` 时，会自动完成 archive + handoff。
 
 输出要求：
 - `Submodules:` 每个 submodule 的分支/提交摘要（repo → commit sha → message）

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

@@ -0,0 +1,58 @@
+---
+name: ws-dev-lite
+description: 轻量开发（simple/local 单点修复；最小改动 + 最小验证）
+---
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：在不引入完整重流程的前提下，完成一次 simple/local 小问题修复，并保持可验证、可追溯。
+
+定位：
+- `ws-dev` 的轻量入口，不是新的 workflow stage。
+- 适用于单点修复、局部配置调整、明确回归修复；不适用于中大型任务。
+
+适用前提：
+- 目标明确，且能归因到 `Req_ID` 或 `Problem_ID`
+- 验证入口明确，且能做最小可复现验证
+- 一般只影响单文件或紧密相关的小范围文件
+- 不需要先改 `REQUIREMENTS.md`，也不需要先单独做 review
+
+立即升级回主流程的情形：
+- 发现任务其实是 medium/complex、跨模块、跨目录或需要方案设计
+- 无法明确归因、verify、change 上下文
+- 需要新建复杂 change/worktree 或处理 submodule 目标分支真值
+- 修复过程中出现连锁改动、需要补系统性测试或需求调整
+
+默认约束：
+- 先做 `$ws-preflight`
+- 默认不创建 `plan/...`
+- 默认不跑 `$ws-plan-verify`
+- 默认不要求先做双 review
+- 若后续准备提交/交付，仍需进入 `$ws-review` / `$ws-commit` / `$ws-finish`
+
+执行步骤：
+1) 先读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
+2) 先判断自己是否真的属于 lite：
+   - 用一句话写清 `Goal`
+   - 用一句话写清 `Why lite`
+   - 若说不清，立刻回退到 `$ws-dev` 或 `$ws-plan`
+3) 在当前 change 上下文内实施最小改动：
+   - 不为“形式完整”额外扩 scope
+   - 不默认补与本问题无关的重构或测试矩阵
+4) 运行最小可复现验证：
+   - 优先使用 `AI_WORKSPACE.md` 已声明的命令
+   - 若只需局部回归，允许运行更窄的验证，但要说明为什么足够
+5) 留下至少一个可追溯证据：
+   - 实际改动文件
+   - 或 `.agentdocs/tmp/...`
+   - 或 `changes/<change-id>/...`
+6) 输出：
+   - `变更文件（Changed）:`
+   - `验证（Verify）:`
+   - `证据（Evidence）:`
+   - `Next:` 若准备提交，进入 `$ws-review` 或 `$ws-commit`
+
+输出要求：
+- 明确说明为什么这是 lite，而不是完整 `ws-dev`
+- 未运行不声称已运行
+- 一旦发现复杂度升高，立刻停止 lite 叙事，切回 `$ws-dev` 或 `$ws-plan`

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

@@ -14,7 +14,8 @@ description: 收尾（门禁 + 安全合并 + submodule→主仓库顺序 push
 前置（必须）：
 - 工作区是干净的：`git status --porcelain` 无输出（若有未提交改动：先 commit 或 stash）
 - change 分支已存在：`change/<change-id>`（也支持 `changes/`、`ws/`、`ws-change/`）
-- 若使用 worktree：在目标分支所在 worktree 执行（`aiws change finish` 会提示正确的 worktree）
+- 若使用 worktree：普通 finish 的 `validate/evidence/state` 先在 `change/<change-id>` worktree 完成；真正执行 `aiws change finish` 时再切到目标分支所在 worktree（命令会提示正确的 worktree）
+- 若 `aiws change status <change-id>` 输出 `governance_rule: finish_resume_required`：说明 merge 已发生，只剩 push / archive / cleanup closeout；直接在该 worktree 运行 `aiws change finish <change-id> --push`，不要先跑 `aiws validate . --stamp`
 - 若存在 `.gitmodules`：必须为每个 submodule 配置 `submodule.<name>.branch`（否则无法确定性减少 detached；先运行 `$ws-submodule-setup` 并提交 `.gitmodules`）
 
 阶段定位：
@@ -60,7 +61,11 @@ if [[ -f .gitmodules ]]; then
   fi
 fi
 ```
-1) （推荐）先跑一次门禁并落盘证据：
+0.5) 先运行 `aiws change status <change-id>`，优先看稳定字段 `governance_rule:`：
+- 若为 `finish_resume_required`：直接跳到步骤 2 执行 `aiws change finish <change-id> --push`
+- 若不是该值：按普通 finish 继续；不要依赖自然语言提示句做分支判断
+
+1) （推荐，仅适用于普通 finish，且应在 `change/<change-id>` worktree 执行）先跑一次门禁并落盘证据：
 ```bash
 if [[ -x "./node_modules/.bin/aiws" ]]; then
   ./node_modules/.bin/aiws validate . --stamp
@@ -70,7 +75,10 @@ else
   npx @aipper/aiws validate . --stamp
 fi
 ```
-1.1) （强烈建议）收敛持久证据并回填 `Evidence_Path`：
+若你已经位于目标分支 worktree，且 `governance_rule` 不是 `finish_resume_required`：
+- 不要在这里跑 `aiws validate . --stamp`
+- 先回 `change/<change-id>` worktree 补齐 finish gate，或先跑 `$ws-verify-before-complete`
+1.1) （强烈建议，仅适用于普通 finish）收敛持久证据并回填 `Evidence_Path`：
 ```bash
 change_id="<change-id>"
 if [[ -x "./node_modules/.bin/aiws" ]]; then
@@ -81,7 +89,7 @@ else
   npx @aipper/aiws change evidence "${change_id}"
 fi
 ```
-1.2) （可选）生成状态快照（建议）：
+1.2) （可选，仅适用于普通 finish）生成状态快照（建议）：
 ```bash
 aiws change state "${change_id}" --write
 ```
@@ -206,15 +214,4 @@ fi
 ```
 说明：
 - 该命令内部已经包含主仓库 push 成功后安全清理独立 change worktree 的逻辑。
-
-7) （可选）归档变更工件（完成交付后推荐）：
-```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
-```
+- 当 `--push` 完整成功时，还会自动把 `changes/<change-id>/` 归档到 `changes/archive/...`，生成 `handoff.md`，并补一个 `归档: <change-id>` commit。

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

@@ -11,15 +11,15 @@ description: 交接（归档后生成/查看 changes/archive/.../handoff.md）
 - 指引在归档与依赖场景下如何使用 handoff
 
 说明：
-- `handoff.md` 由 `aiws change archive` 自动生成：`changes/archive/<date>-<change-id>/handoff.md`
+- `handoff.md` 默认由 `aiws change finish --push` 自动归档时生成：`changes/archive/<date>-<change-id>/handoff.md`
 - `Depends_On` 依赖若已归档，`aiws change start` 会尝试读取依赖的 `handoff.md` 并输出摘要
 
 阶段定位：
-- handoff / archive 阶段；负责把已完成 change 的上下文压缩成后续协作者可直接接手的说明。
+- handoff / archive 阶段；负责查看或补充已归档 change 的交接说明。
 
 必需输入：
-- 当前或已归档的 `change/<change-id>`
-- 对应 archive 目录或准备归档的 change 工件
+- 已归档的 `change/<change-id>`
+- 对应 archive 目录
 
 必需输出：
 - `Change_ID:` 当前交接对象
@@ -28,7 +28,6 @@ description: 交接（归档后生成/查看 changes/archive/.../handoff.md）
 
 阻断条件：
 - 无法定位目标 change
-- 未归档且无法执行 `aiws change archive <change-id>`
 - `handoff.md` 无法生成或读取
 
 完成判定：
@@ -36,15 +35,16 @@ description: 交接（归档后生成/查看 changes/archive/.../handoff.md）
 
 执行建议：
 1) 先运行 `$ws-preflight`。
-2) 若本 change 已完成并准备归档：运行 `aiws change archive <change-id>`（会先做严格校验，并移动目录到 `changes/archive/`，同时生成 `handoff.md`）。
+2) 先确认本 change 已通过 `aiws change finish <change-id> --push` 完成自动归档。
 3) 查看 handoff：
 ```bash
 change_id="<change-id>"
 ls -1 changes/archive/*-"${change_id}"/handoff.md
 sed -n '1,160p' changes/archive/*-"${change_id}"/handoff.md
 ```
-4) 若要让后续 change 可接力：在 `proposal.md` 里声明 `Blocks`（下一步建议会据此生成）。
-5) 若本 change 使用了外部 / 子 agent 协作：确认关键结论已经进入 `review/` 或 `evidence/`，避免 handoff 只留下原始 patch/分析文件而没有最终结论。
+4) 若是历史/异常场景，尚未归档且需要手工恢复，再运行 `aiws change archive <change-id>`。
+5) 若要让后续 change 可接力：在 `proposal.md` 里声明 `Blocks`（下一步建议会据此生成）。
+6) 若本 change 使用了外部 / 子 agent 协作：确认关键结论已经进入 `review/` 或 `evidence/`，避免 handoff 只留下原始 patch/分析文件而没有最终结论。
 
 输出要求：
 - `Change_ID:` <change-id>

package/templates/workspace/AGENTS.md

@@ -19,14 +19,15 @@
 - `ws-plan`：建立 `change/<change-id>` 绑定，落盘 `plan/...`，明确 Verify / Risks / Evidence。
 - `ws-plan-verify`：在编码前做计划质检；不过门禁就先修 plan，不跳步进实现。
 - `ws-dev`：只做可归因、可验证的小步实现；输出 Changed / Verify / Evidence。
+- `ws-dev-lite`：`ws-dev` 的轻量入口；适用于 simple/local 单点修复，默认不建 `plan/...`、不跑 `ws-plan-verify`，治理归属仍收敛到 `ws-dev`。
 - `ws-delegate`：仅在任务已绑定且 scope 可控时，使用原生多 agent / sub-agent；否则明确降级为单 agent + 协同工件模式。
 - `ws-review`：对当前改动做通用审计；高风险或准备交付时，继续细化到 `ws-spec-review` + `ws-quality-review`。
 - `ws-spec-review`：审查 requirements 归因、plan/change 绑定、evidence 与 workflow gate 完整性。
 - `ws-quality-review`：审查行为回归、边界条件、测试覆盖与实现质量。
 - `ws-commit`：串联 review + validate stamp + commit message 确认；不跳过 hooks。
 - `ws-verify-before-complete`：在 finish / handoff 前检查双审查、validate stamp 与交付证据是否齐全。
-- `ws-deliver` / `ws-finish`：做交付收尾、fast-forward 合并、submodule 感知 push 与证据收敛。
-- `ws-handoff`：在归档后输出 handoff，给下一次会话或下一位协作者接力。
+- `ws-deliver` / `ws-finish`：做交付收尾、fast-forward 合并、submodule 感知 push，并在完整 finish 后自动归档。
+- `ws-handoff`：查看/补充归档后的 handoff，给下一次会话或下一位协作者接力。
 
 阶段产物（最少）：
 - planning：`plan/...`、`changes/<change-id>/proposal.md`、`tasks.md`
@@ -45,6 +46,7 @@ OpenCode（如果你主要用 OpenCode，优先）：
 - `/ws-preflight`：读取真值文件并输出约束摘要
 - `/ws-plan` / `/ws-plan-verify`：先生成计划，再做执行前质检
 - `/ws-dev`：常规实现/改配置/改测试
+- `/ws-dev-lite`：小问题直修；若复杂度升高，立刻回到 `/ws-dev` 或 `/ws-plan`
 - `/ws-delegate`：按 AIWS 委托合同拆分子任务，并优先借用 oMo agent
 - `/ws-bugfix`：缺陷修复 + 证据落盘 + CSV 汇总
 - `/ws-review` / `/ws-commit`：提交前审计、门禁与 commit
@@ -64,7 +66,7 @@ Codex（对应入口，可选）：
 - 若你不想先记住阶段，先用 `$using-aiws` 让 router 判定下一步
 - 对应入口在 `.agents/skills/`；显式调用时使用 `$ws-*`
 - `$using-aiws`
-- `$ws-preflight` / `$ws-plan` / `$ws-plan-verify` / `$ws-dev` / `$ws-delegate` / `$ws-frontend-design`
+- `$ws-preflight` / `$ws-plan` / `$ws-plan-verify` / `$ws-dev` / `$ws-dev-lite` / `$ws-delegate` / `$ws-frontend-design`
 - `$ws-review` / `$ws-spec-review` / `$ws-quality-review` / `$ws-commit`
 - `$ws-verify-before-complete` / `$ws-finish` / `$ws-deliver`
 - `$ws-pull` / `$ws-push` / `$ws-submodule-setup`

package/templates/workspace/AI_PROJECT.md

@@ -3,7 +3,7 @@
 <!-- AIWS_MANAGED_BEGIN:ai-project:core -->
 <!-- AI_PROJECT_VERSION: 2 -->
 
-本文件用于在**具体项目/工作区**内统一 Codex / Claude / OpenCode / iFlow 的执行约束与协作方式，避免多套规则各写一份导致漂移。
+本文件用于在**具体项目/工作区**内统一 Codex / Claude / OpenCode 的执行约束与协作方式，避免多套规则各写一份导致漂移。
 
 定位：
 - `REQUIREMENTS.md`：定义“要做什么/验收是什么”（需求真值）

package/templates/workspace/AI_WORKSPACE.md

@@ -32,7 +32,7 @@
 
 <!-- AIWS_MANAGED_BEGIN:ai-workspace:core -->
 
-本文件描述“AI Workspace（多子项目工作区）”的结构与运行方式，供 Codex / Claude / OpenCode / iFlow 共同读取。
+本文件描述“AI Workspace（多子项目工作区）”的结构与运行方式，供 Codex / Claude / OpenCode 共同读取。
 
 ## 1) 目录发现规则
 

package/templates/workspace/changes/README.md

@@ -34,24 +34,25 @@ changes/
 常用命令（推荐使用 `aiws`；不依赖 dotfiles）：
 - `aiws change start <change-id>`（默认：切到 `change/<change-id>` 并初始化工件目录；若检测到 `.gitmodules` 则默认优先使用 worktree，失败则回退为不切分支，避免 submodule 状态混乱）
 - `aiws change start <change-id> --no-switch`（superproject + submodule 场景：不切分支，仅准备 `change/<change-id>` 分支与工件目录）
-- `aiws change start <change-id> --switch`（显式允许切换 superproject 分支；仅在存在 `.gitmodules` 时有意义）
+- `aiws change start <change-id> --switch`（显式允许切换 superproject 分支；仅切 superproject，不递归切换 submodule；仅在存在 `.gitmodules` 时有意义）
 - `aiws change start <change-id> --worktree`（推荐用于 superproject + submodule：创建独立 worktree；当前目录分支保持不变）
   - 可选：`--worktree-dir <path>` 覆盖 worktree 目录
   - 可选：`--submodules` 在 worktree 内执行 `git submodule update --init --recursive`
 - `aiws change finish <change-id>`（安全合并：fast-forward 合并回目标分支；在 `change/<change-id>` 分支上执行时会尝试使用 `.ws-change.json` 的 `base_branch` 作为目标分支）
-- `aiws change finish <change-id> --push [--remote <name>]`（最小收尾闭环：若存在 `.gitmodules` 则先按 `changes/<id>/submodules.targets` 顺序 push submodule，再 push 目标分支；默认优先遵循 upstream 配置；若 `change/<change-id>` 位于独立 worktree，且该 worktree 干净，则在 push 成功后自动执行 worktree cleanup；含 submodule 的 worktree 会因 Git 原生限制在 clean-check 后内部走 `git worktree remove --force`）
+- `aiws change finish <change-id> --push [--remote <name>]`（最小收尾闭环：若存在 `.gitmodules` 则先按 `changes/<id>/submodules.targets` 顺序 push submodule，再 push 目标分支；默认优先遵循 upstream 配置；若 `change/<change-id>` 位于独立 worktree，且该 worktree 干净，则在 push 成功后自动执行 worktree cleanup，并把 `changes/<id>/` 自动归档到 `changes/archive/...`，同时生成 `handoff.md` 与 archive commit）
+- 已 archive 的 `change/<change-id>` 才算真正终态；若只是“已 finish 但仍有 active `changes/<id>/` 未归档”，默认应重跑 `aiws change finish <change-id> --push` 续完收尾，而不是继续开发或复用旧 branch 做新需求。
 - `aiws change new <change-id>`
 - `aiws change list`
 - `aiws change status <change-id>`
 - `aiws change next <change-id>`
 - `aiws change validate <change-id>`
 - `aiws change sync <change-id>`
-- `aiws change archive <change-id>`
+- `aiws change archive <change-id>`（手工恢复 / 历史兼容入口；标准链路一般不需要单独执行）
 - `aiws change evidence <change-id>`（收敛 review / validate / collaboration summary 到 `changes/<id>/evidence/`）
 
 Active change（推荐，团队共享）：
 - 使用分支名声明当前变更：`change/<change-id>`（也支持 `changes/`、`ws/`、`ws-change/`）
-- 切到该分支后，可省略 `<change-id>` 执行：`aiws change status|next|validate|sync|archive`
+- 切到该分支后，可省略 `<change-id>` 执行：`aiws change status|next|validate|sync`
 
 计划质量门（推荐，执行前）：
 - 先生成计划：`$ws-plan`（若尚未进入 `change/<change-id>` 上下文，应先由它调用 `aiws change start <change-id>` 建立分支 / worktree，再在该上下文内写 `plan/...`）
@@ -74,7 +75,10 @@ Active change（推荐，团队共享）：
 
 Hooks/CI（推荐，硬约束）：
 - 工作区会安装 `.githooks/{commit-msg,pre-commit,pre-push}`：
-  - `commit-msg`：默认提示优先使用中文 commit message；若执行 `git config aiws.commitMessagePolicy strict`，则会拒绝全英文首行（`Merge/Revert/fixup!/squash!` 例外）
+  - `commit-msg`：默认行为按仓库角色区分
+    - superproject / root 仓库（存在 `.gitmodules`）：默认 `off`，允许自由 commit message
+    - submodule / 普通仓库：默认 `warn`，提示优先使用中文 commit message
+    - 若执行 `git config aiws.commitMessagePolicy strict`，则会拒绝全英文首行（`Merge/Revert/fixup!/squash!` 例外）
   - `pre-commit` / `pre-push`：默认执行 `aiws validate .`
 - 还会安装门禁脚本（`tools/ws_change_check.py`、`tools/requirements_contract.py`）。
 - **启用 hooks 需要本地配置**（不会自动提交到 git）：
@@ -93,4 +97,4 @@ Hooks/CI（推荐，硬约束）：
 - 委托分析先落到 `changes/<id>/analysis/`，由主 agent 在 `ws-review` 或 `review/*.md` 中收敛结论。
 - patch 草案先落到 `changes/<id>/patches/`，未经审查不要直接应用。
 - 交付前建议执行：`aiws change evidence <change-id>`，让 `delivery-summary` 与 `collaboration-summary` 一起落到 `changes/<id>/evidence/`。
-- 归档后 `handoff.md` 会包含协同工件摘要，便于下一次会话继续接力。
+- finish 自动归档后生成的 `handoff.md` 会包含协同工件摘要，便于下一次会话继续接力。

package/templates/workspace/changes/templates/tasks.md

@@ -41,4 +41,4 @@
 - [ ] 4.1 证据落盘到 `.agentdocs/tmp/...`（报告/日志/请求响应等）
 - [ ] 4.2 生成持久证据：`aiws change evidence {{CHANGE_ID}}`
 - [ ] 4.3 交叉审计（可选但推荐）：在 AI 工具内运行 `/ws-review`（或按 `AI_PROJECT.md` 手工审计）
-- [ ] 4.4 归档：`aiws change archive {{CHANGE_ID}}`
+- [ ] 4.4 收尾：`aiws change finish {{CHANGE_ID}} --push`（成功后自动归档并生成 handoff）

package/templates/workspace/manifest.json

@@ -6,8 +6,7 @@
     "tools": [
       "claude",
       "opencode",
-      "codex",
-      "iflow"
+      "codex"
     ]
   },
   "required": [
@@ -35,6 +34,7 @@
     ".claude/commands/ws-preflight.md",
     ".claude/commands/ws-migrate.md",
     ".claude/commands/ws-dev.md",
+    ".claude/commands/ws-dev-lite.md",
     ".claude/commands/ws-deliver.md",
     ".claude/commands/ws-analyze.md",
     ".claude/commands/ws-pull.md",
@@ -56,6 +56,7 @@
     ".opencode/command/ws-preflight.md",
     ".opencode/command/ws-migrate.md",
     ".opencode/command/ws-dev.md",
+    ".opencode/command/ws-dev-lite.md",
     ".opencode/command/ws-deliver.md",
     ".opencode/command/ws-analyze.md",
     ".opencode/command/ws-bugfix.md",
@@ -72,43 +73,6 @@
     ".opencode/command/ws-req-contract-sync.md",
     ".opencode/command/ws-req-contract-validate.md",
     ".opencode/command/ws-req-flow-sync.md",
-    ".iflow/commands/aiws-init.toml",
-    ".iflow/commands/aiws-update.toml",
-    ".iflow/commands/aiws-validate.toml",
-    ".iflow/commands/aiws-rollback.toml",
-    ".iflow/commands/server-test-plan.toml",
-    ".iflow/commands/server-test.toml",
-    ".iflow/commands/server-triage.toml",
-    ".iflow/commands/server-fix.toml",
-    ".iflow/commands/server-fix-and-commit.toml",
-    ".iflow/commands/server-drain.toml",
-    ".iflow/commands/server-commit.toml",
-    ".iflow/commands/server_test-plan.toml",
-    ".iflow/commands/server_test.toml",
-    ".iflow/commands/ws-preflight.toml",
-    ".iflow/commands/ws-migrate.toml",
-    ".iflow/commands/ws-dev.toml",
-    ".iflow/commands/ws-analyze.toml",
-    ".iflow/commands/ws-deliver.toml",
-    ".iflow/commands/ws-pull.toml",
-    ".iflow/commands/ws-push.toml",
-    ".iflow/commands/ws-finish.toml",
-    ".iflow/commands/ws-submodule-setup.toml",
-    ".iflow/commands/ws-review.toml",
-    ".iflow/commands/ws-commit.toml",
-    ".iflow/commands/ws-rule.toml",
-    ".iflow/commands/ws-contract-check.toml",
-    ".iflow/commands/ws-doctor.toml",
-    ".iflow/commands/ws-env-doctor.toml",
-    ".iflow/commands/ws-init.toml",
-    ".iflow/commands/ws-memory-bank-init.toml",
-    ".iflow/commands/ws-feature-plan.toml",
-    ".iflow/commands/ws-feature-deliver.toml",
-    ".iflow/commands/ws-req-review.toml",
-    ".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",
     ".claude/commands/p-aiws-change-archive.md",
     ".claude/commands/p-aiws-change-finish.md",
     ".claude/commands/p-aiws-change-list.md",
@@ -156,7 +120,6 @@
     ".opencode/commands/**"
   ],
   "optional": [
-    ".iflow/agents/**",
     "memory-bank/**",
     "secrets/test-accounts.example.json",
     ".opencode/oh-my-opencode.json.example",
@@ -166,8 +129,6 @@
     "tools/requirements_contract_sync.py",
     "tools/requirements_flow_gen.py",
     "tools/server_test_runner.py",
-    "tools/iflow_watchdog.sh",
-    "tools/install_iflow_watchdog_systemd_user.sh",
     "tools/ws_resolve_sub_target.sh"
   ],
   "update": {
@@ -223,7 +184,54 @@
       ".opencode/command/aiws-change-archive.md",
       ".opencode/command/aiws-change-templates-which.md",
       ".opencode/command/aiws-change-templates-init.md",
-      ".agents/skills/ws-tasks-plan/SKILL.md"
+      ".agents/skills/ws-tasks-plan/SKILL.md",
+      ".iflow/agents/feature-reviewer.md",
+      ".iflow/agents/requirements-analyst.md",
+      ".iflow/agents/server-commit-manager.md",
+      ".iflow/agents/server-fix-implementer.md",
+      ".iflow/agents/server-test-planner.md",
+      ".iflow/agents/server-test-triager.md",
+      ".iflow/commands/aiws-init.toml",
+      ".iflow/commands/aiws-rollback.toml",
+      ".iflow/commands/aiws-update.toml",
+      ".iflow/commands/aiws-validate.toml",
+      ".iflow/commands/server-commit.toml",
+      ".iflow/commands/server-drain.toml",
+      ".iflow/commands/server-fix-and-commit.toml",
+      ".iflow/commands/server-fix.toml",
+      ".iflow/commands/server-test-plan.toml",
+      ".iflow/commands/server-test.toml",
+      ".iflow/commands/server-triage.toml",
+      ".iflow/commands/server_test-plan.toml",
+      ".iflow/commands/server_test.toml",
+      ".iflow/commands/ws-analyze.toml",
+      ".iflow/commands/ws-commit.toml",
+      ".iflow/commands/ws-contract-check.toml",
+      ".iflow/commands/ws-deliver.toml",
+      ".iflow/commands/ws-dev.toml",
+      ".iflow/commands/ws-doctor.toml",
+      ".iflow/commands/ws-env-doctor.toml",
+      ".iflow/commands/ws-feature-deliver.toml",
+      ".iflow/commands/ws-feature-plan.toml",
+      ".iflow/commands/ws-finish.toml",
+      ".iflow/commands/ws-init.toml",
+      ".iflow/commands/ws-memory-bank-init.toml",
+      ".iflow/commands/ws-migrate.toml",
+      ".iflow/commands/ws-preflight.toml",
+      ".iflow/commands/ws-pull.toml",
+      ".iflow/commands/ws-push.toml",
+      ".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-review.toml",
+      ".iflow/commands/ws-review.toml",
+      ".iflow/commands/ws-rule.toml",
+      ".iflow/commands/ws-submodule-setup.toml",
+      "tools/iflow_watchdog.sh",
+      "tools/install_iflow_watchdog_systemd_user.sh",
+      "tools/systemd/iflow-watchdog@.service",
+      "tools/systemd/iflow-watchdog@.timer"
     ],
     "replace_file": [
       ".aiws/manifest.json",
@@ -256,6 +264,7 @@
       ".agents/skills/ws-bugfix/SKILL.md",
       ".agents/skills/ws-commit/SKILL.md",
       ".agents/skills/ws-dev/SKILL.md",
+      ".agents/skills/ws-dev-lite/SKILL.md",
       ".agents/skills/ws-delegate/SKILL.md",
       ".agents/skills/ws-frontend-design/SKILL.md",
       ".agents/skills/ws-deliver/SKILL.md",
@@ -280,43 +289,6 @@
       ".agents/skills/ws-verify-before-complete/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",
-      ".iflow/commands/aiws-rollback.toml",
-      ".iflow/commands/server-test-plan.toml",
-      ".iflow/commands/server-test.toml",
-      ".iflow/commands/server-triage.toml",
-      ".iflow/commands/server-fix.toml",
-      ".iflow/commands/server-fix-and-commit.toml",
-      ".iflow/commands/server-drain.toml",
-      ".iflow/commands/server-commit.toml",
-      ".iflow/commands/server_test-plan.toml",
-      ".iflow/commands/server_test.toml",
-      ".iflow/commands/ws-preflight.toml",
-      ".iflow/commands/ws-migrate.toml",
-      ".iflow/commands/ws-dev.toml",
-      ".iflow/commands/ws-analyze.toml",
-      ".iflow/commands/ws-deliver.toml",
-      ".iflow/commands/ws-pull.toml",
-      ".iflow/commands/ws-push.toml",
-      ".iflow/commands/ws-finish.toml",
-      ".iflow/commands/ws-submodule-setup.toml",
-      ".iflow/commands/ws-review.toml",
-      ".iflow/commands/ws-commit.toml",
-      ".iflow/commands/ws-rule.toml",
-      ".iflow/commands/ws-contract-check.toml",
-      ".iflow/commands/ws-doctor.toml",
-      ".iflow/commands/ws-env-doctor.toml",
-      ".iflow/commands/ws-init.toml",
-      ".iflow/commands/ws-memory-bank-init.toml",
-      ".iflow/commands/ws-feature-plan.toml",
-      ".iflow/commands/ws-feature-deliver.toml",
-      ".iflow/commands/ws-req-review.toml",
-      ".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",
       ".claude/commands/p-aiws-change-archive.md",
       ".claude/commands/p-aiws-change-finish.md",
       ".claude/commands/p-aiws-change-list.md",
@@ -405,6 +377,8 @@
       ".opencode/skills/ws-deliver/SKILL.md",
       ".claude/skills/ws-dev/SKILL.md",
       ".opencode/skills/ws-dev/SKILL.md",
+      ".claude/skills/ws-dev-lite/SKILL.md",
+      ".opencode/skills/ws-dev-lite/SKILL.md",
       ".opencode/skills/ws-delegate/SKILL.md",
       ".opencode/oh-my-opencode.json.example",
       ".claude/skills/ws-finish/SKILL.md",
@@ -485,6 +459,9 @@
       ".claude/commands/ws-dev.md": [
         "claude:ws-dev"
       ],
+      ".claude/commands/ws-dev-lite.md": [
+        "claude:ws-dev-lite"
+      ],
       ".claude/commands/ws-deliver.md": [
         "claude:ws-deliver"
       ],
@@ -548,6 +525,9 @@
       ".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"
       ],
@@ -788,6 +768,9 @@
       ".opencode/commands/ws-dev.md": [
         "opencode:ws-dev"
       ],
+      ".opencode/commands/ws-dev-lite.md": [
+        "opencode:ws-dev-lite"
+      ],
       ".opencode/commands/ws-finish.md": [
         "opencode:ws-finish"
       ],

package/templates/workspace/memory-bank/README.md

@@ -1,6 +1,6 @@
 # Memory Bank（工作区上下文）
 
-目的：给 iFlow/Codex/Claude 一个“固定且可持续更新”的上下文集合，避免每次会话重新讲一遍导致跑偏。
+目的：给 OpenCode/Codex/Claude 一个“固定且可持续更新”的上下文集合，避免每次会话重新讲一遍导致跑偏。
 
 在你的工作区中：
 - `REQUIREMENTS.md` 仍是**需求真值**（不要复制到这里）。
@@ -11,4 +11,3 @@
 - 改代码前：先看 `REQUIREMENTS.md` + `AI_PROJECT.md` + `AI_WORKSPACE.md`，再结合本目录的 `architecture.md`/`progress.md`。
 - 每次完成一个可验证的小步：更新 `progress.md`（写清：做了什么、证据路径、下一步）。
 - 发生重大结构变化：更新 `architecture.md`（只写高层关系，不要堆细节）。
-