@aipper/aiws-spec 0.0.25 → 0.0.26

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

@@ -53,7 +53,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 上下文
@@ -64,6 +64,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/.claude/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/.claude/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/.claude/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/.claude/skills/ws-finish/SKILL.md

@@ -206,15 +206,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/.claude/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/.githooks/commit-msg

@@ -13,6 +13,16 @@ policy="${AIWS_COMMIT_MSG_POLICY:-}"
 if [[ -z "${policy:-}" ]]; then
   policy="$(git config --get aiws.commitMessagePolicy 2>/dev/null || true)"
 fi
+if [[ -z "${policy:-}" ]]; then
+  superproject_root="$(git rev-parse --show-superproject-working-tree 2>/dev/null || true)"
+  if [[ -n "${superproject_root:-}" ]]; then
+    policy="warn"
+  elif [[ -f ".gitmodules" ]]; then
+    policy="off"
+  else
+    policy="warn"
+  fi
+fi
 policy="${policy:-warn}"
 
 case "$policy" in

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

@@ -18,12 +18,13 @@ description: 默认 workflow router：先判定阶段，再进入具体 ws-* 入
 4) 路由规则：
    - 需求/验收/合同变更：`/ws-req-review`
    - 中大型实现或需要 change/worktree：`/ws-plan`
-   - 小步明确实现：`/ws-dev`
+   - 小步明确实现：`/ws-dev`（若是 simple/local 单点修复，可显式进入 `/ws-dev-lite`）
    - 评审/审计：`/ws-review`
    - finish / merge / push / cleanup：`/ws-finish`
    - handoff / archive summary：`/ws-handoff`
 5) 输出 `OpenCode mode:` / `Task intent:` / `Binding:` / `Route:` / `Why:` / `Next:`。
-6) 除非用户只要路由判断，否则给出 route 后继续遵循对应入口的契约。
+6) 若 `Route: ws-dev` 且任务属于 simple/local 单点修复：`Next` 可显式建议 `/ws-dev-lite`。
+7) 除非用户只要路由判断，否则给出 route 后继续遵循对应入口的契约。
 <!-- AIWS_MANAGED_END:opencode:using-aiws -->
 
 可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/command/ws-dev-lite.md

@@ -0,0 +1,34 @@
+---
+description: 轻量开发：simple/local 单点修复；最小改动 + 最小验证
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-dev-lite -->
+# ws dev lite
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：处理 simple/local 单点修复，走最小改动 + 最小验证，不默认拉起完整重流程。
+
+使用条件：
+- 目标明确、归因明确、验证入口明确
+- 一般只影响单文件或紧密相关的小范围文件
+- 不需要先改 `REQUIREMENTS.md`
+
+强制流程：
+1) 先运行 `/ws-preflight`。
+2) 先说明：
+   - `Goal:`
+   - `Why lite:`
+   - 若说不清，立刻回到 `/ws-dev` 或 `/ws-plan`
+3) 实施最小改动；不要为形式完整额外扩 scope。
+4) 运行最小可复现验证；允许比全量更窄，但必须说明为什么足够。
+5) 输出 `Changed / Verify / Evidence / Next`。
+6) 若准备提交或交付：后续仍进入 `/ws-review`、`/ws-commit`、`/ws-finish`。
+
+边界：
+- 默认不创建 `plan/...`
+- 默认不跑 `ws-plan-verify`
+- 默认不要求先做双 review
+- 一旦复杂度升高，停止 lite，切回主流程
+<!-- AIWS_MANAGED_END:opencode:ws-dev-lite -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -61,7 +61,7 @@ fi
 6) 任一 submodule 不满足 fast-forward 条件时立即停止（不要继续 push 主仓库）。
 7) submodules 全部成功后，再回到主仓库执行：
    - `aiws change finish <change-id> --push`
-8) （可选）交付完成后归档变更工件：`aiws change archive <change-id>`。
+8) `aiws change finish --push` 成功后会自动归档并生成 handoff；只有历史/异常场景才需要手工运行 `aiws change archive <change-id>`。
 
 安全：
 - push 前先输出状态并说明远端/分支。

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

@@ -1,5 +1,5 @@
 ---
-description: 交接：查看归档 change 的 handoff.md（由 aiws change archive 生成）
+description: 交接：查看归档 change 的 handoff.md（标准由 aiws change finish --push 自动归档生成）
 ---
 <!-- AIWS_MANAGED_BEGIN:opencode:ws-handoff -->
 # ws handoff
@@ -8,10 +8,10 @@ description: 交接：查看归档 change 的 handoff.md（由 aiws change archi
 
 目标：
 - 交接与回放：通过 `handoff.md` 让已归档的 change 可被下一位/下一次会话快速接力。
-- handoff 文件位置：`changes/archive/<date>-<change-id>/handoff.md`（由 `aiws change archive` 自动生成）。
+- handoff 文件位置：`changes/archive/<date>-<change-id>/handoff.md`（默认由 `aiws change finish --push` 自动归档时生成）。
 
 执行建议：
-1) 若 change 已完成并准备归档：运行 `/p-aiws-change-archive`（会先严格校验，再归档并生成 `handoff.md`）。
+1) 先确认 change 已通过 `/ws-finish` 或 `aiws change finish --push` 完成自动归档。
 2) 查看 handoff：
 ```bash
 change_id="<change-id>"
@@ -20,6 +20,7 @@ sed -n '1,160p' changes/archive/*-"${change_id}"/handoff.md
 ```
 3) 依赖提示：
 - 若你在某个 change 的 `proposal.md` 声明了 `Depends_On`，`aiws change start` 会尝试读取依赖 change 的 `handoff.md` 并输出摘要（前提：依赖已归档且 handoff 存在）。
+- 若是历史/异常场景尚未归档，再手工运行 `/p-aiws-change-archive`。
 <!-- AIWS_MANAGED_END:opencode:ws-handoff -->
 
 可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -17,8 +17,8 @@ description: 评审：提交前审计改动并落盘证据
    - 是否有可复现验证命令与证据
    - 是否维护了 `changes/<change-id>/` 或相关 `issues/*.csv`
 3) 将审计落盘到（目录不存在则创建）：
-   - 默认：`changes/<change-id>/review/opencode-review.md`
-   - 回退：`.agentdocs/tmp/review/opencode-review.md`（仅在无法确定 `change-id` 时使用）
+   - 默认：`changes/<change-id>/review/codex-review.md`
+   - 回退：`.agentdocs/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
 4) 回复中输出：
    - `证据（Evidence）:` 证据文件路径
    - `主要风险（Top risks）:` 3–8 条（高→低）

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

@@ -18,12 +18,13 @@ description: 默认 workflow router：先判定阶段，再进入具体 ws-* 入
 4) 路由规则：
    - 需求/验收/合同变更：`/ws-req-review`
    - 中大型实现或需要 change/worktree：`/ws-plan`
-   - 小步明确实现：`/ws-dev`
+   - 小步明确实现：`/ws-dev`（若是 simple/local 单点修复，可显式进入 `/ws-dev-lite`）
    - 评审/审计：`/ws-review`
    - finish / merge / push / cleanup：`/ws-finish`
    - handoff / archive summary：`/ws-handoff`
 5) 输出 `OpenCode mode:` / `Task intent:` / `Binding:` / `Route:` / `Why:` / `Next:`。
-6) 除非用户只要路由判断，否则给出 route 后继续遵循对应入口的契约。
+6) 若 `Route: ws-dev` 且任务属于 simple/local 单点修复：`Next` 可显式建议 `/ws-dev-lite`。
+7) 除非用户只要路由判断，否则给出 route 后继续遵循对应入口的契约。
 <!-- AIWS_MANAGED_END:opencode:using-aiws -->
 
 可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.opencode/commands/ws-dev-lite.md

@@ -0,0 +1,34 @@
+---
+description: 轻量开发：simple/local 单点修复；最小改动 + 最小验证
+---
+<!-- AIWS_MANAGED_BEGIN:opencode:ws-dev-lite -->
+# ws dev lite
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：处理 simple/local 单点修复，走最小改动 + 最小验证，不默认拉起完整重流程。
+
+使用条件：
+- 目标明确、归因明确、验证入口明确
+- 一般只影响单文件或紧密相关的小范围文件
+- 不需要先改 `REQUIREMENTS.md`
+
+强制流程：
+1) 先运行 `/ws-preflight`。
+2) 先说明：
+   - `Goal:`
+   - `Why lite:`
+   - 若说不清，立刻回到 `/ws-dev` 或 `/ws-plan`
+3) 实施最小改动；不要为形式完整额外扩 scope。
+4) 运行最小可复现验证；允许比全量更窄，但必须说明为什么足够。
+5) 输出 `Changed / Verify / Evidence / Next`。
+6) 若准备提交或交付：后续仍进入 `/ws-review`、`/ws-commit`、`/ws-finish`。
+
+边界：
+- 默认不创建 `plan/...`
+- 默认不跑 `ws-plan-verify`
+- 默认不要求先做双 review
+- 一旦复杂度升高，停止 lite，切回主流程
+<!-- AIWS_MANAGED_END:opencode:ws-dev-lite -->
+
+可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -61,7 +61,7 @@ fi
 6) 任一 submodule 不满足 fast-forward 条件时立即停止（不要继续 push 主仓库）。
 7) submodules 全部成功后，再回到主仓库执行：
    - `aiws change finish <change-id> --push`
-8) （可选）交付完成后归档变更工件：`aiws change archive <change-id>`。
+8) `aiws change finish --push` 成功后会自动归档并生成 handoff；只有历史/异常场景才需要手工运行 `aiws change archive <change-id>`。
 
 安全：
 - push 前先输出状态并说明远端/分支。

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

@@ -1,5 +1,5 @@
 ---
-description: 交接：查看归档 change 的 handoff.md（由 aiws change archive 生成）
+description: 交接：查看归档 change 的 handoff.md（标准由 aiws change finish --push 自动归档生成）
 ---
 <!-- AIWS_MANAGED_BEGIN:opencode:ws-handoff -->
 # ws handoff
@@ -8,10 +8,10 @@ description: 交接：查看归档 change 的 handoff.md（由 aiws change archi
 
 目标：
 - 交接与回放：通过 `handoff.md` 让已归档的 change 可被下一位/下一次会话快速接力。
-- handoff 文件位置：`changes/archive/<date>-<change-id>/handoff.md`（由 `aiws change archive` 自动生成）。
+- handoff 文件位置：`changes/archive/<date>-<change-id>/handoff.md`（默认由 `aiws change finish --push` 自动归档时生成）。
 
 执行建议：
-1) 若 change 已完成并准备归档：运行 `/p-aiws-change-archive`（会先严格校验，再归档并生成 `handoff.md`）。
+1) 先确认 change 已通过 `/ws-finish` 或 `aiws change finish --push` 完成自动归档。
 2) 查看 handoff：
 ```bash
 change_id="<change-id>"
@@ -20,6 +20,7 @@ sed -n '1,160p' changes/archive/*-"${change_id}"/handoff.md
 ```
 3) 依赖提示：
 - 若你在某个 change 的 `proposal.md` 声明了 `Depends_On`，`aiws change start` 会尝试读取依赖 change 的 `handoff.md` 并输出摘要（前提：依赖已归档且 handoff 存在）。
+- 若是历史/异常场景尚未归档，再手工运行 `/p-aiws-change-archive`。
 <!-- AIWS_MANAGED_END:opencode:ws-handoff -->
 
 可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -17,8 +17,8 @@ description: 评审：提交前审计改动并落盘证据
    - 是否有可复现验证命令与证据
    - 是否维护了 `changes/<change-id>/` 或相关 `issues/*.csv`
 3) 将审计落盘到（目录不存在则创建）：
-   - 默认：`changes/<change-id>/review/opencode-review.md`
-   - 回退：`.agentdocs/tmp/review/opencode-review.md`（仅在无法确定 `change-id` 时使用）
+   - 默认：`changes/<change-id>/review/codex-review.md`
+   - 回退：`.agentdocs/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
 4) 回复中输出：
    - `证据（Evidence）:` 证据文件路径
    - `主要风险（Top risks）:` 3–8 条（高→低）

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

@@ -206,15 +206,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) 目录发现规则