@aipper/aiws-spec 0.0.19 → 0.0.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipper/aiws-spec",
-  "version": "0.0.19",
+  "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/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

@@ -15,7 +15,7 @@
    - `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`。
+6) 进入 `/ws-dev` 修复并回填状态字段 `Fix_Status/Verify_Command/Updated_At`。
 7) 质量门：`aiws change validate <change-id> --strict` + `aiws validate . --stamp`。
 
 强制约束：

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.md

@@ -9,8 +9,8 @@
 执行建议：
 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`。
+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 -->
 

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 + 若阻断则给出阻断原因
 """

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

@@ -1,14 +1,14 @@
 # Command: ws:review
-# Description: AI Workspace 交叉审计交付（Claude + Codex + Gemini），证据落盘到 .agentdocs/tmp/review/
+# Description: AI Workspace 交叉审计交付（Claude + Codex + Gemini），证据优先落盘到 changes/<change-id>/review/
 # Category: workspace
 # Version: 1
 
-description = "AI Workspace 交叉审计交付（Claude + Codex + Gemini），证据落盘到 .agentdocs/tmp/review/"
+description = "AI Workspace 交叉审计交付（Claude + Codex + Gemini），证据优先落盘到 changes/<change-id>/review/"
 
 prompt = """
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 
-目标：在实现/提交前，对当前工作区改动进行交叉审计，并把审计结论落盘到 `.agentdocs/tmp/review/`，便于回放与追责。
+目标：在实现/提交前，对当前工作区改动进行交叉审计，并把审计结论优先落盘到 `changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.agentdocs/tmp/review/`），便于回放与追责。
 
 强制步骤：
 1) 读取真值文件：`AI_PROJECT.md`、`REQUIREMENTS.md`、`AI_WORKSPACE.md`。
@@ -22,7 +22,8 @@ prompt = """
    - Risks：3–8 条
    - Next：最小修复清单 + 最小验证命令
 5) 证据落盘（必须）：
-   - 在 `.agentdocs/tmp/review/` 写入一份 `review.<timestamp>.md`
+   - 默认：在 `changes/<change-id>/review/` 写入一份 `iflow-review.<timestamp>.md`
+   - 回退：在 `.agentdocs/tmp/review/` 写入同名文件（仅在无法确定 `change-id` 时使用）
 6) 如果目标是提交前门禁：
    - 建议运行：`aiws validate .`（或 `npx @aipper/aiws validate .`）
 

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

@@ -17,7 +17,7 @@ description: Commit：门禁/审计后提交（submodule 感知）
 
 步骤（建议）：
 1) 先运行 `/ws-preflight`。
-2) 运行 `/ws-review`（落盘审计证据）。
+2) 运行 `/ws-review`（优先落盘审计证据到 `changes/<change-id>/review/`）。
 3) 运行门禁校验并写 stamp：
 ```bash
 if [[ -x "./node_modules/.bin/aiws" ]]; then
@@ -60,9 +60,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:opencode:ws-commit -->
 
 可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -20,9 +20,9 @@ description: 开发：在 AIWS 约束下完成小步交付
 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:opencode:ws-dev -->
 
 可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

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

package/templates/workspace/AGENTS.md

@@ -19,7 +19,7 @@
   - `$ws-bugfix`：缺陷修复（禅道 MCP 拉单 + 图片证据落盘 + `issues/fix_bus_issues.csv` 汇总）
   - `$ws-pull`：拉取并对齐 submodules（尽量避免 detached；减少人为差异）
   - `$ws-push`：推送（submodule 感知：先 submodules 后 superproject；fast-forward 安全）
-  - `$ws-review`：评审（提交前审计与证据落盘）
+  - `$ws-review`：评审（提交前审计；证据优先落盘到 `changes/<change-id>/review/`）
   - `$ws-commit`：提交（先审计/门禁再 commit；submodule 感知）
   - `$aiws-init`：初始化工作区（生成真值文件与门禁）
   - `$aiws-validate`：校验工作区（漂移检测 + 门禁）

package/templates/workspace/changes/templates/proposal.md

@@ -19,7 +19,7 @@
 - 问题修复：`Problem_ID` = <!-- WS:TODO （问题修复可填；例如 PROB-001） -->
 - `Contract_Row` = <!-- WS:TODO 绑定执行合同中的行 ID，可多项（逗号分隔）；例如 Req_ID=TOOLING-001B -->
 - `Plan_File` = <!-- WS:TODO 例如 plan/2026-02-08_15-30-00-xxx.md -->
-- `Evidence_Path` = <!-- WS:TODO 证据路径，可多项（逗号分隔）；例如 .agentdocs/tmp/review/codex-review.md -->
+- `Evidence_Path` = <!-- WS:TODO 证据路径，可多项（逗号分隔）；例如 changes/<change-id>/review/codex-review.md -->
 
 > 规则：
 > - `Req_ID` 与 `Problem_ID` 至少填写一项。