universal-dev-standards 6.14.0-beta.5 → 6.14.0-beta.7
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/README.md +13 -3
- package/bin/uds.js +32 -7
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +6 -2
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +44 -6
- package/bundled/ai/standards/open-work-tracking.ai.yaml +191 -11
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +48 -3
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +44 -4
- package/bundled/core/open-work-tracking.md +156 -16
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/locales/zh-CN/CHANGELOG.md +75 -3
- package/bundled/locales/zh-CN/README.md +1 -1
- package/bundled/locales/zh-CN/SECURITY.md +1 -1
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +13 -4
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +7 -1
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +7 -1
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +13 -3
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +7 -1
- package/bundled/locales/zh-CN/core/code-review-checklist.md +17 -0
- package/bundled/locales/zh-CN/core/developer-memory.md +9 -0
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +48 -8
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +5 -4
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +25 -23
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +15 -12
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +6 -6
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +7 -1
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +44 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/CHANGELOG.md +75 -3
- package/bundled/locales/zh-TW/README.md +1 -1
- package/bundled/locales/zh-TW/SECURITY.md +1 -1
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +13 -4
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +7 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +7 -1
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +13 -3
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -1
- package/bundled/locales/zh-TW/core/code-review-checklist.md +17 -0
- package/bundled/locales/zh-TW/core/developer-memory.md +9 -0
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +48 -8
- package/bundled/locales/zh-TW/core/open-work-tracking.md +90 -14
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +5 -4
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +25 -23
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +15 -12
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +6 -6
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +7 -1
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +44 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +305 -5
- package/package.json +3 -1
- package/src/commands/audit.js +9 -2
- package/src/commands/check.js +17 -0
- package/src/commands/deps.js +31 -1
- package/src/commands/init.js +41 -21
- package/src/commands/open-work.js +65 -6
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec.js +14 -8
- package/src/commands/update.js +106 -66
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +103 -0
- package/src/core/project-config.js +58 -38
- package/src/flows/init-flow.js +10 -0
- package/src/i18n/messages.js +264 -60
- package/src/installers/skills-installer.js +3 -1
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +75 -0
- package/src/reconciler/backup-manager.js +29 -45
- package/src/reconciler/index.js +62 -8
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/commit-message-judge.js +137 -0
- package/src/utils/copier.js +5 -4
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/open-work-tracking.mjs +919 -48
- package/src/utils/sdd-header.js +65 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +63 -105
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/transient-fs.js +113 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +9 -9
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/open-work-tracking.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
3
|
+
source_version: 1.4.0
|
|
4
|
+
translation_version: 1.4.0
|
|
5
|
+
last_synced: 2026-10-07
|
|
6
|
+
source_hash: 5b59fe93ed56
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -11,8 +11,8 @@ status: current
|
|
|
11
11
|
|
|
12
12
|
> **Language**: [English](../../../core/open-work-tracking.md) | 繁體中文
|
|
13
13
|
|
|
14
|
-
**版本**: 1.
|
|
15
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.4.0
|
|
15
|
+
**最後更新**: 2026-10-07
|
|
16
16
|
**適用**: 任何跨越一個以上工作階段承載工作、有可能在階段之間遺失項目的專案
|
|
17
17
|
**範圍**: universal
|
|
18
18
|
|
|
@@ -35,7 +35,7 @@ status: current
|
|
|
35
35
|
| 已規劃的項目還沒動工,時間過去 | 沒有時鐘的項目會無聲腐爛——沒有東西會再指向它 | 一個門檻,或一次被迫的定期檢視,讓它重新浮現 |
|
|
36
36
|
|
|
37
37
|
下面每一條要求都對應這張表的一列、對應本標準設計當天觀察到的四個失效之一,
|
|
38
|
-
或(OWT-017–OWT-019)對應 1.1.0
|
|
38
|
+
或(OWT-017–OWT-019)對應 1.1.0 補上的兩個缺口、或(OWT-020–OWT-026)對應 1.1.0 沒有命名的兩個狀態、或(OWT-027–OWT-029)對應等著另一個專案的工作
|
|
39
39
|
(見〈[證據與校準](#證據與校準)〉)。**沒有任何一個機制被規定**——
|
|
40
40
|
理由與 [deferred-item-exit](deferred-item-exit.md) 對自己出口的約束相同(DEC-049:
|
|
41
41
|
UDS 定義必須成立的關係,維持它的機制由採用層選擇)。
|
|
@@ -71,7 +71,7 @@ UDS 定義**活動**,採用層負責**編排**(DEC-049)。一份寫成工
|
|
|
71
71
|
(3)對任何有可靠來源可推導的欄位改用生成、(4)回報還剩什麼時同時揭露看不到什麼、
|
|
72
72
|
(5)在控制權從 agent 交回人的那一刻被檢視——而且那個檢視不能讓回合失敗、
|
|
73
73
|
(6)把「這份工作為了什麼」與「做到哪了」分開存放,並替前者的每一次修改留下交代、
|
|
74
|
-
(7
|
|
74
|
+
(7)讓每一個「下一步」都點名一個讀的人找得到的東西(對已問、等回覆的項目,則寫明何時問的、在等什麼、什麼事件解除它)、(8)分得出「還沒問」與「已問、等回覆」,並讓看不見的事實有一個帶戳記的存放處——`unknown` 是正式的值、每筆觀察的年齡一律顯示、(9)讓一個等待可以用邏輯名稱點名另一個專案裡的東西、說明這台機器看不看得到它,並把那份紀錄放在每個相關專案的 session 都讀得到的地方。**
|
|
75
75
|
|
|
76
76
|
---
|
|
77
77
|
|
|
@@ -97,7 +97,17 @@ UDS 定義**活動**,採用層負責**編排**(DEC-049)。一份寫成工
|
|
|
97
97
|
| **OWT-016** | 本標準各要求所引用的任何窗口或閾值,載明來歷,或標為未校準 | warning |
|
|
98
98
|
| **OWT-017** | 承載一件工作之目標、驗收條件或限制的載體,不同時承載它的進度或下一步,反之亦然。以走訪各載體的結構欄位(小節、欄位、型別化標記)判定,絕不看檔名。更新進度因此不需要碰目標 | warning |
|
|
99
99
|
| **OWT-018** | 對一件工作的目標、驗收條件或限制的每一次修改,都留下載明改了什麼、誰核可、為什麼的修訂紀錄。沒有核可者的修改,在控制權交回人時被列出(OWT-007),不得靜默 | error |
|
|
100
|
-
| **OWT-019** |
|
|
100
|
+
| **OWT-019** | 「下一步」欄位至少點名一個具體對象:檔案路徑、測試名稱、指令或需求編號之一。只有動詞(「繼續」「處理剩下的」)不算。它判斷有沒有點名對象,絕不判斷句子措辭好壞。處於 `asked-awaiting` 並滿足 OWT-022 的項目不在這裡判定:它的下一步可以就是它等的那個回覆,由 OWT-022 判定(何時問的、在等什麼、什麼事件解除它) | warning |
|
|
101
|
+
| **OWT-020** | 標為等待中的項目說明自己處於兩個狀態中的哪一個:`not-yet-asked`(還沒問:請求已草擬或已決定要問,尚未送出)或 `asked-awaiting`(已問、等回覆:已送出、還沒有回音)。不屬於這兩者的等待項目,在開放工作摘要裡被個別點名——不被合併進總數,也不被算成已完成 | warning |
|
|
102
|
+
| **OWT-021** | `not-yet-asked` 的項目點名那份草稿或那個動作(送出它就是解除條件):檔案路徑、指令、測試名稱或需求編號(沿用 OWT-019 的辨認方式) | warning |
|
|
103
|
+
| **OWT-022** | `asked-awaiting` 的項目帶有 `asked-at`(含年份的日曆日、不晚於今天),並滿足 OWT-002:在等什麼、什麼事件算解除 | warning |
|
|
104
|
+
| **OWT-023** | 手寫列只容許用在承載庫無法從版本控制、規格標記或 CI 結果推導的事實——例如訊息是否已寄出、對方是否已回覆、是否已核准。每一列帶有 `observed-by`(誰或什麼看到的)、`observed-at`(含年份的日曆日、不晚於今天)與 `yes`、`no` 或 `unknown` 的值;缺其中任一項的列即違反。檢查只判定欄位存在且格式正確——絕不判定那個觀察是否為真 | warning |
|
|
105
|
+
| **OWT-024** | `unknown` 是一個值,不是空白:值為 `unknown` 的列在任何摘要裡單獨計數、單獨顯示,永遠不被算成完成。標為完成、值卻是 `unknown` 的列即違反 | warning |
|
|
106
|
+
| **OWT-025** | 觀察的彙總顯示每筆觀察的年齡(距 `observed-at` 的天數)。超過宣告門檻的觀察被回報為「觀察已舊」、另計、不被算成已確認。戳只說誰、何時看到——絕不說它現在仍然如此 | warning |
|
|
107
|
+
| **OWT-026** | OWT-023 的例外不及於版本控制、規格標記或 CI 結果已能決定的欄位;OWT-003 仍成立。檢查只能拿一份這類主題的詞表去判定,所以其涵蓋率是未知的(OWT-011) | warning |
|
|
108
|
+
| **OWT-027** | 等待項目的解除條件(OWT-002)可以點名另一個專案裡的物件,寫成 `<專案>:<物件>`。專案是**邏輯名稱**(`uds`、`vibeops`),絕不是目錄;物件是檔案路徑、測試名稱、指令或需求編號(OWT-019 辨認的那幾種)或版本控制標籤;載體裡**沒有任何機器專屬的絕對路徑**。名稱在某台機器上對應哪個目錄,宣告在載體之外。一個在等這種物件的項目,沒有任何「可以被問」的請求,所以 OWT-020 的兩個狀態不適用於它 | warning |
|
|
109
|
+
| **OWT-028** | 對每一個這樣的解除條件,檢查說四種話之一,單獨計數、絕不合併成一個總數:**已解除**(該物件現在在對方專案裡存在)、**尚未解除**(專案看得到、物件不在)、**從這裡看不到**(這台機器看不到那個專案:不是已解除,也不是零)、或**需要人判斷**(專案看得到,但這類物件——例如測試名稱、指令、需求編號——沒有任何檢查讀得到的東西)。查找只讀這台機器上的檔案與版本控制,不開任何網路連線 | warning |
|
|
110
|
+
| **OWT-029** | 等著另一個專案的工作,其紀錄是受版本控制、每個相關專案的 session 都讀得到的 repo 裡的一個檔案;不得只放在個人的 AI 工具記憶裡——那種記憶綁一個使用者、一台機器,另一個 session 與 CI 都讀不到。用哪個 repo 是採用專案的選擇。參考檢查不判定載體放在哪裡 | warning |
|
|
101
111
|
|
|
102
112
|
---
|
|
103
113
|
|
|
@@ -164,6 +174,16 @@ UDS 定義**活動**,採用層負責**編排**(DEC-049)。一份寫成工
|
|
|
164
174
|
| 為什麼行為相反 | 它在看的事件本身夠稀少,擋在它上面不會把耐性用完 | TCI 自己的規則已經寫出這裡不能做成閘門的理由:**「一個在每個回合都為真的閘門會被關掉,關掉之後它什麼都不保護」**(TCI R4)。開放工作非空幾乎永遠為真,所以這個確認點被設計成永不保留控制權 |
|
|
165
175
|
| 兩者掛同一事件時的順序 | — | 先回報(OWT-009),所以即使那個回合隨後被 TCI 擋下,它的輸出仍然可見 |
|
|
166
176
|
|
|
177
|
+
### 摘要可以由程式印出,完整版按需取得
|
|
178
|
+
|
|
179
|
+
OWT-007 說的是:控制權從 agent 交回人的那一刻要有一份摘要。它**沒有**規定誰產生、多長,而滿足它的兩種明顯做法價格差很多。**由程式在回合結束時印出一份簡短摘要**:那是掛在回合結束事件上的既有機制所執行的一個指令的輸出,所以不消耗模型的 token,而**完整版在讀的人要看時才產生**。**或者由模型在每則回覆裡手工附上一張完整的表**:它滿足 OWT-007,是可行的選擇,但那是昂貴的做法,不是本標準要求的做法。OWT-008 與 OWT-009 對第一種做法照樣成立:程式只回報、永不阻斷,它的輸出排在任何阻斷式檢查的判決之前。
|
|
180
|
+
|
|
181
|
+
簡短摘要對每個開放項目怎麼分類,這裡建議一組詞彙(建議,不是要求):等人決策;等外部(對方回覆);等 CI;固定日期到期;無人看管。它們與 OWT-002、OWT-020–OWT-022 已讓承載庫記錄的東西(在等什麼、有沒有問過)相呼應;本標準不替摘要本身規定任何詞彙。
|
|
182
|
+
|
|
183
|
+
有一個採用專案是這樣做的:回合結束時由程式印出簡短摘要,完整清單在使用者呼叫時才產生。那個專案的檔案是私有的,所以這裡不放連結。它是一個外部範例,**不屬於 UDS 套件,也不保證與它相容**,只用來說明這個做法可行。
|
|
184
|
+
|
|
185
|
+
**誠實註記:** UDS 沒有出貨任何產生 OWT-007 摘要的程式,本標準也沒有任何東西檢查這種程式存在(見〈[什麼在執行本標準](#什麼在執行本標準)〉)。本小節描述的是滿足一條既有要求的較便宜做法,不新增要求編號,也不新增檢查。
|
|
186
|
+
|
|
167
187
|
---
|
|
168
188
|
|
|
169
189
|
## 錨點:走訪結構,不走訪措辭
|
|
@@ -216,21 +236,55 @@ agent 正當地會提出修改,禁止只會教它學會靜默地改——但
|
|
|
216
236
|
簡短但點了一個測試名稱的句子照樣過。這讓它留在 OWT-010 與 OWT-014 的範圍之內。
|
|
217
237
|
|
|
218
238
|
檢查回報三種結果,而不是一個綠燈:**點名且已找到**(對象被找到——例如路徑存在)、**點名但未找到**
|
|
219
|
-
|
|
239
|
+
(有點名對象但找不到——當下一步就是要建立它時是正當的)、**未點名**(違反)。自 1.4.0 起,有一種列另有第四種結果,見下面。
|
|
220
240
|
辨認「這串字是路徑、指令、測試名稱還是編號」本身是樣式比對,所以依 OWT-011 其涵蓋率明示為未知:
|
|
221
|
-
|
|
241
|
+
認不出的格式會被回報為未點名,而乾淨的通過絕不表示「每個下一步都夠具體」。標示「下一步」欄位的詞(`Next action`、`下一步`、`下一個動作` 等)是**一份清單**,以三種方式讀(標題、表頭、行內標籤),且屬未校準(OWT-016):欄位標題寫 `待辦` 或 `TODO` 的載體,要等採用專案宣告那個詞才會被讀到,因為範圍太寬的詞也會標在不是下一步的欄位上;而完全找不到欄位時,檢查以 2 結束,並印出每個載體看到了什麼、認得哪些詞。
|
|
242
|
+
|
|
243
|
+
**回覆的第四種結果(1.4.0)。** 下一步就是*那個回覆本身*(「等廠商回信」「等對方排時間」),沒有點名任何檔案、指令、測試或編號,過去被回報為未點名。那判定的是錯的東西:對一個已經問出去的項目,起點不是「動詞加對象」,而是 **OWT-022** 要求的三件事——何時問的(`asked-at`)、在等什麼、什麼事件解除它。所以處於 `asked-awaiting` 並滿足 OWT-022 的項目,由 OWT-022 判定、不由 OWT-019 判定,檢查把它回報為第四種結果:**等待回覆**。它不是違反;它**不算「已點名」**,也**不算完成**;它被單獨列出並顯示**年齡**,超過宣告門檻的標為**已舊**(沿用 OWT-025 用的門檻,未校準)。這個免除不是藏身處:只有項目是 `asked-awaiting` **而且** OWT-022 找不出缺漏時才適用。沒有 `asked-at`(或在未來)、沒有寫在等什麼、或沒有解除事件的列,照舊由 OWT-019 判定;`not-yet-asked` 的項目也一樣(它的下一步是送出那份草稿,OWT-021 要求它點名草稿);其他狀態的項目,以及寫成小節標題而不是帶狀態欄之列的下一步,也一樣。沒有狀態欄的載體,讀法與過去完全相同。兩個檢查以同一個函式讀這個項目,所以不可能對它給出相反的結論:`uds open-work waiting` 接受的列,在 `next-action` 底下絕不是 OWT-019 違反;`waiting` 以 OWT-022 報違反的列,絕不被免除。**這無法判定的事:**請求是否真的送出、是否仍未回覆。檢查只判定欄位存在且格式正確,與 OWT-023 對一筆觀察所做的相同(OWT-014)。
|
|
244
|
+
|
|
245
|
+
---
|
|
246
|
+
|
|
247
|
+
## 一個沒人問過的等待項目,不是在等待
|
|
248
|
+
|
|
249
|
+
**OWT-002** 要求等待中的項目說明在等什麼、什麼事件算解除。有兩件差別很大的事都滿足這句話。一則**草擬了、從沒送出**的訊息,等的是「有人把它送出去」;一則**已經送出**的訊息,等的是「對方回覆」。承載庫分不出這兩者,看不到聊天的助理也分不出——而差別正是重點:第一種在有人動手之前,永遠不會有任何東西到來。**OWT-020** 為這兩個狀態命名(`not-yet-asked`、`asked-awaiting`),並要求每個等待項目必處於其一;兩者皆非的項目被個別點名——與 OWT-012 點名未分類項目的方式相同——而且絕不算成已完成。
|
|
250
|
+
|
|
251
|
+
每個狀態再帶上讓它可被檢查的東西。`not-yet-asked` 的項目點名那份草稿或那個動作(**OWT-021**)——沿用 OWT-019 的辨認方式,所以詞彙只有一份——因為只有「問法務」、背後沒有檔案或指令,是一種心情,不是草稿。`asked-awaiting` 的項目帶有 `asked-at`(**OWT-022**),那是讓時鐘開始走的東西:從那一刻起項目有了年齡,有年齡的項目才能被門檻再次浮現。兩者都讀承載庫的結構狀態欄(OWT-010),絕不讀它周圍的措辭。嚴重度是 `warning`、狀態詞彙未校準(OWT-016):目的是讓這兩個狀態能被命名,不是在標準發布當天讓所有既有載體一次變紅。
|
|
252
|
+
|
|
253
|
+
---
|
|
254
|
+
|
|
255
|
+
## 沒有人能推導的事實,需要戳記、誠實的「未知」與看得見的年齡
|
|
256
|
+
|
|
257
|
+
開放工作裡有些事實,助理沒有任何來源可以讀:訊息是否已寄出、對方是否已回覆、某事是否已核准。**OWT-003** 只允許從可推導的來源生成,而下方的表格拒絕手寫狀態檔是有道理的——它會過期,而比過期內容新的戳是隱形的。這類事實沒有可推導的來源可供生成,把手寫列一律拒絕,就讓它們無處可住,最後流落到沒有任何東西會計數的自由文字裡。
|
|
258
|
+
|
|
259
|
+
因此 1.2.0 容許一個**窄例外**(**OWT-023**–**OWT-026**),附三個條件。那一列寫明**誰在何時看到**(`observed-by`、`observed-at`)。它的值是 `yes`、`no` 或 **`unknown`**,而 `unknown` 是正式的值,單獨計數、單獨顯示、永遠不算完成(**OWT-024**)——與 OWT-006 同一種讀法:看不到的不是零。而且報告顯示**每筆觀察的年齡**(**OWT-025**);超過宣告門檻的被回報為「觀察已舊」、另計、不算已確認。這個例外不及於版本控制、規格標記或 CI 結果已能決定的東西(**OWT-026**),因為 OWT-003 沒有被放寬。
|
|
260
|
+
|
|
261
|
+
這不是在宣稱整件事都誠實。戳只說有人在某時看到;**它不說現在仍然如此**,報告就是圍繞這一點建的:年齡印在值的旁邊,所以戳原本會藏起來的過期,是讀者第一眼看到的東西。而檢查能判定的只有可判定的部分:`observed-by` 有沒有填、`observed-at` 是不是一個真實的日子、值在不在值域內。**它判定不了 `observed-by` 填的是不是真的去看過的人,也判定不了那個值是否為真**——那是關於世界的宣稱,不是 artefact 之間的關係(OWT-014),本標準不假裝做得到。「觀察已舊」的門檻沒有任何量測支持(OWT-016)。
|
|
262
|
+
|
|
263
|
+
**這些嚴重度的理由(1.2.0)。** OWT-020 到 OWT-026 全是 `warning`:狀態詞、欄位名與「觀察已舊」的門檻是第一版詞彙,沒有任何量測支持(OWT-016),而違反的代價是讀的人的時間,不是工作本身。更嚴的等級,會讓所有早於這兩個狀態存在的載體在標準發布當天變紅;`warning` 讓採用者先看到清單。**但指令對任何違反都回結束碼 1,`warning` 也一樣**——`uds open-work next-action` 對 OWT-019 本來就是如此——所以把其中一支接進閘門的採用者,自己決定警告要不要擋。
|
|
264
|
+
|
|
265
|
+
---
|
|
266
|
+
|
|
267
|
+
## 對另一個專案的等待,只點名它,不定位它
|
|
268
|
+
|
|
269
|
+
彼此相依的專案會產生一種 OWT-002 從未為它而寫的等待:一個專案的項目,在等另一個專案的產出。1.3.0 讓解除條件可以點名它——`uds:v6.14.0` 或 `vibeops:docs/runbook.md`——並說明什麼東西能防止這種紀錄腐壞(**OWT-027**)。專案是**邏輯名稱**,絕不是目錄。目錄屬於一台機器、一個使用者(它會洩漏使用者名稱,換一台機器就是錯的),而同一份載體的兩個讀者,必須用同一個名稱指同一個專案。所以載體裡放的是名稱,「名稱對應到某台機器上的哪個目錄」則宣告在載體**之外**(參考檢查接受可重複的 `--root NAME=DIR`,或採用專案的設定)。解除條件裡出現機器專屬的絕對路徑即違反。一個在等另一個專案之物件的項目,沒有任何「可以被問」的請求,所以 OWT-020 的兩個狀態不適用於它;它仍被點名,並在自己那一行被計數。
|
|
270
|
+
|
|
271
|
+
檢查對這種等待的回報是四種(**OWT-028**),理由與 OWT-006 相同:**看不到的,不是零。** 已解除;尚未解除;**從這裡看不到**——對方專案不在這台機器上、或讀不到它的版本控制——它單獨計數,既不是已解除也不是零;以及**需要人判斷**——專案看得到,但裡面的測試名稱、指令或需求編號沒有任何檢查讀得到的東西。路徑與版本控制標籤是機器可觀察的:它在對方專案裡存在,或不存在。查找只讀這台機器上的檔案與版本控制、不開任何連線,而「已解除」只說該物件在那邊存在,絕不說它是對的那個物件(OWT-014)。
|
|
272
|
+
|
|
273
|
+
**OWT-029** 說這種紀錄放在哪裡:放在每個相關專案的 session 都讀得到、受版本控制的 repo 裡,而不是只放在某個人的 AI 工具記憶裡。那種記憶綁一個使用者、一台機器,另一個 session 與 CI 都看不到,也沒有給檢查任何具名的載體去判定關係(OWT-014)。用哪個 repo,是採用專案的選擇。本版涵蓋的是一個人在一台機器上的各個 session;工作如何在人與人之間共享、共享的紀錄要不要先審核才可信,這裡不決定。
|
|
274
|
+
|
|
275
|
+
**為什麼是 `warning`、什麼未校準(1.3.0)。** OWT-027 到 OWT-029 是 `warning`,理由與上面 OWT-020 到 OWT-026 相同。構成邏輯名稱的樣式、機器專屬路徑前綴的清單(家目錄與磁碟區目錄、磁碟機代號、`~/`),以及檢查能查找的兩種物件(路徑與標籤),都是第一版判斷(OWT-016);涵蓋率未知(OWT-011),因為用清單裡沒有的形式寫的路徑,不會被認成絕對路徑。
|
|
222
276
|
|
|
223
277
|
---
|
|
224
278
|
|
|
225
279
|
## 本標準刻意不採納的東西
|
|
226
280
|
|
|
227
|
-
|
|
281
|
+
1.1.0 的兩項新增(OWT-017–OWT-019:目標與進度分開並留下修訂紀錄、以及點名對象的下一步),起因是使用者轉貼的一份提示詞——**作者與出處不明,也沒有任何實作**。
|
|
228
282
|
只借了它的設計形狀,本文不引用它的任何宣稱。它提出的其餘部分經過檢視、**沒有**採納,
|
|
229
283
|
理由是機制層的,不是口味:
|
|
230
284
|
|
|
231
285
|
| 不採納 | 理由(機制層) |
|
|
232
286
|
|---|---|
|
|
233
|
-
|
|
|
287
|
+
| 以手寫狀態檔作為任何「已有可靠來源可決定」之狀態的真相 | 手寫狀態會過期,而「戳比過期內容新」是隱形的(OWT-004、OWT-005 存在的起因)。只說「兩者不一致時以版本控制為準」,卻沒有任何機制讓該檔與版本控制對帳,就是採納一個已知會過期的來源。OWT-003 已經要求可推導的欄位改用生成。**自 1.2.0 起有一個窄例外(OWT-023–OWT-026)**:對「沒有任何東西能推導」的事實——訊息是否已寄出、對方是否已回覆——容許一列手寫。它只有在附上誰何時看到的戳記、值可以誠實地是 `unknown`、且每份報告都顯示年齡時才被容許,並且絕不及於版本控制、規格標記或 CI 結果已能決定的欄位。上面的反對理由是被回答了,不是被擱置:那個理由是過期看不見,而這裡年齡就印在每個值旁邊 |
|
|
234
288
|
| 固定的開工儀式(讀檔→查版本控制→驗證) | 交接點已被管住:回合結束有 OWT-007,另有 [turn-completion-integrity](turn-completion-integrity.md)。開工儀式要靠各代理工具自己的指示來設定;寫進這裡只會得到一條沒有任何 artefact 上的檢查判定得了的要求,而那正是 OWT-014 排除的東西 |
|
|
235
289
|
|
|
236
290
|
---
|
|
@@ -274,8 +328,14 @@ DEX-003 扮演的角色相同。上面每一條都指名了 artefact 與它們
|
|
|
274
328
|
| 分類狀態只靠散文措辭判讀 | 正確到某個項目用清單沒預料到的方式寫出來為止 |
|
|
275
329
|
| 項目從承載庫裡無聲消失 | 與一個弄丟它的 bug 無從分辨 |
|
|
276
330
|
| 目標或驗收條件被改了,卻沒有任何「誰同意」的紀錄 | 「每一條驗收都滿足」依然為真,只是針對另一組條件;被改過的目標讀起來像一直這麼寫 |
|
|
277
|
-
|
|
|
331
|
+
| 把手寫的狀態檔當成版本控制或 CI 早已知道之事的真相 | 會過期,而比過期內容新的戳看不見 |
|
|
278
332
|
| 下一步寫「繼續實作」或「處理剩下的」 | 沒有點名任何可以開始的東西;與被遺忘的項目無從分辨 |
|
|
333
|
+
| 等待項目沒有任何「有沒有人問過」的紀錄 | 沒人送出的草稿與沒人回的請求看起來一模一樣;等待永遠不會讓前者解除 |
|
|
334
|
+
| 手寫的「已寄出/已回覆/已核准」,沒有名字也沒有日期 | 與猜測無從分辨,過期時也沒有任何東西顯示 |
|
|
335
|
+
| 一個沒有人能做的觀察,被算成「否」或已完成 | 看不到的事實被讀成不存在或已完成;`unknown` 是一個值,不是零 |
|
|
336
|
+
| 對另一個專案的等待,用某一台機器的目錄記下來 | 換一台機器就是錯的、洩漏使用者名稱,同一份載體的兩個讀者也不再指同一個專案 |
|
|
337
|
+
| 這台機器看不到的專案,被算成已解除或零 | 沒看過的被讀成做完了;「從這裡看不到」是它自己的一個計數 |
|
|
338
|
+
| 等著另一個專案的工作,只放在某個人的 AI 工具記憶裡 | 另一個 session 與 CI 讀不到,檢查也沒有任何具名的載體可以判定 |
|
|
279
339
|
|
|
280
340
|
---
|
|
281
341
|
|
|
@@ -288,6 +348,12 @@ DEX-003 扮演的角色相同。上面每一條都指名了 artefact 與它們
|
|
|
288
348
|
作為 OWT-015 意義上的證據——它已被觀察到對違反的樣本回報失敗——供採用者直接執行或自行重做。
|
|
289
349
|
它沒有接進任何 UDS 發版閘門,因為 UDS 本身沒有承載開放工作的地方可供它檢查。對 OWT-019,它以同一份詞彙讀三種形狀的「下一步」欄位:小節標題、行內標籤、以及表頭在該詞彙內的表格欄(該欄每一列各算一個欄位)。欄數與表頭不一致的表格列會被列為「判定不了」(不會被當成空白;若別處沒有違反,結束碼是 2,不是通過);空白、`—`、`-` 或已完成的儲存格只計數、不評估——它不算違反,因為 OWT-019 判斷的是「寫了的下一步有沒有點名對象」,沒寫是另一種失效,它不判定。
|
|
290
350
|
|
|
351
|
+
自 1.2.0 起,同一份程式還附上 `uds open-work waiting`(OWT-020–OWT-022)與 `uds open-work observations`(OWT-023–OWT-026),結束碼相同(0 無違反、1 違反、2 判定不了)。今天的日期是被注入的(`--now`),絕不在規則裡讀時鐘,所以結果不會隨日子漂移;`--stale-after` 宣告門檻。兩者都以結構欄位名讀表格與清單項目,中英文皆可。沒有 `observed-by` 也沒有 `observed-at` 欄的表格不被讀成觀察載體;用詞彙裡沒有的字寫成的等待項目,被讀成「不是等待」——所以乾淨的通過只涵蓋被辨認出來的部分,而每次執行都這麼說(OWT-011)。`uds open-work self-test` 對 OWT-020–OWT-026 每一條各跑一個違反的樣本與一個符合的樣本,突變測試顯示拿掉任何一個偵測都會讓某個測試或自測變紅(OWT-015)。與 1.1.0 的檢查相同,它都沒有接進任何 UDS 發版閘門。
|
|
352
|
+
|
|
353
|
+
自 1.3.0 起,`uds open-work waiting` 也會解析點名另一個專案的解除條件(OWT-027–OWT-028):`--root NAME=DIR`(可重複,並與它一直接受的單一 `--root DIR` 並存),或 `uds.project.yaml` 的 `open_work.projects`,說明每個專案在哪裡;看不到的專案被單獨計數。`uds open-work next-action` 與 `separation` 接受 `--next-action-word WORD`(可重複),或 `open_work.next_action_words`,放採用專案的載體所用的詞;`uds open-work next-action` 與 `waiting` 接受 `--command-word 程式名`(可重複;`glab` 與 `dotnet` 內建,`go`、`make`、`sh` 刻意不內建),或 `open_work.command_words`,放它讀成指令的程式。`next-action` 另外會說路徑是在哪個目錄下查找的、那個目錄從哪來,並把 `named-unresolved` 分成 `path-missing`(查過、不在)與 `not-resolvable`(指令、測試名稱、需求編號,從不查找)。檢查本體不讀任何設定檔,是 `uds` 指令把設定傳進去,所以 `node scripts/check-open-work-tracking.mjs` 只接受旗標。
|
|
354
|
+
|
|
355
|
+
自 1.4.0 起,`uds open-work next-action` 以 `waiting` 所用的同一個函式、同一個日期讀每一列的狀態,把處於 `asked-awaiting` 且滿足 OWT-022 的列回報為 `waiting-on-reply`:單獨計數(只有在數量不是 0 時才在計數行尾附上 `waiting-on-reply=N`,所以沒有這種列的載體印出的與過去一模一樣)、在自己的一節裡列出並顯示年齡、不算違反。它接受 `--now`(日期,絕不在規則裡讀時鐘)與 `--stale-after`(預設 7 天,未校準)。**對含有這種列的載體,`next-action` 的結束碼會改變:過去因「未點名」而回 1 的列,現在不再讓它回 1。**沒有狀態欄的載體,或列不在這種狀態的載體,印出的與 1.3.0 完全相同。`uds open-work self-test` 對這個結果附上一個符合的樣本與多個違反的樣本(沒有 `asked-at`、`asked-at` 在未來、沒寫在等什麼、沒有解除事件、`not-yet-asked`、其他狀態、沒有狀態欄的載體、小節標題),以及一個同時讀 `waiting` 與 `next-action`、要求兩者一致的自測臂。
|
|
356
|
+
|
|
291
357
|
本標準做的事,是讓那個決定顯形:OWT-014 保證這裡每一條**能**被判定,OWT-015 固定
|
|
292
358
|
「一次判定要算數需要什麼」,OWT-005/OWT-011 固定「一次不完整的判定容許印出什麼」。
|
|
293
359
|
|
|
@@ -315,6 +381,12 @@ DEX-003 扮演的角色相同。上面每一條都指名了 artefact 與它們
|
|
|
315
381
|
或修訂紀錄的標題詞彙;它認得的指令名清單;副檔名清單;需求編號的樣式。
|
|
316
382
|
沒有任何一項對照過真實使用量測,採用專案應傳入自己的。
|
|
317
383
|
|
|
384
|
+
**1.2.0 的新增(OWT-020–OWT-026)**來自一個採用專案在 2026-10-07 對 6.14.0-beta.5 的測試回報(XSPEC-459):一則草擬了從沒送出的訊息,與一則已送出、沒人回的訊息分不出來;助理無法觀察的事實,沒有一個被認可的地方可以寫。那支參考判定程序只有幾小時大、只有一位作者,跑過的是人造樣本,不是真實的待辦。依 OWT-016,它用到的一切類似閾值的東西都是**未校準、初始判斷**:中英文的狀態詞與欄位名、被當成「可推導」的主題清單、「觀察已舊」預設的 7 天、以及日期的讀法(必須有年份;時間不看)。沒有任何一項對照過真實使用量測,採用專案應以自己的詞彙與門檻取代預設。
|
|
385
|
+
|
|
386
|
+
**1.3.0 的新增(OWT-027–OWT-029)**來自同一個採用專案在 2026-10-07 的工作(XSPEC-460 與 XSPEC-461):一個專案的項目在等另一個專案的產出,而當時唯一的紀錄方式是臨時約定;另有一位使用者的載體一個狀態一張表,`next-action` 回了 2,卻沒有說為什麼。依 OWT-016,新的查找所用到的一切類似閾值的東西都是**未校準、初始判斷**:構成邏輯名稱的樣式、機器專屬的路徑前綴、它能查找的兩種物件(路徑與標籤),以及「下一步」詞——內建清單,與它拒絕收進 `待辦`、`後續`、`Next`、`TODO`、`Action` 的決定。沒有任何一項對照過真實使用量測。
|
|
387
|
+
|
|
388
|
+
**1.4.0 的新增(沒有新的要求編號)**來自同一個採用專案對 6.14.0-beta.5 的測試(2026-10-07,XSPEC-464):它的 17 個下一步欄位中有 14 個是「等對方回信」「等排時間」或「等撤銷」;`waiting` 接受這些列、`next-action` 卻拒絕同一批列;而該專案拒絕只為了讓檢查通過而改寫自己的載體。依 OWT-016,新結果用到的一切類似閾值的東西都是**未校準、初始判斷**:「已舊」的 7 天是 OWT-025 本來就帶的預設,未經量測就沿用,而狀態詞就是 OWT-020 讀的那些。這個結果只和載體的紀錄一樣好:只寫了解除條件、沒寫問的日期的載體,在補上日期之前仍由 OWT-019 判定。
|
|
389
|
+
|
|
318
390
|
---
|
|
319
391
|
|
|
320
392
|
## 與其他標準的關係
|
|
@@ -332,3 +404,7 @@ DEX-003 扮演的角色相同。上面每一條都指名了 artefact 與它們
|
|
|
332
404
|
而不是揭露一次就放著。
|
|
333
405
|
- OWT-018 掛在與 OWT-007 相同的交回點:沒有核可者的意圖修改,是在那裡多列出來的一項,
|
|
334
406
|
而且與列在那裡的一切相同,永不阻斷。
|
|
407
|
+
- OWT-020–OWT-022 細化 OWT-002(等待項目說明在等什麼與解除條件),說明那是哪一種等待;OWT-023–OWT-026 與 OWT-003、OWT-006 並列——前者說什麼可以生成、什麼不可以,後者說看不到的絕不被算成零。
|
|
408
|
+
- OWT-027–OWT-029 把 OWT-002 延伸過專案的邊界(解除條件可以是另一個專案的物件),並連同 OWT-006:這台機器看不到的專案被單獨計數,絕不算成已解除、也絕不算成零。
|
|
409
|
+
|
|
410
|
+
- OWT-019 與 OWT-022 在一點上交會(1.4.0):處於 `asked-awaiting` 並滿足 OWT-022 的項目由 OWT-022 判定,它的下一步可以就是它等的那個回覆;其他每一個下一步照舊由 OWT-019 判定。
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/pipeline-security-gates.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-07
|
|
6
|
-
source_hash:
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
last_synced: 2026-10-07
|
|
6
|
+
source_hash: a1e0a4792a90
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -22,6 +22,7 @@ status: current
|
|
|
22
22
|
## 核心原則
|
|
23
23
|
|
|
24
24
|
- **機密掃描在 pre-commit**:所有包含機密的提交都必須被阻擋,不得例外
|
|
25
|
+
- **機密掃描器自己的行為也要寫明**:輸出不得印出被匹配到的機密值;掃描器跑不起來視同閘門失敗(見 1.1 節)
|
|
25
26
|
- **SAST 在建置後**:Critical 和 High 等級發現阻斷 pipeline
|
|
26
27
|
- **SCA + SBOM 在封包階段**:追蹤相依套件風險並產生物料清單
|
|
27
28
|
- **Attestation 驗證在發布前**:封包後、部署前 MUST 驗證 artifact 的 checksum、簽章與 SLSA provenance(消費 supply-chain-attestation 標準的產出,不得「產生 SBOM 卻不驗」)
|
|
@@ -44,6 +45,65 @@ status: current
|
|
|
44
45
|
|
|
45
46
|
**重要**:此閘門必須在程式碼進入版本控制前執行,一旦機密進入 git 歷史便需要完整的機密輪換程序。
|
|
46
47
|
|
|
48
|
+
### 1.1 掃描器自己的三個行為(1.1.0 新增)
|
|
49
|
+
|
|
50
|
+
上表講「掃什麼、什麼時候阻斷」;本節講**掃描器本身**必須怎麼表現。以下三條都以本標準既有的兩條原則為前提:
|
|
51
|
+
「安全閘門失敗 = pipeline 失敗」與「禁止靜默跳過安全閘門」。
|
|
52
|
+
|
|
53
|
+
| 編號 | 強度 | 要求 |
|
|
54
|
+
|------|------|------|
|
|
55
|
+
| **PSG-1** | 必須(MUST) | 掃描的輸出——終端機、CI 紀錄、報告檔——**不得包含被匹配到的機密值本身**,只能指出檔案、行號與規則名稱 |
|
|
56
|
+
| **PSG-2** | 必須(MUST) | 掃描器**無法執行**視同閘門失敗,**必須阻斷**提交/pipeline,不得放行 |
|
|
57
|
+
| **PSG-3** | 建議(SHOULD) | 團隊**自己撰寫**的偵測規則,每一條都有一個該被抓到(紅)與一個不該被誤報(綠)的測試樣本,樣本在測試中執行 |
|
|
58
|
+
|
|
59
|
+
#### PSG-1 輸出不得印出被匹配到的機密值
|
|
60
|
+
|
|
61
|
+
理由:掃描紀錄會被貼進聊天室與工單。閘門把機密值印在輸出裡,等於把已被擋下的機密再洩漏一次。
|
|
62
|
+
|
|
63
|
+
工具註記(只寫已查證的):
|
|
64
|
+
|
|
65
|
+
| 工具 | 註記 | 依據 |
|
|
66
|
+
|------|------|------|
|
|
67
|
+
| gitleaks | 官方 README 的範例輸出(`gitleaks git -v`,未加 `--redact`)含 `Secret:` 一行,印出被匹配到的值全文;`--redact` 旗標的說明為「redact secrets from logs and stdout」。README 未說明 `--redact` 是否也涵蓋 `--report-path` 產生的報告檔,**採用者須自行確認** | gitleaks 官方 README,2026-10-07 讀取 |
|
|
68
|
+
| detect-secrets | 預設輸出行為**本標準未查證,採用者須自行確認** | — |
|
|
69
|
+
| trufflehog | 預設輸出行為**本標準未查證,採用者須自行確認** | — |
|
|
70
|
+
|
|
71
|
+
判定程序(示意,三行):
|
|
72
|
+
|
|
73
|
+
1. 建一個含**假**密鑰的檔案(示意記法:`FAKE-SECRET-DO-NOT-USE-0000`;實際樣本須是**你自己的閘門會匹配的格式**——例如自寫一條 canary 規則,或工具文件列出的測試樣式——且必須是假值,不得是任何真實服務的有效憑證),加入 staging 後執行閘門,**先確認閘門確實阻斷**。
|
|
74
|
+
2. 沒阻斷代表樣本沒被匹配,第 3 步不算數——此時輸出裡當然找不到它,結果是「綠得虛假」。
|
|
75
|
+
3. 在終端機、CI 紀錄、報告檔的**全部輸出**搜尋該假密鑰字串;找到任何一處即不合規。
|
|
76
|
+
|
|
77
|
+
#### PSG-2 掃描器跑不起來視為閘門失敗
|
|
78
|
+
|
|
79
|
+
「跑不起來」包含:執行檔不存在、設定檔無法讀取或無效、逾時、非預期的結束。這些情況必須阻斷,**不得**以 `|| true`、`2>/dev/null` 等方式吞掉,也不得讓閘門輸出「掃描通過」。
|
|
80
|
+
|
|
81
|
+
UDS 自己的先例:`uds init` 為非 Node 專案寫的原生 `.git/hooks/pre-commit`,曾把每個檢查接上 `2>/dev/null || true` 後印出「Pre-commit checks passed」——檢查壞掉也照樣放行,且藏起自己的錯誤。6.14.0-beta.4 修正(見 CHANGELOG 該版〈Fixed〉)。
|
|
82
|
+
|
|
83
|
+
工具註記:gitleaks 官方 README 的〈Exit Codes〉一節寫 `1 - leaks or error encountered`——找到洩漏與發生錯誤是**同一個結束碼**,所以**區分原因要靠輸出,不靠結束碼**;對阻斷與否,兩者的結論相同。README 另說明 `--exit-code` 旗標可改寫「找到洩漏時」的結束碼(2026-10-07 讀取):把它設成 0 會讓閘門在找到洩漏時放行,不得這樣設定。detect-secrets、trufflehog 的結束碼行為**本標準未查證,採用者須自行確認**。
|
|
84
|
+
|
|
85
|
+
判定程序(示意,三行):
|
|
86
|
+
|
|
87
|
+
1. 把掃描器執行檔改名或移走,或把它的設定檔改成無效內容。
|
|
88
|
+
2. 對一個**不含任何機密**的提交執行閘門(此時若被阻斷,原因只可能是掃描器跑不起來)。
|
|
89
|
+
3. 提交被阻斷(結束碼非 0),且輸出說明是掃描器無法執行;若提交被放行,或輸出看起來像「掃描通過」,即不合規。
|
|
90
|
+
|
|
91
|
+
#### PSG-3 自己寫的偵測規則,每條要有紅綠樣本
|
|
92
|
+
|
|
93
|
+
適用於團隊**自己撰寫**的規則,包含 `secret-management-standards` 的 REQ-003 所列的最低四種:AWS access key、PEM 私鑰標頭、一般 API token、含密碼的連線字串。只用工具內建規則、不自己寫規則的團隊不適用。
|
|
94
|
+
|
|
95
|
+
道理與 `open-work-tracking` 的 OWT-015 相同:沒見過失敗的檢查不算證據。一條從沒被紅樣本匹配過的規則,無法證明它抓得到東西;一條沒有綠樣本的規則,無法證明它不會把正常程式碼全擋下來。
|
|
96
|
+
|
|
97
|
+
判定程序(示意,三行):
|
|
98
|
+
|
|
99
|
+
1. 列出團隊自寫的全部偵測規則。
|
|
100
|
+
2. 逐條找對應的一個紅樣本(必被匹配)與一個綠樣本(不得匹配);樣本須是假值。
|
|
101
|
+
3. 確認樣本在測試中真的執行;缺任一個即列為缺口(本條為建議,缺口不阻斷)。
|
|
102
|
+
|
|
103
|
+
#### 範圍的誠實註明
|
|
104
|
+
|
|
105
|
+
UDS **不出貨掃描器**。上面三段是採用者在**自己的閘門**上自行驗證的程序。UDS 自己的 repo 目前也沒有機密掃描(CI 與 hook 都沒有用到上述三種工具)。
|
|
106
|
+
|
|
47
107
|
---
|
|
48
108
|
|
|
49
109
|
### 2. Post-Build — SAST(靜態應用安全測試)
|
|
@@ -72,6 +72,11 @@ proposed → active → deprecated
|
|
|
72
72
|
3. **提議** — 發現新的隱含慣例時,建議建立新的記憶項目
|
|
73
73
|
4. **衝突** — 如果使用者請求與活躍記憶衝突,必須提醒使用者
|
|
74
74
|
|
|
75
|
+
## 邊界:本標準不放什麼
|
|
76
|
+
|
|
77
|
+
- **個人、跨專案、可識別的資訊**(誰負責什麼、怎麼連到某個環境)不是專案情境:這裡的條目放在 repo 裡,會被每個 clone 它的人看到。把它們放在使用者自己的 AI 工具記憶,不要放進 `.project-context/`。
|
|
78
|
+
- **專案之間的協調**(哪件工作在等哪件工作)是開放工作,不是情境:見 [Open Work Tracking](open-work-tracking.md)(OWT-027–OWT-029)。
|
|
79
|
+
|
|
75
80
|
## 相關標準
|
|
76
81
|
|
|
77
82
|
- [情境感知載入](context-aware-loading.md)
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../docs/AVAILABLE-STANDARDS.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-10-07
|
|
6
|
+
source_hash: a189829f9324
|
|
7
|
+
status: current
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 可用標準:UDS 有出貨、你的專案沒有裝的標準
|
|
11
|
+
|
|
12
|
+
> **語言**: [English](../../../docs/AVAILABLE-STANDARDS.md) | 繁體中文 | [简体中文](../../zh-CN/docs/AVAILABLE-STANDARDS.md)
|
|
13
|
+
|
|
14
|
+
用舊版 UDS 設定的專案,只保有當時裝的標準。之後 UDS 新增的標準**不會**被 `uds update --apply` 裝上,
|
|
15
|
+
因為更新只維護專案清單(`.standards/manifest.json`)列出的東西。這個功能出現之前,沒有任何指令會告訴你
|
|
16
|
+
它們存在。現在有三個指令會告訴你,另一個讓你挑著裝。
|
|
17
|
+
|
|
18
|
+
## 唯一的規則
|
|
19
|
+
|
|
20
|
+
一個標準同時符合下列三點,就是**可用但未安裝**:
|
|
21
|
+
|
|
22
|
+
1. 它的類別是 `uds init` 會安裝的類別(`reference` 或 `skill`,見下表),
|
|
23
|
+
2. 在你專案的 `format`(預設 `ai`)下有來源檔(只有技能、沒有檔案的項目不算),
|
|
24
|
+
3. `manifest.standards` 裡沒有同名檔案。
|
|
25
|
+
|
|
26
|
+
這條規則只寫在一個函式裡(`getAvailableStandards`,`cli/src/utils/available-standards.js`)。`uds update` 舊的
|
|
27
|
+
互動路徑、`uds update --plan`/`--apply`、`uds check`、`uds audit --friction` 都問它,所以不會各說各話。
|
|
28
|
+
|
|
29
|
+
## 類別
|
|
30
|
+
|
|
31
|
+
| 類別 | 列為「可用」? | 原因 |
|
|
32
|
+
|---|---|---|
|
|
33
|
+
| `reference` | 是 | `uds init` 會把它裝進 `.standards/`。 |
|
|
34
|
+
| `skill` | 是 | `uds init` 會把它裝進 `.standards/`。 |
|
|
35
|
+
| `core` | **否,但會計數、可用 id 安裝** | 2026 年 3 月才加進登記表,晚於安裝程式「只裝 reference 或 skill」的過濾(2025 年 12 月)。`uds init` 從來沒裝過它,所以對專案而言它從來不是「新的」。這是歷史意外,不是設計決定。 |
|
|
36
|
+
| `testing`、`security`、`deployment`、`operations` | **否,但會計數、可用 id 安裝** | 與 `core` 相同:後來才加,init 從沒裝過。 |
|
|
37
|
+
| `extension` | 否,**`--add-standard` 也不安裝** | 由 init 的語言/框架/語系選項(`--lang`、`--framework`、`--locale`)安裝。 |
|
|
38
|
+
| `integration` | 否,`--add-standard` 也不安裝 | 每個 AI 工具各一個整合檔,由 init 的 AI 工具選項安裝。 |
|
|
39
|
+
| `template` | 否,`--add-standard` 也不安裝 | 要複製使用的文件範本,不是標準檔。 |
|
|
40
|
+
|
|
41
|
+
其他類別不會被悄悄丟掉:`uds update --plan` 結尾會有一行說明有幾個、在哪些類別;可安裝的類別都能用 id 指名安裝
|
|
42
|
+
(見下)。它們是否該像 `reference`/`skill` 一樣被**列出**,是還沒決定的事(XSPEC-458 OQ1)。
|
|
43
|
+
|
|
44
|
+
## 與這件事無關的 manifest 欄位
|
|
45
|
+
|
|
46
|
+
| 欄位 | 狀態 | 作用 |
|
|
47
|
+
|---|---|---|
|
|
48
|
+
| `level` | 死欄位 | 6.11.0 寫的 manifest 只在 `integrationConfigs[<檔案>].level` 裡留有殘值。沒有任何程式碼用它決定安裝什麼。登記表的「等級系統」是已棄用的空殼。 |
|
|
49
|
+
| `profile` | 不存在 | CLI 與任何 manifest 都沒有這個欄位。 |
|
|
50
|
+
| `contentMode` | 有作用,但與此無關 | 決定 `CLAUDE.md` 怎麼產生(`minimal` 或 `index`)。它從不決定裝哪些標準。 |
|
|
51
|
+
|
|
52
|
+
## 指令
|
|
53
|
+
|
|
54
|
+
```sh
|
|
55
|
+
uds update --plan # 先印計畫,再印「上游有、專案沒裝(N 個)」,依類別分組
|
|
56
|
+
uds update --apply # 套用計畫;結尾印出有幾個可用、怎麼裝
|
|
57
|
+
uds update --apply --add-standard open-work-tracking # 裝一個,並記入 manifest
|
|
58
|
+
uds update --apply --add-standard a --add-standard b # 裝多個
|
|
59
|
+
uds update --plan --add-standard open-work-tracking # 先預覽
|
|
60
|
+
uds check # 一行:「上游有 N 個標準未安裝」
|
|
61
|
+
uds audit --friction # 一項低嚴重度發現(不進 --report、不影響 --score)
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
- 除了 `--add-standard`,上面全是**純資訊**:計畫的動作、`uds check` 的判定與結束碼、`uds audit --score`
|
|
65
|
+
都與以前完全相同。`uds audit --score` 不讀這項發現。
|
|
66
|
+
- `--add-standard` 要搭配 `--plan` 或 `--apply`。它會記入 `manifest.standards`,所以之後的 `uds update --apply`
|
|
67
|
+
會保留它(manifest 沒列出的檔會被當成多餘的)。再跑一次 `--plan` 沒有變動;`uds update --rollback` 會把它
|
|
68
|
+
拿掉(manifest 一起還原)。
|
|
69
|
+
- 未知的 id 以非 0 結束並列出最相近的 id;已安裝的 id 會說明已安裝並以 0 結束;`extension`、`integration`、
|
|
70
|
+
`template` 的 id 會被拒絕並說明原因。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# UDS 速查表
|
|
2
2
|
|
|
3
|
-
> Quick reference for all UDS features | Last updated: 2026-10-
|
|
3
|
+
> Quick reference for all UDS features | Last updated: 2026-10-08
|
|
4
4
|
|
|
5
5
|
**Language**: [English](../../../docs/user/CHEATSHEET.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CHEATSHEET.md)
|
|
6
6
|
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
| `uds configure` | Alias for "uds config" — Modify project settings |
|
|
18
18
|
| `uds check` | Check file integrity and adoption status (quick validation). For deep health diagnosis, use "uds audit" |
|
|
19
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) |
|
|
20
|
+
| `uds simulate` | Simulate a standard check with input (Predictive Validation). Exit 0 = passes, 1 = does not comply, 2 = no verdict (cannot simulate; not a pass). Only commit-message defines a simulator today |
|
|
21
21
|
| `uds fix` | Auto-fix standard violations (Self-Healing) |
|
|
22
22
|
| `uds update` | Update standards to latest version |
|
|
23
23
|
| `uds skills` | List installed Claude Code skills |
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
| `uds agent` | Manage UDS agents for AI tools |
|
|
33
33
|
| `uds ai-context` | Manage .ai-context.yaml configuration for AI-friendly architecture |
|
|
34
34
|
| `uds mcp` | MCP server commands for AI tool integration |
|
|
35
|
-
| `uds open-work` | Reference checks for open-work-tracking (OWT-017
|
|
35
|
+
| `uds open-work` | Reference checks for open-work-tracking (OWT-017 to OWT-028). Exit 0 no violation, 1 violation, 2 cannot decide (not a pass) |
|
|
36
36
|
| `uds run` | Run a project command by intent (test/lint/build/security) via uds.project.yaml |
|
|
37
37
|
|
|
38
38
|
## 💬 斜線命令
|
|
@@ -355,7 +355,7 @@
|
|
|
355
355
|
| `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
|
|
356
356
|
| `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ- |
|
|
357
357
|
| `check-home-untouched.mjs` | check-home-untouched — did this run write anywhere |
|
|
358
|
-
| `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017
|
|
358
|
+
| `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 to |
|
|
359
359
|
| `check-orphan-specs.ps1` | Check Orphan Specs |
|
|
360
360
|
| `check-orphan-specs.sh` | Orphan Spec Detection Script |
|
|
361
361
|
| `check-prompt-footprint.mjs` | Prompt Footprint Ratchet — DEC-117 D2/L2 |
|
|
@@ -378,6 +378,7 @@
|
|
|
378
378
|
| `check-version-sync.ps1` | Check Version Sync |
|
|
379
379
|
| `check-version-sync.sh` | Version Sync Checker |
|
|
380
380
|
| `check-workflow-compliance.sh` | Thin wrapper — scripts/check-workflow-compliance.t |
|
|
381
|
+
| `ci-vitest-summary.mjs` | ci-vitest-summary — say how many tests ran, passed |
|
|
381
382
|
| `commitlint-bilingual-rule.mjs` | commitlint-bilingual-rule.mjs — custom commitlint |
|
|
382
383
|
| `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
|
|
383
384
|
| `fix-manifest-paths.ps1` | Fix Manifest Paths |
|
|
@@ -112,9 +112,8 @@ status: current
|
|
|
112
112
|
```
|
|
113
113
|
? Select AI agents to install Skills for:
|
|
114
114
|
── Claude Code ──
|
|
115
|
-
❯ ◉ Claude Code (Plugin Marketplace) - Auto-managed (Recommended)
|
|
116
115
|
◯ Claude Code (User Level) - ~/.claude/skills/
|
|
117
|
-
|
|
116
|
+
❯ ◉ Claude Code (Project Level) - .claude/skills/ (預先勾選:主要路徑)
|
|
118
117
|
── OpenCode ──
|
|
119
118
|
◯ OpenCode (User Level) - ~/.config/opencode/skill/
|
|
120
119
|
◯ OpenCode (Project Level) - .opencode/skill/
|
|
@@ -148,22 +147,26 @@ status: current
|
|
|
148
147
|
|
|
149
148
|
### 詳細說明
|
|
150
149
|
|
|
151
|
-
#### Plugin Marketplace
|
|
150
|
+
#### Plugin Marketplace(替代方式,有限制)
|
|
151
|
+
|
|
152
|
+
它不是提示裡的選項,而是 Claude Code 自己的外掛系統。要用它,請取消提示中的所有勾選(或加 `--skills-location marketplace`),再在 Claude Code 內執行:
|
|
152
153
|
|
|
153
154
|
```bash
|
|
154
|
-
# 如果尚未安裝,執行:
|
|
155
155
|
/plugin marketplace add AsiaOstrich/universal-dev-standards
|
|
156
156
|
/plugin install universal-dev-standards@asia-ostrich
|
|
157
157
|
```
|
|
158
158
|
|
|
159
159
|
**優點**:
|
|
160
|
-
-
|
|
161
|
-
-
|
|
162
|
-
- 所有 15 個 Skills 一次安裝
|
|
160
|
+
- 由 Claude Code 更新,不用自己下指令
|
|
161
|
+
- 專案內不放檔案
|
|
163
162
|
|
|
164
|
-
|
|
165
|
-
-
|
|
163
|
+
**限制**:
|
|
164
|
+
- 只支援 Claude Code
|
|
165
|
+
- 只有英文技能文字(外掛設定沒有語系選擇)
|
|
166
|
+
- 只跟正式版:UDS 的測試版不會有測試版技能,也無法鎖定特定版本
|
|
166
167
|
- 需要網路連線
|
|
168
|
+
- `uds check` 無法逐檔比對它的技能檔
|
|
169
|
+
- 專案內也裝了技能時,Claude Code 會把每個技能列兩次;`uds check` 會警告
|
|
167
170
|
|
|
168
171
|
#### User Level
|
|
169
172
|
|
|
@@ -184,7 +187,10 @@ status: current
|
|
|
184
187
|
- 需要手動更新
|
|
185
188
|
- 不會隨專案版本控制
|
|
186
189
|
|
|
187
|
-
#### Project Level
|
|
190
|
+
#### Project Level(主要路徑,也是 `uds init --yes` 的預設)
|
|
191
|
+
|
|
192
|
+
繁體與簡體中文技能文字都放在 npm 套件內(`--locale zh-tw` 或 `zh-cn`),所以安裝它們不需要網路。如果某份 UDS 缺少這些文字,UDS 會明說,並改裝英文版。
|
|
193
|
+
|
|
188
194
|
|
|
189
195
|
```
|
|
190
196
|
your-project/
|
|
@@ -208,19 +214,15 @@ your-project/
|
|
|
208
214
|
### 決策流程
|
|
209
215
|
|
|
210
216
|
```
|
|
211
|
-
|
|
217
|
+
你用哪些 AI 工具?
|
|
212
218
|
│
|
|
213
|
-
├─
|
|
219
|
+
├─ 任何讀 SKILL.md 的工具(Claude Code、OpenCode、Codex、Copilot……)
|
|
220
|
+
│ → Project Level(主要路徑,預先勾選)
|
|
221
|
+
│ └─ 也想讓這台機器上每個專案都有技能? → 再加 User Level
|
|
214
222
|
│
|
|
215
|
-
└─
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
│
|
|
219
|
-
└─ 否 → 是否需要團隊共享?
|
|
220
|
-
│
|
|
221
|
-
├─ 是 → Project Level
|
|
222
|
-
│
|
|
223
|
-
└─ 否 → User Level
|
|
223
|
+
└─ 只用 Claude Code,且英文文字、只跟正式版、
|
|
224
|
+
專案內不放檔案都可以?
|
|
225
|
+
→ Plugin Marketplace(--skills-location marketplace)
|
|
224
226
|
```
|
|
225
227
|
|
|
226
228
|
---
|
|
@@ -812,7 +814,7 @@ uds init --experimental
|
|
|
812
814
|
| 選項 | 互動式提示 | CLI 參數 | 預設值 |
|
|
813
815
|
|------|------------|----------|--------|
|
|
814
816
|
| AI Tools | `promptAITools()` | - (偵測) | 自動偵測 |
|
|
815
|
-
| Skills Location | `promptSkillsInstallLocation()` | `--skills-location` | `
|
|
817
|
+
| Skills Location | `promptSkillsInstallLocation()` | `--skills-location` | `project` |
|
|
816
818
|
| Standards Scope | `promptStandardsScope()` | - | 依 Skills 決定 |
|
|
817
819
|
| Format | `promptFormat()` | `-f, --format` | `ai` |
|
|
818
820
|
| Git Workflow | `promptGitWorkflow()` | `--workflow` | `github-flow` |
|
|
@@ -962,7 +964,7 @@ uds init -y
|
|
|
962
964
|
# 指定所有選項
|
|
963
965
|
uds init -y \
|
|
964
966
|
--format ai \
|
|
965
|
-
--skills-location
|
|
967
|
+
--skills-location project \
|
|
966
968
|
--workflow github-flow \
|
|
967
969
|
--merge-strategy squash \
|
|
968
970
|
--output-lang english \
|