@aipper/aiws-spec 0.0.23 → 0.0.25

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 (210) hide show
  1. package/README.md +22 -0
  2. package/docs/aiws-bootstrap-routing-design.md +138 -0
  3. package/docs/aiws-governance-positioning.md +69 -0
  4. package/docs/cli-interface.md +87 -5
  5. package/docs/collaboration-artifacts.md +62 -0
  6. package/docs/opencode-omo-adapter.md +135 -0
  7. package/docs/opencode-omo-validation-checklist.md +90 -0
  8. package/docs/spec-contract.md +26 -11
  9. package/docs/superpowers-collaboration-adoption.md +92 -0
  10. package/docs/workflow-delegation-contracts.json +274 -0
  11. package/docs/workflow-delegation-contracts.md +248 -0
  12. package/docs/workflow-delegation-contracts.schema.json +176 -0
  13. package/docs/workflow-governance-rules.json +294 -0
  14. package/docs/workflow-governance-rules.md +63 -0
  15. package/docs/workflow-governance-rules.schema.json +182 -0
  16. package/docs/workflow-review-gates.json +72 -0
  17. package/docs/workflow-review-gates.md +36 -0
  18. package/docs/workflow-review-gates.schema.json +67 -0
  19. package/docs/workflow-router-rules.json +196 -0
  20. package/docs/workflow-router-rules.md +83 -0
  21. package/docs/workflow-router-rules.schema.json +119 -0
  22. package/docs/workflow-stage-contracts.json +148 -0
  23. package/docs/workflow-stage-contracts.md +70 -0
  24. package/docs/workflow-stage-contracts.schema.json +98 -0
  25. package/package.json +1 -1
  26. package/templates/workspace/.agents/skills/using-aiws/SKILL.md +83 -0
  27. package/templates/workspace/.agents/skills/ws-bugfix/SKILL.md +30 -7
  28. package/templates/workspace/.agents/skills/ws-commit/SKILL.md +26 -1
  29. package/templates/workspace/.agents/skills/ws-delegate/SKILL.md +75 -0
  30. package/templates/workspace/.agents/skills/ws-deliver/SKILL.md +46 -9
  31. package/templates/workspace/.agents/skills/ws-dev/SKILL.md +81 -11
  32. package/templates/workspace/.agents/skills/ws-finish/SKILL.md +101 -60
  33. package/templates/workspace/.agents/skills/ws-frontend-design/SKILL.md +126 -0
  34. package/templates/workspace/.agents/skills/ws-handoff/SKILL.md +22 -1
  35. package/templates/workspace/.agents/skills/ws-plan/SKILL.md +61 -2
  36. package/templates/workspace/.agents/skills/ws-plan-verify/SKILL.md +20 -0
  37. package/templates/workspace/.agents/skills/ws-preflight/SKILL.md +23 -0
  38. package/templates/workspace/.agents/skills/ws-quality-review/SKILL.md +56 -0
  39. package/templates/workspace/.agents/skills/ws-review/SKILL.md +24 -0
  40. package/templates/workspace/.agents/skills/ws-spec-review/SKILL.md +57 -0
  41. package/templates/workspace/.agents/skills/ws-verify-before-complete/SKILL.md +59 -0
  42. package/templates/workspace/.claude/commands/using-aiws.md +24 -0
  43. package/templates/workspace/.claude/commands/ws-bugfix.md +11 -6
  44. package/templates/workspace/.claude/commands/ws-commit.md +2 -1
  45. package/templates/workspace/.claude/commands/ws-deliver.md +6 -2
  46. package/templates/workspace/.claude/commands/ws-dev.md +5 -2
  47. package/templates/workspace/.claude/commands/ws-finish.md +19 -19
  48. package/templates/workspace/.claude/commands/ws-plan.md +9 -5
  49. package/templates/workspace/.claude/commands/ws-quality-review.md +24 -0
  50. package/templates/workspace/.claude/commands/ws-spec-review.md +24 -0
  51. package/templates/workspace/.claude/commands/ws-verify-before-complete.md +24 -0
  52. package/templates/workspace/.claude/skills/p-aiws-change-archive/SKILL.md +24 -0
  53. package/templates/workspace/.claude/skills/p-aiws-change-finish/SKILL.md +24 -0
  54. package/templates/workspace/.claude/skills/p-aiws-change-list/SKILL.md +18 -0
  55. package/templates/workspace/.claude/skills/p-aiws-change-new/SKILL.md +26 -0
  56. package/templates/workspace/.claude/skills/p-aiws-change-next/SKILL.md +19 -0
  57. package/templates/workspace/.claude/skills/p-aiws-change-start/SKILL.md +33 -0
  58. package/templates/workspace/.claude/skills/p-aiws-change-status/SKILL.md +19 -0
  59. package/templates/workspace/.claude/skills/p-aiws-change-sync/SKILL.md +19 -0
  60. package/templates/workspace/.claude/skills/p-aiws-change-templates-init/SKILL.md +18 -0
  61. package/templates/workspace/.claude/skills/p-aiws-change-templates-which/SKILL.md +18 -0
  62. package/templates/workspace/.claude/skills/p-aiws-change-validate/SKILL.md +23 -0
  63. package/templates/workspace/.claude/skills/p-aiws-hooks-install/SKILL.md +30 -0
  64. package/templates/workspace/.claude/skills/p-aiws-hooks-status/SKILL.md +18 -0
  65. package/templates/workspace/.claude/skills/p-aiws-init/SKILL.md +27 -0
  66. package/templates/workspace/.claude/skills/p-aiws-rollback/SKILL.md +18 -0
  67. package/templates/workspace/.claude/skills/p-aiws-update/SKILL.md +26 -0
  68. package/templates/workspace/.claude/skills/p-aiws-validate/SKILL.md +22 -0
  69. package/templates/workspace/.claude/skills/p-tasks-plan/SKILL.md +37 -0
  70. package/templates/workspace/.claude/skills/using-aiws/SKILL.md +83 -0
  71. package/templates/workspace/.claude/skills/ws-analyze/SKILL.md +26 -0
  72. package/templates/workspace/.claude/skills/ws-bugfix/SKILL.md +111 -0
  73. package/templates/workspace/.claude/skills/ws-commit/SKILL.md +127 -0
  74. package/templates/workspace/.claude/skills/ws-deliver/SKILL.md +231 -0
  75. package/templates/workspace/.claude/skills/ws-dev/SKILL.md +168 -0
  76. package/templates/workspace/.claude/skills/ws-finish/SKILL.md +220 -0
  77. package/templates/workspace/.claude/skills/ws-frontend-design/SKILL.md +126 -0
  78. package/templates/workspace/.claude/skills/ws-handoff/SKILL.md +52 -0
  79. package/templates/workspace/.claude/skills/ws-migrate/SKILL.md +54 -0
  80. package/templates/workspace/.claude/skills/ws-plan/SKILL.md +138 -0
  81. package/templates/workspace/.claude/skills/ws-plan-verify/SKILL.md +61 -0
  82. package/templates/workspace/.claude/skills/ws-preflight/SKILL.md +55 -0
  83. package/templates/workspace/.claude/skills/ws-pull/SKILL.md +119 -0
  84. package/templates/workspace/.claude/skills/ws-push/SKILL.md +110 -0
  85. package/templates/workspace/.claude/skills/ws-quality-review/SKILL.md +56 -0
  86. package/templates/workspace/.claude/skills/ws-req-change/SKILL.md +41 -0
  87. package/templates/workspace/.claude/skills/ws-req-contract-sync/SKILL.md +17 -0
  88. package/templates/workspace/.claude/skills/ws-req-contract-validate/SKILL.md +12 -0
  89. package/templates/workspace/.claude/skills/ws-req-flow-sync/SKILL.md +28 -0
  90. package/templates/workspace/.claude/skills/ws-req-review/SKILL.md +32 -0
  91. package/templates/workspace/.claude/skills/ws-review/SKILL.md +50 -0
  92. package/templates/workspace/.claude/skills/ws-rule/SKILL.md +23 -0
  93. package/templates/workspace/.claude/skills/ws-spec-review/SKILL.md +57 -0
  94. package/templates/workspace/.claude/skills/ws-submodule-setup/SKILL.md +65 -0
  95. package/templates/workspace/.claude/skills/ws-verify-before-complete/SKILL.md +59 -0
  96. package/templates/workspace/.codex/prompts/ws-dev.md +5 -1
  97. package/templates/workspace/.githooks/commit-msg +109 -0
  98. package/templates/workspace/.iflow/commands/ws-commit.toml +2 -1
  99. package/templates/workspace/.iflow/commands/ws-deliver.toml +6 -2
  100. package/templates/workspace/.iflow/commands/ws-finish.toml +19 -19
  101. package/templates/workspace/.opencode/command/using-aiws.md +29 -0
  102. package/templates/workspace/.opencode/command/ws-bugfix.md +11 -6
  103. package/templates/workspace/.opencode/command/ws-commit.md +2 -1
  104. package/templates/workspace/.opencode/command/ws-delegate.md +33 -0
  105. package/templates/workspace/.opencode/command/ws-deliver.md +6 -2
  106. package/templates/workspace/.opencode/command/ws-dev.md +5 -2
  107. package/templates/workspace/.opencode/command/ws-finish.md +19 -19
  108. package/templates/workspace/.opencode/command/ws-plan.md +12 -5
  109. package/templates/workspace/.opencode/command/ws-preflight.md +4 -0
  110. package/templates/workspace/.opencode/command/ws-quality-review.md +30 -0
  111. package/templates/workspace/.opencode/command/ws-review.md +3 -0
  112. package/templates/workspace/.opencode/command/ws-spec-review.md +30 -0
  113. package/templates/workspace/.opencode/command/ws-verify-before-complete.md +27 -0
  114. package/templates/workspace/.opencode/commands/p-aiws-change-archive.md +27 -0
  115. package/templates/workspace/.opencode/commands/p-aiws-change-finish.md +27 -0
  116. package/templates/workspace/.opencode/commands/p-aiws-change-list.md +26 -0
  117. package/templates/workspace/.opencode/commands/p-aiws-change-new.md +27 -0
  118. package/templates/workspace/.opencode/commands/p-aiws-change-next.md +27 -0
  119. package/templates/workspace/.opencode/commands/p-aiws-change-start.md +27 -0
  120. package/templates/workspace/.opencode/commands/p-aiws-change-status.md +27 -0
  121. package/templates/workspace/.opencode/commands/p-aiws-change-sync.md +27 -0
  122. package/templates/workspace/.opencode/commands/p-aiws-change-templates-init.md +26 -0
  123. package/templates/workspace/.opencode/commands/p-aiws-change-templates-which.md +26 -0
  124. package/templates/workspace/.opencode/commands/p-aiws-change-validate.md +27 -0
  125. package/templates/workspace/.opencode/commands/p-aiws-hooks-install.md +26 -0
  126. package/templates/workspace/.opencode/commands/p-aiws-hooks-status.md +26 -0
  127. package/templates/workspace/.opencode/commands/p-aiws-init.md +23 -0
  128. package/templates/workspace/.opencode/commands/p-aiws-rollback.md +16 -0
  129. package/templates/workspace/.opencode/commands/p-aiws-update.md +22 -0
  130. package/templates/workspace/.opencode/commands/p-aiws-validate.md +17 -0
  131. package/templates/workspace/.opencode/commands/using-aiws.md +29 -0
  132. package/templates/workspace/.opencode/commands/ws-analyze.md +30 -0
  133. package/templates/workspace/.opencode/commands/ws-bugfix.md +35 -0
  134. package/templates/workspace/.opencode/commands/ws-commit.md +70 -0
  135. package/templates/workspace/.opencode/commands/ws-delegate.md +33 -0
  136. package/templates/workspace/.opencode/commands/ws-deliver.md +58 -0
  137. package/templates/workspace/.opencode/commands/ws-dev.md +36 -0
  138. package/templates/workspace/.opencode/commands/ws-finish.md +71 -0
  139. package/templates/workspace/.opencode/commands/ws-handoff.md +25 -0
  140. package/templates/workspace/.opencode/commands/ws-migrate.md +25 -0
  141. package/templates/workspace/.opencode/commands/ws-plan-verify.md +28 -0
  142. package/templates/workspace/.opencode/commands/ws-plan.md +27 -0
  143. package/templates/workspace/.opencode/commands/ws-preflight.md +34 -0
  144. package/templates/workspace/.opencode/commands/ws-pull.md +87 -0
  145. package/templates/workspace/.opencode/commands/ws-push.md +93 -0
  146. package/templates/workspace/.opencode/commands/ws-quality-review.md +30 -0
  147. package/templates/workspace/.opencode/commands/ws-req-change.md +45 -0
  148. package/templates/workspace/.opencode/commands/ws-req-contract-sync.md +21 -0
  149. package/templates/workspace/.opencode/commands/ws-req-contract-validate.md +16 -0
  150. package/templates/workspace/.opencode/commands/ws-req-flow-sync.md +23 -0
  151. package/templates/workspace/.opencode/commands/ws-req-review.md +36 -0
  152. package/templates/workspace/.opencode/commands/ws-review.md +33 -0
  153. package/templates/workspace/.opencode/commands/ws-rule.md +27 -0
  154. package/templates/workspace/.opencode/commands/ws-spec-review.md +30 -0
  155. package/templates/workspace/.opencode/commands/ws-submodule-setup.md +57 -0
  156. package/templates/workspace/.opencode/commands/ws-verify-before-complete.md +27 -0
  157. package/templates/workspace/.opencode/oh-my-opencode.json.example +17 -0
  158. package/templates/workspace/.opencode/skills/p-aiws-change-archive/SKILL.md +24 -0
  159. package/templates/workspace/.opencode/skills/p-aiws-change-finish/SKILL.md +24 -0
  160. package/templates/workspace/.opencode/skills/p-aiws-change-list/SKILL.md +18 -0
  161. package/templates/workspace/.opencode/skills/p-aiws-change-new/SKILL.md +26 -0
  162. package/templates/workspace/.opencode/skills/p-aiws-change-next/SKILL.md +19 -0
  163. package/templates/workspace/.opencode/skills/p-aiws-change-start/SKILL.md +33 -0
  164. package/templates/workspace/.opencode/skills/p-aiws-change-status/SKILL.md +19 -0
  165. package/templates/workspace/.opencode/skills/p-aiws-change-sync/SKILL.md +19 -0
  166. package/templates/workspace/.opencode/skills/p-aiws-change-templates-init/SKILL.md +18 -0
  167. package/templates/workspace/.opencode/skills/p-aiws-change-templates-which/SKILL.md +18 -0
  168. package/templates/workspace/.opencode/skills/p-aiws-change-validate/SKILL.md +23 -0
  169. package/templates/workspace/.opencode/skills/p-aiws-hooks-install/SKILL.md +30 -0
  170. package/templates/workspace/.opencode/skills/p-aiws-hooks-status/SKILL.md +18 -0
  171. package/templates/workspace/.opencode/skills/p-aiws-init/SKILL.md +27 -0
  172. package/templates/workspace/.opencode/skills/p-aiws-rollback/SKILL.md +18 -0
  173. package/templates/workspace/.opencode/skills/p-aiws-update/SKILL.md +26 -0
  174. package/templates/workspace/.opencode/skills/p-aiws-validate/SKILL.md +22 -0
  175. package/templates/workspace/.opencode/skills/p-tasks-plan/SKILL.md +37 -0
  176. package/templates/workspace/.opencode/skills/using-aiws/SKILL.md +87 -0
  177. package/templates/workspace/.opencode/skills/ws-analyze/SKILL.md +26 -0
  178. package/templates/workspace/.opencode/skills/ws-bugfix/SKILL.md +111 -0
  179. package/templates/workspace/.opencode/skills/ws-commit/SKILL.md +127 -0
  180. package/templates/workspace/.opencode/skills/ws-delegate/SKILL.md +63 -0
  181. package/templates/workspace/.opencode/skills/ws-deliver/SKILL.md +231 -0
  182. package/templates/workspace/.opencode/skills/ws-dev/SKILL.md +168 -0
  183. package/templates/workspace/.opencode/skills/ws-finish/SKILL.md +220 -0
  184. package/templates/workspace/.opencode/skills/ws-frontend-design/SKILL.md +126 -0
  185. package/templates/workspace/.opencode/skills/ws-handoff/SKILL.md +52 -0
  186. package/templates/workspace/.opencode/skills/ws-migrate/SKILL.md +54 -0
  187. package/templates/workspace/.opencode/skills/ws-plan/SKILL.md +148 -0
  188. package/templates/workspace/.opencode/skills/ws-plan-verify/SKILL.md +61 -0
  189. package/templates/workspace/.opencode/skills/ws-preflight/SKILL.md +60 -0
  190. package/templates/workspace/.opencode/skills/ws-pull/SKILL.md +119 -0
  191. package/templates/workspace/.opencode/skills/ws-push/SKILL.md +110 -0
  192. package/templates/workspace/.opencode/skills/ws-quality-review/SKILL.md +63 -0
  193. package/templates/workspace/.opencode/skills/ws-req-change/SKILL.md +41 -0
  194. package/templates/workspace/.opencode/skills/ws-req-contract-sync/SKILL.md +17 -0
  195. package/templates/workspace/.opencode/skills/ws-req-contract-validate/SKILL.md +12 -0
  196. package/templates/workspace/.opencode/skills/ws-req-flow-sync/SKILL.md +28 -0
  197. package/templates/workspace/.opencode/skills/ws-req-review/SKILL.md +32 -0
  198. package/templates/workspace/.opencode/skills/ws-review/SKILL.md +57 -0
  199. package/templates/workspace/.opencode/skills/ws-rule/SKILL.md +23 -0
  200. package/templates/workspace/.opencode/skills/ws-spec-review/SKILL.md +64 -0
  201. package/templates/workspace/.opencode/skills/ws-submodule-setup/SKILL.md +65 -0
  202. package/templates/workspace/.opencode/skills/ws-verify-before-complete/SKILL.md +59 -0
  203. package/templates/workspace/AGENTS.md +72 -29
  204. package/templates/workspace/AI_WORKSPACE.md +4 -4
  205. package/templates/workspace/changes/README.md +26 -2
  206. package/templates/workspace/changes/templates/proposal.md +15 -0
  207. package/templates/workspace/changes/templates/tasks.md +9 -2
  208. package/templates/workspace/manifest.json +279 -2
  209. package/templates/workspace/tools/ws_change_check.py +27 -5
  210. package/templates/workspace/tools/ws_resolve_sub_target.sh +1 -0
@@ -5,35 +5,78 @@
5
5
  3) `AI_WORKSPACE.md`(运行/测试入口真值)
6
6
  4) `changes/README.md`(变更工件流程与归档)
7
7
 
8
- 协作约束(建议最小集):
9
- - 每次变更使用分支 `change/<change-id>`,并维护 `changes/<change-id>/proposal.md`、`tasks.md`(可选 `design.md`)
10
- - 启用本机门禁(推荐):`aiws hooks install .`(或手工:`git config core.hooksPath .githooks`;`git commit`/`git push` 会自动跑 `aiws validate .`)
11
- - 提交前校验(强制门禁):`aiws validate .`(包含:漂移检测 + `ws_change_check` + `requirements_contract`)
12
- - Codex(推荐):本仓库内置 repo skills:`.agents/skills/`(可显式 `$ws-dev`,也可隐式套用工作流)
13
- - Codex skills 命名约定:`ws-*` 为常用链路入口;`p-*` 为私有原子入口(一般不需要直接调用)。
14
- - Codex skills(常用,一句话说明):
15
- - `$ws-preflight`:预检(读取真值文件并输出约束摘要)
16
- - `$ws-submodule-setup`:子模块分支对齐(写入 `.gitmodules` 的 `submodule.<name>.branch`)
17
- - `$ws-plan`:规划(生成可落盘 `plan/` 工件;供 `$ws-dev` 执行)
18
- - `$ws-plan-verify`:计划质检(执行前检查计划是否过长/跑偏)
19
- - `$p-tasks-plan`:原子:tasks 同步(从 `changes/<id>/tasks.md` 生成 `update_plan` payload)
20
- - `$ws-dev`:开发(按需求实现并验证;适用于任何需要修改代码/配置的任务)
21
- - `$ws-bugfix`:缺陷修复(禅道 MCP 拉单 + 图片证据落盘 + `issues/fix_bus_issues.csv` 汇总)
22
- - `$ws-pull`:拉取并对齐 submodules(尽量避免 detached;减少人为差异)
23
- - `$ws-push`:推送(submodule 感知:先 submodules 后 superproject;fast-forward 安全)
24
- - `$ws-review`:评审(提交前审计;证据优先落盘到 `changes/<change-id>/review/`)
25
- - `$ws-commit`:提交(先审计/门禁再 commit;submodule 感知)
26
- - `$ws-handoff`:交接(归档后生成/查看 `changes/archive/.../handoff.md`,便于跨会话接力)
27
- - `$p-aiws-init`:初始化工作区(生成真值文件与门禁)
28
- - `$p-aiws-validate`:校验工作区(漂移检测 + 门禁)
29
- - `$p-aiws-hooks-install`:启用 git hooks 门禁(`core.hooksPath=.githooks`)
30
- - `$p-aiws-change-new`:创建 `changes/<change-id>` 工件
31
- - Codex CLI(推荐,可选):安装全局 skills:`npx @aipper/aiws codex install-skills`(写入 `~/.codex/skills/` 或 `$CODEX_HOME/skills`)
32
- - Codex CLI(遗留,可选):安装全局 prompts:`npx @aipper/aiws codex install-prompts`(写入 `~/.codex/prompts/` 或 `$CODEX_HOME/prompts`;prompts 已 deprecated)
33
- - 不要把敏感信息写入 git:`secrets/test-accounts.json`、`.env*`、token、内网地址等
34
-
35
- 如果缺文件:运行 `npx @aipper/aiws init`(或 `aiws init`)。
36
- (如你仍在使用 dotfiles 的 `ws` wrappers,也可用 `ws init/ws migrate`;但本模板默认不依赖 dotfiles。)
8
+ 最小协作约束:
9
+ - 不确定先跑 `/using-aiws`(Codex 对应 `$using-aiws`);它会先读真值,再把任务路由到合适的 `ws-*` 入口。
10
+ - 若你已经明确只是做预检,也可以直接跑 `/ws-preflight`(Codex 对应 `$ws-preflight`);所有实现/修复都以 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md` 为准。
11
+ - 每次变更建议进入 `change/<change-id>`,并维护 `changes/<change-id>/proposal.md`、`tasks.md`(可选 `design.md`)。
12
+ - 若仓库存在 `.gitmodules`:优先 `aiws change start <change-id> --worktree`;不要在当前 superproject worktree 里直接切分支。
13
+ - 提交前执行 `aiws validate .`;需要本机门禁时运行 `aiws hooks install .`(或 `git config core.hooksPath .githooks`)。
14
+ - 不要把敏感信息写入 git:`secrets/test-accounts.json`、`.env*`、token、内网地址等。
15
+
16
+ 标准链路(建议默认):
17
+ - `using-aiws`:默认 bootstrap/router;先读真值,先判 workflow,再进入具体阶段;意图不明确时先澄清。
18
+ - `ws-preflight`:读取真值文件,输出约束摘要;若真值缺失,先停止,不直接开工。
19
+ - `ws-plan`:建立 `change/<change-id>` 绑定,落盘 `plan/...`,明确 Verify / Risks / Evidence。
20
+ - `ws-plan-verify`:在编码前做计划质检;不过门禁就先修 plan,不跳步进实现。
21
+ - `ws-dev`:只做可归因、可验证的小步实现;输出 Changed / Verify / Evidence。
22
+ - `ws-delegate`:仅在任务已绑定且 scope 可控时,使用原生多 agent / sub-agent;否则明确降级为单 agent + 协同工件模式。
23
+ - `ws-review`:对当前改动做通用审计;高风险或准备交付时,继续细化到 `ws-spec-review` + `ws-quality-review`。
24
+ - `ws-spec-review`:审查 requirements 归因、plan/change 绑定、evidence 与 workflow gate 完整性。
25
+ - `ws-quality-review`:审查行为回归、边界条件、测试覆盖与实现质量。
26
+ - `ws-commit`:串联 review + validate stamp + commit message 确认;不跳过 hooks。
27
+ - `ws-verify-before-complete`:在 finish / handoff 前检查双审查、validate stamp 与交付证据是否齐全。
28
+ - `ws-deliver` / `ws-finish`:做交付收尾、fast-forward 合并、submodule 感知 push 与证据收敛。
29
+ - `ws-handoff`:在归档后输出 handoff,给下一次会话或下一位协作者接力。
30
+
31
+ 阶段产物(最少):
32
+ - planning:`plan/...`、`changes/<change-id>/proposal.md`、`tasks.md`
33
+ - implementation:代码 / 配置改动 + Verify 命令记录
34
+ - collaboration:`changes/<change-id>/analysis/...`、`patches/...`、`review/...`
35
+ - review:`changes/<change-id>/review/...` 或回退 `.agentdocs/tmp/review/...`
36
+ - validate:`.agentdocs/tmp/aiws-validate/*.json`
37
+ - handoff / archive:`changes/<change-id>/evidence/...`、`changes/archive/.../handoff.md`
38
+
39
+ OpenCode(如果你主要用 OpenCode,优先):
40
+ - native skills 在 `.opencode/skills/`;native commands 在 `.opencode/commands/`
41
+ - 若项目启用了 `.opencode/oh-my-opencode.json`:`ws-plan` / `ws-review` / `ws-spec-review` / `ws-quality-review` / `ws-delegate` 会优先借用 oMo 的 `planner-sisyphus` / `explore` / `librarian` / `oracle`
42
+ - 若你想按项目固定这组 agent,可参考 `.opencode/oh-my-opencode.json.example`;它只覆盖 `agents`,不接管 hooks/MCP/LSP
43
+ - 常用手动入口继续保留在 `.opencode/commands/`(migration window 内 `.opencode/command/` 也会保留);直接使用 `/ws-*`
44
+ - 若你不确定当前任务该先 plan、dev、review 还是 finish:先用 `/using-aiws`
45
+ - `/ws-preflight`:读取真值文件并输出约束摘要
46
+ - `/ws-plan` / `/ws-plan-verify`:先生成计划,再做执行前质检
47
+ - `/ws-dev`:常规实现/改配置/改测试
48
+ - `/ws-delegate`:按 AIWS 委托合同拆分子任务,并优先借用 oMo agent
49
+ - `/ws-bugfix`:缺陷修复 + 证据落盘 + CSV 汇总
50
+ - `/ws-review` / `/ws-commit`:提交前审计、门禁与 commit
51
+ - `/ws-spec-review` / `/ws-quality-review`:高风险改动建议显式拆成流程审查 + 质量审查
52
+ - `/ws-verify-before-complete`:finish / handoff 前检查双审查和 validate/evidence
53
+ - `/ws-finish` / `/ws-deliver`:交付收尾(fast-forward / submodule 感知)
54
+ - `/ws-pull` / `/ws-push` / `/ws-submodule-setup`:submodule 场景辅助
55
+ - `/p-aiws-*` 为底层原子入口;模板会同时写入 `.opencode/commands/` 与 `.opencode/command/`,一般不需要直接调用
56
+
57
+ Claude Code(如果你主要用 Claude Code):
58
+ - native skills 在 `.claude/skills/`;command-style 兼容入口保留在 `.claude/commands/`
59
+ - 常用链路可按 `ws-*` / `p-aiws-*` 理解;native skills 与 compatibility commands 指向同一套 AIWS workflow
60
+ - 若你不确定当前任务该走哪个阶段:先用 `/using-aiws`
61
+ - 高风险改动或准备 finish 时,建议额外跑 `/ws-spec-review`、`/ws-quality-review`、`/ws-verify-before-complete`
62
+
63
+ Codex(对应入口,可选):
64
+ - 若你不想先记住阶段,先用 `$using-aiws` 让 router 判定下一步
65
+ - 对应入口在 `.agents/skills/`;显式调用时使用 `$ws-*`
66
+ - `$using-aiws`
67
+ - `$ws-preflight` / `$ws-plan` / `$ws-plan-verify` / `$ws-dev` / `$ws-delegate` / `$ws-frontend-design`
68
+ - `$ws-review` / `$ws-spec-review` / `$ws-quality-review` / `$ws-commit`
69
+ - `$ws-verify-before-complete` / `$ws-finish` / `$ws-deliver`
70
+ - `$ws-pull` / `$ws-push` / `$ws-submodule-setup`
71
+ - 其它入口见 `.agents/skills/`:`ws-*` 为常用链路;`p-*` 为底层原子入口,一般不需要直接调用
72
+
73
+ Codex 全局入口(可选):
74
+ - `npx @aipper/aiws codex install-skills`(推荐;安装全局 skills)
75
+ - `npx @aipper/aiws codex install-prompts`(遗留兼容;prompts 已 deprecated)
76
+
77
+ 缺文件或模板漂移时:
78
+ - `npx @aipper/aiws init`(初始化)
79
+ - `npx @aipper/aiws update`(按模板更新托管内容)
37
80
  <!-- AIWS_MANAGED_END:agents -->
38
81
 
39
82
  你可以在本段下方追加项目自定义说明;`aiws update` 不会改动托管块以外内容。
@@ -80,10 +80,10 @@
80
80
  - 先 `/server-test-plan` → `/server-test` 跑到验收通过
81
81
  - 再 `/server-commit` 对 `server_dirs` 指定的 submodule 做 commit,并在工作区根仓库提交 submodule 指针更新
82
82
 
83
- 建议 commit message 保持通用简洁(Conventional Commits 风格),例如:
84
- - `fix(api): ...`
85
- - `chore(server): api test fixes`
86
- - `chore(workspace): bump server submodules`
83
+ 建议 commit message 保持通用简洁,优先使用中文;英文也可以,例如:
84
+ - `修复: API 健康检查空指针`
85
+ - `构建: 调整 server 测试脚本`
86
+ - `杂项: 更新 workspace submodule 指针`
87
87
 
88
88
  ## 3) 测试入口
89
89
 
@@ -15,11 +15,22 @@ changes/
15
15
  proposal.md
16
16
  design.md # 可选
17
17
  tasks.md
18
+ analysis/ # 可选:外部/子 agent 的分析结论(只读输入)
19
+ patches/ # 可选:外部/子 agent 的 patch 草案(不自动应用)
20
+ review/ # 可选:多个 reviewer 的审查结果
21
+ evidence/ # 推荐:交付前收敛出的持久证据
18
22
  .ws-change.json
19
23
  archive/
20
24
  YYYY-MM-DD-<change-id>/
21
25
  ```
22
26
 
27
+ 协同工件约定:
28
+ - `analysis/`:存放委托分析报告、调研结论、备选方案。默认视为“只读输入”,不要把它当作已实施结果。
29
+ - `patches/`:存放 patch / diff 草案。主 agent 或人工必须先审查,再决定是否应用;不要把该目录内容视为已经进代码库。
30
+ - `review/`:允许多名 reviewer 并行落盘,例如 `codex-review.md`、`reviewer-a.md`、`reviewer-b.md`。
31
+ - `evidence/`:存放 validate 总结、delivery summary、collaboration summary 等可持久引用的交付证据。
32
+ - `aiws change new <change-id>` 会预创建以上目录,减少临时约定漂移。
33
+
23
34
  常用命令(推荐使用 `aiws`;不依赖 dotfiles):
24
35
  - `aiws change start <change-id>`(默认:切到 `change/<change-id>` 并初始化工件目录;若检测到 `.gitmodules` 则默认优先使用 worktree,失败则回退为不切分支,避免 submodule 状态混乱)
25
36
  - `aiws change start <change-id> --no-switch`(superproject + submodule 场景:不切分支,仅准备 `change/<change-id>` 分支与工件目录)
@@ -28,6 +39,7 @@ changes/
28
39
  - 可选:`--worktree-dir <path>` 覆盖 worktree 目录
29
40
  - 可选:`--submodules` 在 worktree 内执行 `git submodule update --init --recursive`
30
41
  - `aiws change finish <change-id>`(安全合并:fast-forward 合并回目标分支;在 `change/<change-id>` 分支上执行时会尝试使用 `.ws-change.json` 的 `base_branch` 作为目标分支)
42
+ - `aiws change finish <change-id> --push [--remote <name>]`(最小收尾闭环:若存在 `.gitmodules` 则先按 `changes/<id>/submodules.targets` 顺序 push submodule,再 push 目标分支;默认优先遵循 upstream 配置;若 `change/<change-id>` 位于独立 worktree,且该 worktree 干净,则在 push 成功后自动执行 worktree cleanup;含 submodule 的 worktree 会因 Git 原生限制在 clean-check 后内部走 `git worktree remove --force`)
31
43
  - `aiws change new <change-id>`
32
44
  - `aiws change list`
33
45
  - `aiws change status <change-id>`
@@ -35,15 +47,17 @@ changes/
35
47
  - `aiws change validate <change-id>`
36
48
  - `aiws change sync <change-id>`
37
49
  - `aiws change archive <change-id>`
50
+ - `aiws change evidence <change-id>`(收敛 review / validate / collaboration summary 到 `changes/<id>/evidence/`)
38
51
 
39
52
  Active change(推荐,团队共享):
40
53
  - 使用分支名声明当前变更:`change/<change-id>`(也支持 `changes/`、`ws/`、`ws-change/`)
41
54
  - 切到该分支后,可省略 `<change-id>` 执行:`aiws change status|next|validate|sync|archive`
42
55
 
43
56
  计划质量门(推荐,执行前):
44
- - 先生成计划:`$ws-plan`
57
+ - 先生成计划:`$ws-plan`(若尚未进入 `change/<change-id>` 上下文,应先由它调用 `aiws change start <change-id>` 建立分支 / worktree,再在该上下文内写 `plan/...`)
45
58
  - 再执行计划质检:`$ws-plan-verify`
46
59
  - 最后进入实现:`$ws-dev`
60
+ - 若 `$ws-plan` 创建了独立 worktree,后续 `$ws-plan-verify` / `$ws-dev` / `$ws-finish` 都应优先在该 worktree 内继续
47
61
  - 目标:确保计划具备主索引绑定、步骤不过长、验证命令可复现且有预期结果
48
62
 
49
63
  模板覆盖(可选):
@@ -59,7 +73,10 @@ Active change(推荐,团队共享):
59
73
  - 若真值文件(`AI_PROJECT.md` / `AI_WORKSPACE.md` / `REQUIREMENTS.md`)在变更期间发生变化,严格校验/归档会要求先运行 `aiws change sync <change-id>` 确认基线。
60
74
 
61
75
  Hooks/CI(推荐,硬约束):
62
- - 工作区会安装 `.githooks/{pre-commit,pre-push}`(默认执行 `aiws validate .`)与门禁脚本(`tools/ws_change_check.py`、`tools/requirements_contract.py`)。
76
+ - 工作区会安装 `.githooks/{commit-msg,pre-commit,pre-push}`:
77
+ - `commit-msg`:默认提示优先使用中文 commit message;若执行 `git config aiws.commitMessagePolicy strict`,则会拒绝全英文首行(`Merge/Revert/fixup!/squash!` 例外)
78
+ - `pre-commit` / `pre-push`:默认执行 `aiws validate .`
79
+ - 还会安装门禁脚本(`tools/ws_change_check.py`、`tools/requirements_contract.py`)。
63
80
  - **启用 hooks 需要本地配置**(不会自动提交到 git):
64
81
  - 直接启用:`git config core.hooksPath .githooks`
65
82
  - 或使用:`aiws hooks install .`(等价)
@@ -69,4 +86,11 @@ Hooks/CI(推荐,硬约束):
69
86
  合并建议(减少人为 merge 引入新问题):
70
87
  - 优先使用 worktree + fast-forward 合并:
71
88
  - 完成后在主工作区(例如 `main`)执行:`aiws change finish <change-id>`(等价于 `git merge --ff-only change/<change-id>`)
89
+ - 若还要顺手 push 并清理独立 change worktree:`aiws change finish <change-id> --push`
72
90
  - 若失败:先在 worktree 里 `git rebase main`(或更新 main 后再 rebase),再重试 `--ff-only`
91
+
92
+ 协同交付建议:
93
+ - 委托分析先落到 `changes/<id>/analysis/`,由主 agent 在 `ws-review` 或 `review/*.md` 中收敛结论。
94
+ - patch 草案先落到 `changes/<id>/patches/`,未经审查不要直接应用。
95
+ - 交付前建议执行:`aiws change evidence <change-id>`,让 `delivery-summary` 与 `collaboration-summary` 一起落到 `changes/<id>/evidence/`。
96
+ - 归档后 `handoff.md` 会包含协同工件摘要,便于下一次会话继续接力。
@@ -45,6 +45,20 @@
45
45
 
46
46
  - <!-- WS:TODO 逐条写清要改什么(行为/接口/数据/配置);BREAKING 请标注 -->
47
47
 
48
+ ## 协同与委托(可选)
49
+
50
+ - `analysis/`:
51
+ - <!-- WS:TODO 如需委托分析,写明预计产物;例如 `changes/<change-id>/analysis/research-a.md` -->
52
+ - `patches/`:
53
+ - <!-- WS:TODO 如需外部 patch 草案,写明预计文件;例如 `changes/<change-id>/patches/fix-a.patch` -->
54
+ - `review/`:
55
+ - <!-- WS:TODO 如需多审查者,写明 reviewer 文件命名或汇总策略 -->
56
+
57
+ > 规则:
58
+ > - `analysis/` 产物默认只作为输入依据,不等于实现完成。
59
+ > - `patches/` 中的 patch 草案不自动应用,必须经主 agent 或人工审查。
60
+ > - 交付前建议把协同结果收敛到 `review/` 或 `evidence/`,并回填 `Evidence_Path`。
61
+
48
62
  ## 影响范围(Scope)
49
63
 
50
64
  ### In Scope(本次改动范围)
@@ -95,3 +109,4 @@
95
109
  - 证据落盘(推荐双层):
96
110
  - 持久(建议入库):`changes/<change-id>/evidence/...`(例如 validate 总结、review 总结、关键日志摘要)
97
111
  - 临时(可忽略入库):`.agentdocs/tmp/...`(例如 `aiws validate . --stamp` 的 JSON)
112
+ - 协同(按需):`changes/<change-id>/analysis/...`、`patches/...`、`review/...`
@@ -25,6 +25,12 @@
25
25
  - [ ] 2.1 <!-- WS:TODO -->
26
26
  - [ ] 2.2 <!-- WS:TODO -->
27
27
 
28
+ ## 2A. 协同(可选)
29
+
30
+ - [ ] 2A.1 若使用委托分析:把结果落盘到 `changes/{{CHANGE_ID}}/analysis/`
31
+ - [ ] 2A.2 若使用 patch 草案:把结果落盘到 `changes/{{CHANGE_ID}}/patches/`,并记录是否采用
32
+ - [ ] 2A.3 若存在多审查者:把审查结果落盘到 `changes/{{CHANGE_ID}}/review/`
33
+
28
34
  ## 3. 验证(必须可复现)
29
35
 
30
36
  - [ ] 3.1 <!-- WS:TODO 写具体命令(来自 AI_WORKSPACE.md) -->
@@ -33,5 +39,6 @@
33
39
  ## 4. 交付与归档
34
40
 
35
41
  - [ ] 4.1 证据落盘到 `.agentdocs/tmp/...`(报告/日志/请求响应等)
36
- - [ ] 4.2 交叉审计(可选但推荐):在 AI 工具内运行 `/ws-review`(或按 `AI_PROJECT.md` 手工审计)
37
- - [ ] 4.3 归档:`aiws change archive {{CHANGE_ID}}`
42
+ - [ ] 4.2 生成持久证据:`aiws change evidence {{CHANGE_ID}}`
43
+ - [ ] 4.3 交叉审计(可选但推荐):在 AI 工具内运行 `/ws-review`(或按 `AI_PROJECT.md` 手工审计)
44
+ - [ ] 4.4 归档:`aiws change archive {{CHANGE_ID}}`
@@ -17,6 +17,7 @@
17
17
  "REQUIREMENTS.md",
18
18
  ".gitignore",
19
19
  ".aiws/manifest.json",
20
+ ".githooks/commit-msg",
20
21
  ".githooks/pre-commit",
21
22
  ".githooks/pre-push",
22
23
  "changes/README.md",
@@ -63,6 +64,7 @@
63
64
  ".opencode/command/ws-finish.md",
64
65
  ".opencode/command/ws-submodule-setup.md",
65
66
  ".opencode/command/ws-review.md",
67
+ ".opencode/command/ws-delegate.md",
66
68
  ".opencode/command/ws-commit.md",
67
69
  ".opencode/command/ws-rule.md",
68
70
  ".opencode/command/ws-req-review.md",
@@ -120,10 +122,14 @@
120
122
  ".claude/commands/p-aiws-change-validate.md",
121
123
  ".claude/commands/p-aiws-hooks-install.md",
122
124
  ".claude/commands/p-aiws-hooks-status.md",
125
+ ".claude/commands/using-aiws.md",
123
126
  ".claude/commands/ws-plan.md",
124
127
  ".claude/commands/ws-plan-verify.md",
125
128
  ".claude/commands/ws-handoff.md",
126
129
  ".claude/commands/ws-bugfix.md",
130
+ ".claude/commands/ws-spec-review.md",
131
+ ".claude/commands/ws-quality-review.md",
132
+ ".claude/commands/ws-verify-before-complete.md",
127
133
  ".opencode/command/p-aiws-change-archive.md",
128
134
  ".opencode/command/p-aiws-change-finish.md",
129
135
  ".opencode/command/p-aiws-change-list.md",
@@ -137,14 +143,23 @@
137
143
  ".opencode/command/p-aiws-change-validate.md",
138
144
  ".opencode/command/p-aiws-hooks-install.md",
139
145
  ".opencode/command/p-aiws-hooks-status.md",
146
+ ".opencode/command/using-aiws.md",
140
147
  ".opencode/command/ws-plan.md",
148
+ ".opencode/command/ws-delegate.md",
141
149
  ".opencode/command/ws-plan-verify.md",
142
- ".opencode/command/ws-handoff.md"
150
+ ".opencode/command/ws-handoff.md",
151
+ ".opencode/command/ws-spec-review.md",
152
+ ".opencode/command/ws-quality-review.md",
153
+ ".opencode/command/ws-verify-before-complete.md",
154
+ ".claude/skills/**",
155
+ ".opencode/skills/**",
156
+ ".opencode/commands/**"
143
157
  ],
144
158
  "optional": [
145
159
  ".iflow/agents/**",
146
160
  "memory-bank/**",
147
161
  "secrets/test-accounts.example.json",
162
+ ".opencode/oh-my-opencode.json.example",
148
163
  "changes/templates/proposal.md",
149
164
  "changes/templates/tasks.md",
150
165
  "changes/templates/design.md",
@@ -212,6 +227,7 @@
212
227
  ],
213
228
  "replace_file": [
214
229
  ".aiws/manifest.json",
230
+ ".githooks/commit-msg",
215
231
  ".githooks/pre-commit",
216
232
  ".githooks/pre-push",
217
233
  "tools/ws_change_check.py",
@@ -224,6 +240,7 @@
224
240
  ".agents/skills/p-aiws-validate/SKILL.md",
225
241
  ".agents/skills/p-aiws-hooks-install/SKILL.md",
226
242
  ".agents/skills/p-aiws-hooks-status/SKILL.md",
243
+ ".agents/skills/using-aiws/SKILL.md",
227
244
  ".agents/skills/p-aiws-change-list/SKILL.md",
228
245
  ".agents/skills/p-aiws-change-new/SKILL.md",
229
246
  ".agents/skills/p-aiws-change-start/SKILL.md",
@@ -239,6 +256,8 @@
239
256
  ".agents/skills/ws-bugfix/SKILL.md",
240
257
  ".agents/skills/ws-commit/SKILL.md",
241
258
  ".agents/skills/ws-dev/SKILL.md",
259
+ ".agents/skills/ws-delegate/SKILL.md",
260
+ ".agents/skills/ws-frontend-design/SKILL.md",
242
261
  ".agents/skills/ws-deliver/SKILL.md",
243
262
  ".agents/skills/ws-finish/SKILL.md",
244
263
  ".agents/skills/ws-migrate/SKILL.md",
@@ -256,6 +275,9 @@
256
275
  ".agents/skills/ws-req-flow-sync/SKILL.md",
257
276
  ".agents/skills/ws-req-review/SKILL.md",
258
277
  ".agents/skills/ws-review/SKILL.md",
278
+ ".agents/skills/ws-spec-review/SKILL.md",
279
+ ".agents/skills/ws-quality-review/SKILL.md",
280
+ ".agents/skills/ws-verify-before-complete/SKILL.md",
259
281
  ".agents/skills/ws-rule/SKILL.md",
260
282
  ".opencode/command/ws-bugfix.md",
261
283
  ".iflow/commands/aiws-init.toml",
@@ -308,9 +330,13 @@
308
330
  ".claude/commands/p-aiws-change-validate.md",
309
331
  ".claude/commands/p-aiws-hooks-install.md",
310
332
  ".claude/commands/p-aiws-hooks-status.md",
333
+ ".claude/commands/using-aiws.md",
311
334
  ".claude/commands/ws-plan.md",
312
335
  ".claude/commands/ws-plan-verify.md",
313
336
  ".claude/commands/ws-bugfix.md",
337
+ ".claude/commands/ws-spec-review.md",
338
+ ".claude/commands/ws-quality-review.md",
339
+ ".claude/commands/ws-verify-before-complete.md",
314
340
  ".opencode/command/p-aiws-change-archive.md",
315
341
  ".opencode/command/p-aiws-change-finish.md",
316
342
  ".opencode/command/p-aiws-change-list.md",
@@ -324,8 +350,103 @@
324
350
  ".opencode/command/p-aiws-change-validate.md",
325
351
  ".opencode/command/p-aiws-hooks-install.md",
326
352
  ".opencode/command/p-aiws-hooks-status.md",
353
+ ".opencode/command/using-aiws.md",
327
354
  ".opencode/command/ws-plan.md",
328
- ".opencode/command/ws-plan-verify.md"
355
+ ".opencode/command/ws-delegate.md",
356
+ ".opencode/command/ws-plan-verify.md",
357
+ ".opencode/command/ws-spec-review.md",
358
+ ".opencode/command/ws-quality-review.md",
359
+ ".opencode/command/ws-verify-before-complete.md",
360
+ ".claude/skills/p-aiws-change-archive/SKILL.md",
361
+ ".opencode/skills/p-aiws-change-archive/SKILL.md",
362
+ ".claude/skills/p-aiws-change-finish/SKILL.md",
363
+ ".opencode/skills/p-aiws-change-finish/SKILL.md",
364
+ ".claude/skills/p-aiws-change-list/SKILL.md",
365
+ ".opencode/skills/p-aiws-change-list/SKILL.md",
366
+ ".claude/skills/p-aiws-change-new/SKILL.md",
367
+ ".opencode/skills/p-aiws-change-new/SKILL.md",
368
+ ".claude/skills/p-aiws-change-next/SKILL.md",
369
+ ".opencode/skills/p-aiws-change-next/SKILL.md",
370
+ ".claude/skills/p-aiws-change-start/SKILL.md",
371
+ ".opencode/skills/p-aiws-change-start/SKILL.md",
372
+ ".claude/skills/p-aiws-change-status/SKILL.md",
373
+ ".opencode/skills/p-aiws-change-status/SKILL.md",
374
+ ".claude/skills/p-aiws-change-sync/SKILL.md",
375
+ ".opencode/skills/p-aiws-change-sync/SKILL.md",
376
+ ".claude/skills/p-aiws-change-templates-init/SKILL.md",
377
+ ".opencode/skills/p-aiws-change-templates-init/SKILL.md",
378
+ ".claude/skills/p-aiws-change-templates-which/SKILL.md",
379
+ ".opencode/skills/p-aiws-change-templates-which/SKILL.md",
380
+ ".claude/skills/p-aiws-change-validate/SKILL.md",
381
+ ".opencode/skills/p-aiws-change-validate/SKILL.md",
382
+ ".claude/skills/p-aiws-hooks-install/SKILL.md",
383
+ ".opencode/skills/p-aiws-hooks-install/SKILL.md",
384
+ ".claude/skills/p-aiws-hooks-status/SKILL.md",
385
+ ".opencode/skills/p-aiws-hooks-status/SKILL.md",
386
+ ".claude/skills/using-aiws/SKILL.md",
387
+ ".opencode/skills/using-aiws/SKILL.md",
388
+ ".claude/skills/p-aiws-init/SKILL.md",
389
+ ".opencode/skills/p-aiws-init/SKILL.md",
390
+ ".claude/skills/p-aiws-rollback/SKILL.md",
391
+ ".opencode/skills/p-aiws-rollback/SKILL.md",
392
+ ".claude/skills/p-aiws-update/SKILL.md",
393
+ ".opencode/skills/p-aiws-update/SKILL.md",
394
+ ".claude/skills/p-aiws-validate/SKILL.md",
395
+ ".opencode/skills/p-aiws-validate/SKILL.md",
396
+ ".claude/skills/p-tasks-plan/SKILL.md",
397
+ ".opencode/skills/p-tasks-plan/SKILL.md",
398
+ ".claude/skills/ws-analyze/SKILL.md",
399
+ ".opencode/skills/ws-analyze/SKILL.md",
400
+ ".claude/skills/ws-bugfix/SKILL.md",
401
+ ".opencode/skills/ws-bugfix/SKILL.md",
402
+ ".claude/skills/ws-commit/SKILL.md",
403
+ ".opencode/skills/ws-commit/SKILL.md",
404
+ ".claude/skills/ws-deliver/SKILL.md",
405
+ ".opencode/skills/ws-deliver/SKILL.md",
406
+ ".claude/skills/ws-dev/SKILL.md",
407
+ ".opencode/skills/ws-dev/SKILL.md",
408
+ ".opencode/skills/ws-delegate/SKILL.md",
409
+ ".opencode/oh-my-opencode.json.example",
410
+ ".claude/skills/ws-finish/SKILL.md",
411
+ ".opencode/skills/ws-finish/SKILL.md",
412
+ ".claude/skills/ws-frontend-design/SKILL.md",
413
+ ".opencode/skills/ws-frontend-design/SKILL.md",
414
+ ".claude/skills/ws-handoff/SKILL.md",
415
+ ".opencode/skills/ws-handoff/SKILL.md",
416
+ ".claude/skills/ws-migrate/SKILL.md",
417
+ ".opencode/skills/ws-migrate/SKILL.md",
418
+ ".claude/skills/ws-plan/SKILL.md",
419
+ ".opencode/skills/ws-plan/SKILL.md",
420
+ ".claude/skills/ws-plan-verify/SKILL.md",
421
+ ".opencode/skills/ws-plan-verify/SKILL.md",
422
+ ".claude/skills/ws-preflight/SKILL.md",
423
+ ".opencode/skills/ws-preflight/SKILL.md",
424
+ ".claude/skills/ws-pull/SKILL.md",
425
+ ".opencode/skills/ws-pull/SKILL.md",
426
+ ".claude/skills/ws-push/SKILL.md",
427
+ ".opencode/skills/ws-push/SKILL.md",
428
+ ".claude/skills/ws-req-change/SKILL.md",
429
+ ".opencode/skills/ws-req-change/SKILL.md",
430
+ ".claude/skills/ws-req-contract-sync/SKILL.md",
431
+ ".opencode/skills/ws-req-contract-sync/SKILL.md",
432
+ ".claude/skills/ws-req-contract-validate/SKILL.md",
433
+ ".opencode/skills/ws-req-contract-validate/SKILL.md",
434
+ ".claude/skills/ws-req-flow-sync/SKILL.md",
435
+ ".opencode/skills/ws-req-flow-sync/SKILL.md",
436
+ ".claude/skills/ws-req-review/SKILL.md",
437
+ ".opencode/skills/ws-req-review/SKILL.md",
438
+ ".claude/skills/ws-review/SKILL.md",
439
+ ".opencode/skills/ws-review/SKILL.md",
440
+ ".claude/skills/ws-spec-review/SKILL.md",
441
+ ".opencode/skills/ws-spec-review/SKILL.md",
442
+ ".claude/skills/ws-quality-review/SKILL.md",
443
+ ".opencode/skills/ws-quality-review/SKILL.md",
444
+ ".claude/skills/ws-verify-before-complete/SKILL.md",
445
+ ".opencode/skills/ws-verify-before-complete/SKILL.md",
446
+ ".claude/skills/ws-rule/SKILL.md",
447
+ ".opencode/skills/ws-rule/SKILL.md",
448
+ ".claude/skills/ws-submodule-setup/SKILL.md",
449
+ ".opencode/skills/ws-submodule-setup/SKILL.md"
329
450
  ],
330
451
  "managed_blocks": {
331
452
  "AGENTS.md": [
@@ -511,6 +632,9 @@
511
632
  ".claude/commands/p-aiws-hooks-status.md": [
512
633
  "claude:aiws-hooks-status"
513
634
  ],
635
+ ".claude/commands/using-aiws.md": [
636
+ "claude:using-aiws"
637
+ ],
514
638
  ".claude/commands/ws-plan.md": [
515
639
  "claude:ws-plan"
516
640
  ],
@@ -523,6 +647,15 @@
523
647
  ".claude/commands/ws-bugfix.md": [
524
648
  "claude:ws-bugfix"
525
649
  ],
650
+ ".claude/commands/ws-spec-review.md": [
651
+ "claude:ws-spec-review"
652
+ ],
653
+ ".claude/commands/ws-quality-review.md": [
654
+ "claude:ws-quality-review"
655
+ ],
656
+ ".claude/commands/ws-verify-before-complete.md": [
657
+ "claude:ws-verify-before-complete"
658
+ ],
526
659
  ".opencode/command/p-aiws-change-archive.md": [
527
660
  "opencode:aiws-change-archive"
528
661
  ],
@@ -562,14 +695,158 @@
562
695
  ".opencode/command/p-aiws-hooks-status.md": [
563
696
  "opencode:aiws-hooks-status"
564
697
  ],
698
+ ".opencode/command/using-aiws.md": [
699
+ "opencode:using-aiws"
700
+ ],
565
701
  ".opencode/command/ws-plan.md": [
566
702
  "opencode:ws-plan"
567
703
  ],
704
+ ".opencode/command/ws-delegate.md": [
705
+ "opencode:ws-delegate"
706
+ ],
568
707
  ".opencode/command/ws-plan-verify.md": [
569
708
  "opencode:ws-plan-verify"
570
709
  ],
571
710
  ".opencode/command/ws-handoff.md": [
572
711
  "opencode:ws-handoff"
712
+ ],
713
+ ".opencode/command/ws-spec-review.md": [
714
+ "opencode:ws-spec-review"
715
+ ],
716
+ ".opencode/command/ws-quality-review.md": [
717
+ "opencode:ws-quality-review"
718
+ ],
719
+ ".opencode/command/ws-verify-before-complete.md": [
720
+ "opencode:ws-verify-before-complete"
721
+ ],
722
+ ".opencode/commands/p-aiws-change-archive.md": [
723
+ "opencode:aiws-change-archive"
724
+ ],
725
+ ".opencode/commands/p-aiws-change-finish.md": [
726
+ "opencode:aiws-change-finish"
727
+ ],
728
+ ".opencode/commands/p-aiws-change-list.md": [
729
+ "opencode:aiws-change-list"
730
+ ],
731
+ ".opencode/commands/p-aiws-change-new.md": [
732
+ "opencode:aiws-change-new"
733
+ ],
734
+ ".opencode/commands/p-aiws-change-next.md": [
735
+ "opencode:aiws-change-next"
736
+ ],
737
+ ".opencode/commands/p-aiws-change-start.md": [
738
+ "opencode:aiws-change-start"
739
+ ],
740
+ ".opencode/commands/p-aiws-change-status.md": [
741
+ "opencode:aiws-change-status"
742
+ ],
743
+ ".opencode/commands/p-aiws-change-sync.md": [
744
+ "opencode:aiws-change-sync"
745
+ ],
746
+ ".opencode/commands/p-aiws-change-templates-init.md": [
747
+ "opencode:aiws-change-templates-init"
748
+ ],
749
+ ".opencode/commands/p-aiws-change-templates-which.md": [
750
+ "opencode:aiws-change-templates-which"
751
+ ],
752
+ ".opencode/commands/p-aiws-change-validate.md": [
753
+ "opencode:aiws-change-validate"
754
+ ],
755
+ ".opencode/commands/p-aiws-hooks-install.md": [
756
+ "opencode:aiws-hooks-install"
757
+ ],
758
+ ".opencode/commands/p-aiws-hooks-status.md": [
759
+ "opencode:aiws-hooks-status"
760
+ ],
761
+ ".opencode/commands/using-aiws.md": [
762
+ "opencode:using-aiws"
763
+ ],
764
+ ".opencode/commands/p-aiws-init.md": [
765
+ "opencode:aiws-init"
766
+ ],
767
+ ".opencode/commands/p-aiws-rollback.md": [
768
+ "opencode:aiws-rollback"
769
+ ],
770
+ ".opencode/commands/p-aiws-update.md": [
771
+ "opencode:aiws-update"
772
+ ],
773
+ ".opencode/commands/p-aiws-validate.md": [
774
+ "opencode:aiws-validate"
775
+ ],
776
+ ".opencode/commands/ws-analyze.md": [
777
+ "opencode:ws-analyze"
778
+ ],
779
+ ".opencode/commands/ws-bugfix.md": [
780
+ "opencode:ws-bugfix"
781
+ ],
782
+ ".opencode/commands/ws-commit.md": [
783
+ "opencode:ws-commit"
784
+ ],
785
+ ".opencode/commands/ws-deliver.md": [
786
+ "opencode:ws-deliver"
787
+ ],
788
+ ".opencode/commands/ws-dev.md": [
789
+ "opencode:ws-dev"
790
+ ],
791
+ ".opencode/commands/ws-finish.md": [
792
+ "opencode:ws-finish"
793
+ ],
794
+ ".opencode/commands/ws-handoff.md": [
795
+ "opencode:ws-handoff"
796
+ ],
797
+ ".opencode/commands/ws-spec-review.md": [
798
+ "opencode:ws-spec-review"
799
+ ],
800
+ ".opencode/commands/ws-quality-review.md": [
801
+ "opencode:ws-quality-review"
802
+ ],
803
+ ".opencode/commands/ws-verify-before-complete.md": [
804
+ "opencode:ws-verify-before-complete"
805
+ ],
806
+ ".opencode/commands/ws-migrate.md": [
807
+ "opencode:ws-migrate"
808
+ ],
809
+ ".opencode/commands/ws-plan-verify.md": [
810
+ "opencode:ws-plan-verify"
811
+ ],
812
+ ".opencode/commands/ws-plan.md": [
813
+ "opencode:ws-plan"
814
+ ],
815
+ ".opencode/commands/ws-delegate.md": [
816
+ "opencode:ws-delegate"
817
+ ],
818
+ ".opencode/commands/ws-preflight.md": [
819
+ "opencode:ws-preflight"
820
+ ],
821
+ ".opencode/commands/ws-pull.md": [
822
+ "opencode:ws-pull"
823
+ ],
824
+ ".opencode/commands/ws-push.md": [
825
+ "opencode:ws-push"
826
+ ],
827
+ ".opencode/commands/ws-req-change.md": [
828
+ "opencode:ws-req-change"
829
+ ],
830
+ ".opencode/commands/ws-req-contract-sync.md": [
831
+ "opencode:ws-req-contract-sync"
832
+ ],
833
+ ".opencode/commands/ws-req-contract-validate.md": [
834
+ "opencode:ws-req-contract-validate"
835
+ ],
836
+ ".opencode/commands/ws-req-flow-sync.md": [
837
+ "opencode:ws-req-flow-sync"
838
+ ],
839
+ ".opencode/commands/ws-req-review.md": [
840
+ "opencode:ws-req-review"
841
+ ],
842
+ ".opencode/commands/ws-review.md": [
843
+ "opencode:ws-review"
844
+ ],
845
+ ".opencode/commands/ws-rule.md": [
846
+ "opencode:ws-rule"
847
+ ],
848
+ ".opencode/commands/ws-submodule-setup.md": [
849
+ "opencode:ws-submodule-setup"
573
850
  ]
574
851
  }
575
852
  }