@aipper/aiws-spec 0.0.33 → 0.0.34

package/templates/workspace/.aiws/manifest.json

@@ -5,7 +5,7 @@
   "aiws_version": "0.0.0",
   "installed_at": "1970-01-01T00:00:00Z",
   "updated_at": "1970-01-01T00:00:00Z",
-  "tools": ["claude", "opencode", "codex"],
+  "tools": ["opencode"],
   "managed": [
     { "path": ".githooks/pre-commit", "mode": "replace_file", "sha256": "<sha256>" },
     { "path": ".githooks/pre-push", "mode": "replace_file", "sha256": "<sha256>" },
@@ -16,17 +16,9 @@
     { "path": "AI_WORKSPACE.md", "mode": "managed_blocks", "blocks": { "ai-workspace:core": "<sha256>" } },
     { "path": "REQUIREMENTS.md", "mode": "managed_blocks", "blocks": { "requirements:contract": "<sha256>" } },
     { "path": ".gitignore", "mode": "managed_blocks", "blocks": { "gitignore": "<sha256>" } },
-    { "path": ".claude/commands/aiws-init.md", "mode": "managed_blocks", "blocks": { "claude:aiws-init": "<sha256>" } },
-    { "path": ".claude/commands/aiws-update.md", "mode": "managed_blocks", "blocks": { "claude:aiws-update": "<sha256>" } },
-    { "path": ".claude/commands/aiws-validate.md", "mode": "managed_blocks", "blocks": { "claude:aiws-validate": "<sha256>" } },
-    { "path": ".claude/commands/aiws-rollback.md", "mode": "managed_blocks", "blocks": { "claude:aiws-rollback": "<sha256>" } },
     { "path": ".opencode/command/aiws-init.md", "mode": "managed_blocks", "blocks": { "opencode:aiws-init": "<sha256>" } },
     { "path": ".opencode/command/aiws-update.md", "mode": "managed_blocks", "blocks": { "opencode:aiws-update": "<sha256>" } },
     { "path": ".opencode/command/aiws-validate.md", "mode": "managed_blocks", "blocks": { "opencode:aiws-validate": "<sha256>" } },
-    { "path": ".opencode/command/aiws-rollback.md", "mode": "managed_blocks", "blocks": { "opencode:aiws-rollback": "<sha256>" } },
-    { "path": ".codex/prompts/aiws-init.md", "mode": "managed_blocks", "blocks": { "codex:aiws-init": "<sha256>" } },
-    { "path": ".codex/prompts/aiws-update.md", "mode": "managed_blocks", "blocks": { "codex:aiws-update": "<sha256>" } },
-    { "path": ".codex/prompts/aiws-validate.md", "mode": "managed_blocks", "blocks": { "codex:aiws-validate": "<sha256>" } },
-    { "path": ".codex/prompts/aiws-rollback.md", "mode": "managed_blocks", "blocks": { "codex:aiws-rollback": "<sha256>" } }
+    { "path": ".opencode/command/aiws-rollback.md", "mode": "managed_blocks", "blocks": { "opencode:aiws-rollback": "<sha256>" } }
   ]
 }

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

@@ -66,6 +66,10 @@ fi
 7) submodules 全部成功后，再回到主仓库执行：
    - `aiws change finish <change-id> --push`
 8) `aiws change finish --push` 成功后会自动归档并生成 handoff；只有历史/异常场景才需要手工运行 `aiws change archive <change-id>`。
+9) 输出本轮 change 的中文工作摘要，包含：
+   - 目标：解决了什么问题
+   - 改动范围：改了哪些文件/模块（可引用 handoff 或 evidence）
+   - 验证结果：构建/测试/LSP/validate 等关键门禁的结果
 
 安全：
 - push 前先输出状态并说明远端/分支。

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

@@ -34,6 +34,11 @@ description: 目标协议：设定可审计的 goal 目标并执行完成闭环
    b) 简单路径：`git add` 目标产出文件 → `git commit -m "goal(<goal-id>): <objective 摘要>"` → `git push` → 更新 goal status=complete
    c) 复杂路径：走 `ws-commit` → `ws-finish` → archive change → 更新 goal status=complete
    d) 不通过：记录 blocker → 继续 fix 循环
+9) **Auto-chain to next goal**：当前 goal pipeline 完成后：
+   a) 扫描 `.aiws/goals/*.md`，按文件名排序找出第一个 status=pending 的 goal
+   b) 若找到：读取其 objective，输出 "→ Auto-continuing to <goal-id>"，回到步骤 5 创建新 pipeline 自动继续
+   c) 若未找到：输出 "All goals completed" 并结束
+   d) 若找到的 pending goal 缺少 Success Criteria：输出 blocker 并停止（不自动跳过）
 <!-- AIWS_MANAGED_END:opencode:ws-goal -->
 
 可在下方追加本项目对 OpenCode 的额外说明（托管块外内容会被保留）。

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

@@ -66,6 +66,10 @@ fi
 7) submodules 全部成功后，再回到主仓库执行：
    - `aiws change finish <change-id> --push`
 8) `aiws change finish --push` 成功后会自动归档并生成 handoff；只有历史/异常场景才需要手工运行 `aiws change archive <change-id>`。
+9) 输出本轮 change 的中文工作摘要，包含：
+   - 目标：解决了什么问题
+   - 改动范围：改了哪些文件/模块（可引用 handoff 或 evidence）
+   - 验证结果：构建/测试/LSP/validate 等关键门禁的结果
 
 安全：
 - push 前先输出状态并说明远端/分支。

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

@@ -0,0 +1,41 @@
+---
+name: ws-goal
+description: 目标协议：设定可审计的 goal 目标并执行完成闭环（基于 ws-goal-contract.md）
+---
+# ws-goal
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 将用户需求转化为可审计的 goal 目标，按 ws-goal-contract.md 的目标模板写入目标文件，驱动完成闭环。
+
+前置条件：
+1) 先运行 `/ws-preflight`（对齐 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`）。
+
+执行流程：
+0) 检查 `.aiws/goals/` 目录：
+   a) 若用户仅查询状态（无明确目标），列出所有 goal 文件及其 status 字段，然后结束。
+   b) 若存在 status=active 或 status=paused 的 goal 文件，优先读取并恢复执行，不再新建 goal。
+1) 读取真值文件（`AI_PROJECT.md`、`REQUIREMENTS.md`、`AI_WORKSPACE.md`），确认项目规则与边界。
+2) 接受用户输入的 goal objective，明确目标范围与验收标准。
+3) 按 ws-goal-contract.md 的目标模板生成目标文件，写入 `.aiws/goals/<goal-id>.md`。
+4) 输出 completion audit checklist，列出每个 goal 的完成标准与验证方式。
+5) **Scope Assessment + 路由**：评估目标复杂度，自动选择执行路径：
+   a) 简单（≤5 文件、配置/doc/规范为主、低风险）→ 直行：后续步骤 6-8 auto-finish 闭环
+   b) 复杂（多模块、代码改动 >5 文件、架构/安全/迁移风险）→ 自动触发 `ws-plan` 启动 change 流水线（ws-plan → ws-dev → review → ws-commit → ws-finish），完成后更新 goal status=complete
+   c) 将路由决策写入 goal 文件 Audit Trail
+6) 建议续跑方式：简单路径直行 auto-finish；复杂路径进入 change 流水线后建议 `ws-dev`
+7) 每轮 execution 结束后执行 completion audit，比对 checklist 判断 goal 是否达成；未达成则继续下一轮。
+8) 若 completion audit 确认 goal 达成，自动执行闭环 pipeline：
+   a) Review 检查（按改动类型）：
+      - 配置/文档/规范类（markdown）：内容一致性、引用完整性、内容正确性、无 secrets、格式统一
+      - 代码类（ts/js/py 等）：lint/typecheck 通过、符合现有代码模式、无 secrets、测试通过或覆盖缺口已记录
+      - 混合类：以上两种合并
+   b) 简单路径：`git add` 目标产出文件 → `git commit -m "goal(<goal-id>): <objective 摘要>"` → `git push` → 更新 goal status=complete
+   c) 复杂路径：走 `ws-commit` → `ws-finish` → archive change → 更新 goal status=complete
+   d) 不通过：记录 blocker → 继续 fix 循环
+9) **Auto-chain to next goal**：当前 goal pipeline 完成后：
+   a) 扫描 `.aiws/goals/*.md`，按文件名排序找出第一个 status=pending 的 goal
+   b) 若找到：读取其 objective，输出 "→ Auto-continuing to <goal-id>"，回到步骤 5 创建新 pipeline 自动继续
+   c) 若未找到：输出 "All goals completed" 并结束
+   d) 若找到的 pending goal 缺少 Success Criteria：输出 blocker 并停止（不自动跳过）

package/templates/workspace/AGENTS.md

@@ -28,9 +28,7 @@ Red Flags（这些想法都是错的）：
 
 阶段产物（最少）：intake=`.aiws/plan/*.intake.md` | planning=`.aiws/plan/...`+`proposal.md`+`tasks.md` | dev=代码+Verify | review=`review/...` | validate=`aiws-validate/*.json` | archive=`evidence/...`+`handoff.md`
 
-平台前缀：OpenCode/Claude=`/` Codex=`$` | 例：`/ws-dev` 或 `$ws-dev`
-Codex 全局安装：`npx @aipper/aiws codex install-skills`
-缺文件/漂移时：`npx @aipper/aiws init` / `npx @aipper/aiws update`
+平台前缀：OpenCode=`/` | 例：`/ws-dev`
 <!-- AIWS_MANAGED_END:agents -->
 
 你可以在本段下方追加项目自定义说明；`aiws update` 不会改动托管块以外内容。

package/templates/workspace/AI_PROJECT.md

@@ -3,7 +3,7 @@
 <!-- AIWS_MANAGED_BEGIN:ai-project:core -->
 <!-- AI_PROJECT_VERSION: 2 -->
 
-本文件用于在**具体项目/工作区**内统一 Codex / Claude / OpenCode 的执行约束与协作方式，避免多套规则各写一份导致漂移。
+本文件用于在**具体项目/工作区**内统一 OpenCode 的执行约束与协作方式，避免多套规则各写一份导致漂移。
 
 定位：
 - `REQUIREMENTS.md`：定义“要做什么/验收是什么”（需求真值）
@@ -35,6 +35,11 @@
 
 不得只在对话里口头描述“已验证/已修复”。
 
+完成小结（change finish 时，主 session 应输出一段中文工作摘要）：
+- 目标：概括本轮 change 解决了什么问题
+- 改动范围：改了什么文件/模块（增删改各多少）
+- 验证结果：怎么确认没问题（构建/测试/LSP/validate 等关键门禁结果）
+
 推荐（防规则/范围漂移）：
 - 创建工件：补齐 `.aiws/changes/<change-id>/proposal.md`、`tasks.md`（可选 `design.md`）
 - 声明 active change（团队共享）：切到分支 `change/<change-id>`（也支持 `changes/`、`ws/`、`ws-change/`）

package/templates/workspace/AI_WORKSPACE.md

@@ -32,7 +32,7 @@
 
 <!-- AIWS_MANAGED_BEGIN:ai-workspace:core -->
 
-本文件描述“AI Workspace（多子项目工作区）”的结构与运行方式，供 Codex / Claude / OpenCode 共同读取。
+本文件描述“AI Workspace（多子项目工作区）”的结构与运行方式，供 OpenCode 读取。
 
 ## 1) 目录发现规则