@aipper/aiws-spec 0.0.31 → 0.0.32

package/package.json

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

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

@@ -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

@@ -11,7 +11,7 @@ description: 分析（定位问题与收集上下文）
 - 主题/需求：用户在本次消息中提供的主题（若不明确，先问一句“本次分析主题是什么？”）
 
 步骤（建议）：
-1) 先做 preflight：定位项目根目录，读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
+1) 先做 preflight：定位项目根目录（submodule 感知：若在 submodule 内自动上溯到 superproject 根），读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
 2) 基于真值文件与当前代码现状，输出：
    - 目标 / 非目标
    - 现状证据（文件路径/接口路径）

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

@@ -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`，通过后进入实现。

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

@@ -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-req-review/SKILL.md

@@ -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

@@ -31,7 +31,7 @@ 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` 检查：
    - 是否存在越界目录改动/危险操作
    - 是否有可复现验证命令与证据

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

@@ -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

@@ -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

@@ -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

@@ -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/ws-preflight/SKILL.md

@@ -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-req-review/SKILL.md

@@ -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`