universal-dev-standards 6.7.5 → 6.8.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.
- package/bin/uds.js +7 -0
- package/bundled/ai/standards/ai-instruction-standards.ai.yaml +6 -6
- package/bundled/core/ai-instruction-standards.md +9 -7
- package/bundled/locales/zh-CN/CHANGELOG.md +21 -3
- package/bundled/locales/zh-CN/README.md +6 -6
- package/bundled/locales/zh-CN/SECURITY.md +1 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +10 -8
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +20 -6
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +149 -11
- package/bundled/locales/zh-CN/skills/agents/README.md +1 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +13 -23
- package/bundled/locales/zh-CN/skills/workflows/README.md +2 -11
- package/bundled/locales/zh-TW/CHANGELOG.md +21 -3
- package/bundled/locales/zh-TW/README.md +6 -6
- package/bundled/locales/zh-TW/SECURITY.md +1 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +10 -8
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +20 -6
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +149 -11
- package/bundled/locales/zh-TW/skills/agents/README.md +1 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +13 -23
- package/bundled/locales/zh-TW/skills/workflows/README.md +2 -11
- package/bundled/skills/agents/README.md +1 -1
- package/bundled/skills/reverse-engineer/tdd-analysis.md +16 -23
- package/bundled/skills/workflows/README.md +2 -11
- package/package.json +4 -2
- package/src/commands/lint.js +96 -0
- package/src/commands/quickstart.js +16 -13
- package/src/i18n/messages.js +3 -3
- package/src/reconciler/actual-state-scanner.js +14 -3
- package/src/utils/hasher.js +63 -8
- package/src/utils/integration-generator.js +21 -3
- package/src/utils/skills-installer.js +17 -3
- package/src/utils/spec-linter.js +35 -76
- package/standards-registry.json +7 -7
- package/src/commands/sync.js +0 -133
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../CHANGELOG.md
|
|
3
|
-
source_version: 6.
|
|
4
|
-
translation_version: 6.
|
|
5
|
-
last_synced: 2026-08-
|
|
3
|
+
source_version: 6.8.0
|
|
4
|
+
translation_version: 6.8.0
|
|
5
|
+
last_synced: 2026-08-19
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -17,6 +17,24 @@ status: current
|
|
|
17
17
|
|
|
18
18
|
## [Unreleased]
|
|
19
19
|
|
|
20
|
+
## [6.8.0] - 2026-08-20
|
|
21
|
+
|
|
22
|
+
### 新增
|
|
23
|
+
|
|
24
|
+
- **一道去問「這條 `uds <cmd>` 指示真的跑得動嗎」的閘門(XSPEC-383 R4)。** 2026-08-19 查到三個頂層指令(`uds install`、`uds lint`、`uds sync`)與兩個旗標(`uds check --spec-size`、`uds spec create --boost`)出現在出貨的指引裡而**它們都不存在**——落點包括 `quickstart.js`(它的整個工作就是「快速找到對的指令」)與 `integration-generator.js`(它把指令**寫進每一個採用者的 `CLAUDE.md`/`AGENTS.md`**)。兩處早已修掉(`465335e4`),而**沒有任何東西在確認那個修正會維持**。`check-command-existence.mjs` 走訪 `core/`、`locales/`、`ai/standards/`、`cli/src/`、`skills/`、`docs/` 與 repo 根目錄的 `*.md`,抽出每一個 `uds <cmd>` 樣式,用 `uds <path> --definitely-not-a-real-flag` 對本次 commit 自己的 CLI 探測——**不是 `--help`**:commander 對**未知**指令會回答通用指令表而不是報錯,而那正是 `uds lint`/`uds sync` 在第一輪檢查中存活的原因。
|
|
25
|
+
- **同一支探針對現況再跑一次,翻出第一次事故的修正從未碰到的漂移。** `uds workflow`(v6.0.0 移除)在 `docs/user/CHEATSHEET.md`、`docs/reference/FEATURE-REFERENCE.md`、`skills/workflows/README.md`(及 zh-TW/zh-CN 鏡像)**被當成現行指令展示了五個月**,而 `docs/MIGRATION-v6.md` 自己就給了能抓到它的那條 grep。`uds config --lang`/`--mode` 從未存在(root `README.md`、兩份 locale、`docs/reference/INTEGRATION-VERIFICATION.md`)。`uds agent install --all` 把位置參數寫成旗標。`uds reverse-tdd` 是為了一段 GitHub Actions 範例**虛構出來的 CLI**。`uds check --interactive` 不存在,因為互動模式本來就是預設。**29 個發現,29 個修好,0 個殘留。**
|
|
26
|
+
- **一道去問「有沒有人到得了這段程式碼」的閘門(XSPEC-383 R3)。** 單元測試證明函式是對的,對「有沒有使用者叫得到」一個字都沒說。2026-04-07 有一次 commit 加了 `spec-linter.js`(172 行、14 個測試全過)與 `sync.js`(133 行)——**兩者都從未被註冊**,而同一天有下游產品把自己接上 `npx uds lint --json`,一個因此永遠不會存在的指令。四個半月,兩邊全綠,中間沒有一條通的路。`check-module-reachability.mjs` 從 package.json 的 `bin` 與 `main` 出發做 BFS,**手查找到 2 個,走訪找到 24 個**,含整個九模組的 `src/flow/` 子系統。
|
|
27
|
+
- **`uds lint`(XSPEC-383 R5)。** 註冊那個 linter 自 2026-04-07 起就在等的指令,帶著兩項禁得起真實 spec 考驗的檢查:相依有效性與篇幅。
|
|
28
|
+
|
|
29
|
+
### 變更
|
|
30
|
+
|
|
31
|
+
- **雜湊前先正規化行尾(#155)。** `uds check` 比對的是磁碟上的原始 bytes,於是 Windows 在 `core.autocrlf=true` 下的 checkout 把每個 LF 換成 CRLF,**每一個雜湊都不再吻合**——而「N 個檔案已修改」這句話,無論是有人改了 N 個檔還是平台改寫了每一個換行,讀起來完全一樣。走訪另外找到兩套從不經過 `hasher.js` 的雜湊實作,四處全修。新增 21 個測試,含負向對照:真實內容差異與尾隨空白差異,在 CRLF checkout 上仍須偵測得到。`uds check --force` 的輸出前後逐位元組相同,既有 manifest 不需要重新蓋章。
|
|
32
|
+
- **使用說明產生器改為問 CLI,而不是背誦一份清單。** `scanCliCommands` 把 `cli/bin/uds.js` 讀進一個變數然後忽略它,改用一份註記著「based on uds.js analysis」的手寫陣列。於是**每一次重新產生都把已移除的 `uds workflow` 寫回文件**,也從來不會加入 `uds lint`。現在它解析 `uds --help`——CLI 對自己有哪些指令的權威回答,涵蓋任何單檔解析看不到的註冊寫法(`mcp` 完全由另一個模組註冊)。涵蓋率從 19/24 變成 **23/23**。
|
|
33
|
+
|
|
34
|
+
### 移除
|
|
35
|
+
|
|
36
|
+
- **`uds sync` 與 AC 覆蓋檢查(XSPEC-383 R5,選項 E)。** `sync.js` 零消費者。AC 覆蓋檢查對 93 份真實 spec 量測,回報 98 條驗收條件中 0 條被覆蓋——**不是因為它們沒有測試**,而是因為它用**位置**生成 AC 識別字(`AC-1`、`AC-2`)而不是讀規格宣告的那些,再用寫死的 `@` 前綴去找。一個寫 `AC-045-001` 並且標註不帶 `@` 的專案,無論追溯做得多完整都會得到零覆蓋。**它報的不是「這個專案沒有追溯」,而是「我用我自己的慣例去找,找不到」,而這兩句話印出來一模一樣。** 它是移除而不是留著不接:它是一個正確實作了一個唯一已知消費者並不使用的慣例的東西,躺在樹上等著被人重新接上。跨 repo 的 AC 識別字慣例調解是協商,不是補丁,另案處理。
|
|
37
|
+
|
|
20
38
|
## [6.7.5] - 2026-08-18
|
|
21
39
|
|
|
22
40
|
### 變更
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
source: ../../README.md
|
|
3
3
|
source_version: 6.0.0
|
|
4
4
|
translation_version: 6.0.0
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
5
|
+
last_synced: 2026-08-19
|
|
6
|
+
source_hash: d978c5775a25
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -15,7 +15,7 @@ status: current
|
|
|
15
15
|
|
|
16
16
|
> **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
|
|
17
17
|
|
|
18
|
-
**版本**: 6.
|
|
18
|
+
**版本**: 6.8.0 | **發布日期**: 2026-08-20 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
|
|
19
19
|
|
|
20
20
|
語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
|
|
21
21
|
|
|
@@ -79,7 +79,7 @@ npx universal-dev-standards init
|
|
|
79
79
|
| **核心標準** | 150 | 通用開發準則 |
|
|
80
80
|
| **AI Skills** | 55 | 互動式技能 |
|
|
81
81
|
| **斜線命令** | 51 | 快速操作 |
|
|
82
|
-
| **CLI 指令** |
|
|
82
|
+
| **CLI 指令** | 23 | 專案設定與維護 |
|
|
83
83
|
<!-- UDS_STATS_TABLE_END -->
|
|
84
84
|
|
|
85
85
|
> **5.0 新功能?** 請參閱[預發布說明](../../docs/PRE-RELEASE.md)了解新功能詳情。
|
|
@@ -198,9 +198,9 @@ uds uninstall # 從專案移除標準
|
|
|
198
198
|
|
|
199
199
|
| 參數 | 指令 | 說明 |
|
|
200
200
|
| :--- | :--- | :--- |
|
|
201
|
-
| **提交語言** | `uds config
|
|
201
|
+
| **提交語言** | `uds config set output_language traditional-chinese` | 設定 AI 提交訊息的偏好語言 |
|
|
202
202
|
| **標準** | `uds init` | 安裝所有可用標準 |
|
|
203
|
-
| **工具模式** | `uds config --
|
|
203
|
+
| **工具模式** | `uds config --type content_mode` | 在 Skills、Standards 或兩者之間切換 |
|
|
204
204
|
|
|
205
205
|
---
|
|
206
206
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/ai-instruction-standards.md
|
|
3
|
-
source_version: 1.1.
|
|
4
|
-
translation_version: 1.1.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 1.1.1
|
|
4
|
+
translation_version: 1.1.1
|
|
5
|
+
last_synced: 2026-08-19
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -215,7 +215,7 @@ translation_version: {本翻譯的版本}
|
|
|
215
215
|
|------|------|--------|
|
|
216
216
|
| **Canonical 擁有者** | `core/{name}.md`、`core/{name}.ai.yaml`、`skills/{name}/SKILL.md` | 維持 L1/L2/L3/L4 為英文;每次 breaking change 時 bump `source_version` |
|
|
217
217
|
| **Locale 維護者** | `locales/{lang}/...` 檔 | `translation_version` 對齊 `source_version`;翻譯 L1(必)、L2(選)、L3(必)、L4(建議)|
|
|
218
|
-
| **採用者(下游專案)** | 自己的 `.claude/skills/`、`CLAUDE.md` 等 | 用 `uds
|
|
218
|
+
| **採用者(下游專案)** | 自己的 `.claude/skills/`、`CLAUDE.md` 等 | 用 `uds init --locale {lang}`(首次)或 `uds update --locale {lang}`(重新同步)安裝;**絕不**手動修改 canonical 檔(要客製化請用 locale 變體或 overlay)|
|
|
219
219
|
|
|
220
220
|
### Chimera 防範
|
|
221
221
|
|
|
@@ -237,7 +237,8 @@ Pre-commit / CI lint 強制 error 級規則;warn 級規則只在 dashboard 揭
|
|
|
237
237
|
採用者透過 UDS CLI 安裝指令檔:
|
|
238
238
|
|
|
239
239
|
```bash
|
|
240
|
-
uds
|
|
240
|
+
uds init --locale zh-tw # 首次以繁體中文安裝 skills 與 standards
|
|
241
|
+
uds update --locale zh-tw # 對既有採用重新同步
|
|
241
242
|
```
|
|
242
243
|
|
|
243
244
|
**Locale 解析優先順序**:
|
|
@@ -258,7 +259,7 @@ uds install --locale zh-TW # 以繁體中文安裝 skills 與 standards
|
|
|
258
259
|
若採用者已手動修改過專案中的 canonical 檔(例:在 `.claude/skills/` 翻譯了描述):
|
|
259
260
|
|
|
260
261
|
1. **辨識 chimera**:比對採用者檔案與 UDS canonical / canonical 的 locale 變體。
|
|
261
|
-
2. **安裝正確變體**:執行 `uds
|
|
262
|
+
2. **安裝正確變體**:執行 `uds update --locale {lang}` 替換 chimera 為 locale 變體。
|
|
262
263
|
3. **保留專案級客製**:若 chimera 含合理的專案級客製(非翻譯),抽出為 overlay 或記錄到客製化日誌(例:`UDS-CUSTOMIZATION.md`)。
|
|
263
264
|
4. **丟棄純翻譯**:chimera 中純翻譯部分直接丟棄——locale 變體會取代它。
|
|
264
265
|
|
|
@@ -270,8 +271,9 @@ uds install --locale zh-TW # 以繁體中文安裝 skills 與 standards
|
|
|
270
271
|
| 更新 canonical | 改進英文 source | Bump `source_version`;通知 locale 維護者 |
|
|
271
272
|
| 翻譯 / 同步 locale | 新增或更新 locale 內容 | Bump `translation_version`;參照當前 `source_version` |
|
|
272
273
|
| 檢查覆蓋率 | 定期 review | 看自動產生的 `locales/COVERAGE.md` |
|
|
273
|
-
| 帶 locale 安裝 |
|
|
274
|
-
|
|
|
274
|
+
| 帶 locale 安裝 | 採用者初設 | `uds init --locale {lang}` |
|
|
275
|
+
| 帶 locale 重新同步 | 既有採用 | `uds update --locale {lang}` |
|
|
276
|
+
| 跑 i18n lint | Commit 前 / CI | `uds check --i18n` |
|
|
275
277
|
|
|
276
278
|
---
|
|
277
279
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# UDS 速查表
|
|
2
2
|
|
|
3
|
-
> Quick reference for all UDS features | Last updated: 2026-08-
|
|
3
|
+
> Quick reference for all UDS features | Last updated: 2026-08-19
|
|
4
4
|
|
|
5
5
|
**Language**: [English](../../../docs/user/CHEATSHEET.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CHEATSHEET.md)
|
|
6
6
|
|
|
@@ -12,13 +12,27 @@
|
|
|
12
12
|
|---------|-------------|
|
|
13
13
|
| `uds list` | List available standards |
|
|
14
14
|
| `uds init` | Initialize standards in current project |
|
|
15
|
-
| `uds
|
|
16
|
-
| `uds
|
|
15
|
+
| `uds config` | Manage UDS configuration and project settings |
|
|
16
|
+
| `uds hitl` | Human-in-the-Loop controls |
|
|
17
|
+
| `uds configure` | Alias for "uds config" — Modify project settings |
|
|
18
|
+
| `uds check` | Check file integrity and adoption status (quick validation). For deep health diagnosis, use "uds audit" |
|
|
19
|
+
| `uds lint` | Check spec dependency validity and size against installed specs (specs/*.md) |
|
|
20
|
+
| `uds simulate` | Simulate a standard check with input (Predictive Validation) |
|
|
21
|
+
| `uds fix` | Auto-fix standard violations (Self-Healing) |
|
|
17
22
|
| `uds update` | Update standards to latest version |
|
|
18
23
|
| `uds skills` | List installed Claude Code skills |
|
|
19
|
-
| `uds
|
|
20
|
-
| `uds
|
|
21
|
-
| `uds
|
|
24
|
+
| `uds audit` | Deep health diagnosis with pattern detection and feedback (strategic). For quick file check, use "uds check" |
|
|
25
|
+
| `uds deps` | Compare the versions you test against the versions your declared ranges resolve to |
|
|
26
|
+
| `uds uninstall` | Remove UDS standards, integrations, skills, and hooks |
|
|
27
|
+
| `uds compile` | Compile enforcement standards into hook configurations |
|
|
28
|
+
| `uds report` | Analyze hook telemetry and show adoption report |
|
|
29
|
+
| `uds release` | Manage release process (promote, deploy, manifest, verify) |
|
|
30
|
+
| `uds spec` | Manage lightweight micro-specs for vibe coding. For full spec lifecycle with review, use "/sdd" |
|
|
31
|
+
| `uds quickstart` | Interactive workflow guide — find the right commands quickly |
|
|
32
|
+
| `uds agent` | Manage UDS agents for AI tools |
|
|
33
|
+
| `uds ai-context` | Manage .ai-context.yaml configuration for AI-friendly architecture |
|
|
34
|
+
| `uds mcp` | MCP server commands for AI tool integration |
|
|
35
|
+
| `uds run` | Run a project command by intent (test/lint/build/security) via uds.project.yaml |
|
|
22
36
|
|
|
23
37
|
## 💬 斜線命令
|
|
24
38
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# UDS 功能參考手冊
|
|
2
2
|
|
|
3
3
|
> Universal Development Standards - 完整功能文件
|
|
4
|
-
> Auto-generated | Last updated: 2026-08-
|
|
4
|
+
> Auto-generated | Last updated: 2026-08-19
|
|
5
5
|
|
|
6
6
|
**Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
|
|
7
7
|
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
|
|
10
10
|
## 目錄
|
|
11
11
|
|
|
12
|
-
1. [CLI 指令](#cli-commands) (
|
|
12
|
+
1. [CLI 指令](#cli-commands) (23)
|
|
13
13
|
2. [斜線命令](#slash-commands) (51)
|
|
14
14
|
3. [技能](#skills) (55)
|
|
15
15
|
4. [代理](#agents) (5)
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
6. [核心規範](#core-standards) (150)
|
|
18
18
|
7. [腳本](#scripts) (54)
|
|
19
19
|
|
|
20
|
-
**Total Features:
|
|
20
|
+
**Total Features: 343**
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
@@ -58,9 +58,22 @@
|
|
|
58
58
|
| `-E, --experimental` | Enable experimental features (methodology) |
|
|
59
59
|
| `--force` | Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071) |
|
|
60
60
|
|
|
61
|
+
### `uds config`
|
|
62
|
+
|
|
63
|
+
**說明**: Manage UDS configuration and project settings
|
|
64
|
+
|
|
65
|
+
### `uds hitl`
|
|
66
|
+
|
|
67
|
+
**說明**: Human-in-the-Loop controls
|
|
68
|
+
|
|
69
|
+
**選項**:
|
|
70
|
+
| Option | 說明 |
|
|
71
|
+
|--------|-------------|
|
|
72
|
+
| `--op` | Operation description |
|
|
73
|
+
|
|
61
74
|
### `uds configure`
|
|
62
75
|
|
|
63
|
-
**說明**:
|
|
76
|
+
**說明**: Alias for "uds config" — Modify project settings
|
|
64
77
|
|
|
65
78
|
**選項**:
|
|
66
79
|
| Option | 說明 |
|
|
@@ -73,7 +86,7 @@
|
|
|
73
86
|
|
|
74
87
|
### `uds check`
|
|
75
88
|
|
|
76
|
-
**說明**: Check adoption status
|
|
89
|
+
**說明**: Check file integrity and adoption status (quick validation). For deep health diagnosis, use "uds audit"
|
|
77
90
|
|
|
78
91
|
**選項**:
|
|
79
92
|
| Option | 說明 |
|
|
@@ -91,6 +104,36 @@
|
|
|
91
104
|
| `--force` | Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071) |
|
|
92
105
|
| `--i18n` | Run i18n lint rules (XSPEC-239) across canonical + locale variants |
|
|
93
106
|
|
|
107
|
+
### `uds lint`
|
|
108
|
+
|
|
109
|
+
**說明**: Check spec dependency validity and size against installed specs (specs/*.md)
|
|
110
|
+
|
|
111
|
+
**選項**:
|
|
112
|
+
| Option | 說明 |
|
|
113
|
+
|--------|-------------|
|
|
114
|
+
| `--json` | Output result in JSON format |
|
|
115
|
+
|
|
116
|
+
### `uds simulate`
|
|
117
|
+
|
|
118
|
+
**說明**: Simulate a standard check with input (Predictive Validation)
|
|
119
|
+
|
|
120
|
+
**選項**:
|
|
121
|
+
| Option | 說明 |
|
|
122
|
+
|--------|-------------|
|
|
123
|
+
| `-s, --standard` | Standard to simulate against |
|
|
124
|
+
| `-i, --input` | Input string to test |
|
|
125
|
+
| `--json` | Output result in JSON format |
|
|
126
|
+
|
|
127
|
+
### `uds fix`
|
|
128
|
+
|
|
129
|
+
**說明**: Auto-fix standard violations (Self-Healing)
|
|
130
|
+
|
|
131
|
+
**選項**:
|
|
132
|
+
| Option | 說明 |
|
|
133
|
+
|--------|-------------|
|
|
134
|
+
| `-s, --standard` | Standard to fix |
|
|
135
|
+
| `--json` | Output result in JSON format |
|
|
136
|
+
|
|
94
137
|
### `uds update`
|
|
95
138
|
|
|
96
139
|
**說明**: Update standards to latest version
|
|
@@ -117,9 +160,100 @@
|
|
|
117
160
|
|
|
118
161
|
**說明**: List installed Claude Code skills
|
|
119
162
|
|
|
163
|
+
### `uds audit`
|
|
164
|
+
|
|
165
|
+
**說明**: Deep health diagnosis with pattern detection and feedback (strategic). For quick file check, use "uds check"
|
|
166
|
+
|
|
167
|
+
**選項**:
|
|
168
|
+
| Option | 說明 |
|
|
169
|
+
|--------|-------------|
|
|
170
|
+
| `--health` | Health check only |
|
|
171
|
+
| `--patterns` | Pattern detection only |
|
|
172
|
+
| `--friction` | Friction detection only |
|
|
173
|
+
| `--report` | Interactive feedback submission |
|
|
174
|
+
| `--yes` | Submit all findings without interactive selection (CI / non-TTY) |
|
|
175
|
+
| `--dry-run` | Preview report without submitting |
|
|
176
|
+
| `--gh` | Force gh CLI for submission |
|
|
177
|
+
| `--format` | Output format (json) |
|
|
178
|
+
| `--quiet` | Summary only |
|
|
179
|
+
| `--score` | Run multi-dimensional health score analysis |
|
|
180
|
+
| `--self` | Self mode: analyze UDS repo itself (use with --score) |
|
|
181
|
+
| `--save` | Save score snapshot for trend tracking (use with --score) |
|
|
182
|
+
| `--trend` | Show historical score trend (use with --score) |
|
|
183
|
+
| `--ci` | CI mode: output score only, exit 1 if below threshold (use with --score) |
|
|
184
|
+
| `--threshold` | Score threshold for CI mode (default: 75) |
|
|
185
|
+
|
|
186
|
+
### `uds deps`
|
|
187
|
+
|
|
188
|
+
**說明**: Compare the versions you test against the versions your declared ranges resolve to
|
|
189
|
+
|
|
190
|
+
**選項**:
|
|
191
|
+
| Option | 說明 |
|
|
192
|
+
|--------|-------------|
|
|
193
|
+
| `--path` | Directory containing package.json (default: cwd) |
|
|
194
|
+
| `--json` | Output raw JSON |
|
|
195
|
+
| `--concurrency` | Parallel registry lookups (default: 8) |
|
|
196
|
+
|
|
197
|
+
### `uds uninstall`
|
|
198
|
+
|
|
199
|
+
**說明**: Remove UDS standards, integrations, skills, and hooks
|
|
200
|
+
|
|
201
|
+
**選項**:
|
|
202
|
+
| Option | 說明 |
|
|
203
|
+
|--------|-------------|
|
|
204
|
+
| `--all` | Remove everything including user-level installations |
|
|
205
|
+
| `--standards-only` | Remove only .standards/ directory |
|
|
206
|
+
| `--skills-only` | Remove only skills and commands |
|
|
207
|
+
| `--integrations-only` | Remove only UDS blocks from integration files |
|
|
208
|
+
| `--dry-run` | Preview mode, no files modified |
|
|
209
|
+
| `-y, --yes` | Skip confirmation prompts |
|
|
210
|
+
|
|
211
|
+
### `uds compile`
|
|
212
|
+
|
|
213
|
+
**說明**: Compile enforcement standards into hook configurations
|
|
214
|
+
|
|
215
|
+
**選項**:
|
|
216
|
+
| Option | 說明 |
|
|
217
|
+
|--------|-------------|
|
|
218
|
+
| `--target` | Target platform (claude-code) |
|
|
219
|
+
| `--dry-run` | Preview output without writing files |
|
|
220
|
+
|
|
221
|
+
### `uds report`
|
|
222
|
+
|
|
223
|
+
**說明**: Analyze hook telemetry and show adoption report
|
|
224
|
+
|
|
225
|
+
### `uds release`
|
|
226
|
+
|
|
227
|
+
**說明**: Manage release process (promote, deploy, manifest, verify)
|
|
228
|
+
|
|
229
|
+
### `uds spec`
|
|
230
|
+
|
|
231
|
+
**說明**: Manage lightweight micro-specs for vibe coding. For full spec lifecycle with review, use "/sdd"
|
|
232
|
+
|
|
233
|
+
**選項**:
|
|
234
|
+
| Option | 說明 |
|
|
235
|
+
|--------|-------------|
|
|
236
|
+
| `-s, --scope` | Scope (frontend, backend, fullstack) |
|
|
237
|
+
| `-o, --output` | Output directory (default: specs/) |
|
|
238
|
+
| `-y, --yes` | Auto-confirm without prompting |
|
|
239
|
+
| `--status` | Filter by status (draft, confirmed, archived) |
|
|
240
|
+
| `-o, --output` | Specs directory (default: specs/) |
|
|
241
|
+
| `-o, --output` | Specs directory (default: specs/) |
|
|
242
|
+
| `-o, --output` | Specs directory (default: specs/) |
|
|
243
|
+
| `-o, --output` | Specs directory (default: specs/) |
|
|
244
|
+
| `-y, --yes` | Skip confirmation |
|
|
245
|
+
| `-o, --output` | Specs directory (default: specs/) |
|
|
246
|
+
| `--archived` | Search only archived specs |
|
|
247
|
+
| `-o, --output` | Specs directory |
|
|
248
|
+
| `-o, --output` | Specs directory |
|
|
249
|
+
|
|
250
|
+
### `uds quickstart`
|
|
251
|
+
|
|
252
|
+
**說明**: Interactive workflow guide — find the right commands quickly
|
|
253
|
+
|
|
120
254
|
### `uds agent`
|
|
121
255
|
|
|
122
|
-
**說明**: Manage UDS agents
|
|
256
|
+
**說明**: Manage UDS agents for AI tools
|
|
123
257
|
|
|
124
258
|
**選項**:
|
|
125
259
|
| Option | 說明 |
|
|
@@ -129,13 +263,17 @@
|
|
|
129
263
|
| `-g, --global` | Install to user level instead of project level |
|
|
130
264
|
| `-y, --yes` | Skip confirmation prompts |
|
|
131
265
|
|
|
132
|
-
### `uds
|
|
266
|
+
### `uds ai-context`
|
|
133
267
|
|
|
134
|
-
**說明**: Manage
|
|
268
|
+
**說明**: Manage .ai-context.yaml configuration for AI-friendly architecture
|
|
135
269
|
|
|
136
|
-
### `uds
|
|
270
|
+
### `uds mcp`
|
|
271
|
+
|
|
272
|
+
**說明**: MCP server commands for AI tool integration
|
|
273
|
+
|
|
274
|
+
### `uds run`
|
|
137
275
|
|
|
138
|
-
**說明**:
|
|
276
|
+
**說明**: Run a project command by intent (test/lint/build/security) via uds.project.yaml
|
|
139
277
|
|
|
140
278
|
---
|
|
141
279
|
|
|
@@ -298,7 +436,7 @@
|
|
|
298
436
|
| `ai-agreement-standards` | 1.0.0 | This standard formalizes the interaction between Human (Acquirer) and AI (Suppli |
|
|
299
437
|
| `ai-command-behavior` | 1.0.0 | This standard defines a structure for specifying AI Agent runtime behavior in co |
|
|
300
438
|
| `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
|
|
301
|
-
| `ai-instruction-standards` | 1.1.
|
|
439
|
+
| `ai-instruction-standards` | 1.1.1 | This standard defines best practices for creating and maintaining AI instruction |
|
|
302
440
|
| `ai-response-navigation` | 1.3.0 | This standard defines navigation behavior for AI responses: every substantive AI |
|
|
303
441
|
| `alerting-standards` | 1.0.0 | |
|
|
304
442
|
| `anti-hallucination` | 1.5.1 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
|
|
@@ -605,9 +605,19 @@ test.each([
|
|
|
605
605
|
|
|
606
606
|
## CI/CD 整合
|
|
607
607
|
|
|
608
|
-
### GitHub Actions
|
|
608
|
+
### GitHub Actions —— 目前無法腳本化
|
|
609
|
+
|
|
610
|
+
`uds reverse-tdd` 這個 CLI 指令不存在。覆蓋率缺口分析是以 **`reverse-tdd`
|
|
611
|
+
AI agent**(`uds agent install reverse-tdd`)提供——由你的 AI 工具互動式執行,
|
|
612
|
+
不是會吐出 `coverage.json` 的確定性腳本。本文件先前版本示範了一個呼叫不存在
|
|
613
|
+
CLI 指令的 GitHub Actions 步驟(XSPEC-383 R4,2026-08-19)。
|
|
614
|
+
|
|
615
|
+
下方僅為**示意**——展示若未來真的做出可腳本化的分析器,CI 整合可能長什麼樣,
|
|
616
|
+
不是現在就能貼進 workflow 使用的東西:
|
|
609
617
|
|
|
610
618
|
```yaml
|
|
619
|
+
# 示意用途——目前沒有可腳本化的等價物。
|
|
620
|
+
# 現況:改用 reverse-tdd agent 從你的 AI 工具互動式執行。
|
|
611
621
|
name: BDD Coverage Check
|
|
612
622
|
|
|
613
623
|
on: [pull_request]
|
|
@@ -618,29 +628,9 @@ jobs:
|
|
|
618
628
|
steps:
|
|
619
629
|
- uses: actions/checkout@v4
|
|
620
630
|
|
|
621
|
-
- name: Run BDD Coverage Analysis
|
|
622
|
-
run: |
|
|
623
|
-
uds reverse-tdd features/ --output coverage.json
|
|
624
|
-
|
|
625
|
-
- name: Check Coverage Threshold
|
|
631
|
+
- name: Run BDD Coverage Analysis (尚未實作)
|
|
626
632
|
run: |
|
|
627
|
-
|
|
628
|
-
if (( $(echo "$COVERAGE < 0.80" | bc -l) )); then
|
|
629
|
-
echo "Coverage $COVERAGE below 80% threshold"
|
|
630
|
-
exit 1
|
|
631
|
-
fi
|
|
632
|
-
|
|
633
|
-
- name: Comment on PR
|
|
634
|
-
uses: actions/github-script@v6
|
|
635
|
-
with:
|
|
636
|
-
script: |
|
|
637
|
-
const coverage = require('./coverage.json');
|
|
638
|
-
github.rest.issues.createComment({
|
|
639
|
-
issue_number: context.issue.number,
|
|
640
|
-
owner: context.repo.owner,
|
|
641
|
-
repo: context.repo.repo,
|
|
642
|
-
body: `## BDD 覆蓋率報告\n\n覆蓋率: ${(coverage.summary.effectiveCoverage * 100).toFixed(1)}%`
|
|
643
|
-
});
|
|
633
|
+
echo "目前沒有 CLI 等價物——互動式用法請見 reverse-tdd agent"
|
|
644
634
|
```
|
|
645
635
|
|
|
646
636
|
---
|
|
@@ -164,18 +164,9 @@ steps:
|
|
|
164
164
|
|
|
165
165
|
## 用法
|
|
166
166
|
|
|
167
|
-
###
|
|
167
|
+
### 取得 Workflows
|
|
168
168
|
|
|
169
|
-
|
|
170
|
-
# List available workflows
|
|
171
|
-
uds workflow list
|
|
172
|
-
|
|
173
|
-
# Install specific workflow
|
|
174
|
-
uds workflow install integrated-flow
|
|
175
|
-
|
|
176
|
-
# Install all workflows
|
|
177
|
-
uds workflow install --all
|
|
178
|
-
```
|
|
169
|
+
`uds workflow` 已於 v6.0.0 移除(流程編排職責移至採用層——DEC-049;見 [MIGRATION-v6.md §3](../../../../docs/MIGRATION-v6.md#3-removed-4-deprecated-cli-commands))。沒有 CLI 安裝步驟:workflow 定義直接存放在本 repo 的 `skills/workflows/*.workflow.yaml`(見上方表格),請直接引用路徑或複製到專案的 `.claude/workflows/`。
|
|
179
170
|
|
|
180
171
|
### 執行
|
|
181
172
|
|
|
@@ -597,9 +597,22 @@ Mark both scenarios as [Inferred] with shared test reference
|
|
|
597
597
|
|
|
598
598
|
## CI/CD Integration
|
|
599
599
|
|
|
600
|
-
### GitHub Actions
|
|
600
|
+
### GitHub Actions — not currently scriptable
|
|
601
|
+
|
|
602
|
+
There is no `uds reverse-tdd` CLI command. Coverage-gap analysis is delivered
|
|
603
|
+
as the **`reverse-tdd`** AI agent (`uds agent install reverse-tdd`) — an
|
|
604
|
+
interactive, LLM-driven analysis run from your AI tool, not a deterministic
|
|
605
|
+
script that emits a `coverage.json` file. A prior version of this doc showed
|
|
606
|
+
a GitHub Actions step invoking a CLI command that never existed (XSPEC-383
|
|
607
|
+
R4, 2026-08-19).
|
|
608
|
+
|
|
609
|
+
The sketch below is **illustrative only** — it shows the shape a scriptable
|
|
610
|
+
CI integration would need if one is built, not something you can paste into
|
|
611
|
+
a workflow today:
|
|
601
612
|
|
|
602
613
|
```yaml
|
|
614
|
+
# ASPIRATIONAL — no scriptable equivalent exists yet.
|
|
615
|
+
# Today: run the reverse-tdd agent interactively from your AI tool instead.
|
|
603
616
|
name: BDD Coverage Check
|
|
604
617
|
|
|
605
618
|
on: [pull_request]
|
|
@@ -610,29 +623,9 @@ jobs:
|
|
|
610
623
|
steps:
|
|
611
624
|
- uses: actions/checkout@v4
|
|
612
625
|
|
|
613
|
-
- name: Run BDD Coverage Analysis
|
|
614
|
-
run: |
|
|
615
|
-
uds reverse-tdd features/ --output coverage.json
|
|
616
|
-
|
|
617
|
-
- name: Check Coverage Threshold
|
|
626
|
+
- name: Run BDD Coverage Analysis (not yet implemented)
|
|
618
627
|
run: |
|
|
619
|
-
|
|
620
|
-
if (( $(echo "$COVERAGE < 0.80" | bc -l) )); then
|
|
621
|
-
echo "Coverage $COVERAGE below 80% threshold"
|
|
622
|
-
exit 1
|
|
623
|
-
fi
|
|
624
|
-
|
|
625
|
-
- name: Comment on PR
|
|
626
|
-
uses: actions/github-script@v6
|
|
627
|
-
with:
|
|
628
|
-
script: |
|
|
629
|
-
const coverage = require('./coverage.json');
|
|
630
|
-
github.rest.issues.createComment({
|
|
631
|
-
issue_number: context.issue.number,
|
|
632
|
-
owner: context.repo.owner,
|
|
633
|
-
repo: context.repo.repo,
|
|
634
|
-
body: `## BDD Coverage Report\n\nCoverage: ${(coverage.summary.effectiveCoverage * 100).toFixed(1)}%`
|
|
635
|
-
});
|
|
628
|
+
echo "No CLI equivalent yet — see reverse-tdd agent for interactive use"
|
|
636
629
|
```
|
|
637
630
|
|
|
638
631
|
---
|
|
@@ -157,18 +157,9 @@ steps:
|
|
|
157
157
|
|
|
158
158
|
## Usage
|
|
159
159
|
|
|
160
|
-
###
|
|
160
|
+
### Getting Workflows
|
|
161
161
|
|
|
162
|
-
|
|
163
|
-
# List available workflows
|
|
164
|
-
uds workflow list
|
|
165
|
-
|
|
166
|
-
# Install specific workflow
|
|
167
|
-
uds workflow install integrated-flow
|
|
168
|
-
|
|
169
|
-
# Install all workflows
|
|
170
|
-
uds workflow install --all
|
|
171
|
-
```
|
|
162
|
+
`uds workflow` was removed in v6.0.0 (process orchestration moved to the adoption layer — DEC-049; see [MIGRATION-v6.md §3](../../docs/MIGRATION-v6.md#3-removed-4-deprecated-cli-commands)). There is no CLI install step: workflow definitions live directly under `skills/workflows/*.workflow.yaml` in this repo (see the table above), so reference them by path or copy them into your project's `.claude/workflows/`.
|
|
172
163
|
|
|
173
164
|
### Execution
|
|
174
165
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "universal-dev-standards",
|
|
3
|
-
"version": "6.
|
|
3
|
+
"version": "6.8.0",
|
|
4
4
|
"description": "CLI tool for adopting Universal Development Standards",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"documentation",
|
|
@@ -56,7 +56,9 @@
|
|
|
56
56
|
"prepare": "node ../scripts/setup-husky.mjs",
|
|
57
57
|
"test:upgrade": "node scripts/test-upgrade-path.mjs",
|
|
58
58
|
"check:bundle-parity": "node scripts/check-bundle-parity.mjs",
|
|
59
|
-
"prepack": "node scripts/prepack.mjs"
|
|
59
|
+
"prepack": "node scripts/prepack.mjs",
|
|
60
|
+
"check:reachability": "node scripts/check-module-reachability.mjs",
|
|
61
|
+
"check:command-existence": "node scripts/check-command-existence.mjs"
|
|
60
62
|
},
|
|
61
63
|
"dependencies": {
|
|
62
64
|
"@inquirer/prompts": "^8.4.2",
|