@aipper/aiws-spec 0.0.26 → 0.0.28

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

@@ -9,7 +9,9 @@
 前置（必须）：
 - 工作区干净：`git status --porcelain` 无输出（否则先 commit 或 stash）
 - change 分支存在（`change/<change-id>`；也支持 `changes/`、`ws/`、`ws-change/`）
- - 若存在 `.gitmodules`：必须为每个 submodule 配置 `submodule.<name>.branch`（否则先运行 `/ws-submodule-setup` 并提交 `.gitmodules`）
+- 普通 finish 的 `validate/evidence/state` 应先在 `change/<change-id>` worktree 完成；真正执行 `aiws change finish` 时再切到目标分支所在 worktree
+- 若 `aiws change status <change-id>` 输出 `governance_rule: finish_resume_required`：说明 merge 已发生，只需继续 push / archive / cleanup closeout；直接在提示的 worktree 运行 `aiws change finish <change-id> --push`
+- 若存在 `.gitmodules`：必须为每个 submodule 配置 `submodule.<name>.branch`（否则先运行 `/ws-submodule-setup` 并提交 `.gitmodules`）
 
 步骤（建议）：
 0) 若存在 `.gitmodules`，先检查 submodule branch 配置是否齐全（缺失则停止并提示 setup）：
@@ -31,9 +33,11 @@ if [[ -f .gitmodules ]]; then
 fi
 ```
 1) 先运行 `/ws-preflight`（确保真值文件齐全）。
-2) （推荐）门禁校验并落盘证据：`aiws validate . --stamp`（未安装全局 aiws 时可用 `npx @aipper/aiws validate . --stamp`）。
-2.1) （强烈建议）收敛持久证据并回填 `Evidence_Path`：`aiws change evidence <change-id>`（未安装全局 aiws 时可用 `npx @aipper/aiws change evidence <change-id>`）。
-2.2) （可选）生成状态快照（建议）：`aiws change state <change-id> --write`。
+2) 先运行 `aiws change status <change-id>`，优先看稳定字段 `governance_rule:`。
+   - 若为 `finish_resume_required`：直接跳到步骤 3 执行 `aiws change finish <change-id> --push`
+   - 若不是该值：按普通 finish 继续；不要依赖自然语言提示句做分支判断
+2.1) 普通 finish 时，`aiws validate . --stamp` / `aiws change evidence <change-id>` / `aiws change state <change-id> --write` 应在 `change/<change-id>` worktree 完成。
+   - 如果已经在目标分支 worktree，且 `governance_rule` 不是 `finish_resume_required`，不要在这里跑 `aiws validate . --stamp`；先回 `change/<change-id>` worktree，或先跑 `/ws-verify-before-complete`
 3) 若不存在 `.gitmodules`，或 submodules 已按顺序处理完成，优先直接执行最小收尾闭环：
    - `aiws change finish <change-id> --push`
    - 若当前就在 `change/<change-id>` 分支上，也可省略 `<change-id>`

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

@@ -0,0 +1,19 @@
+<!-- AIWS_MANAGED_BEGIN:claude: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:claude:ws-intake -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/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
 ```

package/templates/workspace/.claude/skills/ws-intake/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: ws-intake
+description: 计划前置澄清（逐条冻结问题并产出 intake 草案，供 ws-plan 消费）
+---
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 在进入 `/ws-plan` 前，把新需求或中大型变更里的待确认问题逐条澄清并冻结。
+- 采用“一题一线程”模式推进：每次只处理 1 个问题，允许该问题多轮往返，直到形成明确结论。
+- 产出一份可被 `/ws-plan` 消费的轻量草案：`plan/<timestamp>-<slug>.intake.md`。
+
+执行要求：
+1) 先读 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，必要时先 `/ws-preflight`。
+2) 若存在最新 `plan/*.intake.md`，先续写它；否则新建一份 intake 草案。
+3) 把当前任务拆成 `Open Questions`，状态只允许 `open / in_discussion / frozen / deferred`。
+4) 每次只推进 1 个当前问题，并显式输出：
+   - `Current question:`
+   - `Why it matters:`
+   - `Current options / current understanding:`
+   - `Exit condition:`
+5) 当前问题在没有被标记成 `frozen` 或 `deferred` 前，不进入下一题。
+6) 每轮都要把 intake 草案写盘，至少包含：
+   - `Context`
+   - `Open Questions`
+   - `Resolved Questions`
+   - `Frozen Decisions`
+   - `Draft Scope`
+   - `Draft Verify`
+   - `Ready for ws-plan: yes/no`
+7) 若关键问题已冻结：`Next` 指向 `/ws-plan`；否则继续 `/ws-intake`。

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

@@ -12,7 +12,9 @@ description: 收尾：fast-forward 合并并把 submodule 并回目标分支后
 前置（必须）：
 - 工作区干净：`git status --porcelain` 无输出（否则先 commit 或 stash）
 - change 分支存在（`change/<change-id>`；也支持 `changes/`、`ws/`、`ws-change/`）
- - 若存在 `.gitmodules`：必须为每个 submodule 配置 `submodule.<name>.branch`（否则先运行 `/ws-submodule-setup` 并提交 `.gitmodules`）
+- 普通 finish 的 `validate/evidence/state` 应先在 `change/<change-id>` worktree 完成；真正执行 `aiws change finish` 时再切到目标分支所在 worktree
+- 若 `aiws change status <change-id>` 输出 `governance_rule: finish_resume_required`：说明 merge 已发生，只需继续 push / archive / cleanup closeout；直接在提示的 worktree 运行 `aiws change finish <change-id> --push`
+- 若存在 `.gitmodules`：必须为每个 submodule 配置 `submodule.<name>.branch`（否则先运行 `/ws-submodule-setup` 并提交 `.gitmodules`）
 
 步骤（建议）：
 0) 若存在 `.gitmodules`，先检查 submodule branch 配置是否齐全（缺失则停止并提示 setup）：
@@ -34,9 +36,11 @@ if [[ -f .gitmodules ]]; then
 fi
 ```
 1) 先运行 `/ws-preflight`（确保真值文件齐全）。
-2) （推荐）门禁校验并落盘证据：`aiws validate . --stamp`（未安装全局 aiws 时可用 `npx @aipper/aiws validate . --stamp`）。
-2.1) （强烈建议）收敛持久证据并回填 `Evidence_Path`：`aiws change evidence <change-id>`（未安装全局 aiws 时可用 `npx @aipper/aiws change evidence <change-id>`）。
-2.2) （可选）生成状态快照（建议）：`aiws change state <change-id> --write`。
+2) 先运行 `aiws change status <change-id>`，优先看稳定字段 `governance_rule:`。
+   - 若为 `finish_resume_required`：直接跳到步骤 3 执行 `aiws change finish <change-id> --push`
+   - 若不是该值：按普通 finish 继续；不要依赖自然语言提示句做分支判断
+2.1) 普通 finish 时，`aiws validate . --stamp` / `aiws change evidence <change-id>` / `aiws change state <change-id> --write` 应在 `change/<change-id>` worktree 完成。
+   - 如果已经在目标分支 worktree，且 `governance_rule` 不是 `finish_resume_required`，不要在这里跑 `aiws validate . --stamp`；先回 `change/<change-id>` worktree，或先跑 `/ws-verify-before-complete`
 3) 若不存在 `.gitmodules`，或 submodules 已按顺序处理完成，优先直接执行最小收尾闭环：
    - `aiws change finish <change-id> --push`
    - 若当前就在 `change/<change-id>` 分支上，也可省略 `<change-id>`

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

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

@@ -12,7 +12,9 @@ description: 收尾：fast-forward 合并并把 submodule 并回目标分支后
 前置（必须）：
 - 工作区干净：`git status --porcelain` 无输出（否则先 commit 或 stash）
 - change 分支存在（`change/<change-id>`；也支持 `changes/`、`ws/`、`ws-change/`）
- - 若存在 `.gitmodules`：必须为每个 submodule 配置 `submodule.<name>.branch`（否则先运行 `/ws-submodule-setup` 并提交 `.gitmodules`）
+- 普通 finish 的 `validate/evidence/state` 应先在 `change/<change-id>` worktree 完成；真正执行 `aiws change finish` 时再切到目标分支所在 worktree
+- 若 `aiws change status <change-id>` 输出 `governance_rule: finish_resume_required`：说明 merge 已发生，只需继续 push / archive / cleanup closeout；直接在提示的 worktree 运行 `aiws change finish <change-id> --push`
+- 若存在 `.gitmodules`：必须为每个 submodule 配置 `submodule.<name>.branch`（否则先运行 `/ws-submodule-setup` 并提交 `.gitmodules`）
 
 步骤（建议）：
 0) 若存在 `.gitmodules`，先检查 submodule branch 配置是否齐全（缺失则停止并提示 setup）：
@@ -34,9 +36,11 @@ if [[ -f .gitmodules ]]; then
 fi
 ```
 1) 先运行 `/ws-preflight`（确保真值文件齐全）。
-2) （推荐）门禁校验并落盘证据：`aiws validate . --stamp`（未安装全局 aiws 时可用 `npx @aipper/aiws validate . --stamp`）。
-2.1) （强烈建议）收敛持久证据并回填 `Evidence_Path`：`aiws change evidence <change-id>`（未安装全局 aiws 时可用 `npx @aipper/aiws change evidence <change-id>`）。
-2.2) （可选）生成状态快照（建议）：`aiws change state <change-id> --write`。
+2) 先运行 `aiws change status <change-id>`，优先看稳定字段 `governance_rule:`。
+   - 若为 `finish_resume_required`：直接跳到步骤 3 执行 `aiws change finish <change-id> --push`
+   - 若不是该值：按普通 finish 继续；不要依赖自然语言提示句做分支判断
+2.1) 普通 finish 时，`aiws validate . --stamp` / `aiws change evidence <change-id>` / `aiws change state <change-id> --write` 应在 `change/<change-id>` worktree 完成。
+   - 如果已经在目标分支 worktree，且 `governance_rule` 不是 `finish_resume_required`，不要在这里跑 `aiws validate . --stamp`；先回 `change/<change-id>` worktree，或先跑 `/ws-verify-before-complete`
 3) 若不存在 `.gitmodules`，或 submodules 已按顺序处理完成，优先直接执行最小收尾闭环：
    - `aiws change finish <change-id> --push`
    - 若当前就在 `change/<change-id>` 分支上，也可省略 `<change-id>`

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

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

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

@@ -0,0 +1,31 @@
+---
+name: ws-intake
+description: 计划前置澄清（逐条冻结问题并产出 intake 草案，供 ws-plan 消费）
+---
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 在进入 `/ws-plan` 前，把新需求或中大型变更里的待确认问题逐条澄清并冻结。
+- 采用“一题一线程”模式推进：每次只处理 1 个问题，允许该问题多轮往返，直到形成明确结论。
+- 产出一份可被 `/ws-plan` 消费的轻量草案：`plan/<timestamp>-<slug>.intake.md`。
+
+执行要求：
+1) 先读 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，必要时先 `/ws-preflight`。
+2) 若存在最新 `plan/*.intake.md`，先续写它；否则新建一份 intake 草案。
+3) 把当前任务拆成 `Open Questions`，状态只允许 `open / in_discussion / frozen / deferred`。
+4) 每次只推进 1 个当前问题，并显式输出：
+   - `Current question:`
+   - `Why it matters:`
+   - `Current options / current understanding:`
+   - `Exit condition:`
+5) 当前问题在没有被标记成 `frozen` 或 `deferred` 前，不进入下一题。
+6) 每轮都要把 intake 草案写盘，至少包含：
+   - `Context`
+   - `Open Questions`
+   - `Resolved Questions`
+   - `Frozen Decisions`
+   - `Draft Scope`
+   - `Draft Verify`
+   - `Ready for ws-plan: yes/no`
+7) 若关键问题已冻结：`Next` 指向 `/ws-plan`；否则继续 `/ws-intake`。

package/templates/workspace/AGENTS.md

@@ -16,8 +16,9 @@
 标准链路（建议默认）：
 - `using-aiws`：默认 bootstrap/router；先读真值，先判 workflow，再进入具体阶段；意图不明确时先澄清。
 - `ws-preflight`：读取真值文件，输出约束摘要；若真值缺失，先停止，不直接开工。
+- `ws-intake`：计划前置澄清；适用于新需求或中大型变更，按“一题一线程”逐条冻结问题，产出 `plan/*.intake.md` 轻量草案。
 - `ws-plan`：建立 `change/<change-id>` 绑定，落盘 `plan/...`，明确 Verify / Risks / Evidence。
-- `ws-plan-verify`：在编码前做计划质检；不过门禁就先修 plan，不跳步进实现。
+- `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 + 协同工件模式。
@@ -30,6 +31,7 @@
 - `ws-handoff`：查看/补充归档后的 handoff，给下一次会话或下一位协作者接力。
 
 阶段产物（最少）：
+- intake：`plan/*.intake.md`
 - planning：`plan/...`、`changes/<change-id>/proposal.md`、`tasks.md`
 - implementation：代码 / 配置改动 + Verify 命令记录
 - collaboration：`changes/<change-id>/analysis/...`、`patches/...`、`review/...`
@@ -43,8 +45,9 @@ OpenCode（如果你主要用 OpenCode，优先）：
 - 若你想按项目固定这组 agent，可参考 `.opencode/oh-my-opencode.json.example`；它只覆盖 `agents`，不接管 hooks/MCP/LSP
 - 常用手动入口继续保留在 `.opencode/commands/`（migration window 内 `.opencode/command/` 也会保留）；直接使用 `/ws-*`
 - 若你不确定当前任务该先 plan、dev、review 还是 finish：先用 `/using-aiws`
+- 需求还没冻结、想逐条把问题聊清楚：先用 `/ws-intake`
 - `/ws-preflight`：读取真值文件并输出约束摘要
-- `/ws-plan` / `/ws-plan-verify`：先生成计划，再做执行前质检
+- `/ws-plan` / `/ws-plan-verify`：先生成计划，再做执行前质检与多视角方案审查
 - `/ws-dev`：常规实现/改配置/改测试
 - `/ws-dev-lite`：小问题直修；若复杂度升高，立刻回到 `/ws-dev` 或 `/ws-plan`
 - `/ws-delegate`：按 AIWS 委托合同拆分子任务，并优先借用 oMo agent
@@ -60,13 +63,14 @@ Claude Code（如果你主要用 Claude Code）：
 - native skills 在 `.claude/skills/`；command-style 兼容入口保留在 `.claude/commands/`
 - 常用链路可按 `ws-*` / `p-aiws-*` 理解；native skills 与 compatibility commands 指向同一套 AIWS workflow
 - 若你不确定当前任务该走哪个阶段：先用 `/using-aiws`
+- 需求还没冻结、想逐条把问题聊清楚：先用 `/ws-intake`
 - 高风险改动或准备 finish 时，建议额外跑 `/ws-spec-review`、`/ws-quality-review`、`/ws-verify-before-complete`
 
 Codex（对应入口，可选）：
 - 若你不想先记住阶段，先用 `$using-aiws` 让 router 判定下一步
 - 对应入口在 `.agents/skills/`；显式调用时使用 `$ws-*`
 - `$using-aiws`
-- `$ws-preflight` / `$ws-plan` / `$ws-plan-verify` / `$ws-dev` / `$ws-dev-lite` / `$ws-delegate` / `$ws-frontend-design`
+- `$ws-preflight` / `$ws-intake` / `$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/changes/README.md

@@ -34,12 +34,13 @@ 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，并把 `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>`

package/templates/workspace/manifest.json

@@ -32,6 +32,7 @@
     ".claude/commands/p-aiws-validate.md",
     ".claude/commands/p-aiws-rollback.md",
     ".claude/commands/ws-preflight.md",
+    ".claude/commands/ws-intake.md",
     ".claude/commands/ws-migrate.md",
     ".claude/commands/ws-dev.md",
     ".claude/commands/ws-dev-lite.md",
@@ -54,6 +55,7 @@
     ".opencode/command/p-aiws-validate.md",
     ".opencode/command/p-aiws-rollback.md",
     ".opencode/command/ws-preflight.md",
+    ".opencode/command/ws-intake.md",
     ".opencode/command/ws-migrate.md",
     ".opencode/command/ws-dev.md",
     ".opencode/command/ws-dev-lite.md",
@@ -263,6 +265,7 @@
       ".agents/skills/ws-analyze/SKILL.md",
       ".agents/skills/ws-bugfix/SKILL.md",
       ".agents/skills/ws-commit/SKILL.md",
+      ".agents/skills/ws-intake/SKILL.md",
       ".agents/skills/ws-dev/SKILL.md",
       ".agents/skills/ws-dev-lite/SKILL.md",
       ".agents/skills/ws-delegate/SKILL.md",
@@ -303,6 +306,7 @@
       ".claude/commands/p-aiws-hooks-install.md",
       ".claude/commands/p-aiws-hooks-status.md",
       ".claude/commands/using-aiws.md",
+      ".claude/commands/ws-intake.md",
       ".claude/commands/ws-plan.md",
       ".claude/commands/ws-plan-verify.md",
       ".claude/commands/ws-bugfix.md",
@@ -323,6 +327,7 @@
       ".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-delegate.md",
       ".opencode/command/ws-plan-verify.md",
@@ -373,6 +378,8 @@
       ".opencode/skills/ws-bugfix/SKILL.md",
       ".claude/skills/ws-commit/SKILL.md",
       ".opencode/skills/ws-commit/SKILL.md",
+      ".claude/skills/ws-intake/SKILL.md",
+      ".opencode/skills/ws-intake/SKILL.md",
       ".claude/skills/ws-deliver/SKILL.md",
       ".opencode/skills/ws-deliver/SKILL.md",
       ".claude/skills/ws-dev/SKILL.md",
@@ -615,6 +622,9 @@
       ".claude/commands/using-aiws.md": [
         "claude:using-aiws"
       ],
+      ".claude/commands/ws-intake.md": [
+        "claude:ws-intake"
+      ],
       ".claude/commands/ws-plan.md": [
         "claude:ws-plan"
       ],
@@ -678,6 +688,9 @@
       ".opencode/command/using-aiws.md": [
         "opencode:using-aiws"
       ],
+      ".opencode/command/ws-intake.md": [
+        "opencode:ws-intake"
+      ],
       ".opencode/command/ws-plan.md": [
         "opencode:ws-plan"
       ],
@@ -777,6 +790,9 @@
       ".opencode/commands/ws-handoff.md": [
         "opencode:ws-handoff"
       ],
+      ".opencode/commands/ws-intake.md": [
+        "opencode:ws-intake"
+      ],
       ".opencode/commands/ws-spec-review.md": [
         "opencode:ws-spec-review"
       ],