universal-dev-standards 6.14.1 → 6.15.0-beta.1
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 +2 -2
- package/bundled/ai/standards/developer-memory.ai.yaml +2 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +6 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +2 -2
- package/bundled/core/developer-memory.md +1 -1
- package/bundled/core/full-coverage-testing.md +4 -2
- package/bundled/core/open-work-tracking.md +13 -0
- package/bundled/core/project-context-memory.md +1 -1
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +49 -4
- package/bundled/locales/zh-CN/README.md +2 -2
- package/bundled/locales/zh-CN/SECURITY.md +1 -0
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +5 -3
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +4 -4
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +1 -0
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +8 -3
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +5 -4
- package/bundled/locales/zh-CN/skills/README.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +1 -1
- package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +7 -7
- package/bundled/locales/zh-CN/skills/open-work-assistant/SKILL.md +133 -0
- package/bundled/locales/zh-TW/CHANGELOG.md +49 -4
- package/bundled/locales/zh-TW/README.md +2 -2
- package/bundled/locales/zh-TW/SECURITY.md +1 -0
- package/bundled/locales/zh-TW/core/developer-memory.md +3 -3
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +5 -3
- package/bundled/locales/zh-TW/core/open-work-tracking.md +13 -2
- package/bundled/locales/zh-TW/core/project-context-memory.md +3 -3
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +4 -4
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +1 -0
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +8 -3
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +5 -4
- package/bundled/locales/zh-TW/skills/README.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +7 -7
- package/bundled/locales/zh-TW/skills/open-work-assistant/SKILL.md +133 -0
- package/bundled/skills/README.md +2 -1
- package/bundled/skills/dev-workflow-guide/SKILL.md +4 -4
- package/bundled/skills/open-work-assistant/SKILL.md +127 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +183 -23
- package/bundled/templates/gates/check-stubs.mjs +85 -16
- package/package.json +2 -2
- package/src/commands/audit.js +4 -1
- package/src/commands/check.js +55 -6
- package/src/commands/config.js +2 -3
- package/src/commands/init.js +10 -3
- package/src/commands/update.js +239 -43
- package/src/i18n/messages.js +87 -0
- package/src/installers/hooks-installer.js +32 -5
- package/src/installers/skills-installer.js +45 -0
- package/src/reconciler/backup-locations.js +3 -2
- package/src/reconciler/backup-manager.js +14 -11
- package/src/reconciler/plan-executor.js +51 -7
- package/src/utils/copier.js +13 -8
- package/src/utils/flush-and-exit.js +37 -0
- package/src/utils/group-errors.js +65 -0
- package/src/utils/integration-generator.js +14 -5
- package/src/utils/skill-hash-ownership.js +33 -0
- package/src/utils/skill-link-rewriter.js +184 -0
- package/src/utils/skills-installer.js +115 -11
- package/src/utils/transient-fs.js +168 -14
- package/standards-registry.json +10 -19
- package/bundled/ai/standards/open-work-tracking.ai.yaml +0 -466
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: open-work
|
|
3
|
+
source: ../../../../skills/open-work-assistant/SKILL.md
|
|
4
|
+
source_version: 1.0.0
|
|
5
|
+
translation_version: 1.0.0
|
|
6
|
+
last_synced: 2026-10-30
|
|
7
|
+
source_hash: 01f94f0311a4
|
|
8
|
+
status: current
|
|
9
|
+
scope: universal
|
|
10
|
+
description: |
|
|
11
|
+
[UDS] 选用的小助手,帮助追踪跨会话仍未完成的工作:便宜的收件点、每个等待都有解除条件、下一步点名真实的东西。
|
|
12
|
+
Use when: 工作在会话之间漏掉、某个项目「等待中」好几天却没人知道在等什么、「下一步」只写「继续」。
|
|
13
|
+
Not for: 已经用 issue 追踪器或看板管理工作而且没有漏掉东西的项目;规划功能——请用 /plan 或 /sdd。
|
|
14
|
+
Keywords: open work, backlog, inbox, waiting, release condition, next action, 开放工作, 待办追踪, 收件箱, 等待中, 解除条件.
|
|
15
|
+
allowed-tools: Read, Glob, Grep, Write, Bash
|
|
16
|
+
argument-hint: "[capture | waiting | next-action | report | 收件 | 等待 | 下一步 | 报告]"
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
# 开放工作追踪
|
|
20
|
+
|
|
21
|
+
> **语言**: [English](../../../../skills/open-work-assistant/SKILL.md) | [繁體中文](../../../zh-TW/skills/open-work-assistant/SKILL.md) | 简体中文
|
|
22
|
+
|
|
23
|
+
**版本**: 1.0.0 | **最后更新**: 2026-10-30 | **适用**: Claude Code Skills
|
|
24
|
+
|
|
25
|
+
帮助避免工作在会话之间漏掉。想用才用。UDS 没有任何东西要求你用。
|
|
26
|
+
|
|
27
|
+
## 目的
|
|
28
|
+
|
|
29
|
+
这个技能以前是一条标准,叫 `open-work-tracking`。UDS 把它搬到这里,是因为那条标准只在一个项目上试过,而那个项目自己的使用没有证实它。技能比较合适:工作开始漏掉时你拿起它,没有漏掉时你放下它。
|
|
30
|
+
|
|
31
|
+
旧标准的全文保留成参考文档:[open-work-tracking](../../../../core/open-work-tracking.md)。UDS 不再安装它。本技能放的是其中值得保留的部分。
|
|
32
|
+
|
|
33
|
+
## 什么时候用、什么时候不用
|
|
34
|
+
|
|
35
|
+
先找出真正的问题是哪一个。去问用户。不要为了一个没有人遇到的问题去开一份追踪清单。
|
|
36
|
+
|
|
37
|
+
| 出了什么问题 | 什么有帮助 |
|
|
38
|
+
|---|---|
|
|
39
|
+
| 做事做到一半冒出新想法,没有便宜的地方可以放 | 一个只要两个字段的收件点 |
|
|
40
|
+
| 某个项目暂停「等待中」,之后没人知道在等什么 | 在等待旁边写下解除条件 |
|
|
41
|
+
| 已规划的项目没动工,时间过去,没有东西指回它 | 一个日期,或定期看一眼清单 |
|
|
42
|
+
|
|
43
|
+
三个都不是真的,就停下来并说明。项目已经有 issue 追踪器或项目看板、而且在那里没有漏掉东西,就继续用它。没有人读的第二份清单,只是多一个漏掉工作的地方。
|
|
44
|
+
|
|
45
|
+
## 工作流程
|
|
46
|
+
|
|
47
|
+
### 1. 收件:两个字段
|
|
48
|
+
|
|
49
|
+
写下日期和一句话。不要多写。
|
|
50
|
+
|
|
51
|
+
| 日期 | 内容 |
|
|
52
|
+
|---|---|
|
|
53
|
+
| 2026-10-30 | 确认结构调整之后导出作业还有没有在跑 |
|
|
54
|
+
|
|
55
|
+
这一步不要问分类、优先级或负责人。那些等整理清单时再决定。必填字段多一个,大家就不再用这份清单。
|
|
56
|
+
|
|
57
|
+
### 2. 等待:写下什么会解除它
|
|
58
|
+
|
|
59
|
+
每个标为「等待中」的项目要有两样东西:在等什么,以及什么事件结束这个等待。优先选机器看得到的事件:日期、会出现的文件、标签、标识符。
|
|
60
|
+
|
|
61
|
+
| 项目 | status | asked-at | waiting for | release |
|
|
62
|
+
|---|---|---|---|---|
|
|
63
|
+
| 厂商报价 | asked-awaiting | 2026-10-27 | 厂商的回复 | 文件 `quotes/vendor-a.md` 存在 |
|
|
64
|
+
|
|
65
|
+
写明是哪一种等待:
|
|
66
|
+
|
|
67
|
+
- `not-yet-asked`:请求已经拟好或决定好,还没有人送出。点名那份草稿或那个命令,送出它就解除这个等待。
|
|
68
|
+
- `asked-awaiting`:已经送出,还没有回音。写 `asked-at`(含年份的完整日期)。有年龄的项目可以在阈值到了时重新浮现,没有年龄的不行。
|
|
69
|
+
|
|
70
|
+
等待的是另一个项目里的东西,就写成 `<项目>:<对象>`,例如 `uds:v6.15.0` 或 `vibeops:docs/handoff.md`。项目是逻辑名称,绝不是某一台机器上的目录。
|
|
71
|
+
|
|
72
|
+
### 3. 下一步:要点名东西
|
|
73
|
+
|
|
74
|
+
下一步至少点名一个读的人找得到的东西:文件路径、测试名称、命令,或需求标识符。「继续」和「处理剩下的」什么都没点名。
|
|
75
|
+
|
|
76
|
+
| 弱 | 较好 |
|
|
77
|
+
|---|---|
|
|
78
|
+
| 继续做迁移 | 运行 `npm run migrate -- --dry-run`,并读 `migrations/0042.sql` |
|
|
79
|
+
|
|
80
|
+
已经问过、在等回复的项目,可以把那个回复当作下一步。这时它需要 `asked-at`、在等什么、什么解除它。
|
|
81
|
+
|
|
82
|
+
### 4. 整理清单:三个出口
|
|
83
|
+
|
|
84
|
+
挑一个固定的日子整理收件的项目。每个项目去三个地方之一:
|
|
85
|
+
|
|
86
|
+
1. 变成规格或被追踪的项目。
|
|
87
|
+
2. 进入要做的工作清单。
|
|
88
|
+
3. 丢掉,并写一句为什么。
|
|
89
|
+
|
|
90
|
+
停在未整理状态超过大约两周的项目,要在报告里被点名。没有理由的丢弃,看起来和被误删的项目一模一样。
|
|
91
|
+
|
|
92
|
+
### 5. 报告:说出你看不到的部分
|
|
93
|
+
|
|
94
|
+
报告「还有 N 项未完成」时,也要说你看了几个来源、有几个看不到。看不到的来源不是零。没有这句话的报告,读起来像是完整的。
|
|
95
|
+
|
|
96
|
+
在回合结束、控制权交回给人的时候印出报告。报告绝不能挡住回合。「还有工作没做完」几乎永远为真,而一个永远红灯的检查会被关掉。
|
|
97
|
+
|
|
98
|
+
### 6. 你看不到的事实
|
|
99
|
+
|
|
100
|
+
有些事实,助手没有任何来源可以读:消息有没有寄出、对方有没有回复、有没有核准。要手写它们,必须附三样东西:谁看到的(`observed-by`)、何时(`observed-at`,含年份),以及值是 `yes`、`no` 或 `unknown`。`unknown` 是正式的值,单独计数,永远不算完成。每笔观察都显示年龄。时间戳只说有人看过一次,不说现在仍然如此。
|
|
101
|
+
|
|
102
|
+
版本控制、规格标记或 CI 结果已经说明的事,不要手写。
|
|
103
|
+
|
|
104
|
+
### 7. 选用:运行参考检查
|
|
105
|
+
|
|
106
|
+
UDS 在 CLI 里附了这些规则的参考检查程序:
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
uds open-work next-action [files...] # 每个下一步都有点名东西吗?
|
|
110
|
+
uds open-work waiting [files...] # 每个等待都有解除条件吗?
|
|
111
|
+
uds open-work observations [files...] # 手写的事实都有时间戳吗?
|
|
112
|
+
uds open-work self-test # 检查程序自己遇到坏样本还是会失败吗?
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
检查程序靠字段名称找字段,例如 `status`、`asked-at`、`waiting for`、`release`(上面的表格用的就是这些)。你的表格用别的词,就在 `uds.project.yaml` 的 `open_work` 下面声明。
|
|
116
|
+
|
|
117
|
+
结束码 0 表示没有违反,1 表示有违反,2 表示检查程序判定不了。2 不是通过。干净的结果只涵盖它认得的词。词汇是第一版的猜测,没有在真实使用上调整过。
|
|
118
|
+
|
|
119
|
+
## 放在哪里
|
|
120
|
+
|
|
121
|
+
放在你的项目本来就会看的地方:issue 追踪器、项目看板、repo 里的一个文件。UDS 不替你选。两个性质重要:那个地方受版本控制、或至少每个需要它的会话都读得到,而且不是只放在某一个人私有的助手记忆里。等待另一个项目的工作,要记在两个项目的会话都读得到的地方。
|
|
122
|
+
|
|
123
|
+
## 本技能不宣称的事
|
|
124
|
+
|
|
125
|
+
- 上面的规则来自一个项目。UDS 没有证据显示它们对其他项目有效。
|
|
126
|
+
- 阈值(两个字段、两周、观察七天算旧)是第一版的判断,不是量测。
|
|
127
|
+
- 检查程序读的是表格和清单的结构。它分辨不出一则记录是不是真的。
|
|
128
|
+
|
|
129
|
+
## 相关
|
|
130
|
+
|
|
131
|
+
- [open-work-tracking](../../../../core/open-work-tracking.md):以前的标准,现在只供参考。它的要求编号是 OWT-001 到 OWT-029。
|
|
132
|
+
- [deferred-item-exit](../../../../core/deferred-item-exit.md):被延后的项目必须离开它所在的文档。本技能从那一条结束的地方开始。
|
|
133
|
+
- [turn-completion-integrity](../../core/turn-completion-integrity.md):检查「说了却没做」的承诺。与第 5 步的报告不同,它可以挡住回合。
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../CHANGELOG.md
|
|
3
|
-
source_version: 6.
|
|
4
|
-
translation_version: 6.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
3
|
+
source_version: 6.15.0-beta.1
|
|
4
|
+
translation_version: 6.15.0-beta.1
|
|
5
|
+
last_synced: 2026-11-04
|
|
6
|
+
source_hash: edd0f49d4139
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -18,6 +18,51 @@ status: current
|
|
|
18
18
|
|
|
19
19
|
## [Unreleased]
|
|
20
20
|
|
|
21
|
+
## [6.15.0-beta.1] - 2026-11-04
|
|
22
|
+
|
|
23
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。**請先讀:`uds check --ci` 現在對兩種原本只印出來的發現以 1 結束**(整合檔指向不存在的路徑,以及已安裝、卻沒有任何雜湊涵蓋的斜線指令),所以採用者升級後 CI 可能變紅;下方第一項說明誰受影響、怎麼清掉。這個測試版另有:`uds update` 與 `uds update --apply` 現在會替換沒人改過的舊 hook 腳本(先備份)、`uds init` 與 `uds update` 不再丟失或重複印出錯誤輸出、`open-work-tracking` 改成選用技能 `open-work`、已安裝的技能與斜線指令不再帶著打不開的連結,以及 `check-anti-fake-tests` 與 `check-stubs` 在沒看完整個專案時會明說「INCOMPLETE」。
|
|
24
|
+
|
|
25
|
+
### 變更
|
|
26
|
+
|
|
27
|
+
- **行為改變——`uds check --ci` 現在對兩種原本只印出來的發現以非 0 結束:整合檔指向不存在的路徑,以及沒有任何雜湊涵蓋的已安裝斜線指令。** 兩者都是在 2026-09-16(6.9.1)以「只回報」加入,為的是不讓採用者的 CI 在升級時變紅。沒有人處理的發現,正是 6.9.0 的六個缺陷一直沒被發現的原因,而這兩項已經以同樣的狀態放了五個次版本。現在算數的是:在 `CLAUDE.md`/`AGENTS.md`(`integrations` 列出的任一檔案)裡,檔案不在磁碟上的 `.standards/...` 引用,以及檔案任何位置提到、不在磁碟上的 `.standards/...` 或 `core/...` 路徑;還有已安裝指令資料夾自己的 `.manifest.json` 有列出、檔案也在磁碟上,但 `commandHashes` 沒有涵蓋的指令(資料夾 manifest 沒列出的零散 `.md` 偵測不到;列出了但檔案已不在的指令不在這裡回報)。引用的檔案存在、但 manifest 沒有列出,仍然只是警告。指令檔缺少或被改過,自 6.14.0 起就已讓 `--ci` 失敗。**誰受影響:**`uds check` 輸出出現 `✗ ... references files that do not exist`、`✗ ... mentions paths that do not exist in this project` 或 `⚠ N installed command file(s) are covered by no hash` 的專案;`uds check --ci` 在那裡現在以 1 結束。**遷移:**引用的問題執行 `uds update --integrations-only`(UDS 區塊之外的路徑必須手動修正;UDS 不改寫不是它寫的文字);指令的問題執行 `uds update --commands` 重新記錄。已在三個採用者專案(dev-platform、EngramGraph、VibeOps)上檢查:沒有一個出現這兩項發現,所以沒有任何一個的結果改變。
|
|
28
|
+
|
|
29
|
+
- **`uds init` 現在把許多檔案共有的原因只印一次,並附上檔案數與前三個名稱,不再每個檔案印一次(看板 #81)。** 當 `uds init` 無法建立 `.standards/`(專案資料夾無法寫入)時,每個標準都以同一則約 700 位元組的訊息失敗,清單把它印了 50 次以上、共 64 KB,不一樣的幾行(語言包、整合檔)因此很難找到。現在錯誤依原因分組:原因印一次,接著一行 `-> 66 files affected, the first 3: <names>`(繁體中文是 `→ 影響 66 個檔案,前 3 個:<names>`,簡體中文是 `→ 影响 66 个文件,前 3 个:<names>`);在無法寫入的專案資料夾上實測會出現兩組,一組 66 個檔案(標準),一組 7 個(選項檔)。只合併一字不差相同的原因:自己帶檔名的訊息(`Could not copy "a" to "b"`)仍然每個檔案一行,所以先前分得開的東西都不會被藏起來。**對解析失敗 `uds init` 輸出的腳本的行為改變:**合併組的 `<file>: <cause>` 行不見了(因同一原因失敗的語言包只算進數字、不列名稱),「前 3 個」之後的名稱只是樣本,數字才是完整計數。結束碼(1)、回復與錯誤文字本身都沒變。`uds update` 與 `uds config` 的錯誤清單照舊列印。**未驗證:**Windows;讓資料夾唯讀、再透過 shell 管線讀輸出的測試在那裡被跳過,沒有 Windows 機器跑過這一項。
|
|
30
|
+
|
|
31
|
+
- **`check-anti-fake-tests` 與 `check-stubs` 在沒看完整個專案時,現在會說「INCOMPLETE」並以 2 結束;以前它們會回報通過(XSPEC-518 R2)。**三件事讓掃描悄悄地變成只看一部分:走訪在 200,000 個檔案停下、打不開的目錄被跳過、讀不了的檔案被跳過。在非常大的目錄樹或被鎖住的目錄上,「沒有假測試」的意思其實是「我走到的檔案裡沒有」。現在,停在檔案數上限、打不開目錄,或讀不了測試(或原始碼)檔案的執行,會印出 `INCOMPLETE` 與 `RESULT: INCOMPLETE ... NOT a pass`,在 `--json` 帶 `"incomplete": true`(附 `truncated`、`walkLimit`、`unreadableDirs`、`readFailures`),並且在讀到的部分沒找到任何東西時以 2(「無法判斷」)結束;讀到的部分有發現時仍以 1 結束,輸出也會說搜尋不完整。`uds check` 本來就把結束碼 2 視為「無法判斷,不算通過」。檔案數上限是硬上限:列出的檔案不會超過上限,單一目錄內也一樣。`--max-files N` 可以調低它(用來試這條路徑,或替巨大的目錄樹設上限);不是正整數的值會被拒絕並以 2 結束。目錄依名稱順序讀取,所以哪一部分沒讀到不取決於檔案系統。超過 2 MB 的測試檔仍然只列在「NOT scanned」之下,和沒有規則的語言一樣。**如果你的 CI 在超過上限的目錄樹、或 CI 使用者打不開某個目錄的樹上執行這些腳本,它會開始以 2 失敗:那是它以前沒有說出口的事實。**
|
|
32
|
+
|
|
33
|
+
- **`open-work-tracking` 不再是標準;值得留下來的部分是選用技能 `open-work`(dev-platform XSPEC-427)。**這個標準要求每個採用者都有收件匣、每個等待都寫放行條件,等等。它是以一個專案為基準校準的,而那個專案自己的使用並沒有證實它:收件匣設好之後的幾週沒有收到任何新條目,專案也把工作搬到了議題看板。技能比較合適:工作開始遺失時拿起來用,沒有遺失時就放下。改變的內容:(1) `uds init` 與 `uds update` 不再安裝 `.standards/open-work-tracking.ai.yaml`,登錄檔也不再列出這個標準(163 筆變成 162 筆);(2) `core/open-work-tracking.md` 留作參考文件,頂端加上 `UDS:REFERENCE-ONLY` 聲明(和 6.0.0 離開的七個標準相同的處理,見 [docs/MIGRATION-v6.md](docs/MIGRATION-v6.md) §2),並列在 `scripts/reference-only-standards.json`;它的需求 OWT-001 到 OWT-029 不變;(3) 新技能 `open-work`(資料夾 `skills/open-work-assistant/`,含 zh-TW 與 zh-CN,Tier 3:預設只列名稱)收納工作指引:用兩個欄位擷取、每個等待寫放行條件、下一步要指名檔案、測試或指令、整理清單時的三個出口、說明它看不到什麼的報告、蓋章的手寫事實。它註明這些規則來自一個專案,門檻是初步猜測;(4) `uds open-work`(參考檢查)不變,技能會指向它。**既有採用者會看到:**`uds update --apply` 把 `.standards/open-work-tracking.ai.yaml` 列在「刪除」之下(「UDS no longer ships this file」),先做備份(採用者改過的副本也會被刪,內容在備份裡,`uds update --rollback` 可以帶回),專案有 UDS 技能時安裝該技能,並改寫 `CLAUDE.md` 與 `AGENTS.md` 的 UDS 區塊,不再含這個標準(預設專案的標準數從 74 變成 73)。較舊的 `uds update` 路徑(不帶 `--apply`)不再更新這個檔案,並從 `manifest.standards` 拿掉它,檔案留在磁碟上;下一次 `uds update --apply` 會移除。不想要技能也不想要檔案的採用者,不用再做其他事。README 與 `uds-manifest.json` 中的 153 是 `core/` 裡文件的數量,仍包含這一份;技能數從 56 變成 57。`developer-memory` 與 `project-context-memory` 原本指向標準的地方,現在指向技能與參考文件(只改文字,版本不變),`docs/AVAILABLE-STANDARDS.md` 的 `--add-standard` 範例改用 `turn-completion-integrity`。**未驗證:**除了那一個專案之外,是否有其他採用者用過這個標準;UDS 沒有這方面的遙測。
|
|
34
|
+
|
|
35
|
+
- **已安裝的技能不再帶著打不開的連結:指向安裝目錄之外的連結,現在會變成它原本要指的檔案的 GitHub 網址。**技能原始碼的連結指向 UDS 儲存庫的目錄結構(`../../core/x.md`、`../../../../skills/y/SKILL.md`、`../commands/z.md`);安裝到 `<project>/<agent folder>/skills/<name>/` 之後,周圍的儲存庫不在了,每個技能語言版本約 450 個連結(在已安裝檔案上實測:en 459、zh-TW 449、zh-CN 472)打不開(dev-platform #61;#47 曾手動修過一個技能)。`uds init`、`uds update --skills`、`uds config --type skills` 與較舊的 `installSkills` 分支現在把連結寫成 `https://github.com/AsiaOstrich/universal-dev-standards/blob/main/<repo path>`(資料夾用 `tree/main/`,保留 `#anchor`;在地化的技能指向它原始碼所指的 `locales/<locale>/...`)。仍然落在同一次安裝會寫入的檔案上的連結(技能自己的檔案、其他已安裝技能的檔案)保持相對路徑,沒有指向 UDS 任何東西的連結也是(文件指引範本的 `docs/`、`CONTRIBUTING.md`、`examples/` 佔位符;原始碼裡就已失效的連結)。程式碼區塊、行內程式碼與沒有關閉的圍欄不是連結,不會動。`skills/` 與 `locales/` 裡的檔案不變。**升級時你會看到:**每個帶有這種連結的已安裝技能檔,都和你現有的版本不同(每次安裝約 200 個檔案),所以 `uds update --plan --skills` 會把這些技能列為已變更一次;`uds update --skills` 改寫它們與 manifest 雜湊,之後 `uds check` 就乾淨了。安裝器、更新規劃器與 `uds check` 取自同一個函式的內容,所以三者一致。自採用的副本 `.claude/skills/` 與 `.agents/skills/` 已重新產生,因為產生器的契約是「安裝會產生的東西」(從同一個模組匯入的同一個轉換)。斜線指令由下一項涵蓋。
|
|
36
|
+
|
|
37
|
+
- **已安裝的斜線指令不再帶著打不開的連結:指向安裝目錄之外的連結,現在會變成它原本要指的檔案的 GitHub 網址。**指令原始碼的連結和技能一樣指向 UDS 儲存庫的目錄結構(`../../core/x.md`、`../ac-coverage/SKILL.md`、`../../locales/zh-TW/skills/commands/y.md`);安裝到 `<project>/.cursor/commands/`(還有 `.opencode/command/`、`.roo/commands/`、`.github/prompts/`、`.gemini/commands/`,以及這些 agent 的使用者層級資料夾)之後,周圍的儲存庫不在了,zh-TW Cursor 安裝的 203 個相對連結中有 176 個打不開(dev-platform #62;上一項技能的指令端孿生問題)。指令安裝器現在執行技能用的那個改寫,取自同一個函式(`resolveCommandContent`),所以 `uds init`、`uds update --commands` 與其他所有安裝指令的路徑都寫入 `https://github.com/AsiaOstrich/universal-dev-standards/blob/main/<repo path>`(資料夾用 `tree/main/`,保留 `#anchor`,在地化原始碼指向 `locales/<locale>/...` 的地方照舊),更新規劃器與 `uds check` 對同一份內容算雜湊。指令檔是 `.md` 的 agent(Cursor、OpenCode、Roo Code、Copilot)中,指向其他指令的連結(`./check.md`、`sdd.md`)維持原樣,因為那些檔案在同一個資料夾。Gemini CLI 的檔案是 `.toml`,所以 `./check.md` 連結在那裡打不開,會變成指令原始碼的 GitHub 網址;改寫發生在 markdown 轉成 TOML 之前,TOML 結構與其中的網址逐檔檢查。指向技能的連結也是 GitHub 網址:技能資料夾是獨立的選用安裝,指向它的相對連結會取決於指令檔無從得知的事。程式碼區塊與行內程式碼不動,沒有指向 UDS 任何東西的連結也不動。`skills/commands/` 與 `locales/*/skills/commands/` 裡的檔案不變。**升級時你會看到:**每個帶有這種連結的已安裝指令檔都和你現有的版本不同(每個 agent 共 51 個全部),所以 `uds update --plan --commands` 會把每個 agent 列為重新安裝一次;`uds update --commands` 照常備份、改寫檔案與 manifest 雜湊,之後 `uds check` 回報指令檔完整。如果你手動改過已安裝的指令檔,更新會像往常一樣覆蓋它(備份裡有你的副本)。**未修:**zh-CN `sdd-retro` 指令連結 `../../docs/specs/cli/shared/SPEC-011-retroactive-spec-tracking.md`,少了儲存庫的一層(zh-TW 是對的);該連結在原始碼就已失效,替不存在的路徑寫 GitHub 網址只會多一個失效連結,所以維持原樣,測試會點名它。本儲存庫的 `.gemini/commands/` 是凍結的副本(`.gemini/DEPRECATED.md`),不會重新產生;這裡沒有提交其他指令副本。`uds config --type commands` 會詢問安裝位置,測試沒有跑它;它呼叫的是同一個函式。
|
|
38
|
+
|
|
39
|
+
- **`uds update` 與 `uds update --apply` 現在會替換舊版 UDS 安裝、且沒有人改過的 hook 腳本,而且每一次 hook 腳本改寫之前都先備份。**到目前為止只有 `uds update --with-hooks` 這樣做;其他形式只印一行說腳本「NOT updated by this command」,而大多數採用者打的是 `uds update`,所以 6.14.1 的安全修正(`scripts/hooks/check-dangerous-cmd.mjs` 終於會擋下)只送到知道多一個旗標的人手上。現在 `--apply`、`--force` 與單獨的 `uds update` 都會像 `--with-hooks` 一樣檢查 `scripts/hooks/`(與某個先前 UDS 出貨的腳本逐位元組比對):沒改過的舊副本會被替換,改過的會保留並點名,而 hook 設定、以及還不存在的腳本都不會被新增(那仍是 `--with-hooks` 的事)。版本紀錄已是最新、調和器沒有東西可套用時它也會執行,而這正是 6.14.1 留下的那種採用者。腳本被改寫之前會先複製到 `.uds-backups/`(標籤 `hooks`,與其他每個步驟相同的資料夾與格式),輸出會印出位置,`uds update --rollback` 可以放回去;寫入中途失敗時會當場全部復原,結束碼為 1,若無法做備份則什麼都不寫,結束碼為 1。`uds update --with-hooks --force` 在覆蓋改過的腳本之前做同樣的備份並印出位置。`--plan` 會說它會替換哪些腳本;限縮為 `--skills`、`--commands`、`--standards-only`、`--integrations-only`、`--sync-refs` 或 `--claude-target` 的執行不會動它們,並且會說明。**行為改變,沒有選擇退出的旗標:**`uds update --apply` 與單獨的 `uds update` 現在會寫入 `scripts/hooks/` 之內,以前不會;想讓某個腳本不被動,它必須和 UDS 出貨過的每一份副本都不同,因為沒有 `--with-hooks --force`,改過的腳本永遠不會被替換。備份不涵蓋 `--with-hooks` 合併的 hook 設定(`.claude/settings.json`、`.codex/hooks.json` 等)。(dev-platform #41)
|
|
40
|
+
|
|
41
|
+
### 新增
|
|
42
|
+
|
|
43
|
+
- **`npm run ci:local` 會執行儲存庫的假測試閘門,CI 執行同一條指令(XSPEC-518 R4)。**UDS 把 `check-anti-fake-tests` 出貨給每個採用者,卻從未對自己的測試跑過它。新的 CI 工作「Fake-test gate」執行 `npm run ci:local`,後者對整個儲存庫執行 `node templates/gates/check-anti-fake-tests.mjs`,在任何發現、以及沒看完整個專案的搜尋(結束碼 2)時讓工作失敗。人在推送前執行同一行;之後加進 `ci:local` 的檢查在 CI 也會執行。維護者工具:npm 套件裡沒有它的任何部分。
|
|
44
|
+
- **`check-anti-fake-tests` 可以用書面理由豁免一支測試:測試自己那一行、或緊接在它上方的註解行裡寫註解 `ANTI_FAKE_EXEMPT: <why>`(XSPEC-518 R3)。**到目前為止,讓一項發現安靜下來的唯一辦法,是改測試,或在 `.standards/test-policy.json` 豁免一個路徑。刻意當成冒煙測試(只要不丟例外就好)的測試,現在可以在自己旁邊這麼說。重點是理由:至少 8 個字母、數字或中文字元,且不能是 `TODO`、`TBD`、`N/A` 之類的佔位符;理由是空的、佔位符或更短的標記不起作用,發現仍在,文字會說「gives no usable reason」。標記只在註解內有效(字串內無效),只作用於它附著的那一支測試(中間隔了空行或程式碼就斷開,所以放在前一支測試內的註解不會作用到任何東西),而且兩支測試從同一行開始時兩支都不豁免。被豁免的測試永遠不會被藏起來:每次執行都會連同理由列出,`--json` 以 `exempted` 帶出。
|
|
45
|
+
|
|
46
|
+
### 修正
|
|
47
|
+
|
|
48
|
+
- **`uds init --format both` 不再把 `.standards/english.md`(和另外六個選項檔)寫進 `CLAUDE.md`,而這些檔案其實在 `.standards/options/`。**manifest 把選項的人類可讀副本記為 `options/<group>/<name>.md`,而區分選項與核心標準的程式碼只認得 `ai/options/...` 這種寫法,所以七個選項副本被列在高了一層的資料夾,還放在一行叫 AI 工具去讀它們的文字之下。`uds check` 把它們印成 `mentions paths that do not exist in this project`。現在它們列在 `.standards/options/` 之下。Installed Standards Index 的計數與 `AGENTS.md` 摘要用的是同一個判斷,所以選項數與 `--format human` 專案的 AGENTS.md 也一併修正。既有專案:執行 `uds update --integrations-only` 改寫該區塊。這是在 `uds check --ci` 開始於儲存庫自己的端對端測試中對此失敗時發現的(決策 293)。
|
|
49
|
+
|
|
50
|
+
- **`uds update` 與 `uds audit --effects` 的輸出進入管線時,不再丟失長報告的結尾(看板 #81,#77 的後續)。**#77 的失敗 `uds init` 修正發現,`process.exit()` 會丟掉仍在等著寫入管線的輸出(CI、AI 助理、`| tee`、腳本):在 macOS 上,讀取端較慢時輸出恰好停在 65,536 位元組,說明最後什麼失敗的結尾沒有送達,結束碼卻送達了。同樣兩個指令在輸出之後以 `process.exit()` 結束,而輸出隨專案成長:`uds update` 對每個寫不進去的檔案印一行(63 個標準無法還原時實測 144 KB),`uds audit --effects` 對每個實作印一項發現(400 個空殼實作 131 KB,`--format json` 也一樣)。兩者現在都等到輸出被收走,才結束行程;結束碼(0、1、2)與以前相同。**讀取端還活著但不讀取時的行為改變**(管線另一端被停住或被擋住):以前指令會結束,交不出去的輸出被丟掉;現在它會等到讀取端收走。這個等待刻意沒有時間上限:設了上限會帶回它所修的遺失。已經離開的讀取端(關閉了管線,EPIPE)不會拖住指令;它仍然立刻結束。`cli/src` 與 `cli/bin` 裡全部 53 個 `process.exit()` 呼叫都讀過(56 行提到它,其中 3 行是註解):其他的只印幾行固定文字、一個數字或一行 JSON,或長度受 AI 工具數量限制的清單(`uds config`,以及 `uds update --integrations-only` 結尾的整合錯誤),或把終端機交給子行程(`uds run`),維持原樣。**未驗證:**Windows;測試透過 shell 管線讀輸出,在那裡被跳過,沒有 Windows 機器跑過這一項。
|
|
51
|
+
- **`uds update --apply` 不再把它剛移除的標準名稱留在 manifest、`CLAUDE.md` 與 `uds check` 裡。**UDS 不再出貨某個標準時,`--apply` 刪了檔案,卻把它在 `manifest.standards` 與整合設定裡的條目留著。`uds check` 於是警告「Manifest entries that match no installed standard ... `uds update` does not prune them」,而 `--apply` 本身把「1 manifest entry could not be matched to an installed file and is not listed above」寫進專案的 `CLAUDE.md`(`AGENTS.md` 也一樣一行)。這是 `scripts/check-upgrade-fidelity.sh` 在準備上述變更時發現的:它回報 `uds update -y` 與 `uds update --apply` 對同一次升級寫出不同的 `CLAUDE.md` 區塊。刪除動作現在會拿掉這個條目(id 形式、路徑形式,以及每個整合設定保留的副本),而規劃本來就在改寫 `CLAUDE.md` 與 `AGENTS.md` 區塊之前先刪標準,所以區塊不再提到它。這對 UDS 不再出貨的每個標準都成立,不只 `open-work-tracking`。更早的 UDS 留在 manifest 裡的條目(例如 6.0.0 離開的標準)不動:如 `uds check` 所說,請手動從 `.standards/manifest.json` 的 `standards` 移除。測試:`cli/tests/e2e/xspec-427-open-work-tracking-becomes-skill.test.js`,它從上一版 UDS 寫的檔案開始。
|
|
52
|
+
- **`dev-workflow-guide` 技能不再出貨在採用者專案裡打不開的連結。**它的參考指向 `../../../../skills/workflows/*.workflow.yaml`、`../../adoption/...` 與 `../workflows/...`:這些路徑只存在於 UDS 原始碼儲存庫內(從已安裝的 `<agent>/skills/dev-workflow-guide/` 往上四層就離開專案,而且工作流程檔沒有裝在技能旁邊)。英文、zh-TW 與 zh-CN 的原始碼現在用相對連結指向同層的 `workflow-phases.md`,儲存庫文件則用 GitHub 網址;本儲存庫自己載入的副本(`.claude/skills`、`.agents/skills`)已重新產生。**未修,範圍比這個技能更廣:**其他出貨的技能仍連結採用者沒有的、以儲存庫為基準的 `core/` 與 `locales/` 文件;`.gemini/skills` 是凍結的舊副本。(dev-platform #47)
|
|
53
|
+
- **`uds update --skills`(與 `--apply`)現在會拿掉它所刪除的技能檔的 `skillHashes` 紀錄。**安裝器會移除技能不再出貨的頂層檔案,但 manifest 一直只合併、從不修剪,所以被刪檔案的紀錄留了下來,`uds check` 把每一筆都報成遺失,而那些檔案沒有人能還原,因為是更新本身移除的(VibeOps:記錄 140 個檔案,磁碟上 125 個,15 行假的「遺失」)。紀錄以該次執行改寫的技能為單位替換;沒碰的技能保留自己的紀錄。已經處於這個狀態的專案,下一次 `uds update --skills`(或 `--apply`)就會清掉。**行為改變:**`uds check` 不再列出那些檔案,更新後 `manifest.skillHashes` 會變小。(dev-platform #46)
|
|
54
|
+
- **當 manifest 裡有沒有任何已安裝標準對得上的條目時,`uds check` 不再打勾「AGENTS.md standards synced」。**AI 工具整合檢查本來就會警告(「Index declares 1 standards but the manifest has 2」),但 AGENTS.md 檢查在計數之前就把無法解析的條目丟掉,1 比 1 相等,在同一次執行裡印出綠色勾號。現在它改顯示警告符號而不是勾號,並點名這些條目(附修法:從 `.standards/manifest.json` 的 `standards` 刪除它們;`uds update` 不會修剪)。**對解析輸出的腳本的行為改變:**有這種條目的專案以前印 `✓ AGENTS.md standards synced (N)`,現在印 `⚠ AGENTS.md standards synced (N)` 加兩行。結束碼刻意不變:`uds` 裡沒有任何東西會移除這些條目,非 0 的結束碼會讓採用者的 CI 變紅,卻沒有任何指令能清掉它。(dev-platform #45)
|
|
55
|
+
|
|
56
|
+
- **當真正的問題是權限錯誤時,`uds init` 不再叫你去看防毒軟體(XSPEC-516 R2)。**複製標準失敗並出現 `EPERM` 或 `EACCES` 時,訊息說檔案「locked by another program」,並列出防毒軟體、搜尋索引器與雲端同步。這對 Windows 短暫的檔案鎖是對的,但 Windows 對唯讀檔案或被拒絕的資料夾也回報同樣兩個代碼。現在,這些代碼在重試之後仍持續失敗時,UDS 會自己試著寫入(開啟來源、開啟目的地寫入,或在資料夾內建立再移除一個暫存檔;不用 `fs.access`,因為它在 Windows 上忽略 ACL):只要其中一個被拒絕,訊息就說「permission denied」,點名它找到的東西並列出該檢查什麼(唯讀屬性、擁有者與權限、安全性索引標籤、唯讀磁碟機);不提防毒軟體。如果檔案能開啟寫入,那就是鎖,舊訊息保留。在 Windows 之外,這兩個代碼本來就不重試;它們現在會得到同樣的權限訊息,而不是裸錯誤(原始錯誤文字仍在訊息結尾,代碼不變)。**未驗證:**Windows 分支(重試,然後詢問檔案系統)由注入平台的單元測試涵蓋;沒有 Windows 機器為這一項跑過。
|
|
57
|
+
- **`uds init` 與 `uds update --apply` 對於無法建立的資料夾現在說「permission denied」,`uds update --apply` 會重試檔案被鎖住的標準,鎖與權限的訊息也跟隨語言設定(看板 #77,XSPEC-516 R2 的後續)。**權限措辭加進檔案複製時留下了缺口。(1) 複製前才建立的資料夾(`.standards/`)用的是單純的 `mkdirSync`,所以無法寫入的專案資料夾,每個標準都印一次 Node 裸露的 `EACCES: permission denied, mkdir '...'`,而不是說明該檢查什麼的訊息;現在它走同一套重試與同一套措辭,附上關於資料夾及其上層的檢查清單。(2) `uds update --apply` 用單純的 `copyFileSync` 把標準複製到專案,而它先做的備份(`.uds-backups/`,其中的資料夾與副本,回復也用)用的是單純的 `mkdirSync` 與 `cpSync`:被短暫鎖住的檔案(防毒軟體、索引器)在第一次嘗試就讓更新失敗,權限問題則顯示 Node 的裸文字;兩者現在都像 `uds init` 一樣重試鎖,並對權限問題說「permission denied」。(3) `copyIntegration`(為 `uds check --restore-missing` 還原整合檔,也是整合安裝器的靜態複製後備)得到同樣處理;它無法建立的資料夾現在回報為失敗的檔案(`{ success: false, error }`),不再從函式內丟出例外。**重試有上限:**最多嘗試 10 次,每次之間等 50 ms、100 ms、150 ms,依此類推到 500 ms,每個檔案總共約 2.3 秒,絕不超過 5 秒;之後錯誤會說明是哪個檔案、可能的原因與該怎麼做。在 Windows 之外的權限錯誤不重試(只試一次)。(4) 這兩則訊息現在都在 CLI 的訊息表裡(`fsErrors`,英文、繁體中文與簡體中文),所以它們和其他所有訊息一樣跟隨同一套語言設定(`--ui-lang`、專案的顯示語言、`~/.udsrc`,然後是 `LANG`)。**這兩則訊息的措辭會隨語言改變:**在 `zh-tw` 或 `zh-cn` 下它們現在是中文,所以搜尋其英文文字的腳本(例如 `locked by another program` 或 `permission denied`)在那裡找不到東西;以前不論設定為何,它們都是英文。英文措辭不變,原始錯誤文字(Node 的,英文)仍在每則訊息的結尾。在 Windows 上,可以建立檔案但不能建立資料夾的資料夾,現在用暫存資料夾而不是暫存檔來詢問,所以它被稱為「permission denied」,不再是「locked by another program」。失敗的 `uds init` 現在以設定結束碼(仍為 1)結束,而不是呼叫 `process.exit(1)`:當它的輸出進入管線(CI、AI 助理、腳本)時,macOS 以非同步方式寫入放不下的部分,而 `process.exit()` 把剩下的丟掉,所以失敗檔案清單的結尾可能遺失(實測:讀取端較慢時輸出恰好停在 65,536 位元組;在 CI 執行 41331713139 發現)。那一步只改了這條失敗路徑;另外兩個可能以同樣方式丟失輸出的指令,在上方一項修正(看板 #81)。**未涵蓋:**其他用單純 `mkdirSync`/`copyFileSync` 寫入專案的地方(技能、agent 與工作流程安裝器、hook 腳本安裝器、`github.js` 下載後備、整合產生器、`init` 與 `config` 自己的 `.standards` 資料夾、`spec-split`、update 指令的掃描器複製)仍印 Node 的裸文字且不重試;原因在這項變更的提交裡。Windows 分支(重試,然後詢問檔案系統)只在注入平台的單元測試中跑過,沒有 Windows 機器。
|
|
58
|
+
|
|
59
|
+
### 測試
|
|
60
|
+
|
|
61
|
+
- **刪除 XSPEC-005 的 66 支產生式佔位測試(XSPEC-518 R1)。**2026-04-07 的三個檔案(`cli/tests/unit/superspec-borrowing/XSPEC-005-superspec-borrowing.test.js`、`cli/tests/integration/XSPEC-005-superspec-borrowing.it.test.js`、`cli/tests/e2e/XSPEC-005-superspec-borrowing.e2e.test.js`)每個驗收條件放一支 `[TODO]` 測試,每支都以 `expect(true).toBe(true)` 結尾,66 支測試什麼也沒測卻通過;`check-anti-fake-tests` 點名了全部 66 支。它們指向的功能從未被建出或已被刪除(`uds check --spec-size`、`uds spec deps`、`uds spec create --boost`、`uds sync`),存在的那些已經有真正的測試(`validate-spec-size`、`spec-dependency`、`spec-dual-mode`、`spec-linter`、`lint`、`compute-spec-score`)。`tests/acceptance/XSPEC-005-superspec-borrowing-acceptance.md` 現在針對每個驗收測試,列出哪一支真正的測試涵蓋它,或沒有任何測試涵蓋。
|
|
62
|
+
- **complete-tier 斜線指令測試現在在指令缺少時會失敗(XSPEC-518 R1)。**`should_detect_missing_slash_commands_in_complete_tier_instruction_files` 算出指令檔漏掉哪些指令,只把它們記到日誌(「informational for now」),並以 `expect(true).toBe(true)` 結尾,所以它不可能失敗。現在它斷言 `integrations/REGISTRY.json` 裡沒有任何 complete-tier 檔案漏掉 `COMMAND-INDEX.json` 裡的指令,且至少比對了一個檔案。今天兩個被檢查的檔案缺口都是 50 中的 0;從 `integrations/opencode/AGENTS.md` 移除一處 `/check` 提及,它就變紅。
|
|
63
|
+
- **XSPEC-458 的測試不再需要 UDS 6.11.0 沒有的標準,XSPEC-462 的測試也不再寫死技能數。**`open-work-tracking` 是真正的 6.11.0 manifest 唯一缺少的標準,所以「上游有、未安裝」的測試(XSPEC-458 R1 到 R5)用了它。少了它,原始 fixture 就沒有缺少登錄檔提供的任何東西;測試現在以那份 manifest 減去一個參考標準(`STAND_IN_ID`,`self-review-protocol`,在 `cli/tests/utils/xspec-458.js`)建出舊專案,fixture README 也這麼說。`--format both` 升級的測試(XSPEC-483)預期 `open-work-tracking` 的兩個檔案是唯一的刪除,而不是預期沒有刪除。XSPEC-462 的測試手動數「56 個技能」,技能一增加就變紅;現在它們數 `skills/` 裡含 `SKILL.md` 的資料夾。讀取標準文字的測試(XSPEC-459 R4、XSPEC-460、XSPEC-464 R4 與一支單元測試)失去了它們的 `.ai.yaml`、登錄檔與自採用分支,並新增了把這三者讀成不存在的分支。
|
|
64
|
+
- **互動測試依提示問什麼來作答,從未出現的問題會讓測試失敗(XSPEC-516 R1)。**最後一支依固定順序送按鍵的測試(`init-flow.test.js` 的 `should allow selecting multiple AI tools`,隨 stdout 區塊到來送出 20 個答案,斷言只在安裝碰巧成功時才執行)現在用 `runPrompted`,並讀回 manifest 與 Cursor 的規則檔。依位置的 `runInteractive` 已從 `cli/tests/utils/cli-runner.js` 移除。`runPrompted` 現在在某條規則的提示從未出現時拒絕(`allowUnused: true` 可選擇退出),並且可以驅動另一個程式(`entry`、`command`),`e2e-helpers-cross-platform.test.js` 用它以兩種順序詢問同樣兩個問題。**已檢查且不變:**沒有任何測試路徑繞過 `cli/tests/setup.js` 的拋棄式家目錄(XSPEC-516 R3)。
|
|
65
|
+
|
|
21
66
|
## [6.14.1] - 2026-10-30
|
|
22
67
|
|
|
23
68
|
> **正式版發布**:包含下方 6.14.1-beta.1 與 beta.2 的所有內容,beta.2 之後沒有任何變更。beta.2 已在 Windows、macOS、Linux 完成發布後驗收(0 項失敗)。**安全修正:**危險指令 hook 現在會真的擋下;已經裝過 hook 的專案執行 `uds update --with-hooks` 即可換上修好的腳本(beta.2)。
|
|
@@ -15,7 +15,7 @@ status: current
|
|
|
15
15
|
|
|
16
16
|
> **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
|
|
17
17
|
|
|
18
|
-
**版本**: 6.
|
|
18
|
+
**版本**: 6.15.0-beta.1 (Pre-release) | **發布日期**: 2026-11-04 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
|
|
19
19
|
|
|
20
20
|
語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
|
|
21
21
|
|
|
@@ -77,7 +77,7 @@ npx universal-dev-standards init
|
|
|
77
77
|
| 類別 | 數量 | 說明 |
|
|
78
78
|
|----------|-------|-------------|
|
|
79
79
|
| **核心標準** | 153 | 通用開發準則 |
|
|
80
|
-
| **AI Skills** |
|
|
80
|
+
| **AI Skills** | 57 | 互動式技能 |
|
|
81
81
|
| **斜線命令** | 51 | 快速操作 |
|
|
82
82
|
| **CLI 指令** | 24 | 專案設定與維護 |
|
|
83
83
|
<!-- UDS_STATS_TABLE_END -->
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
source: ../../../core/developer-memory.md
|
|
3
3
|
source_version: 1.2.1
|
|
4
4
|
translation_version: 1.2.1
|
|
5
|
-
last_synced: 2026-10-
|
|
6
|
-
source_hash:
|
|
5
|
+
last_synced: 2026-10-30
|
|
6
|
+
source_hash: e0ef1ff960bb
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -654,7 +654,7 @@ fi
|
|
|
654
654
|
下面兩種資訊不在本標準的範圍內,寫進這裡是錯的:
|
|
655
655
|
|
|
656
656
|
- **個人、跨專案、可識別的資訊**(誰負責什麼、怎麼連到某個環境)。去識別化(見上方的 schema)會把這些剝掉,所以它們不能是一筆記憶條目。它們屬於使用者自己的 AI 工具的記憶——那種記憶綁定該使用者與該機器,不被分享。
|
|
657
|
-
-
|
|
657
|
+
- **專案之間的協調**(哪件工作在等哪件工作)。那是開放工作,不是記憶:實作指引是選用技能 [`/open-work`](../../../skills/open-work-assistant/SKILL.md),規則在參考文件 [Open Work Tracking](open-work-tracking.md)(OWT-027–OWT-029)。
|
|
658
658
|
|
|
659
659
|
---
|
|
660
660
|
|
|
@@ -3,7 +3,7 @@ source: ../../../core/full-coverage-testing.md
|
|
|
3
3
|
source_version: 1.3.0
|
|
4
4
|
translation_version: 1.3.0
|
|
5
5
|
last_synced: 2026-10-08
|
|
6
|
-
source_hash:
|
|
6
|
+
source_hash: be68e0568eda
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -106,7 +106,7 @@ expect(countInstalled({ standards: [{ id: 'a', installed: true }, { id: 'b', ins
|
|
|
106
106
|
|
|
107
107
|
**兩個已接受、不隱瞞的代價。**
|
|
108
108
|
|
|
109
|
-
1. **差分測試會被點名。** 拿參考實作當預期值的測試,`expect(fastTotal(items)).toBe(items.reduce((s, i) => s + i.price, 0))
|
|
109
|
+
1. **差分測試會被點名。** 拿參考實作當預期值的測試,`expect(fastTotal(items)).toBe(items.reduce((s, i) => s + i.price, 0))`,文字上和教科書例一模一樣,所以掃描腳本會點名它。這種測試是正當的(見上表「預言是另一份獨立寫成的實作」);處理方式有二:在同一支測試裡另外加一個對手算字面值的斷言(只有在測試的所有斷言都不是真斷言時才回報),或用 `ANTI_FAKE_EXEMPT: <理由>` 註解只豁免那一支測試(見下方〈兩支掃描腳本〉;理由必填,且該測試每次執行都會被列出),或把該檔列進 `.standards/test-policy.json` 的 `ignore`(這會讓整個檔案不再被這支腳本的任何檢查看到,且 `ignore` 不收理由,請在註解寫明)。測試名稱寫「與參考實作一致」**不能**豁免,`exempt` 清單也不適用於這支腳本(它屬於「改了程式碼卻沒有測試」的檢查)。
|
|
110
110
|
2. **這條規則很容易被繞過。** 把**被測值**包進 `Number(...)`、在它後面接 `.valueOf()` 或 `[0]`、把引數改成 `items.slice()`,掃描腳本就看不到了。(對**預期值**做同樣的事沒有用:照樣會被點名。)它是提醒審查者的線索,不是擋得住刻意規避的閘門,寫測試的是 AI 代理時尤其如此:掃描乾淨不能當成預期值獨立的證據。下面審查者的問題才是控制手段,腳本只指出最容易判的情形。
|
|
111
111
|
|
|
112
112
|
與 `expect(true).toBe(true)` 相同,只有在測試的**所有**斷言都不是真斷言時才回報;自我比較旁邊還有一個對字面值的斷言,就留給審查者。文字判不了的,掃描腳本保持沉默——會亂叫的掃描腳本遲早被關掉。
|
|
@@ -286,11 +286,13 @@ legacy 降級模式(外部服務失敗時的 fallback、重試、部分結果
|
|
|
286
286
|
|
|
287
287
|
- 純 Node、零相依、不預設任何測試框架。它們是**你的檔案**:可以改、可以接進 CI。單獨執行時,找到東西就以非 0 結束——`node scripts/check-stubs.mjs` 就是本標準部署閘門所說的 pre-push/部署閘門。
|
|
288
288
|
- `uds init` 不會覆寫已存在的檔案,`uds update` 也不會;較早初始化的專案,`uds update` 會詢問是否寫入(提示的預設為否;`uds update -y` 會直接回答是)。
|
|
289
|
-
- 有暫存檔案時只讀那些檔案;沒有暫存任何東西時(CI 執行、手動 `uds check
|
|
289
|
+
- 有暫存檔案時只讀那些檔案;沒有暫存任何東西時(CI 執行、手動 `uds check`)每支都會走訪整個專案——走訪最多列出 200,000 個檔案(`--max-files N` 可調低),`uds check` 給每支 120 秒(超過就回報「無法判定」,絕不算通過)——所以在很大的儲存庫裡,請在 CI 執行,不要期待立刻完成。走訪撞到檔案數上限、打不開某個目錄、或讀不了某個檔案時,會印出 `INCOMPLETE`;若在已看到的部分沒有發現,就以 `2` 結束(有發現仍是 `1`):只查了一部分的結果,絕不當成乾淨。
|
|
290
290
|
- 同一行或上面三行內出現 `STUB` 或 `COVERAGE_EXEMPT`,該暫時實作就算已**宣告**;已宣告的只以標記回報一次。
|
|
291
291
|
- **語言範圍。**測試檔規則涵蓋 JavaScript/TypeScript、Python、Java/Kotlin/Scala/C#、Go、Rust、Ruby、Elixir、PHP、Swift、Dart、Lua 與 C/C++。其他語言的測試檔會被列為「未掃描」——絕不當成乾淨。空函式規則涵蓋 JavaScript/TypeScript、Python、Go、Rust、Ruby 與 PHP;其他語言仍會找標記與「尚未實作」的本體,輸出也會寫出哪些語言沒有空函式規則。
|
|
292
292
|
- 它們讀的是文字,不執行你的測試。若某個輔助函式用掃描器認不得的名稱做斷言,會被報為「no-assertion」:把它命名為 `assert*`/`verify*`/`expect*`,或把它的樣式列在政策檔的 `assertionPatterns`。
|
|
293
293
|
- 每次執行都先拿已知的假測試與已知的好測試檢驗自己;檢驗失敗就以 `2`(「無法判定」)結束,這絕不算通過。
|
|
294
|
+
- 兩支腳本的結束碼:`0` 沒找到東西,`1` 有發現,`2` 無法判定(自我檢驗失敗、`--staged` 時讀不了 git,或查詢不完整且在已看到的部分沒有發現)。`2` 絕不算通過。
|
|
295
|
+
- 只有 `check-anti-fake-tests`:可以用註解 `ANTI_FAKE_EXEMPT: <理由>` 豁免一支測試,寫在該測試同一行,或寫在緊貼其正上方的註解行。理由至少要有 8 個字母、數字或漢字,且不能是 `TODO` 這類占位字;沒有可用理由的註記不生效,發現會說明原因。它只作用於所附著的那一支測試(中間隔了空行或程式碼就失效;同一行起頭兩支測試時,兩支都不豁免)。被豁免的測試每次執行都會列出,`--json` 以 `exempted` 欄位記錄。
|
|
294
296
|
|
|
295
297
|
### 改了程式碼卻沒動測試(`uds check`,針對已暫存的變更)
|
|
296
298
|
|
|
@@ -2,13 +2,24 @@
|
|
|
2
2
|
source: ../../../core/open-work-tracking.md
|
|
3
3
|
source_version: 1.4.0
|
|
4
4
|
translation_version: 1.4.0
|
|
5
|
-
last_synced: 2026-10-
|
|
6
|
-
source_hash:
|
|
5
|
+
last_synced: 2026-10-30
|
|
6
|
+
source_hash: 5babb5536216
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
# 開放工作追蹤標準
|
|
11
11
|
|
|
12
|
+
<!-- UDS:REFERENCE-ONLY -->
|
|
13
|
+
> **僅供參考——UDS 不再安裝這條標準。** 它的機器可讀檔 `.ai.yaml` 與 registry 條目已移除。
|
|
14
|
+
> 這條標準只在一個專案上校準過,而那個專案自己的使用沒有證實它,
|
|
15
|
+
> 所以它不再是每個採用者都要遵守的東西。本文件保留,供已經依它建置的採用者參考,
|
|
16
|
+
> **不由 `uds init` 或 `uds update` 出貨**。其中值得保留的部分改成
|
|
17
|
+
> **選用技能** [`/open-work`](../../../skills/open-work-assistant/SKILL.md):想用才用,沒有任何東西要求你用。
|
|
18
|
+
> 參考檢查仍以 `uds open-work` 提供。已經裝在你 `.standards/` 的副本,由
|
|
19
|
+
> `uds update --apply` 移除(計畫會把它列在 Delete 底下,並先做備份)。本告示所對照的清單是
|
|
20
|
+
> [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json);
|
|
21
|
+
> 變更記在 [CHANGELOG](../../../CHANGELOG.md)(Unreleased)。
|
|
22
|
+
|
|
12
23
|
> **Language**: [English](../../../core/open-work-tracking.md) | 繁體中文
|
|
13
24
|
|
|
14
25
|
**版本**: 1.4.0
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
source: ../../../core/project-context-memory.md
|
|
3
3
|
source_version: 1.2.1
|
|
4
4
|
translation_version: 1.2.1
|
|
5
|
-
last_synced: 2026-10-
|
|
6
|
-
source_hash:
|
|
5
|
+
last_synced: 2026-10-30
|
|
6
|
+
source_hash: 2d7135188919
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -243,7 +243,7 @@ Beta v5.1.0-beta.1 published on 2026-03-14.
|
|
|
243
243
|
## 邊界:本標準不放什麼
|
|
244
244
|
|
|
245
245
|
- **個人、跨專案、可識別的資訊**(誰負責什麼、怎麼連到某個環境)不是專案情境:這裡的條目放在 repo 裡,會被每個 clone 它的人看到。把它們放在使用者自己的 AI 工具記憶,不要放進 `.project-context/`。
|
|
246
|
-
-
|
|
246
|
+
- **專案之間的協調**(哪件工作在等哪件工作)是開放工作,不是情境:實作指引是選用技能 [`/open-work`](../../../skills/open-work-assistant/SKILL.md),規則在參考文件 [Open Work Tracking](open-work-tracking.md)(OWT-027–OWT-029)。
|
|
247
247
|
|
|
248
248
|
---
|
|
249
249
|
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
source: ../../../docs/AVAILABLE-STANDARDS.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-10-
|
|
6
|
-
source_hash:
|
|
5
|
+
last_synced: 2026-10-30
|
|
6
|
+
source_hash: 2fb441aba7b2
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -54,9 +54,9 @@ status: current
|
|
|
54
54
|
```sh
|
|
55
55
|
uds update --plan # 先印計畫,再印「上游有、專案沒裝(N 個)」,依類別分組
|
|
56
56
|
uds update --apply # 套用計畫;結尾印出有幾個可用、怎麼裝
|
|
57
|
-
uds update --apply --add-standard
|
|
57
|
+
uds update --apply --add-standard turn-completion-integrity # 裝一個,並記入 manifest
|
|
58
58
|
uds update --apply --add-standard a --add-standard b # 裝多個
|
|
59
|
-
uds update --plan --add-standard
|
|
59
|
+
uds update --plan --add-standard turn-completion-integrity # 先預覽
|
|
60
60
|
uds check # 一行:「上游有 N 個標準未安裝」
|
|
61
61
|
uds audit --friction # 一項低嚴重度發現(不進 --report、不影響 --score)
|
|
62
62
|
```
|
|
@@ -129,6 +129,7 @@
|
|
|
129
129
|
| `metrics-dashboard-assistant` | [UDS] 長期追蹤開發指標、程式碼品質指標與技術債。 |
|
|
130
130
|
| `migration-assistant` | [UDS] 引導系統性的程式碼遷移、框架升級與技術現代化。 |
|
|
131
131
|
| `observability-assistant` | 引導可觀測性建置、指標設計與告警設定。 |
|
|
132
|
+
| `open-work-assistant` | [UDS] 選用的小幫手,幫忙追蹤跨工作階段仍未完成的工作:便宜的收件點、每個等待都有解除條件、下一步點名真實的東西。 |
|
|
132
133
|
| `orchestrate` | 以 Claude 原生 Agent tool 編排多任務執行計畫(以 DAG 為基礎,不需外部引擎)。 |
|
|
133
134
|
| `plan` | 從 Spec 文件、OpenSpec 變更或自由文字需求生成 plan.json。 |
|
|
134
135
|
| `pr-automation-assistant` | 引導 pull request 建立、審查自動化與合併策略。 |
|
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
source: ../../../docs/CLI-INIT-OPTIONS.md
|
|
3
3
|
source_version: 3.7.1
|
|
4
4
|
translation_version: 3.7.1
|
|
5
|
-
last_synced: 2026-10-
|
|
6
|
-
source_hash:
|
|
5
|
+
last_synced: 2026-10-30
|
|
6
|
+
source_hash: bdccdf225333
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -911,7 +911,12 @@ uds update --with-hooks --ai-tool antigravity # 直接指定工具,不做
|
|
|
911
911
|
- **不會動什麼。** 已經裝好的 hook 不會被重寫。你自己的 hooks 不會被移除或重排:Claude、Codex、Gemini 的
|
|
912
912
|
項目是合併進去;Antigravity 的 `.agents/hooks.json` 只寫在 `uds-turn-completion-integrity` 這個鍵底下
|
|
913
913
|
(不是合法 JSON 的 `hooks.json` 會原樣保留並回報)。`scripts/hooks/` 裡與隨附版本不同的 hook 腳本會被保留並回報;
|
|
914
|
-
加上 `--force`
|
|
914
|
+
加上 `--force` 才會覆寫。它改寫的每一支腳本(沒人改過的舊版,或加了 `--force` 時改過的那一支)都會先複製到
|
|
915
|
+
`.uds-backups/`,輸出會印出位置;`uds update --rollback` 會把它放回去。
|
|
916
|
+
- **其他 `uds update` 形式。** 一般的 `uds update` 與 `uds update --apply`(含 `--force`)也會替換「舊版 UDS 裝的、沒人改過」的
|
|
917
|
+
hook 腳本,同樣先備份;改過的會保留(它們不會新增尚未安裝的 hook,也不會做 `--force` 的覆寫——那仍屬於這裡)。
|
|
918
|
+
`--plan` 會列出它會替換哪些腳本。縮限到 `--skills`、`--commands`、`--standards-only`、`--integrations-only`、
|
|
919
|
+
`--sync-refs` 或 `--claude-target` 的執行不會動它們,並會明說。
|
|
915
920
|
- **它不做什麼。** 不更新標準、技能或整合檔(那是一般的 `uds update`),也不會把工具加進 manifest。
|
|
916
921
|
它不能與 `--skills`、`--commands` 等其他 update 模式合用,合用時會明說。
|
|
917
922
|
|
|
@@ -11,13 +11,13 @@
|
|
|
11
11
|
|
|
12
12
|
1. [CLI 指令](#cli-commands) (24)
|
|
13
13
|
2. [斜線命令](#slash-commands) (51)
|
|
14
|
-
3. [技能](#skills) (
|
|
14
|
+
3. [技能](#skills) (57)
|
|
15
15
|
4. [代理](#agents) (5)
|
|
16
16
|
5. [工作流程](#workflows) (5)
|
|
17
17
|
6. [核心規範](#core-standards) (153)
|
|
18
18
|
7. [腳本](#scripts) (68)
|
|
19
19
|
|
|
20
|
-
**Total Features:
|
|
20
|
+
**Total Features: 363**
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
@@ -152,7 +152,7 @@
|
|
|
152
152
|
| `--commands` | Install/update slash commands for configured AI tools |
|
|
153
153
|
| `--debug` | Show debug output for Skills/Commands detection |
|
|
154
154
|
| `--plan` | Show reconciliation plan without executing (like terraform plan); combines with --skills/--commands to plan just that scope, still writing nothing |
|
|
155
|
-
| `--apply` | Apply exactly the plan --plan prints (plain `uds update` does not); with --skills/--commands it does the reconciliation AND that scope, not only the scope |
|
|
155
|
+
| `--apply` | Apply exactly the plan --plan prints (plain `uds update` does not); with --skills/--commands it does the reconciliation AND that scope, not only the scope. Also replaces hook scripts in scripts/hooks/ that are unmodified copies of an older UDS (copied to .uds-backups/ first; edited ones are kept), as plain `uds update` does |
|
|
156
156
|
| `--force` | Force update all files, ignoring hash comparison |
|
|
157
157
|
| `--prune` | Delete .standards/ files UDS wrote but no longer ships (listed without this flag; never touches files UDS did not write) |
|
|
158
158
|
| `--rollback` | Rollback to the most recent backup (with the series of updates that follow from it) |
|
|
@@ -160,7 +160,7 @@
|
|
|
160
160
|
| `--add-standard` | With --plan or --apply: also install this standard UDS ships and the project lacks, and record it in the manifest (repeatable; `uds update --plan` lists what is available) |
|
|
161
161
|
| `--claude-target` | Switch an existing install to a different Claude Code integration target: project (CLAUDE.md) or local (CLAUDE.local.md) — moves the UDS block, keeps your content, no reinstall |
|
|
162
162
|
| `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
|
|
163
|
-
| `--with-hooks` | Install the enforcement hooks that are missing from this already-initialized project (re-detects tools; hooks already there and your own hooks are not touched; a hook script that is an unmodified copy from an older UDS is replaced, an edited one is kept; with --plan, writes nothing; --force also overwrites edited hook scripts) |
|
|
163
|
+
| `--with-hooks` | Install the enforcement hooks that are missing from this already-initialized project (re-detects tools; hooks already there and your own hooks are not touched; a hook script that is an unmodified copy from an older UDS is replaced, an edited one is kept; with --plan, writes nothing; --force also overwrites edited hook scripts; every script it rewrites is copied to .uds-backups/ first, and `uds update --rollback` puts it back) |
|
|
164
164
|
| `--ai-tool` | With --with-hooks: comma-separated tools to install hooks for (claude-code, codex, gemini-cli, antigravity) instead of detecting them |
|
|
165
165
|
|
|
166
166
|
### `uds skills`
|
|
@@ -388,6 +388,7 @@
|
|
|
388
388
|
| `metrics-dashboard-assistant` | [UDS] 長期追蹤開發指標、程式碼品質指標與技術債。 |
|
|
389
389
|
| `migration-assistant` | [UDS] 引導系統性的程式碼遷移、框架升級與技術現代化。 |
|
|
390
390
|
| `observability-assistant` | 引導可觀測性建置、指標設計與告警設定。 |
|
|
391
|
+
| `open-work-assistant` | [UDS] 選用的小幫手,幫忙追蹤跨工作階段仍未完成的工作:便宜的收件點、每個等待都有解除條件、下一步點名真實的東西。 |
|
|
391
392
|
| `orchestrate` | 以 Claude 原生 Agent tool 編排多任務執行計畫(以 DAG 為基礎,不需外部引擎)。 |
|
|
392
393
|
| `plan` | 從 Spec 文件、OpenSpec 變更或自由文字需求生成 plan.json。 |
|
|
393
394
|
| `pr-automation-assistant` | 引導 pull request 建立、審查自動化與合併策略。 |
|
|
@@ -60,6 +60,7 @@ skills/
|
|
|
60
60
|
| `refactoring-assistant` | `/refactor` | [UDS] 重構指引 |
|
|
61
61
|
| `project-discovery` | `/discover` | [UDS] 評估專案健康度與風險 |
|
|
62
62
|
| `brainstorm-assistant` | `/brainstorm` | [UDS] 結構化 AI 輔助發想 |
|
|
63
|
+
| `open-work-assistant` | `/open-work` | [UDS] 選用:避免工作在工作階段之間漏掉(便宜的收件點、每個等待都有解除條件、點名東西的下一步) |
|
|
63
64
|
| `comprehension-ladder` | `/comprehend` | [UDS] 把難懂的 AI 輸出換成受控文字、Mermaid 圖或離線 HTML 解說頁,不改變事實 |
|
|
64
65
|
| `changelog-guide` | `/changelog` | [UDS] 產生 changelog 條目 |
|
|
65
66
|
| `dev-workflow-guide` | `/dev-workflow` | [UDS] 將開發階段對應到 UDS 命令 |
|
|
@@ -101,7 +102,7 @@ skills/
|
|
|
101
102
|
### Tier 3 — Specialist(每月或事件驅動)
|
|
102
103
|
**列出預設**:在參考覆寫中為 `"name-only"`——節省 token;**仍可透過 `/<name>` 呼叫**。
|
|
103
104
|
|
|
104
|
-
`incident-response-assistant`、`observability-assistant`、`slo-assistant`、`runbook-assistant`、`retrospective-assistant`、`durable-execution-assistant`、`metrics-dashboard-assistant`、`migration-assistant`、`security-scan-assistant`、`brainstorm-assistant`、`skill-builder`
|
|
105
|
+
`incident-response-assistant`、`observability-assistant`、`slo-assistant`、`runbook-assistant`、`retrospective-assistant`、`durable-execution-assistant`、`metrics-dashboard-assistant`、`migration-assistant`、`security-scan-assistant`、`brainstorm-assistant`、`skill-builder`、`open-work-assistant`
|
|
105
106
|
|
|
106
107
|
> Tier 的理由與準則:[`flows/skill-tiering-rationale.md`](../../../flows/skill-tiering-rationale.md)。採用者可自由覆寫參考設定(若每日使用某個 Tier 3 skill 可升為 `"on"`,或將任一 skill 降為 `"name-only"`)。
|
|
107
108
|
|
|
@@ -4,7 +4,7 @@ source: ../../../../skills/dev-workflow-guide/SKILL.md
|
|
|
4
4
|
source_version: 1.0.0
|
|
5
5
|
translation_version: 1.1.0
|
|
6
6
|
last_synced: 2026-08-17
|
|
7
|
-
source_hash:
|
|
7
|
+
source_hash: 66f5ad727df3
|
|
8
8
|
status: current
|
|
9
9
|
description: |
|
|
10
10
|
[UDS] 把目前的軟體開發階段對應到正確的 UDS 指令與 Skill。
|
|
@@ -15,7 +15,7 @@ description: |
|
|
|
15
15
|
|
|
16
16
|
# 開發工作流程指南
|
|
17
17
|
|
|
18
|
-
> **語言**: [English](
|
|
18
|
+
> **語言**: [English](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/skills/dev-workflow-guide/SKILL.md) | 繁體中文
|
|
19
19
|
|
|
20
20
|
將你目前的軟體開發階段對應到正確的 UDS 指令與技能。即時了解在開發的每個階段應該使用哪些工具。
|
|
21
21
|
|
|
@@ -166,7 +166,7 @@ API 設計與實作的推薦流程:
|
|
|
166
166
|
2. **階段參數**:顯示該階段的詳細指引,包含所有相關指令與範例
|
|
167
167
|
3. **場景參數**:顯示該場景的推薦逐步工作流程
|
|
168
168
|
|
|
169
|
-
此技能會從 [workflow-phases.md](
|
|
169
|
+
此技能會從 [workflow-phases.md](./workflow-phases.md) 讀取詳細的階段資訊。
|
|
170
170
|
|
|
171
171
|
## 下一步引導
|
|
172
172
|
|
|
@@ -183,10 +183,10 @@ API 設計與實作的推薦流程:
|
|
|
183
183
|
|
|
184
184
|
## 參考
|
|
185
185
|
|
|
186
|
-
- [詳細階段指引](
|
|
187
|
-
- [每日工作流程指南](
|
|
188
|
-
- [功能開發工作流程](
|
|
189
|
-
- [整合流程工作流程](
|
|
186
|
+
- [詳細階段指引](./workflow-phases.md) - 完整的逐階段參考
|
|
187
|
+
- [每日工作流程指南](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/adoption/DAILY-WORKFLOW-GUIDE.md) - 完整的每日工作流程指南
|
|
188
|
+
- [功能開發工作流程](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/skills/workflows/feature-dev.workflow.yaml) - 自動化功能開發工作流程
|
|
189
|
+
- [整合流程工作流程](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/skills/workflows/integrated-flow.workflow.yaml) - 完整的 ATDD/SDD/BDD/TDD 工作流程
|
|
190
190
|
|
|
191
191
|
---
|
|
192
192
|
|