npm - @aipper/aiws-spec - Versions diffs - 0.0.30 → 0.0.32 - Mend

@aipper/aiws-spec 0.0.30 → 0.0.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (49) hide show

package/package.json CHANGED Viewed

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

package/templates/workspace/.agents/skills/p-aiws-change-archive/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: 私有：归档变更工件（会先做严格校验并生成 handof
 ---
 目标：
-- 将 `changes/<change-id>/` 归档到 `changes/archive/<YYYY-MM-DD>/...`
+- 将 `.aiws/changes/<change-id>/` 归档到 `changes/archive/<YYYY-MM-DD>/...`
 执行（在仓库根目录）：
 ```bash

package/templates/workspace/.agents/skills/p-aiws-change-finish/SKILL.md CHANGED Viewed

@@ -20,5 +20,5 @@ fi
 说明：
 - 默认等价于：`git merge --ff-only change/<change-id>`
-- 若你当前就在 `change/<change-id>` 分支上，`finish` 会尝试读取 `changes/<change-id>/.ws-change.json` 的 `base_branch` 作为目标分支
+- 若你当前就在 `change/<change-id>` 分支上，`finish` 会尝试读取 `.aiws/changes/<change-id>/.ws-change.json` 的 `base_branch` 作为目标分支
 - 若无法 fast-forward：先在 change 分支（或对应 worktree）里 `git rebase <target-branch>`，再重试 `aiws change finish`

package/templates/workspace/.agents/skills/p-aiws-change-new/SKILL.md CHANGED Viewed

@@ -1,10 +1,10 @@
 ---
 name: p-aiws-change-new
-description: 私有：创建 changes/<change-id> 工件
+description: 私有：创建 .aiws/changes/<change-id> 工件
 ---
 目标：
-- 创建 `changes/<change-id>/` 工件目录与基础文件（proposal/tasks/可选 design）
+- 创建 `.aiws/changes/<change-id>/` 工件目录与基础文件（proposal/tasks/可选 design）
 要求：
 - `change-id` 必须是 kebab-case：`^[a-z0-9]+(-[a-z0-9]+)*$`

package/templates/workspace/.agents/skills/p-aiws-change-start/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: 私有：切分支并初始化变更工件（可选安装 hooks）
 ---
 目标：
-- 切到分支 `change/<change-id>` 并初始化 `changes/<change-id>/` 工件
+- 切到分支 `change/<change-id>` 并初始化 `.aiws/changes/<change-id>/` 工件
   - 若检测到 `.gitmodules`（git submodules），默认优先使用 `--worktree`（失败则回退为 `--no-switch`），避免切走 superproject 分支导致 submodule 状态混乱
 要求：

package/templates/workspace/.agents/skills/p-aiws-change-sync/SKILL.md CHANGED Viewed

@@ -1,10 +1,10 @@
 ---
 name: p-aiws-change-sync
-description: 私有：同步真值基线到 changes/<change-id>（写入 .ws-change.json）
+description: 私有：同步真值基线到 .aiws/changes/<change-id>（写入 .ws-change.json）
 ---
 目标：
-- 将当前真值文件（`AI_PROJECT.md` / `AI_WORKSPACE.md` / `REQUIREMENTS.md`）的 hash 快照同步到 `changes/<change-id>/.ws-change.json`
+- 将当前真值文件（`AI_PROJECT.md` / `AI_WORKSPACE.md` / `REQUIREMENTS.md`）的 hash 快照同步到 `.aiws/changes/<change-id>/.ws-change.json`
 执行（在仓库根目录）：
 ```bash

package/templates/workspace/.agents/skills/p-aiws-change-validate/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: 私有：校验 changes 工件（可 strict）
 ---
 目标：
-- 校验 `changes/<change-id>/` 工件完整性、归因与 WS:TODO（用于 hooks/CI）
+- 校验 `.aiws/changes/<change-id>/` 工件完整性、归因与 WS:TODO（用于 hooks/CI）
 执行（在仓库根目录）：
 ```bash

package/templates/workspace/.agents/skills/p-aiws-validate/SKILL.md CHANGED Viewed

@@ -19,4 +19,4 @@ fi
 ```
 证据（可选）：
-- stamp：`.agentdocs/tmp/aiws-validate/*.json`（由 `.gitignore` 忽略）
+- stamp：`.aiws/tmp/aiws-validate/*.json`（由 `.gitignore` 忽略）

package/templates/workspace/.agents/skills/p-tasks-plan/SKILL.md CHANGED Viewed

@@ -1,18 +1,18 @@
 ---
 name: p-tasks-plan
-description: 原子：tasks 同步（从 changes/<id>/tasks.md 生成 update_plan payload）
+description: 原子：tasks 同步（从 .aiws/changes/<id>/tasks.md 生成 update_plan payload）
 ---
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 目标：
-- 用 `changes/<change-id>/tasks.md` 的 checkbox 任务作为“步骤真值”
+- 用 `.aiws/changes/<change-id>/tasks.md` 的 checkbox 任务作为“步骤真值”
 - 生成可直接用于 `update_plan` 的 JSON payload（`pending/in_progress/completed`）
 - 输出当前进度摘要（done/total + 当前 in_progress）
 约束：
 - 不写入任何 secrets（token、账号、内网端点等不得进入 git）
-- 只读 `changes/<id>/tasks.md`（不自动改写 tasks 文件）
+- 只读 `.aiws/changes/<id>/tasks.md`（不自动改写 tasks 文件）
 - 未运行不声称已运行
 执行步骤（建议）：
@@ -20,18 +20,18 @@ description: 原子：tasks 同步（从 changes/<id>/tasks.md 生成 update_pla
 2) 推断 `change-id`：
    - 优先从当前分支名读取：`git rev-parse --abbrev-ref HEAD`（期望形如 `change/<change-id>`）
    - 若无法推断：让用户明确本次要同步的 `<change-id>`
-3) 检查 tasks 文件存在：`test -f changes/<change-id>/tasks.md`
+3) 检查 tasks 文件存在：`test -f .aiws/changes/<change-id>/tasks.md`
 4) 输出进度摘要：
 ```bash
-python3 tools/ws_tasks_plan.py status --file changes/<change-id>/tasks.md
+python3 tools/ws_tasks_plan.py status --file .aiws/changes/<change-id>/tasks.md
 ```
 5) 生成 `update_plan` payload（JSON 输出到 stdout）：
 ```bash
-python3 tools/ws_tasks_plan.py plan --file changes/<change-id>/tasks.md --explanation "sync tasks.md -> update_plan"
+python3 tools/ws_tasks_plan.py plan --file .aiws/changes/<change-id>/tasks.md --explanation "sync tasks.md -> update_plan"
 ```
 6) 调用 `update_plan`，将上一步 JSON 原样作为入参（确保任意时刻最多 1 条 `in_progress`）。
 输出要求：
 - `Change_ID:` <change-id>
-- `Tasks:` `changes/<change-id>/tasks.md`
+- `Tasks:` `.aiws/changes/<change-id>/tasks.md`
 - `Next:` 推荐下一步（通常为继续完善 tasks 或进入 `$ws-dev`）

package/templates/workspace/.agents/skills/using-aiws/SKILL.md CHANGED Viewed

@@ -19,7 +19,7 @@ description: 默认 workflow bootstrap/router：先读真值，再路由到正
 - `AI_PROJECT.md`
 - `REQUIREMENTS.md`
 - `AI_WORKSPACE.md`
-- 若已存在：当前 `change/<change-id>` 上下文、`plan/...`、`changes/<change-id>/...`
+- 若已存在：当前 `change/<change-id>` 上下文、`plan/...`、`.aiws/changes/<change-id>/...`
 必需输出：
 - `Root:` 当前项目根
@@ -41,7 +41,7 @@ description: 默认 workflow bootstrap/router：先读真值，再路由到正
 - 已经明确给出单一路由结果，并进入对应 `ws-*` skill；或已提出关键澄清问题并停止。
 执行步骤（强制）：
-1) 先遵守 `$ws-preflight` 的真值读取要求：
+1) 先遵守 `$ws-preflight` 的真值读取要求（含 submodule 感知的项目根定位——若在 submodule 内自动上溯到 superproject 根）：
    - 定位项目根目录
    - 读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
    - 输出 `Root:` / `Found:` / `Missing:`

package/templates/workspace/.agents/skills/ws-analyze/SKILL.md CHANGED Viewed

@@ -5,20 +5,20 @@ description: 分析（定位问题与收集上下文）
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
-目标：在开始实现/修复前做一次技术分析，产出可执行的最小行动清单，并把证据落盘到 `.agentdocs/tmp/analyze/`。
+目标：在开始实现/修复前做一次技术分析，产出可执行的最小行动清单，并把证据落盘到 `.aiws/tmp/analyze/`。
 输入：
 - 主题/需求：用户在本次消息中提供的主题（若不明确，先问一句“本次分析主题是什么？”）
 步骤（建议）：
-1) 先做 preflight：定位项目根目录，读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
+1) 先做 preflight：定位项目根目录（submodule 感知：若在 submodule 内自动上溯到 superproject 根），读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
 2) 基于真值文件与当前代码现状，输出：
    - 目标 / 非目标
    - 现状证据（文件路径/接口路径）
    - 推荐方案（1 个）+ 备选（可选）
    - 风险与回滚（3–8 条）
    - 最小验证命令（可复现）
-3) 将分析落盘到：`.agentdocs/tmp/analyze/codex-analysis.md`（目录不存在则创建）。
+3) 将分析落盘到：`.aiws/tmp/analyze/codex-analysis.md`（目录不存在则创建）。
 4) 回复中必须包含：`Evidence:` 证据文件路径。
 安全：

package/templates/workspace/.agents/skills/ws-bugfix/SKILL.md CHANGED Viewed

@@ -1,13 +1,13 @@
 ---
 name: ws-bugfix
-description: 缺陷修复（通过禅道 MCP 拉取 bug 与附件，下载图片证据，汇总到 issues/fix_bus_issues.csv，并绑定到 changes/<change-id>/）
+description: 缺陷修复（通过禅道 MCP 拉取 bug 与附件，下载图片证据，汇总到 issues/fix_bus_issues.csv，并绑定到 .aiws/changes/<change-id>/）
 ---
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 目标：
 - 用禅道 MCP 拉取 bug 详情与附件（尤其图片）
-- 把证据落盘到 `changes/<change-id>/bug/`（避免只停留在对话）
+- 把证据落盘到 `.aiws/changes/<change-id>/bug/`（避免只停留在对话）
 - 把修复任务汇总/更新到 `issues/fix_bus_issues.csv`
 - 与 `ws-dev` / `aiws change` 流程绑定，确保可追溯、可验证
@@ -21,7 +21,7 @@ description: 缺陷修复（通过禅道 MCP 拉取 bug 与附件，下载图片
 2) 准备 `change-id`（建议：`bug-<bug-id>` 或 `bugfix-<bug-id>-<slug>`）。
 3) 建立 change 上下文（推荐先于任何落盘）：
    - 若当前还不在 `change/<change-id>` 分支 / worktree，先调用 `aiws change start`
-   - 工作区必须先干净；否则不要先写 `changes/<change-id>/bug/` 或 `issues/fix_bus_issues.csv`，避免后续切 worktree 时工件留在原工作区
+   - 工作区必须先干净；否则不要先写 `.aiws/changes/<change-id>/bug/` 或 `issues/fix_bus_issues.csv`，避免后续切 worktree 时工件留在原工作区
    - 仓库已有提交：优先 `--worktree`
    - superproject + submodule：优先 `--worktree --submodules`
    - 仓库尚无提交 / 不满足 worktree 前置条件：回退 `--no-switch`
@@ -46,7 +46,7 @@ fi
      - 优先复用 `$ws-dev` 的 `submodules.targets` 生成/确认流程
      - detached HEAD 时默认建议取 `.gitmodules` 声明的分支
      - 已附着在某个本地分支时默认建议取当前分支
-     - 以上都只是建议值，最终必须显式写入 `changes/<change-id>/submodules.targets`
+     - 以上都只是建议值，最终必须显式写入 `.aiws/changes/<change-id>/submodules.targets`
 建议流程（按顺序）：
@@ -58,14 +58,14 @@ fi
 - 若当前环境没有 zentao MCP 工具：立即停止并提示用户先配置，不要猜数据。
 ## 2) 证据落盘（强制）
-在当前 active change 上下文的 `changes/<change-id>/bug/` 下落盘：
+在当前 active change 上下文的 `.aiws/changes/<change-id>/bug/` 下落盘：
 - `zentao-bug-<bug-id>.json`：原始字段快照（避免信息丢失）
 - `zentao-bug-<bug-id>.md`：人类可读摘要（复现步骤/期望/实际/风险）
 - `images/<bug-id>/...`：下载的图片附件（保留原扩展名）
 建议目录：
 ```text
-changes/<change-id>/bug/
+.aiws/changes/<change-id>/bug/
   zentao-bug-<bug-id>.json
   zentao-bug-<bug-id>.md
   images/<bug-id>/
@@ -83,7 +83,7 @@ Bug_ID,Title,Severity,Module,Status,Assigned_To,Change_ID,Image_Count,Image_Path
 字段约束：
 - `Change_ID`：必须等于当前 `change-id`
-- `Evidence_Path`：指向 `changes/<change-id>/bug/zentao-bug-<bug-id>.md`
+- `Evidence_Path`：指向 `.aiws/changes/<change-id>/bug/zentao-bug-<bug-id>.md`
 - `Image_Paths`：多个路径用 `;` 分隔
 - `Fix_Status`：`TODO|DOING|DONE|BLOCKED`
@@ -107,5 +107,5 @@ aiws validate . --stamp
 - `Change_ID:` `<change-id>`
 - `Change context:` `<当前分支或 worktree 路径>`
 - `CSV:` `issues/fix_bus_issues.csv` 中对应 `Bug_ID` 行的关键字段
-- `Evidence:` `changes/<change-id>/bug/zentao-bug-<bug-id>.md` + 图片目录
+- `Evidence:` `.aiws/changes/<change-id>/bug/zentao-bug-<bug-id>.md` + 图片目录
 - `Verify:` 实际运行命令与结果（未运行不声称已运行）

package/templates/workspace/.agents/skills/ws-delegate/SKILL.md CHANGED Viewed

@@ -55,10 +55,10 @@ description: 原生多 agent 委托入口（Codex 优先；先定义角色/边
 5) 若当前环境不支持，或无法稳定约束 scope：
    - 明确输出 `Execution Mode: fallback single-agent`
    - 仍按 AIWS 协同工件约定执行：
-     - `changes/<id>/analysis/`
-     - `changes/<id>/patches/`
-     - `changes/<id>/review/`
-     - `changes/<id>/evidence/`
+     - `.aiws/changes/<id>/analysis/`
+     - `.aiws/changes/<id>/patches/`
+     - `.aiws/changes/<id>/review/`
+     - `.aiws/changes/<id>/evidence/`
 6) 不论是否启用原生多 agent，都不要跳过：
    - 需求归因
    - 验证命令

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

@@ -20,7 +20,7 @@ description: 开发（按需求实现并验证；适用于任何需要修改代
 - `变更文件（Changed）:` 实际改动清单
 - `验证（Verify）:` 实际运行的命令与结果说明
-- `证据（Evidence）:` `plan/...`、`changes/<change-id>/...`、`.agentdocs/tmp/...` 等证据路径
+- `证据（Evidence）:` `plan/...`、`.aiws/changes/<change-id>/...`、`.aiws/tmp/...` 等证据路径
 - `Next:` 若准备提交，建议 `$ws-review` 或 `$ws-commit`
 ## 阻断条件
@@ -37,7 +37,7 @@ description: 开发（按需求实现并验证；适用于任何需要修改代
 ### 1. Preflight
-定位项目根目录，读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
+定位项目根目录（submodule 感知：若在 submodule 内自动上溯到 superproject 根），读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
 - 中大型任务：建议先用 `$ws-plan` 生成 `plan/` 工件。
 - 已有计划：先 `$ws-plan-verify`，通过后进入实现。
@@ -47,7 +47,7 @@ description: 开发（按需求实现并验证；适用于任何需要修改代
 在进入实现前，先验证绑定工件是否完整：
-- 若计划或实际改动超过 2 个文件：**必须**检查 `changes/<change-id>/` 下是否存在 `proposal.md` 和 `tasks.md`
+- 若计划或实际改动超过 2 个文件：**必须**检查 `.aiws/changes/<change-id>/` 下是否存在 `proposal.md` 和 `tasks.md`
 - 若缺失：**阻断**并输出信息 `Design Gate: proposal.md and tasks.md required for multi-file implementations. Run $ws-plan first.`
 - 若为单文件/小改动（≤2 文件）：此检查为 advisory 级别，缺失仅在输出中提示但不阻断
 - Design Gate 检查结果需记录在输出中，作为实现入口证据
@@ -59,7 +59,7 @@ Design Gate 通过后，继续进入变更归因与实现。
 - 若 `git status --porcelain` 仅有计划/工件文件，属于预期行为，继续即可。
 - 若需创建新 change：`aiws change start <change-id> --hooks --no-switch`
 - 若需切换分支：先确认无额外未提交改动，再 `git switch change/<change-id>`
-- 若存在 submodule（`.gitmodules`）：进入编码前必须准备好 `changes/<change-id>/submodules.targets`。`aiws change start` 的 `--submodules` 标志会自动处理。参考 `changes/README.md` 和 `changes/<change-id>/submodules.targets` 格式。
+- 若存在 submodule（`.gitmodules`）：进入编码前必须准备好 `.aiws/changes/<change-id>/submodules.targets`。`aiws change start` 的 `--submodules` 标志会自动处理。参考 `changes/README.md` 和 `.aiws/changes/<change-id>/submodules.targets` 格式。
 ### 3. 实现策略：默认 dispatch aiws-worker（Subagent-First）

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

@@ -44,8 +44,8 @@ description: 轻量开发（simple/local 单点修复；最小改动 + 最小验
    - 若只需局部回归，允许运行更窄的验证，但要说明为什么足够
 5) 留下至少一个可追溯证据：
    - 实际改动文件
-   - 或 `.agentdocs/tmp/...`
-   - 或 `changes/<change-id>/...`
+   - 或 `.aiws/tmp/...`
+   - 或 `.aiws/changes/<change-id>/...`
 6) 输出：
    - `变更文件（Changed）:`
    - `验证（Verify）:`

package/templates/workspace/.agents/skills/ws-frontend-design/SKILL.md CHANGED Viewed

@@ -123,4 +123,4 @@ app-ui 规则：
 - `Visual thesis:` 一句话
 - `Changed:` 改动文件清单
 - `Verify:` 实际运行命令 + 预期结果
-- `Evidence:` 相关 `plan/...`、`changes/<change-id>/...` 或截图/审计路径
+- `Evidence:` 相关 `plan/...`、`.aiws/changes/<change-id>/...` 或截图/审计路径

package/templates/workspace/.agents/skills/ws-plan/SKILL.md CHANGED Viewed

@@ -16,7 +16,7 @@ description: 规划（生成可落盘 plan/ 工件；供 ws-dev 执行）
 - 不写入任何 secrets（token、账号、内网端点等不得进入 git）
 - 本 skill 只负责“想清楚怎么做 + 落盘计划”，不要直接大规模改动代码
 - 未运行不声称已运行；验证命令要写清“预期结果”
-- 若存在 `changes/<change-id>/proposal.md`，计划与 proposal 的绑定字段必须保持一致（不一致时先修正再继续）
+- 若存在 `.aiws/changes/<change-id>/proposal.md`，计划与 proposal 的绑定字段必须保持一致（不一致时先修正再继续）
 阶段定位：
 - planning 阶段；负责把用户目标收敛为 change 绑定、计划文件和验证入口。
@@ -25,7 +25,7 @@ description: 规划（生成可落盘 plan/ 工件；供 ws-dev 执行）
 - 当前任务描述
 - 真值文件：`AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
 - 若已存在：最新 `plan/*.intake.md`
-- 若已存在：`changes/<change-id>/proposal.md`
+- 若已存在：`.aiws/changes/<change-id>/proposal.md`
 - 若已有计划：当前 `plan/...` 文件
 必需输出：
@@ -52,7 +52,7 @@ description: 规划（生成可落盘 plan/ 工件；供 ws-dev 执行）
 3) 若用户任务描述不清，且也没有可消费的 intake 草案：先问 1-3 个关键澄清问题（不要猜）；若问题较多则回退到 `$ws-intake`
 4) 判断复杂度：`simple / medium / complex`（给出一句理由），并估算步骤数。
 5) 识别或建立主索引 / change 上下文：
-   - 若存在 `changes/<change-id>/proposal.md`：读取其中 `Change_ID` / `Req_ID` / `Problem_ID` / `Contract_Row` / `Evidence_Path`
+   - 若存在 `.aiws/changes/<change-id>/proposal.md`：读取其中 `Change_ID` / `Req_ID` / `Problem_ID` / `Contract_Row` / `Evidence_Path`
    - 若缺失关键绑定：先补齐 proposal（至少 `Change_ID`、`Req_ID|Problem_ID`、`Contract_Row`）再继续生成计划
    - 若当前不在 `change/<change-id>` 分支 / worktree，且本次任务需要新建 change：先调用 `aiws change start` 建立上下文，再继续写 plan
    - 推荐顺序：
@@ -101,7 +101,7 @@ fi
    - `Submodules`（当存在 `.gitmodules` 且声明了 submodule 条目时，强制）：声明“本次 change 的 submodule 目标分支真值”（用于同一 superproject 分支内的多渠道交付；也避免仅靠 `.gitmodules` 默认分支导致交付推送到错误分支）
    - `Verify`：可复现命令 + 期望结果（优先引用 `AI_WORKSPACE.md` 的入口；必要时补充 e2e）
    - `Risks & Rollback`：风险点 + 回滚方案（例如 git 回滚、`aiws rollback`、恢复备份等）
-   - `Evidence`：计划文件路径；若创建了变更工件则附 `changes/<change-id>/...`
+   - `Evidence`：计划文件路径；若创建了变更工件则附 `.aiws/changes/<change-id>/...`
 8) 若存在 change proposal：回填并对齐 `proposal.md` 的 `Plan_File`（必要时同步 `Contract_Row` / `Evidence_Path`），保证 plan/proposal 一致。
 9) 运行 `$ws-plan-verify` 作为执行前质量门（计划不过长、不跑偏、验证可复现）。
 10) 若计划涉及“需求/验收”变更：先用 `$ws-req-review` 评审 → 用户确认后再 `$ws-req-change` 落盘（避免需求漂移）。
@@ -111,7 +111,7 @@ fi
 - 背景：`.gitmodules submodule.<name>.branch` 适合作为“团队默认分支真值”，但当同一 superproject 分支需要在不同交付中选择不同 submodule 目标分支（多渠道）时，仅靠 `.gitmodules` 不足。
 - 强约束：当 `.gitmodules` 声明了 submodule 条目时，门禁会要求本次 change 存在该文件且覆盖所有 submodule path（否则 `aiws validate .` / `aiws change validate --strict` 阻断）。
 - 约定：为本次 change 落盘一个“交付目标分支映射”文件，并在后续 `$ws-dev`/`$ws-deliver`/`$ws-finish` 优先使用它：
-  - 文件：`changes/<change-id>/submodules.targets`
+  - 文件：`.aiws/changes/<change-id>/submodules.targets`
   - 格式：每行一个 submodule（忽略空行与 `#` 注释），字段用空白分隔（推荐 `TAB`）：
     - 第 1 列：submodule path（例如 `vendor/foo`）
     - 第 2 列：target branch（例如 `release/channel-a`）

package/templates/workspace/.agents/skills/ws-preflight/SKILL.md CHANGED Viewed

@@ -31,9 +31,10 @@ description: 预检（提交前快速检查与建议）
 - 使用者已经知道当前仓库能否继续进入后续阶段，以及必须遵守的约束与下一步入口。
 执行步骤（强制）：
-1) 定位项目根目录：
-   - 优先：`git rev-parse --show-toplevel`
-   - 若失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
+1) 定位项目根目录（submodule 感知）：
+   - 优先：`git rev-parse --show-superproject-working-tree`（若当前在 submodule 内则返回 superproject 根）
+   - 若为空（不在 submodule 内）：`git rev-parse --show-toplevel`
+   - 若两者都失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
 2) 在项目根目录读取以下文件（存在则必须读取；缺失则明确报告缺失项，不要臆测内容）：
    - `AI_PROJECT.md`
    - `REQUIREMENTS.md`

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

@@ -7,7 +7,7 @@ description: 质量审查（行为回归 / 测试覆盖 / 实现质量）
 目标：
 - 审查当前改动的行为正确性、边界条件、测试覆盖和实现质量
-- 把“代码/行为层 findings”优先落盘到 `changes/<change-id>/review/quality-review.md`
+- 把“代码/行为层 findings”优先落盘到 `.aiws/changes/<change-id>/review/quality-review.md`
 阶段定位：
 - review 子 gate；负责实现质量、行为回归与验证覆盖审查。
@@ -16,10 +16,10 @@ description: 质量审查（行为回归 / 测试覆盖 / 实现质量）
 - 当前 `git diff`
 - 已执行的验证结果
 - 相关代码 / 配置 / 测试文件
-- 若存在：`changes/<change-id>/analysis/`、`patches/`、已有 review 文件
+- 若存在：`.aiws/changes/<change-id>/analysis/`、`patches/`、已有 review 文件
 必需输出：
-- `证据（Evidence）:` `changes/<change-id>/review/quality-review.md` 或回退 `.agentdocs/tmp/review/quality-review.md`
+- `证据（Evidence）:` `.aiws/changes/<change-id>/review/quality-review.md` 或回退 `.aiws/tmp/review/quality-review.md`
 - `主要发现（Findings）:` 高到低排序的问题 / 风险 / 缺失测试
 - `下一步（Next）:` 最小修复项与回归命令
@@ -39,8 +39,8 @@ description: 质量审查（行为回归 / 测试覆盖 / 实现质量）
    - 测试是否足以支撑改动
    - 是否存在明显复杂度、耦合、可维护性或性能问题
 3) 将结论落盘到：
-   - 默认：`changes/<change-id>/review/quality-review.md`
-   - 回退：`.agentdocs/tmp/review/quality-review.md`
+   - 默认：`.aiws/changes/<change-id>/review/quality-review.md`
+   - 回退：`.aiws/tmp/review/quality-review.md`
 4) 输出：
    - `证据（Evidence）:`
    - `主要发现（Findings）:`

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

@@ -8,7 +8,7 @@ description: 需求评审（对齐真值与验收）
 目标：在不修改任何文件的前提下，对 `REQUIREMENTS.md` 做一次整体 QA，输出缺口/冲突/风险，减少实现漂移。
 执行步骤（强制）：
-1) 定位项目根目录：`git rev-parse --show-toplevel`（失败则停止并让用户确认根目录）。
+1) 定位项目根目录：先尝试 `git rev-parse --show-superproject-working-tree`（submodule 感知上溯到 superproject 根）；若为空再用 `git rev-parse --show-toplevel`。都失败则停止并让用户确认根目录。
 2) 读取（存在则必须读取；缺失则明确列出，不要臆测）：
    - `AI_PROJECT.md`
    - `REQUIREMENTS.md`

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

@@ -5,7 +5,7 @@ description: 评审（提交前审计与证据落盘）
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
-目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据优先落盘到 `changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.agentdocs/tmp/review/`）。
+目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据优先落盘到 `.aiws/changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.aiws/tmp/review/`）。
 若当前语境已经明确是“准备交付/finish”，则本入口不应只停留在通用 review：应继续同时补齐 `$ws-spec-review` 与 `$ws-quality-review`，把 dual review gate 一次性收敛完。
 阶段定位：
@@ -16,10 +16,10 @@ description: 评审（提交前审计与证据落盘）
 - 已执行的验证结果
 - 真值文件：`AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
 - 当前 `change/<change-id>` 上下文（若能识别）
-- 若存在：`changes/<change-id>/analysis/`、`patches/`、已有 `review/` 文件
+- 若存在：`.aiws/changes/<change-id>/analysis/`、`patches/`、已有 `review/` 文件
 必需输出：
-- 审计文件：`changes/<change-id>/review/codex-review.md` 或回退 `.agentdocs/tmp/review/codex-review.md`
+- 审计文件：`.aiws/changes/<change-id>/review/codex-review.md` 或回退 `.aiws/tmp/review/codex-review.md`
 - `主要风险（Top risks）:` 3-8 条
 - `下一步（Next）:` 最小修复清单 + 最小验证命令
@@ -31,19 +31,19 @@ description: 评审（提交前审计与证据落盘）
 - 审计证据已落盘，主要风险和下一步已明确，可作为 commit/deliver 前置输入。
 步骤（建议）：
-1) 先做 preflight：定位项目根目录，读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
+1) 先做 preflight：定位项目根目录（submodule 感知：若在 submodule 内自动上溯到 superproject 根），读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
 2) 基于 `git status` / `git diff`（以及你实际运行过的测试结果），对照 `AI_PROJECT.md` 与 `REQUIREMENTS.md` 检查：
    - 是否存在越界目录改动/危险操作
    - 是否有可复现验证命令与证据
-   - 是否维护了 `changes/<change-id>/` 或相关 `issues/*.csv`
+   - 是否维护了 `.aiws/changes/<change-id>/` 或相关 `issues/*.csv`
    - 若存在 `analysis/` / `patches/`：审查这些委托工件是否已被主 agent 理解、是否需要采用/拒绝，并把结论写入 review 文件
 3) 将审计落盘到（目录不存在则创建）：
-   - 默认：`changes/<change-id>/review/codex-review.md`
-   - 回退：`.agentdocs/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
+   - 默认：`.aiws/changes/<change-id>/review/codex-review.md`
+   - 回退：`.aiws/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
    - 若已有其它 reviewer 文件：不要覆盖它们；当前 reviewer 应写自己的文件或更新自己的汇总文件
 4) 若当前任务已进入“准备提交/交付/finish”的语境，继续补齐 dual review gate：
-   - 运行/收敛 `$ws-spec-review`，落盘 `changes/<change-id>/review/spec-review.md`（或回退 `.agentdocs/tmp/review/spec-review.md`）
-   - 运行/收敛 `$ws-quality-review`，落盘 `changes/<change-id>/review/quality-review.md`（或回退 `.agentdocs/tmp/review/quality-review.md`）
+   - 运行/收敛 `$ws-spec-review`，落盘 `.aiws/changes/<change-id>/review/spec-review.md`（或回退 `.aiws/tmp/review/spec-review.md`）
+   - 运行/收敛 `$ws-quality-review`，落盘 `.aiws/changes/<change-id>/review/quality-review.md`（或回退 `.aiws/tmp/review/quality-review.md`）
    - 不要把单个 `codex-review.md` 误当成 finish gate 已完成
 5) 回复中输出：
    - `证据（Evidence）:` 证据文件路径

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

@@ -7,7 +7,7 @@ description: 规范审查（requirements / plan / evidence / gate 完整性）
 目标：
 - 审查当前改动是否满足真值文件、change 绑定、证据路径和 gate 完整性要求
-- 把“流程/规范层 blocker”与“代码层问题”区分开，优先落盘到 `changes/<change-id>/review/spec-review.md`
+- 把“流程/规范层 blocker”与“代码层问题”区分开，优先落盘到 `.aiws/changes/<change-id>/review/spec-review.md`
 阶段定位：
 - review 子 gate；负责 requirements / plan / evidence / workflow gate 完整性审查。
@@ -17,10 +17,10 @@ description: 规范审查（requirements / plan / evidence / gate 完整性）
 - `REQUIREMENTS.md`
 - `AI_WORKSPACE.md`
 - 当前 `git diff`
-- 若存在：`plan/...`、`changes/<change-id>/proposal.md`、`tasks.md`、`review/`、`evidence/`
+- 若存在：`plan/...`、`.aiws/changes/<change-id>/proposal.md`、`tasks.md`、`review/`、`evidence/`
 必需输出：
-- `证据（Evidence）:` `changes/<change-id>/review/spec-review.md` 或回退 `.agentdocs/tmp/review/spec-review.md`
+- `证据（Evidence）:` `.aiws/changes/<change-id>/review/spec-review.md` 或回退 `.aiws/tmp/review/spec-review.md`
 - `阻断项（Blockers）:` requirements 归因 / gate / evidence 缺口
 - `下一步（Next）:` 修复项与最小验证命令
@@ -40,8 +40,8 @@ description: 规范审查（requirements / plan / evidence / gate 完整性）
    - 是否存在越界目录改动、危险操作、未声明的非目标扩张
    - 是否已经准备好可复现验证入口
 3) 把结论落盘到：
-   - 默认：`changes/<change-id>/review/spec-review.md`
-   - 回退：`.agentdocs/tmp/review/spec-review.md`
+   - 默认：`.aiws/changes/<change-id>/review/spec-review.md`
+   - 回退：`.aiws/tmp/review/spec-review.md`
 4) 输出：
    - `证据（Evidence）:`
    - `阻断项（Blockers）:`

package/templates/workspace/.opencode/command/ws-preflight.md CHANGED Viewed

@@ -9,9 +9,10 @@ description: 预检：读取真值文件并输出约束摘要
 目标：在开始任何“写代码/改配置/落盘文件”之前，对齐工作区真值文件，避免规则漂移。
 执行步骤（强制）：
-1) 定位项目根目录：
-   - 优先：`git rev-parse --show-toplevel`
-   - 若失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
+1) 定位项目根目录（submodule 感知）：
+   - 优先：`git rev-parse --show-superproject-working-tree`（submodule 内上溯到 superproject 根）
+   - 若为空：`git rev-parse --show-toplevel`
+   - 若两者都失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
 2) 在项目根目录读取以下文件（存在则必须读取；缺失则明确报告缺失项，不要臆测内容）：
    - `AI_PROJECT.md`
    - `REQUIREMENTS.md`

package/templates/workspace/.opencode/command/ws-req-review.md CHANGED Viewed

@@ -9,7 +9,7 @@ description: 需求评审：对 REQUIREMENTS 做整体 QA（不改文件）
 目标：在不修改任何文件的前提下，对 `REQUIREMENTS.md` 做一次整体 QA，输出缺口/冲突/风险，减少实现漂移。
 执行步骤（强制）：
-1) 定位项目根目录：`git rev-parse --show-toplevel`（失败则停止并让用户确认根目录）。
+1) 定位项目根目录：先尝试 `git rev-parse --show-superproject-working-tree`（submodule 感知上溯）；若为空再用 `git rev-parse --show-toplevel`。都失败则停止并让用户确认根目录。
 2) 读取（存在则必须读取；缺失则明确列出，不要臆测）：
    - `AI_PROJECT.md`
    - `REQUIREMENTS.md`

package/templates/workspace/.opencode/commands/ws-preflight.md CHANGED Viewed

@@ -9,9 +9,10 @@ description: 预检：读取真值文件并输出约束摘要
 目标：在开始任何“写代码/改配置/落盘文件”之前，对齐工作区真值文件，避免规则漂移。
 执行步骤（强制）：
-1) 定位项目根目录：
-   - 优先：`git rev-parse --show-toplevel`
-   - 若失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
+1) 定位项目根目录（submodule 感知）：
+   - 优先：`git rev-parse --show-superproject-working-tree`（submodule 内上溯到 superproject 根）
+   - 若为空：`git rev-parse --show-toplevel`
+   - 若两者都失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
 2) 在项目根目录读取以下文件（存在则必须读取；缺失则明确报告缺失项，不要臆测内容）：
    - `AI_PROJECT.md`
    - `REQUIREMENTS.md`

package/templates/workspace/.opencode/commands/ws-req-review.md CHANGED Viewed

@@ -9,7 +9,7 @@ description: 需求评审：对 REQUIREMENTS 做整体 QA（不改文件）
 目标：在不修改任何文件的前提下，对 `REQUIREMENTS.md` 做一次整体 QA，输出缺口/冲突/风险，减少实现漂移。
 执行步骤（强制）：
-1) 定位项目根目录：`git rev-parse --show-toplevel`（失败则停止并让用户确认根目录）。
+1) 定位项目根目录：先尝试 `git rev-parse --show-superproject-working-tree`（submodule 感知上溯）；若为空再用 `git rev-parse --show-toplevel`。都失败则停止并让用户确认根目录。
 2) 读取（存在则必须读取；缺失则明确列出，不要臆测）：
    - `AI_PROJECT.md`
    - `REQUIREMENTS.md`

package/templates/workspace/.opencode/skills/p-aiws-change-archive/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: 私有：归档变更工件（会先做严格校验并生成 handof
 ---
 目标：
-- 将 `changes/<change-id>/` 归档到 `changes/archive/<YYYY-MM-DD>/...`
+- 将 `.aiws/changes/<change-id>/` 归档到 `changes/archive/<YYYY-MM-DD>/...`
 执行（在仓库根目录）：
 ```bash

package/templates/workspace/.opencode/skills/p-aiws-change-finish/SKILL.md CHANGED Viewed

@@ -20,5 +20,5 @@ fi
 说明：
 - 默认等价于：`git merge --ff-only change/<change-id>`
-- 若你当前就在 `change/<change-id>` 分支上，`finish` 会尝试读取 `changes/<change-id>/.ws-change.json` 的 `base_branch` 作为目标分支
+- 若你当前就在 `change/<change-id>` 分支上，`finish` 会尝试读取 `.aiws/changes/<change-id>/.ws-change.json` 的 `base_branch` 作为目标分支
 - 若无法 fast-forward：先在 change 分支（或对应 worktree）里 `git rebase <target-branch>`，再重试 `aiws change finish`

package/templates/workspace/.opencode/skills/p-aiws-change-new/SKILL.md CHANGED Viewed

@@ -1,10 +1,10 @@
 ---
 name: p-aiws-change-new
-description: 私有：创建 changes/<change-id> 工件
+description: 私有：创建 .aiws/changes/<change-id> 工件
 ---
 目标：
-- 创建 `changes/<change-id>/` 工件目录与基础文件（proposal/tasks/可选 design）
+- 创建 `.aiws/changes/<change-id>/` 工件目录与基础文件（proposal/tasks/可选 design）
 要求：
 - `change-id` 必须是 kebab-case：`^[a-z0-9]+(-[a-z0-9]+)*$`

package/templates/workspace/.opencode/skills/p-aiws-change-start/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: 私有：切分支并初始化变更工件（可选安装 hooks）
 ---
 目标：
-- 切到分支 `change/<change-id>` 并初始化 `changes/<change-id>/` 工件
+- 切到分支 `change/<change-id>` 并初始化 `.aiws/changes/<change-id>/` 工件
   - 若检测到 `.gitmodules`（git submodules），默认优先使用 `--worktree`（失败则回退为 `--no-switch`），避免切走 superproject 分支导致 submodule 状态混乱
 要求：

package/templates/workspace/.opencode/skills/p-aiws-change-sync/SKILL.md CHANGED Viewed

@@ -1,10 +1,10 @@
 ---
 name: p-aiws-change-sync
-description: 私有：同步真值基线到 changes/<change-id>（写入 .ws-change.json）
+description: 私有：同步真值基线到 .aiws/changes/<change-id>（写入 .ws-change.json）
 ---
 目标：
-- 将当前真值文件（`AI_PROJECT.md` / `AI_WORKSPACE.md` / `REQUIREMENTS.md`）的 hash 快照同步到 `changes/<change-id>/.ws-change.json`
+- 将当前真值文件（`AI_PROJECT.md` / `AI_WORKSPACE.md` / `REQUIREMENTS.md`）的 hash 快照同步到 `.aiws/changes/<change-id>/.ws-change.json`
 执行（在仓库根目录）：
 ```bash

package/templates/workspace/.opencode/skills/p-aiws-change-validate/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: 私有：校验 changes 工件（可 strict）
 ---
 目标：
-- 校验 `changes/<change-id>/` 工件完整性、归因与 WS:TODO（用于 hooks/CI）
+- 校验 `.aiws/changes/<change-id>/` 工件完整性、归因与 WS:TODO（用于 hooks/CI）
 执行（在仓库根目录）：
 ```bash

package/templates/workspace/.opencode/skills/p-aiws-validate/SKILL.md CHANGED Viewed

@@ -19,4 +19,4 @@ fi
 ```
 证据（可选）：
-- stamp：`.agentdocs/tmp/aiws-validate/*.json`（由 `.gitignore` 忽略）
+- stamp：`.aiws/tmp/aiws-validate/*.json`（由 `.gitignore` 忽略）

package/templates/workspace/.opencode/skills/p-tasks-plan/SKILL.md CHANGED Viewed

@@ -1,18 +1,18 @@
 ---
 name: p-tasks-plan
-description: 原子：tasks 同步（从 changes/<id>/tasks.md 生成 update_plan payload）
+description: 原子：tasks 同步（从 .aiws/changes/<id>/tasks.md 生成 update_plan payload）
 ---
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 目标：
-- 用 `changes/<change-id>/tasks.md` 的 checkbox 任务作为“步骤真值”
+- 用 `.aiws/changes/<change-id>/tasks.md` 的 checkbox 任务作为“步骤真值”
 - 生成可直接用于 `update_plan` 的 JSON payload（`pending/in_progress/completed`）
 - 输出当前进度摘要（done/total + 当前 in_progress）
 约束：
 - 不写入任何 secrets（token、账号、内网端点等不得进入 git）
-- 只读 `changes/<id>/tasks.md`（不自动改写 tasks 文件）
+- 只读 `.aiws/changes/<id>/tasks.md`（不自动改写 tasks 文件）
 - 未运行不声称已运行
 执行步骤（建议）：
@@ -20,18 +20,18 @@ description: 原子：tasks 同步（从 changes/<id>/tasks.md 生成 update_pla
 2) 推断 `change-id`：
    - 优先从当前分支名读取：`git rev-parse --abbrev-ref HEAD`（期望形如 `change/<change-id>`）
    - 若无法推断：让用户明确本次要同步的 `<change-id>`
-3) 检查 tasks 文件存在：`test -f changes/<change-id>/tasks.md`
+3) 检查 tasks 文件存在：`test -f .aiws/changes/<change-id>/tasks.md`
 4) 输出进度摘要：
 ```bash
-python3 tools/ws_tasks_plan.py status --file changes/<change-id>/tasks.md
+python3 tools/ws_tasks_plan.py status --file .aiws/changes/<change-id>/tasks.md
 ```
 5) 生成 `update_plan` payload（JSON 输出到 stdout）：
 ```bash
-python3 tools/ws_tasks_plan.py plan --file changes/<change-id>/tasks.md --explanation "sync tasks.md -> update_plan"
+python3 tools/ws_tasks_plan.py plan --file .aiws/changes/<change-id>/tasks.md --explanation "sync tasks.md -> update_plan"
 ```
 6) 调用 `update_plan`，将上一步 JSON 原样作为入参（确保任意时刻最多 1 条 `in_progress`）。
 输出要求：
 - `Change_ID:` <change-id>
-- `Tasks:` `changes/<change-id>/tasks.md`
+- `Tasks:` `.aiws/changes/<change-id>/tasks.md`
 - `Next:` 推荐下一步（通常为继续完善 tasks 或进入 `$ws-dev`）

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

@@ -19,7 +19,7 @@ description: 使用时机：新会话开始、不确定下一步做什么时。
 - 当前任务描述
 - `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
-- 若已存在：`change/<change-id>` 上下文、`plan/...`、`changes/<change-id>/...`
+- 若已存在：`change/<change-id>` 上下文、`plan/...`、`.aiws/changes/<change-id>/...`
 ## 必需输出
@@ -44,7 +44,7 @@ description: 使用时机：新会话开始、不确定下一步做什么时。
 ### 1.5 Per-turn Breadcrumb（必做）
-每轮对话开始时强制读取当前 change 状态（`changes/<change-id>/.ws-change.json` 或 phase 状态文件），输出 `[workflow-state:PHASE/N]` breadcrumb 标记。
+每轮对话开始时强制读取当前 change 状态（`.aiws/changes/<change-id>/.ws-change.json` 或 phase 状态文件），输出 `[workflow-state:PHASE/N]` breadcrumb 标记。
 目的：即使 context 被压缩，breadcrumb 也能让 AI 知道当前处于哪个阶段、上次做到哪一步。
@@ -121,7 +121,7 @@ Subagent 不可用时的降级路径：
 - 上次 delegation 返回 `NEEDS_CONTEXT` → 补 context JSONL 后重新派发
 - Subagent-first 默认：`ready-for-dev` / `in-progress` 默认派发 worker/reviewer
 - Subagent 不可用时：降级为当前 agent 直接执行，但必须在 evidence 中记录降级原因
-- Subagent 不可用时回退：单 agent 模式 + 显式维护 `changes/<id>/` 工件（handoff-evidence.md, analysis/, patches/）；不阻断流程，但须标注 `mode: single-agent`
+- Subagent 不可用时回退：单 agent 模式 + 显式维护 `.aiws/changes/<id>/` 工件（handoff-evidence.md, analysis/, patches/）；不阻断流程，但须标注 `mode: single-agent`
 ### 5. 输出路由

package/templates/workspace/.opencode/skills/ws-analyze/SKILL.md CHANGED Viewed

@@ -5,7 +5,7 @@ description: 使用时机：需要分析问题、定位根因、收集上下文
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
-目标：在开始实现/修复前做一次技术分析，产出可执行的最小行动清单，并把证据落盘到 `.agentdocs/tmp/analyze/`。
+目标：在开始实现/修复前做一次技术分析，产出可执行的最小行动清单，并把证据落盘到 `.aiws/tmp/analyze/`。
 输入：
 - 主题/需求：用户在本次消息中提供的主题（若不明确，先问一句“本次分析主题是什么？”）
@@ -18,7 +18,7 @@ description: 使用时机：需要分析问题、定位根因、收集上下文
    - 推荐方案（1 个）+ 备选（可选）
    - 风险与回滚（3–8 条）
    - 最小验证命令（可复现）
-3) 将分析落盘到：`.agentdocs/tmp/analyze/codex-analysis.md`（目录不存在则创建）。
+3) 将分析落盘到：`.aiws/tmp/analyze/codex-analysis.md`（目录不存在则创建）。
 4) 回复中必须包含：`Evidence:` 证据文件路径。
 安全：

package/templates/workspace/.opencode/skills/ws-autonomy/SKILL.md CHANGED Viewed

@@ -59,4 +59,4 @@ description: 使用时机：需要自主协作、无人值守执行时。触发
 安全：
 - `ws-autonomy` 不是 runtime controller。
-- 任何 tmux helper 的结果都必须回收到 `.agentdocs/tmp/opencode-autonomy/`，最终再由主 agent 收敛到 `changes/<id>/...`。
+- 任何 tmux helper 的结果都必须回收到 `.aiws/tmp/opencode-autonomy/`，最终再由主 agent 收敛到 `.aiws/changes/<id>/...`。

package/templates/workspace/.opencode/skills/ws-bugfix/SKILL.md CHANGED Viewed

@@ -7,7 +7,7 @@ description: 使用时机：从禅道/外部系统拉取 bug 进行修复时。
 目标：
 - 用禅道 MCP 拉取 bug 详情与附件（尤其图片）
-- 把证据落盘到 `changes/<change-id>/bug/`（避免只停留在对话）
+- 把证据落盘到 `.aiws/changes/<change-id>/bug/`（避免只停留在对话）
 - 把修复任务汇总/更新到 `issues/fix_bus_issues.csv`
 - 与 `ws-dev` / `aiws change` 流程绑定，确保可追溯、可验证
@@ -21,7 +21,7 @@ description: 使用时机：从禅道/外部系统拉取 bug 进行修复时。
 2) 准备 `change-id`（建议：`bug-<bug-id>` 或 `bugfix-<bug-id>-<slug>`）。
 3) 建立 change 上下文（推荐先于任何落盘）：
    - 若当前还不在 `change/<change-id>` 分支 / worktree，先调用 `aiws change start`
-   - 工作区必须先干净；否则不要先写 `changes/<change-id>/bug/` 或 `issues/fix_bus_issues.csv`，避免后续切 worktree 时工件留在原工作区
+   - 工作区必须先干净；否则不要先写 `.aiws/changes/<change-id>/bug/` 或 `issues/fix_bus_issues.csv`，避免后续切 worktree 时工件留在原工作区
    - 仓库已有提交：优先 `--worktree`
    - superproject + submodule：优先 `--worktree --submodules`
    - 仓库尚无提交 / 不满足 worktree 前置条件：回退 `--no-switch`
@@ -46,7 +46,7 @@ fi
      - 优先复用 `$ws-dev` 的 `submodules.targets` 生成/确认流程
      - detached HEAD 时默认建议取 `.gitmodules` 声明的分支
      - 已附着在某个本地分支时默认建议取当前分支
-     - 以上都只是建议值，最终必须显式写入 `changes/<change-id>/submodules.targets`
+     - 以上都只是建议值，最终必须显式写入 `.aiws/changes/<change-id>/submodules.targets`
 建议流程（按顺序）：
@@ -58,14 +58,14 @@ fi
 - 若当前环境没有 zentao MCP 工具：立即停止并提示用户先配置，不要猜数据。
 ## 2) 证据落盘（强制）
-在当前 active change 上下文的 `changes/<change-id>/bug/` 下落盘：
+在当前 active change 上下文的 `.aiws/changes/<change-id>/bug/` 下落盘：
 - `zentao-bug-<bug-id>.json`：原始字段快照（避免信息丢失）
 - `zentao-bug-<bug-id>.md`：人类可读摘要（复现步骤/期望/实际/风险）
 - `images/<bug-id>/...`：下载的图片附件（保留原扩展名）
 建议目录：
 ```text
-changes/<change-id>/bug/
+.aiws/changes/<change-id>/bug/
   zentao-bug-<bug-id>.json
   zentao-bug-<bug-id>.md
   images/<bug-id>/
@@ -83,7 +83,7 @@ Bug_ID,Title,Severity,Module,Status,Assigned_To,Change_ID,Image_Count,Image_Path
 字段约束：
 - `Change_ID`：必须等于当前 `change-id`
-- `Evidence_Path`：指向 `changes/<change-id>/bug/zentao-bug-<bug-id>.md`
+- `Evidence_Path`：指向 `.aiws/changes/<change-id>/bug/zentao-bug-<bug-id>.md`
 - `Image_Paths`：多个路径用 `;` 分隔
 - `Fix_Status`：`TODO|DOING|DONE|BLOCKED`
@@ -107,5 +107,5 @@ aiws validate . --stamp
 - `Change_ID:` `<change-id>`
 - `Change context:` `<当前分支或 worktree 路径>`
 - `CSV:` `issues/fix_bus_issues.csv` 中对应 `Bug_ID` 行的关键字段
-- `Evidence:` `changes/<change-id>/bug/zentao-bug-<bug-id>.md` + 图片目录
+- `Evidence:` `.aiws/changes/<change-id>/bug/zentao-bug-<bug-id>.md` + 图片目录
 - `Verify:` 实际运行命令与结果（未运行不声称已运行）

package/templates/workspace/.opencode/skills/ws-delegate/SKILL.md CHANGED Viewed

@@ -10,7 +10,7 @@ description: 使用时机：需要拆分子任务、委托给子 agent 时。触
 ## 核心约束
 - **Subagent-First**：主 session 只做编排与收敛，不直接写实现代码。所有产出必须由 subagent 完成并可追溯到具体 worker。
-- **Handoff 证据**：每轮委托完成后，worker 必须产出结构化 handoff 到 `changes/<id>/handoff-evidence.md`（完成项、未完成项、残余风险），供主 session 收敛判断。handoff 文件缺失等同于委托未完成。
+- **Handoff 证据**：每轮委托完成后，worker 必须产出结构化 handoff 到 `.aiws/changes/<id>/handoff-evidence.md`（完成项、未完成项、残余风险），供主 session 收敛判断。handoff 文件缺失等同于委托未完成。
 ## 必需输入
@@ -40,7 +40,7 @@ description: 使用时机：需要拆分子任务、委托给子 agent 时。触
 - 没有写清委托边界
 - 上下文策展未执行（未生成 JSONL 或未在 prompt 中引用）
 - 无法判断当前是否可用 oMo，又不能接受回退
-- handoff 文件 `changes/<id>/handoff-evidence.md` 缺失或为空（委托返回后必须检查）
+- handoff 文件 `.aiws/changes/<id>/handoff-evidence.md` 缺失或为空（委托返回后必须检查）
 ## 角色映射
@@ -82,7 +82,7 @@ description: 使用时机：需要拆分子任务、委托给子 agent 时。触
 2. 展开 glob 为实际路径（替换 `<id>`）
 3. 委托者调整：添加/删除/调整 priority/sections
 4. 预算检查：high+medium ≤ 5 文件，总行数 ≤ 4000
-5. 写入 `changes/<id>/analysis/<role>-context.jsonl`
+5. 写入 `.aiws/changes/<id>/analysis/<role>-context.jsonl`
 OpenCode 插件 `aiws-inject-context` 会自动注入 JSONL 上下文——只需在 `task()` 中指定 `role: <role>`。
@@ -113,16 +113,16 @@ OpenCode 插件 `aiws-inject-context` 会自动注入 JSONL 上下文——只
 - task: <描述>
 - readScope: <文件/目录>
 - writeScope: <文件/目录>
-- artifactTargets: changes/<id>/patches/, changes/<id>/evidence/
+- artifactTargets: .aiws/changes/<id>/patches/, .aiws/changes/<id>/evidence/
 - fallback: single-agent
-Context Curation: changes/<id>/analysis/worker-context.jsonl
+Context Curation: .aiws/changes/<id>/analysis/worker-context.jsonl
 ```
 ## 委托者检查清单
 派遣前：
 - [ ] 子 agent prompt 包含上下文引用
-- [ ] JSONL 已写入 `changes/<id>/analysis/<role>-context.jsonl`
+- [ ] JSONL 已写入 `.aiws/changes/<id>/analysis/<role>-context.jsonl`
 - [ ] 预算检查通过
 - [ ] readScope / writeScope / artifactTargets 已声明
@@ -130,7 +130,7 @@ Context Curation: changes/<id>/analysis/worker-context.jsonl
 - [ ] 解析 Status 行
 - [ ] 非 DONE → 按状态处理规则行动
 - [ ] 非 DONE → 记录决策到 `delegation-decisions.md`
-- [ ] handoff 文件 `changes/<id>/handoff-evidence.md` 已存在且非空
+- [ ] handoff 文件 `.aiws/changes/<id>/handoff-evidence.md` 已存在且非空
 安全：
 - 不让 `ws-delegate` 变成第二套 orchestrator

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

@@ -20,17 +20,17 @@ description: 使用时机：需要修改代码、配置、测试时。触发词
 - `变更文件（Changed）:` 实际改动清单
 - `验证（Verify）:` 实际运行的命令与结果说明
-- `证据（Evidence）:` `plan/...`、`changes/<change-id>/...`、`.agentdocs/tmp/...` 等证据路径
+- `证据（Evidence）:` `plan/...`、`.aiws/changes/<change-id>/...`、`.aiws/tmp/...` 等证据路径
 - `Next:` 若准备提交，建议 `$ws-review` 或 `$ws-commit`
 ## 前置条件（硬阻断 — 必须最先检查）
 在开始任何代码改动之前，必须完成以下检查：
-1. **Design Gate**：若 `changes/<change-id>/proposal.md` 不存在：
+1. **Design Gate**：若 `.aiws/changes/<change-id>/proposal.md` 不存在：
    - 立即停止，不要写代码
    - 输出：`BLOCKED: 缺少 proposal。请先执行 $ws-plan 创建变更计划与任务分解。`
-2. **Task Gate**：若 `changes/<change-id>/tasks.md` 不存在：
+2. **Task Gate**：若 `.aiws/changes/<change-id>/tasks.md` 不存在：
    - 立即停止，不要写代码
    - 输出：`BLOCKED: 缺少 tasks。请先执行 $ws-plan 创建任务分解。`
@@ -78,7 +78,7 @@ description: 使用时机：需要修改代码、配置、测试时。触发词
 - 若 `git status --porcelain` 仅有计划/工件文件，属于预期行为，继续即可。
 - 若需创建新 change：`aiws change start <change-id> --hooks --no-switch`
 - 若需切换分支：先确认无额外未提交改动，再 `git switch change/<change-id>`
-- 若存在 submodule（`.gitmodules`）：进入编码前必须准备好 `changes/<change-id>/submodules.targets`。`aiws change start` 的 `--submodules` 标志会自动处理。参考 `changes/README.md` 和 `changes/<change-id>/submodules.targets` 格式。
+- 若存在 submodule（`.gitmodules`）：进入编码前必须准备好 `.aiws/changes/<change-id>/submodules.targets`。`aiws change start` 的 `--submodules` 标志会自动处理。参考 `changes/README.md` 和 `.aiws/changes/<change-id>/submodules.targets` 格式。
 ### 3. 实现策略：默认 dispatch aiws-worker（Subagent-First）

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

@@ -54,8 +54,8 @@ description: 使用时机：单文件/小范围快速修复时。触发词：轻
    - 若只需局部回归，允许运行更窄的验证，但要说明为什么足够
 6) 留下至少一个可追溯证据：
    - 实际改动文件
-   - 或 `.agentdocs/tmp/...`
-   - 或 `changes/<change-id>/...`
+   - 或 `.aiws/tmp/...`
+   - 或 `.aiws/changes/<change-id>/...`
 7) 输出：
    - `变更文件（Changed）:`
    - `验证（Verify）:`

package/templates/workspace/.opencode/skills/ws-frontend-design/SKILL.md CHANGED Viewed

@@ -123,4 +123,4 @@ app-ui 规则：
 - `Visual thesis:` 一句话
 - `Changed:` 改动文件清单
 - `Verify:` 实际运行命令 + 预期结果
-- `Evidence:` 相关 `plan/...`、`changes/<change-id>/...` 或截图/审计路径
+- `Evidence:` 相关 `plan/...`、`.aiws/changes/<change-id>/...` 或截图/审计路径

package/templates/workspace/.opencode/skills/ws-plan/SKILL.md CHANGED Viewed

@@ -21,7 +21,7 @@ OpenCode + oMo 优先策略：
 - 不写入任何 secrets（token、账号、内网端点等不得进入 git）
 - 本 skill 只负责“想清楚怎么做 + 落盘计划”，不要直接大规模改动代码
 - 未运行不声称已运行；验证命令要写清“预期结果”
-- 若存在 `changes/<change-id>/proposal.md`，计划与 proposal 的绑定字段必须保持一致（不一致时先修正再继续）
+- 若存在 `.aiws/changes/<change-id>/proposal.md`，计划与 proposal 的绑定字段必须保持一致（不一致时先修正再继续）
 阶段定位：
 - planning 阶段；负责把用户目标收敛为 change 绑定、计划文件和验证入口。
@@ -29,7 +29,7 @@ OpenCode + oMo 优先策略：
 必需输入：
 - 当前任务描述
 - 真值文件：`AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
-- 若已存在：`changes/<change-id>/proposal.md`
+- 若已存在：`.aiws/changes/<change-id>/proposal.md`
 - 若已有计划：当前 `plan/...` 文件
 必需输出：
@@ -53,7 +53,7 @@ OpenCode + oMo 优先策略：
 2) 若用户任务描述不清：先问 1-3 个关键澄清问题（不要猜）。
 3) 判断复杂度：`simple / medium / complex`（给出一句理由），并估算步骤数。
  4) 识别或建立主索引 / change 上下文：
-   - 若存在 `changes/<change-id>/proposal.md`：读取其中 `Change_ID` / `Req_ID` / `Problem_ID` / `Contract_Row` / `Evidence_Path`
+   - 若存在 `.aiws/changes/<change-id>/proposal.md`：读取其中 `Change_ID` / `Req_ID` / `Problem_ID` / `Contract_Row` / `Evidence_Path`
    - 若缺失关键绑定：先补齐 proposal（至少 `Change_ID`、`Req_ID|Problem_ID`、`Contract_Row`）再继续生成计划
    - 若当前不在 `change/<change-id>` 分支 / worktree，且本次任务需要新建 change：
      ```bash
@@ -76,7 +76,7 @@ OpenCode + oMo 优先策略：
    - `Verify`：可复现命令 + 期望结果（优先引用 `AI_WORKSPACE.md` 的入口；必要时补充 e2e）
     - `Risks & Rollback`：风险点 + 回滚方案（例如 git 回滚、`aiws rollback`、恢复备份等）
     - 若 intake 草案包含 `Error States` 或 `Rollback Plan`：必须显式引用并纳入本计划的 `Risks & Rollback` 中，不能丢弃 intake 已识别的问题
-   - `Evidence`：计划文件路径；若创建了变更工件则附 `changes/<change-id>/...`
+   - `Evidence`：计划文件路径；若创建了变更工件则附 `.aiws/changes/<change-id>/...`
 7) 若存在 change proposal：回填并对齐 `proposal.md` 的 `Plan_File`（必要时同步 `Contract_Row` / `Evidence_Path`），保证 plan/proposal 一致。
 8) 运行 `$ws-plan-verify` 作为执行前质量门（计划不过长、不跑偏、验证可复现）。
    - 通过后：标记 `[workflow-state:plan:DONE]` 或 `[workflow-state:gate:plan_passed]`，表示 plan 阶段已收敛。
@@ -91,7 +91,7 @@ oMo 回退：
 - 背景：`.gitmodules submodule.<name>.branch` 适合作为“团队默认分支真值”，但当同一 superproject 分支需要在不同交付中选择不同 submodule 目标分支（多渠道）时，仅靠 `.gitmodules` 不足。
 - 强约束：当 `.gitmodules` 声明了 submodule 条目时，门禁会要求本次 change 存在该文件且覆盖所有 submodule path（否则 `aiws validate .` / `aiws change validate --strict` 阻断）。
 - 约定：为本次 change 落盘一个“交付目标分支映射”文件，并在后续 `$ws-dev`/`$ws-deliver`/`$ws-finish` 优先使用它：
-  - 文件：`changes/<change-id>/submodules.targets`
+  - 文件：`.aiws/changes/<change-id>/submodules.targets`
   - 格式：每行一个 submodule（忽略空行与 `#` 注释），字段用空白分隔（推荐 `TAB`）：
     - 第 1 列：submodule path（例如 `vendor/foo`）
     - 第 2 列：target branch（例如 `release/channel-a`）

package/templates/workspace/.opencode/skills/ws-preflight/SKILL.md CHANGED Viewed

@@ -32,9 +32,10 @@ description: 使用时机：新会话开始、仓库首次操作时。触发词
 - 使用者已经知道当前仓库能否继续进入后续阶段，以及必须遵守的约束与下一步入口。
 执行步骤（强制）：
-1) 定位项目根目录：
-   - 优先：`git rev-parse --show-toplevel`
-   - 若失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
+1) 定位项目根目录（submodule 感知）：
+   - 优先：`git rev-parse --show-superproject-working-tree`（submodule 内上溯到 superproject 根）
+   - 若为空：`git rev-parse --show-toplevel`
+   - 若两者都失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
 2) 在项目根目录读取以下文件（存在则必须读取；缺失则明确报告缺失项，不要臆测内容）：
    - `AI_PROJECT.md`
    - `REQUIREMENTS.md`

package/templates/workspace/.opencode/skills/ws-quality-review/SKILL.md CHANGED Viewed

@@ -7,7 +7,7 @@ description: 使用时机：需要审查实现质量、测试覆盖时。触发
 目标：
 - 审查当前改动的行为正确性、边界条件、测试覆盖和实现质量
-- 把“代码/行为层 findings”优先落盘到 `changes/<change-id>/review/quality-review.md`
+- 把“代码/行为层 findings”优先落盘到 `.aiws/changes/<change-id>/review/quality-review.md`
 OpenCode + oMo 优先策略：
 - 若检测到 `.opencode/oh-my-opencode.json`，或当前会话明确可用 `oracle` / `explore`，优先借用这些 agent 做质量审查。
@@ -21,10 +21,10 @@ OpenCode + oMo 优先策略：
 - 当前 `git diff`
 - 已执行的验证结果
 - 相关代码 / 配置 / 测试文件
-- 若存在：`changes/<change-id>/analysis/`、`patches/`、已有 review 文件
+- 若存在：`.aiws/changes/<change-id>/analysis/`、`patches/`、已有 review 文件
 必需输出：
-- `证据（Evidence）:` `changes/<change-id>/review/quality-review.md` 或回退 `.agentdocs/tmp/review/quality-review.md`
+- `证据（Evidence）:` `.aiws/changes/<change-id>/review/quality-review.md` 或回退 `.aiws/tmp/review/quality-review.md`
 - `主要发现（Findings）:` 高到低排序的问题 / 风险 / 缺失测试
 - `下一步（Next）:` 最小修复项与回归命令
@@ -50,8 +50,8 @@ OpenCode + oMo 优先策略：
       - over_defensive：过度防御（不必要的安全检查、对不可能情况的处理）
       - cargo_cult：货舱崇拜（照搬模式但不理解原因，如不必要的 observer/strategy）
 3) 将结论落盘到：
-   - 默认：`changes/<change-id>/review/quality-review.md`
-   - 回退：`.agentdocs/tmp/review/quality-review.md`
+   - 默认：`.aiws/changes/<change-id>/review/quality-review.md`
+   - 回退：`.aiws/tmp/review/quality-review.md`
 4) 输出：
    - `证据（Evidence）:`
    - `主要发现（Findings）:`

package/templates/workspace/.opencode/skills/ws-req-review/SKILL.md CHANGED Viewed

@@ -8,7 +8,7 @@ description: 使用时机：需要评审需求、验收条件、合同时。触
 目标：在不修改任何文件的前提下，对 `REQUIREMENTS.md` 做一次整体 QA，输出缺口/冲突/风险，减少实现漂移。
 执行步骤（强制）：
-1) 定位项目根目录：`git rev-parse --show-toplevel`（失败则停止并让用户确认根目录）。
+1) 定位项目根目录：先尝试 `git rev-parse --show-superproject-working-tree`（submodule 感知上溯）；若为空再用 `git rev-parse --show-toplevel`。都失败则停止并让用户确认根目录。
 2) 读取（存在则必须读取；缺失则明确列出，不要臆测）：
    - `AI_PROJECT.md`
    - `REQUIREMENTS.md`

package/templates/workspace/.opencode/skills/ws-review/SKILL.md CHANGED Viewed

@@ -11,7 +11,7 @@ description: 使用时机：需要审计当前改动、查找风险时。触发
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
-目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据优先落盘到 `changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.agentdocs/tmp/review/`）。
+目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据优先落盘到 `.aiws/changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.aiws/tmp/review/`）。
 若当前语境已经明确是“准备交付/finish”，则本入口不应只停留在通用 review：应继续同时补齐 `$ws-spec-review` 与 `$ws-quality-review`，把 dual review gate 一次性收敛完。
 OpenCode + oMo 优先策略：
@@ -28,10 +28,10 @@ OpenCode + oMo 优先策略：
 - 已执行的验证结果
 - 真值文件：`AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
 - 当前 `change/<change-id>` 上下文（若能识别）
-- 若存在：`changes/<change-id>/analysis/`、`patches/`、已有 `review/` 文件
+- 若存在：`.aiws/changes/<change-id>/analysis/`、`patches/`、已有 `review/` 文件
 必需输出：
-- 审计文件：`changes/<change-id>/review/codex-review.md` 或回退 `.agentdocs/tmp/review/codex-review.md`
+- 审计文件：`.aiws/changes/<change-id>/review/codex-review.md` 或回退 `.aiws/tmp/review/codex-review.md`
 - `主要风险（Top risks）:` 3-8 条
 - `下一步（Next）:` 最小修复清单 + 最小验证命令
@@ -61,7 +61,7 @@ OpenCode + oMo 优先策略：
 3) 基于 `git status` / `git diff`（以及你实际运行过的测试结果），对照 `AI_PROJECT.md` 与 `REQUIREMENTS.md` 检查：
    - 是否存在越界目录改动/危险操作
    - 是否有可复现验证命令与证据
-   - 是否维护了 `changes/<change-id>/` 或相关 `issues/*.csv`
+   - 是否维护了 `.aiws/changes/<change-id>/` 或相关 `issues/*.csv`
    - 若存在 `analysis/` / `patches/`：审查这些委托工件是否已被主 agent 理解、是否需要采用/拒绝，并把结论写入 review 文件
 4) Workflow State Suffix 审计（检查 4 种后缀使用是否一致）：
    - `session` 后缀：只由 ws-dev-lite / ws-intake 写入，标记会话级进度（如 `[workflow-state:session:in_progress]`）
@@ -70,12 +70,12 @@ OpenCode + oMo 优先策略：
    - `gateway` 后缀：由 ws-finish / ws-deliver 写入，标记交付门禁结果（如 `[workflow-state:gateway:finish_gate_ok]`）
    - 检查当前 change 中使用的后缀类型是否正确对应所在阶段；若出现混用（如 session 与 gate 在同一文件），在审计报告中标记异常并说明应该修正的方向。
 5) 将审计落盘到（目录不存在则创建）：
-   - 默认：`changes/<change-id>/review/codex-review.md`
-   - 回退：`.agentdocs/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
+   - 默认：`.aiws/changes/<change-id>/review/codex-review.md`
+   - 回退：`.aiws/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
    - 若已有其它 reviewer 文件：不要覆盖它们；当前 reviewer 应写自己的文件或更新自己的汇总文件
 6) 若 triage 标记为 `dual_review_required`，继续补齐 dual review gate：
-   - 运行/收敛 `$ws-spec-review`，落盘 `changes/<change-id>/review/spec-review.md`（或回退 `.agentdocs/tmp/review/spec-review.md`）
-   - 运行/收敛 `$ws-quality-review`，落盘 `changes/<change-id>/review/quality-review.md`（或回退 `.agentdocs/tmp/review/quality-review.md`）
+   - 运行/收敛 `$ws-spec-review`，落盘 `.aiws/changes/<change-id>/review/spec-review.md`（或回退 `.aiws/tmp/review/spec-review.md`）
+   - 运行/收敛 `$ws-quality-review`，落盘 `.aiws/changes/<change-id>/review/quality-review.md`（或回退 `.aiws/tmp/review/quality-review.md`）
    - 不要把单个 `codex-review.md` 误当成 finish gate 已完成
 7) 回复中输出：
    - `证据（Evidence）:` 证据文件路径

package/templates/workspace/.opencode/skills/ws-spec-review/SKILL.md CHANGED Viewed

@@ -7,7 +7,7 @@ description: 使用时机：需要审查流程完整性、requirements 归因时
 目标：
 - 审查当前改动是否满足真值文件、change 绑定、证据路径和 gate 完整性要求
-- 把“流程/规范层 blocker”与“代码层问题”区分开，优先落盘到 `changes/<change-id>/review/spec-review.md`
+- 把“流程/规范层 blocker”与“代码层问题”区分开，优先落盘到 `.aiws/changes/<change-id>/review/spec-review.md`
 OpenCode + oMo 优先策略：
 - 若检测到 `.opencode/oh-my-opencode.json`，或当前会话明确可用 `oracle` / `librarian`，优先借用它们做 spec / gate 审查。
@@ -22,10 +22,10 @@ OpenCode + oMo 优先策略：
 - `REQUIREMENTS.md`
 - `AI_WORKSPACE.md`
 - 当前 `git diff`
-- 若存在：`plan/...`、`changes/<change-id>/proposal.md`、`tasks.md`、`review/`、`evidence/`
+- 若存在：`plan/...`、`.aiws/changes/<change-id>/proposal.md`、`tasks.md`、`review/`、`evidence/`
 必需输出：
-- `证据（Evidence）:` `changes/<change-id>/review/spec-review.md` 或回退 `.agentdocs/tmp/review/spec-review.md`
+- `证据（Evidence）:` `.aiws/changes/<change-id>/review/spec-review.md` 或回退 `.aiws/tmp/review/spec-review.md`
 - `阻断项（Blockers）:` requirements 归因 / gate / evidence 缺口
 - `下一步（Next）:` 修复项与最小验证命令
@@ -46,8 +46,8 @@ OpenCode + oMo 优先策略：
    - 是否存在越界目录改动、危险操作、未声明的非目标扩张
    - 是否已经准备好可复现验证入口
 3) 把结论落盘到：
-   - 默认：`changes/<change-id>/review/spec-review.md`
-   - 回退：`.agentdocs/tmp/review/spec-review.md`
+   - 默认：`.aiws/changes/<change-id>/review/spec-review.md`
+   - 回退：`.aiws/tmp/review/spec-review.md`
 4) 输出：
    - `证据（Evidence）:`
    - `阻断项（Blockers）:`

package/templates/workspace/.opencode/skills/ws-verify-before-complete/SKILL.md CHANGED Viewed

@@ -9,11 +9,11 @@ description: Thin wrapper for `aiws verify-bc`
 进入 `ws-finish` / `ws-handoff` 前必须确认：
-- [ ] `ws-spec-review` 已完成：`test -f changes/<id>/review/spec-review.md` (→ PASS/FAIL)
-- [ ] `ws-quality-review` 已完成：`test -f changes/<id>/review/quality-review.md` (→ PASS/FAIL)
-- [ ] `aiws validate .` stamp 存在：`ls .agentdocs/tmp/aiws-validate/*.json 2>/dev/null` (→ PASS/FAIL)
-- [ ] 无未关闭 Critical blocker：`grep -c 'Critical' changes/<id>/review/*.md` = 0 或已标记 resolved (→ PASS/FAIL)
-- [ ] 评审-返工循环 handoff 记录：`test -f changes/<id>/handoff-evidence.md` 且含 rework round 记录 (→ PASS/FAIL)
+- [ ] `ws-spec-review` 已完成：`test -f .aiws/changes/<id>/review/spec-review.md` (→ PASS/FAIL)
+- [ ] `ws-quality-review` 已完成：`test -f .aiws/changes/<id>/review/quality-review.md` (→ PASS/FAIL)
+- [ ] `aiws validate .` stamp 存在：`ls .aiws/tmp/aiws-validate/*.json 2>/dev/null` (→ PASS/FAIL)
+- [ ] 无未关闭 Critical blocker：`grep -c 'Critical' .aiws/changes/<id>/review/*.md` = 0 或已标记 resolved (→ PASS/FAIL)
+- [ ] 评审-返工循环 handoff 记录：`test -f .aiws/changes/<id>/handoff-evidence.md` 且含 rework round 记录 (→ PASS/FAIL)
 ## Gate Result（结构化输出）