@aipper/aiws-spec 0.0.33 → 0.0.36

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

@@ -0,0 +1,32 @@
+---
+name: ws-goal
+description: 目标协议：设定可审计的 goal 目标；依赖链预检；管道委托；完成审计
+---
+# ws-goal
+
+用中文输出（命令/路径/代码标识符保持原样不翻译）。
+
+目标：
+- 将用户需求转化为可审计的 goal 目标，按 ws-goal-contract.md 的目标模板写入目标文件。
+- 依赖链预检：阻断"死 change 阻塞下游"这类 chain 问题。
+- 管道委托：预检通过后将完整 pipeline 委托给子 agent（从 ws-plan 一路走到 ws-finish）。
+- 完成审计：claim done 时验证 outcome 真伪。
+
+ws-goal 不做的事：
+- 不直接创建 change、不直接写 code
+- 不替换 review/commit/finish 门禁
+- 不 auto-chain 到下一个 goal
+
+前置条件：
+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) **Workspace State Analysis**：分析 dirty/submodule/change artifacts/git 状态，输出影响等级报告，用户确认后才能继续。参考 `/ws-goal` command 的 step 4.5 完整流程。
+6) **Pipeline Delegation**：预检 + 分析通过后，将 goal 完整执行委托给管道 agent。参考 `/ws-goal` command 的 step 5 完整流程。

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) 目录发现规则