universal-dev-standards 5.5.0 → 5.7.0

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 (123) hide show
  1. package/bundled/ai/options/testing/integration-testing.ai.yaml +2 -2
  2. package/bundled/ai/options/testing/unit-testing.ai.yaml +2 -2
  3. package/bundled/ai/standards/agent-communication-protocol.ai.yaml +8 -9
  4. package/bundled/ai/standards/agent-dispatch.ai.yaml +8 -9
  5. package/bundled/ai/standards/branch-completion.ai.yaml +8 -10
  6. package/bundled/ai/standards/browser-compatibility-standards.ai.yaml +63 -0
  7. package/bundled/ai/standards/capability-declaration.ai.yaml +4 -4
  8. package/bundled/ai/standards/change-batching-standards.ai.yaml +8 -10
  9. package/bundled/ai/standards/circuit-breaker.ai.yaml +7 -7
  10. package/bundled/ai/standards/contract-testing-standards.ai.yaml +62 -0
  11. package/bundled/ai/standards/cross-flow-regression.ai.yaml +61 -0
  12. package/bundled/ai/standards/disaster-recovery-drill.ai.yaml +1 -1
  13. package/bundled/ai/standards/dual-phase-output.ai.yaml +3 -3
  14. package/bundled/ai/standards/execution-history.ai.yaml +8 -10
  15. package/bundled/ai/standards/failure-source-taxonomy.ai.yaml +8 -10
  16. package/bundled/ai/standards/full-coverage-testing.ai.yaml +192 -0
  17. package/bundled/ai/standards/git-worktree.ai.yaml +1 -1
  18. package/bundled/ai/standards/governance-layer.ai.yaml +114 -0
  19. package/bundled/ai/standards/mock-boundary.ai.yaml +1 -1
  20. package/bundled/ai/standards/model-selection.ai.yaml +1 -1
  21. package/bundled/ai/standards/packaging-standards.ai.yaml +8 -8
  22. package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +8 -9
  23. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +4 -0
  24. package/bundled/ai/standards/recovery-recipe-registry.ai.yaml +6 -10
  25. package/bundled/ai/standards/release-readiness-gate.ai.yaml +77 -0
  26. package/bundled/ai/standards/security-decision.ai.yaml +3 -3
  27. package/bundled/ai/standards/server-ops-security.ai.yaml +1 -1
  28. package/bundled/ai/standards/standard-admission-criteria.ai.yaml +1 -1
  29. package/bundled/ai/standards/standard-lifecycle-management.ai.yaml +1 -1
  30. package/bundled/ai/standards/supply-chain-attestation.ai.yaml +1 -1
  31. package/bundled/ai/standards/testing.ai.yaml +20 -13
  32. package/bundled/ai/standards/token-budget.ai.yaml +3 -3
  33. package/bundled/ai/standards/workflow-enforcement.ai.yaml +8 -11
  34. package/bundled/ai/standards/workflow-state-protocol.ai.yaml +8 -10
  35. package/bundled/core/accessibility-standards.md +58 -0
  36. package/bundled/core/adversarial-test.md +1 -1
  37. package/bundled/core/agent-behavior-discipline.md +4 -4
  38. package/bundled/core/agent-communication-protocol.md +5 -5
  39. package/bundled/core/branch-completion.md +4 -0
  40. package/bundled/core/browser-compatibility-standards.md +220 -0
  41. package/bundled/core/checkin-standards.md +1 -0
  42. package/bundled/core/circuit-breaker.md +4 -4
  43. package/bundled/core/container-security.md +8 -8
  44. package/bundled/core/contract-testing-standards.md +182 -0
  45. package/bundled/core/cross-flow-regression.md +190 -0
  46. package/bundled/core/disaster-recovery-drill.md +3 -3
  47. package/bundled/core/dual-phase-output.md +1 -1
  48. package/bundled/core/failure-source-taxonomy.md +3 -3
  49. package/bundled/core/flow-based-testing.md +135 -2
  50. package/bundled/core/full-coverage-testing.md +183 -0
  51. package/bundled/core/git-worktree.md +1 -1
  52. package/bundled/core/governance-layer.md +151 -0
  53. package/bundled/core/llm-output-validation.md +2 -2
  54. package/bundled/core/mock-boundary.md +1 -1
  55. package/bundled/core/packaging-standards.md +14 -14
  56. package/bundled/core/performance-standards.md +65 -0
  57. package/bundled/core/policy-as-code-testing.md +9 -9
  58. package/bundled/core/recovery-recipe-registry.md +2 -2
  59. package/bundled/core/release-quality-manifest.md +58 -12
  60. package/bundled/core/release-readiness-gate.md +184 -0
  61. package/bundled/core/sast-advanced.md +5 -5
  62. package/bundled/core/secure-op.md +5 -5
  63. package/bundled/core/security-decision.md +1 -1
  64. package/bundled/core/server-ops-security.md +15 -15
  65. package/bundled/core/smoke-test.md +1 -1
  66. package/bundled/core/standard-admission-criteria.md +1 -1
  67. package/bundled/core/standard-lifecycle-management.md +1 -1
  68. package/bundled/core/supply-chain-attestation.md +4 -4
  69. package/bundled/core/token-budget.md +3 -3
  70. package/bundled/locales/zh-CN/CHANGELOG.md +51 -4
  71. package/bundled/locales/zh-CN/README.md +11 -27
  72. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +5 -5
  73. package/bundled/locales/zh-CN/core/circuit-breaker.md +1 -1
  74. package/bundled/locales/zh-CN/core/git-worktree.md +1 -1
  75. package/bundled/locales/zh-CN/core/packaging-standards.md +14 -14
  76. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +6 -9
  77. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +1 -1
  78. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +1 -1
  79. package/bundled/locales/zh-CN/core/token-budget.md +1 -1
  80. package/bundled/locales/zh-TW/CHANGELOG.md +51 -4
  81. package/bundled/locales/zh-TW/README.md +11 -27
  82. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +5 -5
  83. package/bundled/locales/zh-TW/core/browser-compatibility-standards.md +11 -0
  84. package/bundled/locales/zh-TW/core/capability-declaration.md +4 -4
  85. package/bundled/locales/zh-TW/core/circuit-breaker.md +7 -7
  86. package/bundled/locales/zh-TW/core/contract-testing-standards.md +11 -0
  87. package/bundled/locales/zh-TW/core/cross-flow-regression.md +11 -0
  88. package/bundled/locales/zh-TW/core/dual-phase-output.md +3 -3
  89. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +7 -9
  90. package/bundled/locales/zh-TW/core/governance-layer.md +159 -0
  91. package/bundled/locales/zh-TW/core/packaging-standards.md +14 -14
  92. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +6 -9
  93. package/bundled/locales/zh-TW/core/release-readiness-gate.md +11 -0
  94. package/bundled/locales/zh-TW/core/security-decision.md +3 -3
  95. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +1 -1
  96. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +1 -1
  97. package/bundled/locales/zh-TW/core/token-budget.md +3 -3
  98. package/bundled/skills/README.md +23 -0
  99. package/bundled/skills/atdd-assistant/SKILL.md +4 -5
  100. package/bundled/skills/bdd-assistant/SKILL.md +4 -5
  101. package/bundled/skills/checkin-assistant/SKILL.md +4 -6
  102. package/bundled/skills/code-review-assistant/SKILL.md +4 -5
  103. package/bundled/skills/commands/observability.md +42 -0
  104. package/bundled/skills/commands/runbook.md +44 -0
  105. package/bundled/skills/commands/slo.md +45 -0
  106. package/bundled/skills/journey-test-assistant/SKILL.md +1 -1
  107. package/bundled/skills/orchestrate/SKILL.md +1 -1
  108. package/bundled/skills/plan/SKILL.md +1 -1
  109. package/bundled/skills/pr-automation-assistant/SKILL.md +4 -5
  110. package/bundled/skills/push/SKILL.md +1 -1
  111. package/bundled/skills/spec-driven-dev/SKILL.md +4 -5
  112. package/bundled/skills/sweep/SKILL.md +3 -3
  113. package/bundled/skills/tdd-assistant/SKILL.md +4 -5
  114. package/package.json +6 -6
  115. package/src/commands/check.js +43 -0
  116. package/src/commands/flow.js +7 -5
  117. package/src/commands/init.js +2 -1
  118. package/src/commands/start.js +7 -6
  119. package/src/commands/sweep.js +7 -6
  120. package/src/commands/update.js +10 -0
  121. package/src/commands/workflow.js +7 -6
  122. package/src/core/agent-communication-protocol.js +10 -3
  123. package/standards-registry.json +107 -51
@@ -14,7 +14,7 @@ status: current
14
14
 
15
15
  > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
16
16
 
17
- **版本**: 5.5.0 | **发布日期**: 2026-04-13 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
17
+ **版本**: 5.7.0 | **发布日期**: 2026-04-13 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
18
18
 
19
19
  语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流,确保不同技术栈之间的一致性、质量和可维护性。
20
20
 
@@ -106,12 +106,18 @@ graph TD
106
106
  | :--- | :--- | :---: | :---: | :--- |
107
107
  | **Claude Code** | ✅ 完整支持 | **29** | **33** | `CLAUDE.md` |
108
108
  | **OpenCode** | ✅ 完整支持 | **29** | **33** | `AGENTS.md` |
109
- | **Gemini CLI** | 🧪 预览版 | **18+** | **20+** | `GEMINI.md` |
110
109
  | **Cursor** | ✅ 完整支持 | **核心** | **模拟支持** | `.cursorrules` |
111
- | **Cline / Roo Code**| 🔶 部分支持 | **核心** | **工作流** | `.clinerules` |
112
- | **Windsurf** | 🔶 部分支持 | | **规则书** | `.windsurfrules` |
110
+ | **Roo Code** | 完整支持 | **核心** | **工作流** | `.roo/rules/` |
111
+ | **Gemini CLI** | 🧪 预览版 | **18+** | **20+** | `GEMINI.md` |
112
+ | **Cline** | 🔶 部分支持 | **核心** | **工作流** | `.clinerules` |
113
+ | **Windsurf** | 🔶 部分支持 | **核心** | **规则书** | `.windsurfrules` |
114
+ | **GitHub Copilot** | 🔶 部分支持 | **核心** | **提示词** | `.github/copilot-instructions.md` |
115
+ | **OpenAI Codex** | 🔶 部分支持 | **核心** | — | `AGENTS.md` |
116
+ | **Aider** | 🔶 部分支持 | — | — | `AGENTS.md` |
117
+ | **Continue** | 🔶 部分支持 | — | — | `.continue/config.json` |
118
+ | **Google Antigravity** | ⚠️ 最低限度 | — | — | `.antigravity/rules.md` |
113
119
 
114
- > **状态图例**:✅ 完整支持 | 🧪 预览版 | 🔶 部分支持 | ⏳ 计划中
120
+ > **状态图例**:✅ 完整支持 | 🧪 预览版 | 🔶 部分支持 | ⚠️ 最低限度 | ⏳ 计划中
115
121
 
116
122
  ---
117
123
 
@@ -153,28 +159,6 @@ uds uninstall # 从项目移除标准
153
159
 
154
160
  ---
155
161
 
156
- ## 🌐 生态系统
157
-
158
- UDS 是 AsiaOstrich 三层产品架构中的**标准定义层**:
159
-
160
- ```
161
- UDS(定义什么) → DevAP(代理如何执行) → VibeOps(完整生命周期)
162
- ```
163
-
164
- | 层级 | 产品 | 角色 | 授权 |
165
- |------|------|------|------|
166
- | 标准 | **UDS** | 开发方法论框架 | MIT + CC BY 4.0 |
167
- | 编排 | [DevAP](https://github.com/AsiaOstrich/dev-autopilot) | 代理无关的编排引擎 | MIT |
168
- | 生命周期 | [VibeOps](https://github.com/AsiaOstrich/vibeops360) | AI 驱动的软件工厂 | AGPL-3.0-only |
169
-
170
- - **UDS** 定义开发标准 → 供 DevAP(质量 Gate)和 VibeOps(代理管线)使用
171
- - **DevAP** 使用 UDS 标准编排 AI 代理 → VibeOps 是其消费者之一
172
- - **VibeOps** 提供完整软件生命周期 → 通过 `uds init` 集成 UDS(一次复制)
173
-
174
- UDS 保持**工具无关性**:支持 Claude Code、OpenCode、Gemini CLI、Cursor、Cline 和 Windsurf。DevAP 和 VibeOps 是消费者,并非必要依赖。
175
-
176
- ---
177
-
178
162
  ## 📄 授权
179
163
 
180
164
  | 组件 | 授权 |
@@ -12,7 +12,7 @@ status: current
12
12
 
13
13
  **版本**: 1.0.0
14
14
  **最后更新**: 2026-03-30
15
- **适用性**: 跨项目 AI Agent 编排(UDS / DevAP / VibeOps)
15
+ **适用性**: 跨采用层 AI Agent 编排(任意 Adapter / Pipeline / Agent runtime 消费 UDS 标准)
16
16
  **范围**: 通用 (Universal)
17
17
  **相关标准**: [代理派遣](./agent-dispatch.md)、[AI 模型选择策略](./model-selection.md)
18
18
  **规格**: [SPEC-AGENT-COMM-001](../../../docs/specs/SPEC-AGENT-COMM-001-agent-communication-protocol.md)
@@ -60,12 +60,12 @@ status: current
60
60
  | `timeout` | 任务超时 |
61
61
  | `unknown` | 无法识别的状态(降级) |
62
62
 
63
- ### 1.2 跨项目映射
63
+ ### 1.2 跨采用层映射
64
64
 
65
- 跨项目状态码映射表:
65
+ 跨采用层状态码对映表(informative example,采用层自订自己的对映):
66
66
 
67
- | 统一状态 | UDS | DevAP | VibeOps |
68
- |----------|-----|-------|---------|
67
+ | 统一状态 | UDS | Adapter Example A | Adapter Example B |
68
+ |----------|-----|-------------------|-------------------|
69
69
  | `success` | DONE | success | success |
70
70
  | `success_partial` | DONE_WITH_CONCERNS | done_with_concerns | partial |
71
71
  | `failed` | — | failed | failure |
@@ -22,7 +22,7 @@ status: current
22
22
 
23
23
  通用断路器标准:三态状态机(CLOSED/HALF_OPEN/OPEN)、阈值配置、与遥测整合。
24
24
 
25
- 各模块各自实现断路器导致行为不一致(阈值不同、HALF_OPEN 探针逻辑各异、遥测事件命名混乱)。本标准提供统一的状态机定义、配置键名,以及必须上报的遥测事件,确保 DevAP/VibeOps/telemetry 三端可互相理解断路器状态。
25
+ 各模块各自实现断路器导致行为不一致(阈值不同、HALF_OPEN 探针逻辑各异、遥测事件命名混乱)。本标准提供统一的状态机定义、配置键名,以及必须上报的遥测事件,确保 采用层(pipeline / agent / telemetry)可互相理解断路器状态。
26
26
 
27
27
  ---
28
28
 
@@ -46,7 +46,7 @@ status: current
46
46
 
47
47
  1. **选择 worktree 位置** — 优先顺序:
48
48
  - 已配置的路径
49
- - `.devap/worktrees/` 或类似项目本地目录
49
+ - `.uds/worktrees/` 或类似项目本地目录
50
50
  - 询问用户
51
51
  2. **验证 `.gitignore`** — 运行 `git check-ignore` 确认 worktree 目录被忽略
52
52
  3. **创建 worktree** — `git worktree add <path> -b <branch-name>`
@@ -12,19 +12,19 @@ status: current
12
12
 
13
13
  **版本**: 1.0.0
14
14
  **最后更新**: 2026-04-15
15
- **适用性**: 使用 UDS/DevAP 工具链的项目
15
+ **适用性**: 使用 UDS-aware 工具链的项目
16
16
  **范围**: 通用 (Universal)
17
17
 
18
18
  ---
19
19
 
20
20
  ## 目的
21
21
 
22
- 本标准定义一套基于 Recipe 的打包框架,让用户项目可在 `.devap/packaging.yaml` 中声明打包目标(target)。UDS 负责提供 Recipe 定义与内置 Recipe 库;DevAP 则在 pipeline 中执行编排。
22
+ 本标准定义一套基于 Recipe 的打包框架,让用户项目可在 專案 packaging 配置(路徑由採用層決定) 中声明打包目标(target)。UDS 负责提供 Recipe 定义与内置 Recipe 库;采用层 runtime pipeline 中执行编排。
23
23
 
24
24
  框架的关注点分离如下:
25
25
  - **用户项目**:声明「打包什么」(targets + 配置覆盖)
26
26
  - **UDS**:定义「如何打包」(Recipe 结构 + 内置 Recipes)
27
- - **DevAP**:执行「何时打包」(在 Review 与 Deploy 之间的 pipeline 阶段)
27
+ - **采用层 pipeline**:执行「何时打包」(在 Review 与 Deploy 之间的 pipeline 阶段)
28
28
 
29
29
  ---
30
30
 
@@ -33,9 +33,9 @@ status: current
33
33
  | 原则 | 说明 |
34
34
  |------|------|
35
35
  | **Recipe-based** | 每个打包目标都参照一个具名 Recipe;不在 pipeline YAML 中编写临时脚本 |
36
- | **声明式 targets** | 项目在 `.devap/packaging.yaml` 中声明 targets;DevAP 负责解析与执行 |
36
+ | **声明式 targets** | 项目在 專案 packaging 配置(路徑由採用層決定) 中声明 targets;采用层 runtime 负责解析与执行 |
37
37
  | **可定制** | 四个定制层允许配置覆盖、Hook 注入、自定义 Recipe 及 Escape Hatch |
38
- | **整合至 Pipeline** | 打包作为独立阶段运行于 VibeOps pipeline 的 Review 与 Deploy 之间 |
38
+ | **整合至 Pipeline** | 打包作为独立阶段运行于 採用層 pipeline 的 Review 与 Deploy 之间 |
39
39
 
40
40
  ---
41
41
 
@@ -119,15 +119,15 @@ UDS 随附四个内置 Recipe,位于 `recipes/` 目录:
119
119
 
120
120
  | 层级 | 机制 | 使用时机 |
121
121
  |------|------|----------|
122
- | **L1 — 配置覆盖** | `.devap/packaging.yaml` 中的 `config:` 块 | 更改默认值(registry URL、tag、输出目录)|
123
- | **L2 — Hook 注入** | `.devap/packaging.yaml` 中的 `hooks:` 块 | 在构建或发布前后执行额外命令 |
124
- | **L3 — 自定义 Recipe** | 项目 `.devap/recipes/` 中的新 `.yaml` 文件 | 完全不同的构建流程;内置 Recipe 不适用 |
122
+ | **L1 — 配置覆盖** | 專案 packaging 配置(路徑由採用層決定) 中的 `config:` 块 | 更改默认值(registry URL、tag、输出目录)|
123
+ | **L2 — Hook 注入** | 專案 packaging 配置(路徑由採用層決定) 中的 `hooks:` 块 | 在构建或发布前后执行额外命令 |
124
+ | **L3 — 自定义 Recipe** | 项目 `.uds/recipes/` 中的新 `.yaml` 文件 | 完全不同的构建流程;内置 Recipe 不适用 |
125
125
  | **L4 — Escape Hatch** | target 定义中以 `script:` 替代 `recipe:` | 原始 shell 脚本,无合适的 Recipe 抽象 |
126
126
 
127
127
  ### L1 示例 — 配置覆盖
128
128
 
129
129
  ```yaml
130
- # .devap/packaging.yaml
130
+ # .uds/packaging.yaml
131
131
  targets:
132
132
  - name: publish-npm
133
133
  recipe: npm-library
@@ -140,7 +140,7 @@ targets:
140
140
  ### L2 示例 — Hook 注入
141
141
 
142
142
  ```yaml
143
- # .devap/packaging.yaml
143
+ # .uds/packaging.yaml
144
144
  targets:
145
145
  - name: docker-push
146
146
  recipe: docker-service
@@ -153,7 +153,7 @@ targets:
153
153
  ### L3 示例 — 自定义 Recipe
154
154
 
155
155
  ```yaml
156
- # .devap/recipes/electron-app.yaml
156
+ # .uds/recipes/electron-app.yaml
157
157
  name: electron-app
158
158
  description: 构建 Electron 桌面应用程序
159
159
  requires:
@@ -169,7 +169,7 @@ config:
169
169
  ### L4 示例 — Escape Hatch
170
170
 
171
171
  ```yaml
172
- # .devap/packaging.yaml
172
+ # .uds/packaging.yaml
173
173
  targets:
174
174
  - name: legacy-bundle
175
175
  script: |
@@ -187,9 +187,9 @@ targets:
187
187
  |------|------|------|
188
188
  | 所有 `requires` 文件存在 | 100% | 在任何步骤执行前检查 |
189
189
  | 所有步骤以 exit code 0 结束 | 100% | 任何非零 exit 使执行失败 |
190
- | `postBuild` 产出物存在 | 存在于预期路径 | 构建步骤后由 DevAP 验证 |
190
+ | `postBuild` 产出物存在 | 存在于预期路径 | 构建步骤后由采用层 runtime 验证 |
191
191
  | Hook 命令以 exit code 0 结束 | 100% | Hook 失败会传播为步骤失败 |
192
- | 已发布产出物可被取回 | HTTP 200 / registry 查询成功 | DevAP 在发布后进行 smoke check |
192
+ | 已发布产出物可被取回 | HTTP 200 / registry 查询成功 | 由采用层 runtime 在发布后进行 smoke check |
193
193
 
194
194
  ### 失败处理
195
195
 
@@ -133,14 +133,11 @@ fix_loop | circuit_breaker | rebase_and_retry | model_switch | degraded_mode | h
133
133
 
134
134
  ## 集成点
135
135
 
136
- ### DevAP
136
+ > 集成指引(informative;具体文件路径属于采用层自订范围)。
137
137
 
138
- - `packages/core/src/types.ts` — `RecoveryRecipe` / `RecoveryStrategy` type
139
- - `packages/core/src/recovery-registry.ts` — Registry 实现与默认 recipe
140
- - `packages/core/src/orchestrator.ts` — fix loop 前查询 Registry
138
+ ### 预期呼叫点
141
139
 
142
- ### VibeOps
143
-
144
- - `src/types/index.ts`独立定义 `RecoveryRecipe`(AGPL 隔离)
145
- - `src/runner/recovery-registry.ts`独立实现
146
- - `recovery-recipes.yaml` — 默认 recipe 配置
140
+ - 核心型别模块 — `RecoveryRecipe` / `RecoveryStrategy` type
141
+ - recovery-registry 模块 — Registry 实现与默认 recipe
142
+ - orchestrator 模块 fix loop 前查询 Registry
143
+ - recovery-recipes 配置档 默认 recipe 配置(档名由采用层决定)
@@ -66,7 +66,7 @@ status: current
66
66
 
67
67
  ### 4. AI-executable(AI 可消费)
68
68
 
69
- 至少一个 DevAP QualityGate / VibeOps Agent prompt / Skill 能消费:
69
+ 至少一个采用层组件(Quality Gate / Agent prompt / Skill / IDE rule)能消费:
70
70
 
71
71
  - 定义清楚的 guidelines(每条可验证)
72
72
  - 至少 2 个 Given-When-Then scenarios
@@ -85,7 +85,7 @@ Deprecated ──(迁移完成)────────→ Archived
85
85
 
86
86
  ## 情境示例
87
87
 
88
- - **情境 1 — Trial → Active**:`retry-standards` 处于 trial。2026-08-01 审视发现 DevAP Fix Loop VibeOps Builder 均采用且无重大缺陷 → 转 Active,`since=2026-08-01`,移除 `expires`
88
+ - **情境 1 — Trial → Active**:`retry-standards` 处于 trial。2026-08-01 审视发现多个采用层(Fix Loop / Builder Agent 等)均采用且无重大缺陷 → 转 Active,`since=2026-08-01`,移除 `expires`
89
89
  - **情境 2 — Trial 逾期自动 Archived**:某标准 trial 期限 2026-10-17 到期未通过验证 → 状态转 Archived,记录原因
90
90
  - **情境 3 — Deprecated 带迁移**:`legacy-retry-logic` 被 `retry-standards` 取代 → `status=deprecated, supersedes=retry-standards, migration_guide=docs/migrations/retry-v1-to-v2.md`;Skill 使用时显示警告
91
91
 
@@ -20,7 +20,7 @@ status: current
20
20
 
21
21
  ## 目的
22
22
 
23
- Token 阈值四区模型(SAFE/WARNING/DANGER/BLOCKING),统一 DevAP/VibeOps 的 token 用量管控行为。
23
+ Token 阈值四区模型(SAFE/WARNING/DANGER/BLOCKING),统一各采用层的 token 用量管控行为。
24
24
 
25
25
  各 Agent 对于「快用完 token 了」的处理方式各异(有的直接截断、有的无警告、有的在最后才通知)。本标准定义四个阈值区间,确保所有 Agent 在进入不同区间时采取一致的行为(警告、简化输出、阻塞)。
26
26
 
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  source: ../../CHANGELOG.md
3
- source_version: 5.5.0
4
- translation_version: 5.5.0
5
- last_synced: 2026-05-05
3
+ source_version: 5.7.0
4
+ translation_version: 5.7.0
5
+ last_synced: 2026-05-08
6
6
  status: current
7
7
  ---
8
8
 
@@ -17,6 +17,52 @@ status: current
17
17
 
18
18
  ## [Unreleased]
19
19
 
20
+ ## [5.7.0] - 2026-05-08
21
+
22
+ > **跨平台腳本遷移**(XSPEC-179 + XSPEC-180):bash 腳本逐步被單一來源的
23
+ > TypeScript / Node.js ESM 等價實作取代,可在 macOS / Linux / Windows 上以
24
+ > 相同方式執行。原 `.sh` 檔保留並加上 `DEPRECATED` 警告以維持向後相容。
25
+
26
+ ### 新增
27
+
28
+ - **AI 工具表格補全**(`README.md`、`locales/zh-TW/README.md`、`locales/zh-CN/README.md`):補上五個遺漏工具——GitHub Copilot、OpenAI Codex、Aider、Continue、Google Antigravity。新增 ⚠ Minimal 狀態圖例。(`1b588e1`)
29
+ - **`scripts/bump-version.mjs`**(XSPEC-179 Phase 1):跨平台版本升版實作,與原 `.sh` 對等。(`1a44e14`)
30
+ - **`scripts/install-hooks.mjs`**(XSPEC-179 Phase 1):跨平台 git hooks 安裝程式;於 Windows 自動跳過 `chmod`。(`1a44e14`)
31
+ - **`scripts/pre-commit.mjs`**(XSPEC-180):pre-commit hook 的 Node.js ESM 實作,平台分支於 Windows 呼叫 `check-translation-sync.ps1`,其他平台呼叫 `.sh`。(`1572869`)
32
+ - **7 個 TypeScript 檢查腳本**(XSPEC-179 Phase 2,`0a26d14`):從 bash 遷移至單一 TypeScript 來源,透過 `tsx` 執行:
33
+ - `scripts/check-ai-behavior-sync.ts`
34
+ - `scripts/check-commit-spec-reference.ts`
35
+ - `scripts/check-flow-gate-report.ts`
36
+ - `scripts/check-integration-commands-sync.ts`
37
+ - `scripts/check-registry-completeness.ts`
38
+ - `scripts/check-release-readiness-signoff.ts`
39
+ - `scripts/check-workflow-compliance.ts`
40
+ - **`tsx@^4.20.0`** 加入 root `devDependencies`(XSPEC-179 Phase 2,`0a26d14`)。
41
+ - **7 個 npm scripts** 串接 TypeScript 檢查腳本(`0a26d14`):`check:ai-behavior`、`check:commit-spec`、`check:flow-gate`、`check:integration-commands`、`check:registry`、`check:release-signoff`、`check:workflow-compliance`。
42
+
43
+ ### 變更
44
+
45
+ - **下游專案解耦**(6 批次,`ebe716c`–`2392c0f`):所有公開敘述中對特定下游產品(DevAP / VibeOps)的直接引用已替換為採用層中性術語,涵蓋 130+ 個檔案。UDS 重申為純 MIT + CC BY 4.0 標準庫,與任何特定採用層無依賴關係。
46
+ - **REGISTRY**:`roo-code` integration tier 從 `planned` 升為 `partial`;AI 工具表格中將 Roo Code 獨立成列(不再與 Cline 合併)。(`1b588e1`)
47
+ - **`.githooks/pre-commit`**(XSPEC-180,`1572869`):從 51 行 bash 縮減為 16 行 POSIX `sh` 薄殼層,將實際邏輯委派給 `scripts/pre-commit.mjs`。
48
+ - **`scripts/bump-version.mjs`**(`19ad314`):新增 `buildCmd()` 輔助函式,於 Windows 自動切換為 PowerShell + `.ps1` 來呼叫 `check-version-sync` / `check-translation-sync`,恢復 Windows 平台對等性。
49
+ - **XSPEC-179 Phase 2 策略修訂**(`0a26d14`):放棄先前的 `.sh` + `.ps1` 雙軌方案,改採**單一 TypeScript 來源**策略。單一 `.ts` 透過 `tsx` 在所有平台上行為一致,消除「只能在 Windows 驗證」的反饋落差。
50
+
51
+ ### 棄用
52
+
53
+ - **`scripts/bump-version.sh`**(`1a44e14`):標記為 DEPRECATED,由 `bump-version.mjs` 取代。
54
+ - **`scripts/install-hooks.sh`**(`1a44e14`):標記為 DEPRECATED,由 `install-hooks.mjs` 取代。
55
+ - **7 個 legacy `check-*.sh` 腳本**(`0a26d14`):對應的 `.ts` 版本(如上)已成為 canonical 實作。`.sh` 檔保留供 legacy Linux/macOS 環境使用,但不應再新增功能。
56
+
57
+ ### 移除
58
+
59
+ - **`.devap/` 目錄**(`2392c0f`):移除孤兒 DevAP dogfooding 安裝目錄。DevAP 已於 2026-04-28 退場(XSPEC-086/095);UDS 現使用原生 `flows/commit.flow.yaml` 與 `scripts/bump-version.mjs`。
60
+
61
+ ### 修復
62
+
63
+ - **`scripts/check-release-readiness-signoff.sh`**(`0a26d14`,於 TypeScript 移植時順帶修復的潛伏 bug):原本錯誤的 `grep -c "0\n0"` 樣式(永遠無法比對到字面 `\n`)已修正,現在能可靠偵測缺漏的 sign-off 訊號。
64
+ - **`scripts/check-integration-commands-sync.sh`**(`0a26d14`,於 TypeScript 移植時順帶修復的潛伏 bug):消除 `find` 與下游 consumer 之間 broken pipe 引發的 SIGPIPE 噪音。
65
+
20
66
  ## [5.3.2] - 2026-04-27
21
67
 
22
68
  > **修補版本發布**:Bug 修復 —— `uds update -y` 現在會自動安裝/更新 Skills 和 Commands,不再只顯示提示訊息。
@@ -865,7 +911,8 @@ status: current
865
911
  - 範本:需求文件範本
866
912
  - 整合:OpenSpec 框架
867
913
 
868
- [Unreleased]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v3.4.0...HEAD
914
+ [Unreleased]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v5.7.0...HEAD
915
+ [5.7.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v5.6.0...v5.7.0
869
916
  [3.4.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v3.3.0...v3.4.0
870
917
  [3.3.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v3.0.0...v3.3.0
871
918
  [3.0.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v2.3.0...v3.0.0
@@ -14,7 +14,7 @@ status: current
14
14
 
15
15
  > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
16
16
 
17
- **版本**: 5.5.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
17
+ **版本**: 5.7.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
18
18
 
19
19
  語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
20
20
 
@@ -106,12 +106,18 @@ graph TD
106
106
  | :--- | :--- | :---: | :---: | :--- |
107
107
  | **Claude Code** | ✅ 完整支援 | **29** | **33** | `CLAUDE.md` |
108
108
  | **OpenCode** | ✅ 完整支援 | **29** | **33** | `AGENTS.md` |
109
- | **Gemini CLI** | 🧪 預覽版 | **18+** | **20+** | `GEMINI.md` |
110
109
  | **Cursor** | ✅ 完整支援 | **核心** | **模擬支援** | `.cursorrules` |
111
- | **Cline / Roo Code**| 🔶 部分支援 | **核心** | **工作流** | `.clinerules` |
112
- | **Windsurf** | 🔶 部分支援 | | **規則書** | `.windsurfrules` |
110
+ | **Roo Code** | 完整支援 | **核心** | **工作流** | `.roo/rules/` |
111
+ | **Gemini CLI** | 🧪 預覽版 | **18+** | **20+** | `GEMINI.md` |
112
+ | **Cline** | 🔶 部分支援 | **核心** | **工作流** | `.clinerules` |
113
+ | **Windsurf** | 🔶 部分支援 | **核心** | **規則書** | `.windsurfrules` |
114
+ | **GitHub Copilot** | 🔶 部分支援 | **核心** | **提示詞** | `.github/copilot-instructions.md` |
115
+ | **OpenAI Codex** | 🔶 部分支援 | **核心** | — | `AGENTS.md` |
116
+ | **Aider** | 🔶 部分支援 | — | — | `AGENTS.md` |
117
+ | **Continue** | 🔶 部分支援 | — | — | `.continue/config.json` |
118
+ | **Google Antigravity** | ⚠️ 最低限度 | — | — | `.antigravity/rules.md` |
113
119
 
114
- > **狀態圖例**:✅ 完整支援 | 🧪 預覽版 | 🔶 部分支援 | ⏳ 計畫中
120
+ > **狀態圖例**:✅ 完整支援 | 🧪 預覽版 | 🔶 部分支援 | ⚠️ 最低限度 | ⏳ 計畫中
115
121
 
116
122
  ---
117
123
 
@@ -153,28 +159,6 @@ uds uninstall # 從專案移除標準
153
159
 
154
160
  ---
155
161
 
156
- ## 🌐 生態系統
157
-
158
- UDS 是 AsiaOstrich 三層產品架構中的**標準定義層**:
159
-
160
- ```
161
- UDS(定義什麼) → DevAP(代理人如何執行) → VibeOps(完整生命週期)
162
- ```
163
-
164
- | 層級 | 產品 | 角色 | 授權 |
165
- |------|------|------|------|
166
- | 標準 | **UDS** | 開發方法論框架 | MIT + CC BY 4.0 |
167
- | 編排 | [DevAP](https://github.com/AsiaOstrich/dev-autopilot) | 代理人無關的編排引擎 | MIT |
168
- | 生命週期 | [VibeOps](https://github.com/AsiaOstrich/vibeops360) | AI 驅動的軟體工廠 | AGPL-3.0-only |
169
-
170
- - **UDS** 定義開發標準 → 供 DevAP(品質 Gate)和 VibeOps(代理人管線)使用
171
- - **DevAP** 使用 UDS 標準編排 AI 代理人 → VibeOps 是其消費者之一
172
- - **VibeOps** 提供完整軟體生命週期 → 透過 `uds init` 整合 UDS(一次複製)
173
-
174
- UDS 保持**工具無關性**:支援 Claude Code、OpenCode、Gemini CLI、Cursor、Cline 和 Windsurf。DevAP 和 VibeOps 是消費者,並非必要依賴。
175
-
176
- ---
177
-
178
162
  ## 📄 授權
179
163
 
180
164
  | 元件 | 授權 |
@@ -12,7 +12,7 @@ status: current
12
12
 
13
13
  **版本**: 1.0.0
14
14
  **最後更新**: 2026-03-30
15
- **適用性**: 跨專案 AI Agent 編排(UDS / DevAP / VibeOps)
15
+ **適用性**: 跨採用層 AI Agent 編排(任意 Adapter / Pipeline / Agent runtime 消費 UDS 標準)
16
16
  **範圍**: 通用 (Universal)
17
17
  **相關標準**: [代理派遣](./agent-dispatch.md)、[AI 模型選擇策略](./model-selection.md)
18
18
  **規格**: [SPEC-AGENT-COMM-001](../../../docs/specs/SPEC-AGENT-COMM-001-agent-communication-protocol.md)
@@ -60,12 +60,12 @@ status: current
60
60
  | `timeout` | 任務超時 |
61
61
  | `unknown` | 無法識別的狀態(降級) |
62
62
 
63
- ### 1.2 跨專案映射
63
+ ### 1.2 跨採用層映射
64
64
 
65
- 跨專案狀態碼映射表:
65
+ 跨採用層狀態碼對映表(informative example,採用層自訂自己的對映):
66
66
 
67
- | 統一狀態 | UDS | DevAP | VibeOps |
68
- |----------|-----|-------|---------|
67
+ | 統一狀態 | UDS | Adapter Example A | Adapter Example B |
68
+ |----------|-----|-------------------|-------------------|
69
69
  | `success` | DONE | success | success |
70
70
  | `success_partial` | DONE_WITH_CONCERNS | done_with_concerns | partial |
71
71
  | `failed` | — | failed | failure |
@@ -0,0 +1,11 @@
1
+ ---
2
+ source: ../../../core/browser-compatibility-standards.md
3
+ source_version: 1.0.0
4
+ translation_version: 0.0.0
5
+ last_synced: 2026-05-05
6
+ ---
7
+
8
+ <!-- TODO: 待完整繁體中文翻譯 — Translation pending -->
9
+ <!-- See source: core/browser-compatibility-standards.md -->
10
+
11
+ > 此標準尚未完整翻譯。請參閱英文原文:[English](../../../core/browser-compatibility-standards.md)
@@ -93,10 +93,10 @@ Fail-Closed 能力聲明:工具/Adapter/Agent 必須顯式聲明安全性
93
93
 
94
94
  ## 適用組件
95
95
 
96
- - DevAP AgentAdapter(ClaudeAdapter / OpenCodeAdapter / CliAdapter)
97
- - DevAP Tool 呼叫系統
98
- - VibeOps ToolExecutor
99
- - VibeOps Agentplanner / builder / evaluator 等)
96
+ - AgentAdapter 實作(採用層;如 ClaudeAdapter / OpenCodeAdapter / CliAdapter)
97
+ - Tool 呼叫系統(採用層)
98
+ - ToolExecutor 實作(採用層)
99
+ - Agent(採用層;planner / builder / evaluator 等)
100
100
  - 所有 MCP 工具插件
101
101
 
102
102
  ---
@@ -31,7 +31,7 @@ status: current
31
31
  - 任何重試機制必須使用斷路器包裝,不得直接無限重試
32
32
  - 斷路器狀態必須透過遙測可觀測(`circuit_breaker_state_change` 事件)
33
33
  - OPEN 狀態下的請求必須立即失敗(fail fast),不等待 timeout
34
- - `failureThreshold` 預設值為 3,與 claude-code-book DevAP Fix Loop 一致
34
+ - `failureThreshold` 預設值為 3,與 claude-code-book 及常見 Fix Loop 實作慣例一致
35
35
  - 斷路器必須按照「功能單元」建立,不得全域共享單一斷路器
36
36
 
37
37
  ---
@@ -93,12 +93,12 @@ status: current
93
93
 
94
94
  ## 適用場景
95
95
 
96
- - DevAP Fix Loop Agent 呼叫重試
97
- - DevAP Judge / Quality Gate 重試
98
- - DevAP API 呼叫(LLM API 不穩定保護)
99
- - VibeOps Feedback Loop 重試
100
- - VibeOps FLARE 主動檢索重試
101
- - VibeOps AutoCompact(原始靈感來源)
96
+ - Fix Loop Agent 呼叫重試(採用層)
97
+ - Judge / Quality Gate 重試(採用層)
98
+ - LLM API 呼叫(不穩定保護;採用層)
99
+ - Feedback Loop 重試(採用層)
100
+ - FLARE 主動檢索重試(採用層)
101
+ - AutoCompact 風格的對話壓縮(claude-code-book 為原始靈感來源)
102
102
 
103
103
  ---
104
104
 
@@ -0,0 +1,11 @@
1
+ ---
2
+ source: ../../../core/contract-testing-standards.md
3
+ source_version: 1.0.0
4
+ translation_version: 0.0.0
5
+ last_synced: 2026-05-05
6
+ ---
7
+
8
+ <!-- TODO: 待完整繁體中文翻譯 — Translation pending -->
9
+ <!-- See source: core/contract-testing-standards.md -->
10
+
11
+ > 此標準尚未完整翻譯。請參閱英文原文:[English](../../../core/contract-testing-standards.md)
@@ -0,0 +1,11 @@
1
+ ---
2
+ source: ../../../core/cross-flow-regression.md
3
+ source_version: 1.0.0
4
+ translation_version: 0.0.0
5
+ last_synced: 2026-05-05
6
+ ---
7
+
8
+ <!-- TODO: 待完整繁體中文翻譯 — Translation pending -->
9
+ <!-- See source: core/cross-flow-regression.md -->
10
+
11
+ > 此標準尚未完整翻譯。請參閱英文原文:[English](../../../core/cross-flow-regression.md)
@@ -116,9 +116,9 @@ IMPORTANT: The <analysis> block is your scratchpad. Only <summary> persists.
116
116
 
117
117
  ## 適用 Agent
118
118
 
119
- - DevAP Judge Agent
120
- - VibeOps Evaluator Agent
121
- - VibeOps Guardian Agent
119
+ - Judge Agent(採用層)
120
+ - Evaluator Agent(採用層)
121
+ - Guardian Agent(採用層)
122
122
  - 任何 LLM 驅動的 AutoCompact/摘要組件
123
123
 
124
124
  ---
@@ -32,7 +32,7 @@ status: current
32
32
  - `failureSource` 為 optional 欄位,不得破壞現有不含此欄位的程式碼
33
33
  - 在同一失敗事件中,選擇最根本的來源作為 `failureSource`(例如 `branch_divergence` 比 `compilation` 更根本)
34
34
  - `failureSource` 應由偵測到失敗的元件設定(QualityGate / Adapter / SafetyHook / BranchDriftChecker)
35
- - 跨專案(DevAP / VibeOps)各自獨立定義 `FailureSource` type,語義保持一致
35
+ - 各採用層各自獨立定義 `FailureSource` type,語義保持一致
36
36
 
37
37
  ---
38
38
 
@@ -134,13 +134,11 @@ test_failure | tool_failure | policy_violation | resource_exhaustion
134
134
 
135
135
  ## 整合點
136
136
 
137
- ### DevAP
137
+ > 整合指引(informative;具體檔案路徑屬於採用層自訂範圍)。
138
138
 
139
- - `packages/core/src/types.ts` — `TaskResult.failureSource` / `FailureSource` type
140
- - `packages/core/src/quality-gate.ts` — `QualityGateResult.failureSource` 推斷
141
- - `packages/adapter-claude/src/claude-adapter.ts` — `resource_exhaustion` 映射
139
+ ### 預期呼叫點
142
140
 
143
- ### VibeOps
144
-
145
- - `src/types/index.ts` `IterationRecord.failureSource`(獨立定義,AGPL 隔離)
146
- - `src/runner/pipeline-runner.ts` — `agent:error` 事件 payload
141
+ - 核心型別模組 — `TaskResult.failureSource` / `FailureSource` type
142
+ - quality-gate 模組 — `QualityGateResult.failureSource` 推斷
143
+ - agent adapter — `resource_exhaustion` / `network_error` 映射
144
+ - pipeline runner — `agent:error` / `agent:retry` 事件 payload