@aipper/aiws-spec 0.0.18 → 0.0.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipper/aiws-spec",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "description": "AIWS spec and templates (single source of truth).",
   "type": "module",
   "files": [

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

@@ -21,7 +21,7 @@ description: 提交（当前分支可直提；submodule 感知；先审计/门
 
 执行步骤（建议）：
 1) 运行 `$ws-preflight`（确保真值文件就绪）。
-2) 运行 `$ws-review`（生成审计证据：`.agentdocs/tmp/review/codex-review.md`）。
+2) 运行 `$ws-review`（优先生成审计证据：`changes/<change-id>/review/codex-review.md`；无 `change-id` 时回退 `.agentdocs/tmp/review/codex-review.md`）。
 3) 运行门禁校验并写 stamp：
 ```bash
 if [[ -x "./node_modules/.bin/aiws" ]]; then
@@ -73,6 +73,6 @@ git show --stat --oneline -1
 ```
 
 输出要求：
-- `Evidence:` `.agentdocs/tmp/review/codex-review.md` + `.agentdocs/tmp/aiws-validate/*.json`
-- `Context:` 当前分支 + 是否检测到 submodule + 若阻断则给出阻断原因
-- `Commit:` 最终使用的 commit message（仅当用户确认后）
+- `证据（Evidence）:` `changes/<change-id>/review/codex-review.md`（无 `change-id` 时回退 `.agentdocs/tmp/review/codex-review.md`） + `.agentdocs/tmp/aiws-validate/*.json`
+- `上下文（Context）:` 当前分支 + 是否检测到 submodule + 若阻断则给出阻断原因
+- `提交信息（Commit）:` 最终使用的 commit message（仅当用户确认后）

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

@@ -33,6 +33,6 @@ fi
 8) 交付收尾（推荐，减少手动 merge 出错）：运行 `$ws-finish`（底层调用 `aiws change finish`，默认 fast-forward 安全合并回目标分支）。
 
 输出要求：
-- `Changed:` 文件清单
-- `Verify:` 实际运行的命令 + 期望结果
-- `Evidence:` 证据路径（例如 `plan/...`、`.agentdocs/tmp/aiws-validate/...` 或 `changes/<change-id>/...`）
+- `变更文件（Changed）:` 文件清单
+- `验证（Verify）:` 实际运行的命令 + 期望结果
+- `证据（Evidence）:` 证据路径（例如 `changes/<change-id>/review/...`、`plan/...`、`.agentdocs/tmp/aiws-validate/...` 或 `changes/<change-id>/...`）

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

@@ -5,7 +5,7 @@ description: 评审（提交前审计与证据落盘）
 
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 
-目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据落盘到 `.agentdocs/tmp/review/`。
+目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据优先落盘到 `changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.agentdocs/tmp/review/`）。
 
 步骤（建议）：
 1) 先做 preflight：定位项目根目录，读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
@@ -13,11 +13,13 @@ description: 评审（提交前审计与证据落盘）
    - 是否存在越界目录改动/危险操作
    - 是否有可复现验证命令与证据
    - 是否维护了 `changes/<change-id>/` 或相关 `issues/*.csv`
-3) 将审计落盘到：`.agentdocs/tmp/review/codex-review.md`（目录不存在则创建）。
+3) 将审计落盘到（目录不存在则创建）：
+   - 默认：`changes/<change-id>/review/codex-review.md`
+   - 回退：`.agentdocs/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
 4) 回复中输出：
-   - `Evidence:` 证据文件路径
-   - `Top risks:` 3–8 条（高→低）
-   - `Next:` 最小修复清单 + 最小验证命令
+   - `证据（Evidence）:` 证据文件路径
+   - `主要风险（Top risks）:` 3–8 条（高→低）
+   - `下一步（Next）:` 最小修复清单 + 最小验证命令
 
 安全：
 - 不打印 secrets。

package/templates/workspace/.claude/commands/aiws-change-archive.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-archive -->
+# aiws change archive
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 归档已完成 change 工件
+
+执行（在仓库根目录）：
+```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:claude:aiws-change-archive -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-finish.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-finish -->
+# aiws change finish
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 将 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:claude:aiws-change-finish -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-list.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-list -->
+# aiws change list
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 列出当前仓库 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:claude:aiws-change-list -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-new.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-new -->
+# aiws change new
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 创建 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:claude:aiws-change-new -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-next.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-next -->
+# aiws change next
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 输出 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:claude:aiws-change-next -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-start.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-start -->
+# aiws change start
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 切到 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:claude:aiws-change-start -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-status.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-status -->
+# aiws change status
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看 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:claude:aiws-change-status -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-sync.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-sync -->
+# aiws change sync
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 同步当前 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:claude:aiws-change-sync -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-templates-init.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-templates-init -->
+# aiws change templates init
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 初始化 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:claude:aiws-change-templates-init -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-templates-which.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-templates-which -->
+# aiws change templates which
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看 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:claude:aiws-change-templates-which -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-change-validate.md

@@ -0,0 +1,22 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-validate -->
+# aiws change validate
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 按严格模式校验变更工件与绑定关系
+
+执行（在仓库根目录）：
+```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:claude:aiws-change-validate -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-hooks-install.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-hooks-install -->
+# aiws hooks install
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 启用 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:claude:aiws-hooks-install -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.claude/commands/aiws-hooks-status.md

@@ -0,0 +1,21 @@
+<!-- AIWS_MANAGED_BEGIN:claude:aiws-hooks-status -->
+# aiws hooks status
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 查看当前仓库 hooks 门禁状态（只读）
+
+执行（在仓库根目录）：
+```bash
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws hooks status .
+elif command -v aiws >/dev/null 2>&1; then
+  aiws hooks status .
+else
+  npx @aipper/aiws hooks status .
+fi
+```
+<!-- AIWS_MANAGED_END:claude:aiws-hooks-status -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

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

@@ -17,7 +17,7 @@
    - 风险与回滚（3–8 条）
    - 最小验证命令（可复现）
 3) 将分析落盘到：`.agentdocs/tmp/analyze/claude-analysis.md`（目录不存在则创建）。
-4) 回复中必须包含：`Evidence:` 证据文件路径。
+4) 回复中必须包含：`证据（Evidence）:` 证据文件路径。
 
 安全：
 - 不打印 secrets（尤其 `secrets/test-accounts.json`）。

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

@@ -0,0 +1,27 @@
+<!-- AIWS_MANAGED_BEGIN:claude:ws-bugfix -->
+# ws bugfix
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 通过禅道 MCP 拉单、图片证据落盘并汇总 `issues/fix_bus_issues.csv`。
+
+建议流程：
+1) 先运行 `/ws-preflight`。
+2) 建立变更工件（推荐）：`aiws change start <change-id> --hooks`（superproject+submodule 可用 `--worktree --submodules`）。
+3) 通过已配置 zentao MCP 拉取 bug 字段与附件列表。
+4) 落盘证据到 `changes/<change-id>/bug/`：
+   - `zentao-bug-<bug-id>.json`
+   - `zentao-bug-<bug-id>.md`
+   - `images/<bug-id>/...`
+5) upsert `issues/fix_bus_issues.csv`（主键 `Bug_ID`）。
+6) 进入 `/ws-dev` 修复并回填状态字段 `Fix_Status/Verify_Command/Updated_At`。
+7) 质量门：`aiws change validate <change-id> --strict` + `aiws validate . --stamp`。
+
+强制约束：
+- 不自动 commit / push。
+- 不写入 secrets（token、cookie、内网地址）。
+- 无法复现时先输出阻塞信息并落盘，不直接改代码。
+<!-- AIWS_MANAGED_END:claude:ws-bugfix -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

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

@@ -14,7 +14,7 @@
 
 步骤（建议）：
 1) 先运行 `/ws-preflight`。
-2) 运行 `/ws-review`（落盘审计证据）。
+2) 运行 `/ws-review`（优先落盘审计证据到 `changes/<change-id>/review/`）。
 3) 运行门禁校验并写 stamp：
 ```bash
 if [[ -x "./node_modules/.bin/aiws" ]]; then
@@ -57,9 +57,9 @@ git commit -m "<message>"
 ```
 
 输出必须包含：
-- `Evidence:` `.agentdocs/tmp/review/*` + `.agentdocs/tmp/aiws-validate/*`
-- `Context:` 当前分支 + 是否检测到 submodule + 若阻断则给出阻断原因
-- `Next:` 若存在 submodule 改动，先提示用户进入 submodule 提交
+- `证据（Evidence）:` `changes/<change-id>/review/*`（无 change-id 时回退 `.agentdocs/tmp/review/*`） + `.agentdocs/tmp/aiws-validate/*`
+- `上下文（Context）:` 当前分支 + 是否检测到 submodule + 若阻断则给出阻断原因
+- `下一步（Next）:` 若存在 submodule 改动，先提示用户进入 submodule 提交
 <!-- AIWS_MANAGED_END:claude:ws-commit -->
 
 可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

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

@@ -36,10 +36,10 @@
    - 优先运行 `/ws-finish`（底层调用 `aiws change finish`，默认 `--ff-only`）
 
 输出要求：
-- `Submodules:` 每个 submodule 的 commit 摘要（repo/path → sha → message）
-- `Superproject:` commit 摘要
-- `Merge:` `/ws-finish` 输出（into/from）
-- `Evidence:` `.agentdocs/tmp/aiws-validate/*.json`（若使用 --stamp）
+- `子模块（Submodules）:` 每个 submodule 的 commit 摘要（repo/path → sha → message）
+- `主仓库（Superproject）:` commit 摘要
+- `合并信息（Merge）:` `/ws-finish` 输出（into/from）
+- `证据（Evidence）:` `.agentdocs/tmp/aiws-validate/*.json`（若使用 --stamp）
 <!-- AIWS_MANAGED_END:claude:ws-deliver -->
 
 可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

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

@@ -17,9 +17,9 @@
 7) 交付收尾（推荐，减少手动 merge 出错）：运行 `/ws-finish`（底层调用 `aiws change finish`，默认 fast-forward 安全合并回目标分支）。
 
 输出要求：
-- `Changed:` 文件清单
-- `Verify:` 实际运行的命令 + 期望结果
-- `Evidence:` 证据路径（例如 `.agentdocs/tmp/...` 或 `changes/<change-id>/...`）
+- `变更文件（Changed）:` 文件清单
+- `验证（Verify）:` 实际运行的命令 + 期望结果
+- `证据（Evidence）:` 证据路径（例如 `changes/<change-id>/review/...`、`changes/<change-id>/...` 或 `.agentdocs/tmp/...`）
 <!-- AIWS_MANAGED_END:claude:ws-dev -->
 
 可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

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

@@ -0,0 +1,25 @@
+<!-- AIWS_MANAGED_BEGIN:claude:ws-plan-verify -->
+# ws plan verify
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 执行前检查计划是否跑偏，并给出最小修正项。
+
+执行建议：
+1) 先运行 `/ws-preflight`。
+2) 运行严格门禁：
+```bash
+if [[ -x "./node_modules/.bin/aiws" ]]; then
+  ./node_modules/.bin/aiws change validate <change-id> --strict
+elif command -v aiws >/dev/null 2>&1; then
+  aiws change validate <change-id> --strict
+else
+  npx @aipper/aiws change validate <change-id> --strict
+fi
+```
+3) 若失败：先修 `proposal.md` / `plan` 的绑定字段与验证命令，再复跑。
+4) 通过后再进入 `/ws-dev`。
+<!-- AIWS_MANAGED_END:claude:ws-plan-verify -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

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

@@ -0,0 +1,17 @@
+<!-- AIWS_MANAGED_BEGIN:claude:ws-plan -->
+# ws plan
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 生成可落盘执行计划（供 /ws-dev 执行）。
+
+执行建议：
+1) 先运行 `/ws-preflight`（对齐 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`）。
+2) 生成或更新计划文件：`plan/YYYY-MM-DD_HH-MM-SS-<slug>.md`。
+3) 计划至少包含：`绑定信息（Bindings）`、`目标（Goal）`、`非目标（Non-goals）`、`范围（Scope）`、`执行计划（Plan）`、`验证（Verify）`、`风险与回滚（Risks & Rollback）`、`证据（Evidence）`。
+4) 若已有 `changes/<change-id>/proposal.md`，对齐 `计划文件（Plan_File）` / `合同行（Contract_Row）` / `证据路径（Evidence_Path）`。
+5) 完成后先运行 `/ws-plan-verify`，通过再进入 `/ws-dev`。
+<!-- AIWS_MANAGED_END:claude:ws-plan -->
+
+可在下方追加本项目对 Claude Code 的额外说明（托管块外内容会被保留）。

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

@@ -14,10 +14,10 @@
    - `REQUIREMENTS.md`
    - `AI_WORKSPACE.md`
 3) 输出：
-   - `Root:` <项目根路径>
-   - `Found:` <实际读取到的文件列表>
-   - `Missing:` <缺失文件列表>
-   - `Key rules:` 3–8 条 bullet（范围/禁止项/必须产物/必须验证命令）
+   - `根目录（Root）:` <项目根路径>
+   - `已读取（Found）:` <实际读取到的文件列表>
+   - `缺失（Missing）:` <缺失文件列表>
+   - `关键规则（Key rules）:` 3–8 条 bullet（范围/禁止项/必须产物/必须验证命令）
 
 安全：
 - 不打印 secrets；遇到疑似敏感值只提示“存在风险”但不要复述原文。

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

@@ -15,11 +15,11 @@
    - `requirements/requirements-issues.csv`（若存在）
 3) 输出固定结构的报告：
 
-## Requirements QA
+## 需求 QA（Requirements QA）
 - 结论：是否可进入实现（是/否/有条件）
 - 漂移风险：最容易导致不一致的点
 - 可验收性缺口：缺少输入/输出/错误码/边界/示例的条目
-- 完整性：Non-goals/兼容性/鉴权/重试/并发/观测性/性能
+- 完整性：非目标（Non-goals）/兼容性/鉴权/重试/并发/观测性/性能
 - 一致性：与 `AI_PROJECT.md` 约束冲突点
 - 可测试性与证据：最小验证命令 + 期望结果 + 证据路径
 - 风险清单：3–8 条

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

@@ -3,7 +3,7 @@
 
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 
-目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据落盘到 `.agentdocs/tmp/review/`。
+目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据优先落盘到 `changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.agentdocs/tmp/review/`）。
 
 步骤（建议）：
 1) 先运行 `/ws-preflight`。
@@ -11,11 +11,13 @@
    - 是否存在越界目录改动/危险操作
    - 是否有可复现验证命令与证据
    - 是否维护了 `changes/<change-id>/` 或相关 `issues/*.csv`
-3) 将审计落盘到：`.agentdocs/tmp/review/claude-review.md`（目录不存在则创建）。
+3) 将审计落盘到（目录不存在则创建）：
+   - 默认：`changes/<change-id>/review/claude-review.md`
+   - 回退：`.agentdocs/tmp/review/claude-review.md`（仅在无法确定 `change-id` 时使用）
 4) 回复中输出：
-   - `Evidence:` 证据文件路径
-   - `Top risks:` 3–8 条（高→低）
-   - `Next:` 最小修复清单 + 最小验证命令
+   - `证据（Evidence）:` 证据文件路径
+   - `主要风险（Top risks）:` 3–8 条（高→低）
+   - `下一步（Next）:` 最小修复清单 + 最小验证命令
 
 安全：
 - 不打印 secrets。

package/templates/workspace/.codex/prompts/ws-dev.md

@@ -21,9 +21,9 @@ argument-hint: ""
 6) 提交前强制：`aiws validate .`（commit/push hooks 也会阻断）。
 
 输出要求：
-- `Changed:` 文件清单
-- `Verify:` 实际运行的命令 + 期望结果
-- `Evidence:` 证据路径（例如 `.agentdocs/tmp/...` 或 `changes/<change-id>/...`）
+- `变更文件（Changed）:` 文件清单
+- `验证（Verify）:` 实际运行的命令 + 期望结果
+- `证据（Evidence）:` 证据路径（例如 `changes/<change-id>/review/...`、`changes/<change-id>/...` 或 `.agentdocs/tmp/...`）
 <!-- AIWS_MANAGED_END:codex:ws-dev -->
 
 可在下方追加本项目对 Codex 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.codex/prompts/ws-review.md

@@ -8,7 +8,7 @@ argument-hint: ""
 
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 
-目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据落盘到 `.agentdocs/tmp/review/`。
+目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据优先落盘到 `changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.agentdocs/tmp/review/`）。
 
 步骤（建议）：
 1) 先运行 `/ws-preflight`。
@@ -16,11 +16,13 @@ argument-hint: ""
    - 是否存在越界目录改动/危险操作
    - 是否有可复现验证命令与证据
    - 是否维护了 `changes/<change-id>/` 或相关 `issues/*.csv`
-3) 将审计落盘到：`.agentdocs/tmp/review/codex-review.md`（目录不存在则创建）。
+3) 将审计落盘到（目录不存在则创建）：
+   - 默认：`changes/<change-id>/review/codex-review.md`
+   - 回退：`.agentdocs/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
 4) 回复中输出：
-   - `Evidence:` 证据文件路径
-   - `Top risks:` 3–8 条（高→低）
-   - `Next:` 最小修复清单 + 最小验证命令
+   - `证据（Evidence）:` 证据文件路径
+   - `主要风险（Top risks）:` 3–8 条（高→低）
+   - `下一步（Next）:` 最小修复清单 + 最小验证命令
 
 安全：
 - 不打印 secrets。

package/templates/workspace/.iflow/commands/ws-commit.toml

@@ -20,7 +20,7 @@ prompt = """
 强制步骤：
 1) 读取真值文件：`AI_PROJECT.md`、`REQUIREMENTS.md`、`AI_WORKSPACE.md`（缺失则先运行 `/aiws-init` 或 `aiws init .`）。
 2) 若 iFlow 拦截写入：先执行 `/ws-contract-check`，再继续。
-3) 先运行 `/ws-review`（落盘审计证据到 `.agentdocs/tmp/review/`）。
+3) 先运行 `/ws-review`（优先落盘审计证据到 `changes/<change-id>/review/`）。
 4) 运行门禁并写 stamp：`aiws validate . --stamp`（未安装全局 aiws 时可用 `npx @aipper/aiws validate . --stamp`）。
 5) 输出提交上下文（必须输出给用户确认）：
    - `git branch --show-current`
@@ -39,6 +39,6 @@ prompt = """
 10) 执行提交（不带 `--no-verify`）：`git commit -m "<message>"`。
 
 输出必须包含：
-- Evidence：`.agentdocs/tmp/review/*` + `.agentdocs/tmp/aiws-validate/*`
-- Context：当前分支 + 是否检测到 submodule + 若阻断则给出阻断原因
+- 证据（Evidence）：`changes/<change-id>/review/*`（无 change-id 时回退 `.agentdocs/tmp/review/*`） + `.agentdocs/tmp/aiws-validate/*`
+- 上下文（Context）：当前分支 + 是否检测到 submodule + 若阻断则给出阻断原因
 """