universal-dev-standards 6.15.0 → 6.16.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/bin/uds.js +2 -0
  2. package/bundled/locales/zh-CN/CHANGELOG.md +34 -4
  3. package/bundled/locales/zh-CN/CLAUDE.md +2 -2
  4. package/bundled/locales/zh-CN/README.md +17 -14
  5. package/bundled/locales/zh-CN/SECURITY.md +1 -0
  6. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +1 -1
  7. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +24 -2
  8. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +3 -1
  9. package/bundled/locales/zh-TW/CHANGELOG.md +34 -4
  10. package/bundled/locales/zh-TW/CLAUDE.md +2 -2
  11. package/bundled/locales/zh-TW/README.md +17 -14
  12. package/bundled/locales/zh-TW/SECURITY.md +1 -0
  13. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +1 -1
  14. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +24 -2
  15. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +3 -1
  16. package/package.json +3 -3
  17. package/src/commands/skills.js +9 -0
  18. package/src/commands/update.js +223 -2
  19. package/src/reconciler/desired-state-calculator.js +11 -2
  20. package/src/utils/optional-skills-report.js +86 -0
  21. package/src/utils/optional-skills.js +20 -0
  22. package/src/utils/skill-selection.js +137 -0
  23. package/src/utils/skills-installer.js +11 -4
  24. package/standards-registry.json +7 -7
  25. package/src/core/agent-communication-protocol.js +0 -257
  26. package/src/flow/condition-evaluator.js +0 -86
  27. package/src/flow/flow-bundler.js +0 -80
  28. package/src/flow/flow-commands.js +0 -107
  29. package/src/flow/flow-engine.js +0 -154
  30. package/src/flow/flow-inheritance.js +0 -100
  31. package/src/flow/flow-parser.js +0 -104
  32. package/src/flow/flow-validator.js +0 -37
  33. package/src/flow/gate-checker.js +0 -82
  34. package/src/flow/gate-loader.js +0 -52
  35. package/src/missions/MissionManager.js +0 -533
  36. package/src/utils/e2e-analyzer.js +0 -471
  37. package/src/utils/e2e-detector.js +0 -132
  38. package/src/utils/hook-stats.js +0 -151
  39. package/src/utils/workflow-executor.js +0 -870
  40. package/src/utils/workflows-installer.js +0 -545
  41. package/src/vibe/auto-sweep.js +0 -349
package/bin/uds.js CHANGED
@@ -236,6 +236,8 @@ program
236
236
  .option('--rollback', 'Rollback to the most recent backup (with the series of updates that follow from it)')
237
237
  .option('--from <backup>', 'With --rollback: restore this one backup instead of the most recent series (the id --rollback prints, or its folder name); use it for a backup an older UDS made')
238
238
  .option('--add-standard <id>', '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)', (value, previous) => [...previous, value], [])
239
+ .option('--add-skill <name>', 'Add one skill to every AI tool folder this project has, and record it so updates keep it (repeatable). Takes the skill name (open-work) or its folder name (open-work-assistant). Optional skills such as open-work are installed only this way; combine with --apply/--skills to run that too, with --plan to preview', (value, previous) => [...previous, value], [])
240
+ .option('--remove-skill <name>', 'Remove one skill from every AI tool folder this project has, and record it so no update installs it again (repeatable; any skill, not only optional ones). Undo with --add-skill. Combine with --apply/--skills to run that too, with --plan to preview', (value, previous) => [...previous, value], [])
239
241
  .option('--claude-target <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')
240
242
  .option('--locale <locale>', 'Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env')
241
243
  .option('--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)')
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  source: ../../CHANGELOG.md
3
- source_version: 6.15.0
4
- translation_version: 6.15.0
5
- last_synced: 2026-11-04
6
- source_hash: f021bb23e372
3
+ source_version: 6.16.0-beta.2
4
+ translation_version: 6.16.0-beta.2
5
+ last_synced: 2026-11-20
6
+ source_hash: 74d8ad482d4d
7
7
  status: current
8
8
  ---
9
9
 
@@ -18,6 +18,36 @@ status: current
18
18
 
19
19
  ## [Unreleased]
20
20
 
21
+ ## [6.16.0-beta.2] - 2026-11-20
22
+
23
+ *6.16.0-beta.1 已打 tag 但未发布:它的 CI 在 Windows 上失败(可达性检查有路径分隔符的错误,已在此版修复)。预发布版,以 `npm install -g universal-dev-standards@beta` 安装。可选技能现在真的是可选,并可用 `uds update --add-skill` / `--remove-skill` 自行选择;README 的“验证”列现在要求每个工具通过五项检查;删除 17 个走不到的模块。更新带有 `open-work` 的项目前,请先读“修复”的第一条。*
24
+
25
+ ### 修复
26
+
27
+ - **可选技能现在真的是可选:`uds update` 不再把 `open-work` 装进没有要它的项目(issue #298)。** `open-work` 技能(文件夹 `skills/open-work-assistant/`)自己写着它是可选的、“UDS 里没有任何东西要求它”,但 `uds update --apply`(连同 `--skills`、`--commands`)把它装进每个项目的每个 AI 工具文件夹(`.claude/skills`、`.opencode/skill`、`.agents/skills` 等)。已经有自己同类技能的人,就会看到两个说法几乎一样的技能。原因是:项目该拿到哪些技能,被定义成“这版 UDS 出货的全部”,而且写了两份(reconciler 的规划与安装器),没有任何方式让某个技能被排除。现在有一份可选技能清单(`cli/src/utils/skill-selection.js` 的 `OPTIONAL_SKILLS`,目前只有 `open-work-assistant`),和一个决定某个工具文件夹该拿哪些技能的函数;reconciler 的规划,以及 `init`、`update`、`config` 里每个 `skillNames = null` 的安装,都问同一个函数,所以规划不会承诺一组、写入却写另一组。项目拿到的是:UDS 出货的,减去可选技能,减去它移除的技能,加上它要求的可选技能,加上**已经在该工具文件夹里的可选技能**。最后一项是给 6.15.0-beta.1 的项目:它们已经有 `open-work`,会被保留并像其他技能一样更新,`uds update --plan` 不会把它列在 Delete,只有项目自己移除它才会消失。`uds update --plan`、`--apply`、`--skills` 现在结尾多一段“Optional skills”,说明哪些技能是可选、这个项目装了没有,以及加装或移除各自的命令;`uds skills` 说明没装的可选技能不算缺少。**现有项目会看到的改变:**已有 `open-work` 的 6.15.0-beta.1 项目什么都不会少。从 6.14.x 或更旧版本更新的项目不再拿到 `open-work`(6.15.0-beta.1 之前本来也没有)。要它:`uds update --add-skill open-work`。
28
+ - **本仓库自己的闸门检查现在在 Windows 上也用 `/` 比对文件路径,`windows-latest` 因此通过(6.16.0-beta.1 就是卡在这里)。** `check-module-reachability` 用 `path.relative()` 组出每个模块的键,这在 Windows 上会得到 `bin\uds.js`,再拿去和写成 `bin/uds.js` 的入口与基线比对。两种写法在 Windows 上永远对不上,于是入口本身被报成“新增的不可达模块”,`windows-latest` 的单元测试因此失败。同样的修复也应用到 `check-command-existence` 与 `check-shipped-stamp-consistency`(共用一个辅助函数,`cli/scripts/lib/posix-path.mjs` 的 `relativePosix`);只有比对用的键改了,读文件仍走平台原生路径。`uds` 的命令、选项与输出都没有变:这些是在本仓库的 CI 里跑的检查,不在软件包内。
29
+ - **空的基线清单不再到期,非空的基线清单必须带有效的到期日。** 到期日是“先不修的清单”的时钟,不是闸门的时钟。现在由一条共用规则(`cli/scripts/lib/baseline-expiry.mjs`)统一判断,应用到 `check-command-existence`、`check-module-reachability`、`check-shipped-stamp-consistency` 与 orphan-matrix 的 allowlist:清单为空就不看日期;清单非空时,日期已过或没有有效的 `YYYY-MM-DD` 日期都算失败(以前没有日期会被当成“未到期”而悄悄通过)。基线文件与其日期本身未改。同样只影响本仓库的 CI,`uds` 的命令、选项与输出都没有变。
30
+
31
+ ### 新增
32
+
33
+ - **`uds update --add-skill <name>` 与 `uds update --remove-skill <name>` 加装或移除单个技能,而且选择会被记住(issue #298)。** 两者都可重复。名称可以是技能名(`open-work`)或文件夹名(`open-work-assistant`);UDS 没有出货的名称会以 1 结束、列出可用的名称、什么都不写(同一个命令里有一个坏名称,其他的也不会执行)。`--add-skill` 立即把技能装进项目所有的 AI 工具文件夹,若是可选技能,另记在 `manifest.skills.extra`。`--remove-skill` 从每个项目级别的工具文件夹删除该技能的文件夹,移除它的哈希记录与 `skills.names` 里的条目,并记在 `manifest.skills.excluded`;任何技能都能移除,不只可选技能,之后的 `uds update`(一般、`--apply`、`--skills`)都不会再装回——手动删掉的技能文件夹从来没有这个保证(下一次更新就写回来)。对已移除的技能执行 `--add-skill`,会把它从 `excluded` 拿掉。用户级别的文件夹(`~/.claude/skills`)由这台机器上的所有项目共用,所以移除时不动它,并打印出它的路径。两者都会先做备份(`uds update --rollback` 可还原),`--plan` 说明会做什么而不写任何东西,加装一个技能也不会改变该文件夹里其他技能所记录的版本。单独使用时,每个选项就是一整个命令;与 `--apply`、`--force`、`--skills`、`--commands`、`--standards-only` 并用时,它先做自己的部分,其余再接着执行。不能与 `--rollback`、`--claude-target`、`--with-hooks`、`--sync-refs`、`--integrations-only` 并用。**Manifest 与旧版 manifest:**这两个键是 `skills` 底下的文件夹名列表;在此之前写的 manifest 两者都没有,读作“项目没有做任何选择”,所以不需要迁移,空列表也不会被写出。这个选择不放在 `skills.names`:它是 UDS 安装过的名称并集,不是选择。
34
+
35
+ ### 变更
36
+
37
+ - **README 的“验证”列现在只有工具通过全部五项检查才标勾,所以 Codex 改回“尚未验证”(XSPEC-357 R8)。** README 写支持 11 个工具,但只有 Codex 有验证记录,而且那份记录只涵盖对工具要求的五件事里的一件。现在每个工具有五格(安装、代理读到规范、实际任务中遵循、违反时检测得到、更新后仍正常),每格附日期与证据路径,没验的就写原因。README 开头由“1 个经过行为验证”改为“0 个经过行为验证”(三种语言都改);Codex 那一行仍保留 2026-07-23 的任务探针结果。新的矩阵页是 `docs/reference/INTEGRATION-VERIFICATION-MATRIX.md`,由 `integrations/REGISTRY.json` 生成。第 1、5 格(安装与更新)有从 `uds init` 与 `uds update` 入口触发的 e2e 测试,读回各工具配置文件里的 UDS 区块:采用者自己的行要保留、区块列出的每份标准都要在磁盘上、旧版安装上运行 `uds update` 之后缺的标准要被补回。Continue.dev 在 `uds init` 没有入口,它的这两格维持“尚未验证”。第 4 格只有部分覆盖,记为“尚未验证”:`uds check --ci` 对所有工具都能抓到被改过的标准与被删掉的 UDS 区块,但格式不合的提交信息只有需自行开启的 Claude Code hook 会在提交时拦下。第 2、3 格维持“尚未验证”,各自写明原因。`npm run check:liveness` 现在由五格推导整体状态、逐行比对三种语言的 README,并比对生成出来的矩阵页。**`uds` 的命令、选项与输出都没有改变。**
38
+
39
+ ### 移除
40
+
41
+ - **删除 `cli/src` 中任何入口都走不到的 17 个模块,连同只测它们的 19 个测试文件。** 它们是 `src/flow/*`(9 个文件)、`MissionManager`、`agent-communication-protocol`、`auto-sweep`、`workflow-executor`、`workflows-installer`、`e2e-analyzer`、`e2e-detector` 与 `hook-stats`。从 `bin/uds.js`、出货的 hook 或 script 都没有路径走到它们,各自只靠自己的测试存活。`uds` 的命令、选项与输出都没有改变;完整测试维持 5423 个通过。可达性检查(`cli/scripts/check-module-reachability.mjs`)现在也把仓库根目录 `scripts/` 的静态 import 当作入口,所以 `context-chunker`、`md-parser`、`yaml-generator` 正确判为可达。它的基线缩到只剩一个模块 `telemetry-uploader.js`,延到 2027-02-19,因为清除它要改有指纹的出货 hook。E2E 测试文件占比的上限由 30% 调为 35%,因为删掉单元测试文件后占比升到 31.6%。
42
+
43
+ ### 依赖
44
+
45
+ - `cli/` 的依赖更新:`commander` 15.0.0 → 15.1.0、`vite` 8.3.5 → 8.3.7、`eslint` 10.13.0 → 10.14.0、`globals` 17.13.0 → 17.14.0。不需要改代码。
46
+
47
+ ### 测试
48
+
49
+ - 建立 issue #297 与 #298 端到端测试的 git 仓库时,不再设置 `GIT_CONFIG_GLOBAL`:它指向 null 设备时,`git init` 在 `windows-latest` 上以 128 退出,而一次性 `HOME` 已经隔离了全局配置。两个测试现在都检查退出码,失败时打印 git 的错误信息。
50
+
21
51
  ## [6.15.0] - 2026-11-04
22
52
 
23
53
  > **正式版发布**:包含下方 6.15.0-beta.1 与 beta.2 的所有内容,beta.2 之后没有任何变更。beta.2 已在 Windows、macOS、Linux 完成发布后验收(0 项失败),并在一台采用者的 Windows 机器上实测。**请先读:**`uds check --ci` 现在对两种原本只打印出来的发现以 1 结束(集成文件指向不存在的路径,以及没有任何哈希覆盖的已安装斜线命令),所以采用者升级后 CI 可能变红;详见 6.15.0-beta.1。beta.2 多一个修正:区块丢失 END 行时,`uds update` 拒绝写入,不再另加第二个区块。
@@ -3,7 +3,7 @@ source: ../../CLAUDE.md
3
3
  source_version: 1.2.0
4
4
  translation_version: 1.2.0
5
5
  last_synced: 2026-10-16
6
- source_hash: a1de69c3a838
6
+ source_hash: 4b07af500a72
7
7
  status: current
8
8
  ---
9
9
 
@@ -260,7 +260,7 @@ cd cli && node scripts/test-discovery.mjs commands development
260
260
  cd cli && npm run test:quick
261
261
 
262
262
  # ✅ Good: Test specific modules
263
- npm test -- tests/commands/ai-context.test.js tests/unit/utils/workflows-installer.test.js
263
+ npm test -- tests/commands/ai-context.test.js tests/unit/utils/workflow-state.test.js
264
264
 
265
265
  # ✅ Good: Use test discovery for targeted testing
266
266
  cd cli && npm run test:discover
@@ -15,7 +15,7 @@ status: current
15
15
 
16
16
  > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
17
17
 
18
- **版本**: 6.15.0 | **发布日期**: 2026-11-04 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
18
+ **版本**: 6.16.0-beta.2 (Pre-release) | **发布日期**: 2026-11-20 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
19
19
 
20
20
  语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流,确保不同技术栈之间的一致性、质量和可维护性。
21
21
 
@@ -131,7 +131,7 @@ Markdown 1,271,471 bytes。重现指令见
131
131
 
132
132
  ## 🤖 AI 工具支持
133
133
 
134
- UDS 提供 **11 个现行工具的集成,其中 1 个已通过行为验证。**
134
+ UDS 提供 **11 个现行工具的集成,其中 0 个已通过行为验证。**
135
135
 
136
136
  这是刻意分开的两个数字。**状态**说的是**我们写的那份集成**有多完整;
137
137
  **验证**说的是**有没有人确认过该工具真的读得到、且行为确实照做**——
@@ -141,24 +141,27 @@ UDS 提供 **11 个现行工具的集成,其中 1 个已通过行为验证。*
141
141
 
142
142
  | AI 工具 | 状态 | 验证 | Skills | 斜线命令 | 配置文件 |
143
143
  | :--- | :--- | :---: | :---: | :---: | :--- |
144
- | **Claude Code** | ✅ 完整支持 | 🔬 —<sup>◆</sup> | **55** | **51** | `CLAUDE.md` |
145
- | **OpenCode** | ✅ 完整支持 | 🔬 — | **55** | **51** | `AGENTS.md` |
146
- | **Cursor** | ✅ 完整支持 | 🔬 — | **核心** | **模拟支持** | `.cursorrules` |
147
- | **Roo Code** | ✅ 完整支持 | 🔬 — | **核心** | **工作流** | `.roo/rules/` |
148
- | **Cline** | 🔶 部分支持 | 🔬 — | **核心** | **工作流** | `.clinerules` |
149
- | **Windsurf** | 🔶 部分支持 | 🔬 — | **核心** | **规则书** | `.windsurfrules` |
150
- | **GitHub Copilot** | 🔶 部分支持 | 🔬 — | **核心** | **提示词** | `.github/copilot-instructions.md` |
151
- | **OpenAI Codex** | 🔶 部分支持 | ✅ 2026-07-23 | **核心** | — | `AGENTS.md` |
152
- | **Aider** | 🔶 部分支持 | 🔬 — | — | — | `AGENTS.md` |
144
+ | **Claude Code** | ✅ 完整支持 | 🔬 ①⑤ 2026-11-17<sup>◆</sup> | **55** | **51** | `CLAUDE.md` |
145
+ | **OpenCode** | ✅ 完整支持 | 🔬 ①⑤ 2026-11-17 | **55** | **51** | `AGENTS.md` |
146
+ | **Cursor** | ✅ 完整支持 | 🔬 ①⑤ 2026-11-17 | **核心** | **模拟支持** | `.cursorrules` |
147
+ | **Roo Code** | ✅ 完整支持 | 🔬 ①⑤ 2026-11-17 | **核心** | **工作流** | `.roo/rules/` |
148
+ | **Cline** | 🔶 部分支持 | 🔬 ①⑤ 2026-11-17 | **核心** | **工作流** | `.clinerules` |
149
+ | **Windsurf** | 🔶 部分支持 | 🔬 ①⑤ 2026-11-17 | **核心** | **规则书** | `.windsurfrules` |
150
+ | **GitHub Copilot** | 🔶 部分支持 | 🔬 ①⑤ 2026-11-17 | **核心** | **提示词** | `.github/copilot-instructions.md` |
151
+ | **OpenAI Codex** | 🔶 部分支持 | 🔬 ①⑤ 2026-11-17 · ③ 2026-07-23 | **核心** | — | `AGENTS.md` |
152
+ | **Aider** | 🔶 部分支持 | 🔬 ①⑤ 2026-11-17 | — | — | `AGENTS.md` |
153
153
  | **Continue.dev** | 🔶 部分支持 | 🔬 — | — | — | `.continue/config.json` |
154
- | **Google Antigravity** | ⚠️ 最低限度 | 🔬 — | —<sup>‡</sup> | — | `.antigravity/rules.md` |
154
+ | **Google Antigravity** | ⚠️ 最低限度 | 🔬 ①⑤ 2026-11-17 | —<sup>‡</sup> | — | `.antigravity/rules.md` |
155
155
  | **Gemini CLI** | ⛔ 已停止服务<sup>†</sup> | — | — | — | `GEMINI.md`(已冻结) |
156
156
 
157
157
  > **状态图例**(我们写的集成有多完整):
158
158
  > ✅ 完整支持 | 🔶 部分支持 | ⚠️ 最低限度 | ⏳ 计划中 | ⛔ 已停止服务
159
159
  >
160
- > **验证图例**(是否有探针实跑确认该工具行为确实照做):
161
- > ✅ *日期* 已验证 | 🔬 — 尚未验证 | ⌛ 已过期 | ❌ 未通过
160
+ > **验证图例**(是否有实跑确认该工具行为确实照做):一个工具要**五格全过**才算已验证——
161
+ > ① 安装、② 代理读到规范、③ 实际任务中遵循、④ 违反时检测得到、⑤ `uds update` 之后仍正常。
162
+ > ✅ *日期* 五格全过 | 🔬 未五格全过:列出已通过的格子(①⑤ …)与日期,全没过则为 — |
163
+ > ⌛ 已过期 | ❌ 未通过。各格、证据与没过的原因见
164
+ > **[验证矩阵](../../docs/reference/INTEGRATION-VERIFICATION-MATRIX.md)**(英文)。
162
165
 
163
166
  <sup>◆</sup> Claude Code 是维护者每日实际使用的工具,这也是它的集成最完整的原因——
164
167
  但**每日使用不等于一次留下记录的验证**,且工具不能当自己的裁判。
@@ -14,6 +14,7 @@ status: current
14
14
  <!-- UDS_SUPPORTED_VERSIONS_START -->
15
15
  | 版本 | 支持状态 |
16
16
  |------|--------|
17
+ | 6.16.0-beta.2 | ✅ 预发布版本 |
17
18
  | 6.15.0 | ✅ 最新正式版 |
18
19
  | < 6.0.0 | ❌ 已终止支持 |
19
20
  <!-- UDS_SUPPORTED_VERSIONS_END -->
@@ -1,6 +1,6 @@
1
1
  # UDS 速查表
2
2
 
3
- > Quick reference for all UDS features | Last updated: 2026-10-30
3
+ > Quick reference for all UDS features | Last updated: 2026-11-04
4
4
 
5
5
  **Language**: [English](../../../docs/user/CHEATSHEET.md) | [繁體中文](../../zh-TW/docs/CHEATSHEET.md) | 简体中文
6
6
 
@@ -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-30
6
- source_hash: bdccdf225333
5
+ last_synced: 2026-11-04
6
+ source_hash: 598fcbb2167d
7
7
  status: current
8
8
  ---
9
9
 
@@ -920,6 +920,28 @@ uds update --with-hooks --ai-tool antigravity # 直接指定工具,不做
920
920
  - **它不做什么。** 不更新标准、技能或集成文件(那是一般的 `uds update`),也不会把工具加进 manifest。
921
921
  它不能与 `--skills`、`--commands` 等其他 update 模式合用,合用时会明说。
922
922
 
923
+ ### 可选技能,以及加装或移除单个技能(`uds update --add-skill` / `--remove-skill`)
924
+
925
+ UDS 出货 `skills/` 底下所有技能,但自称可选的技能只会装进有要求它的项目。目前只有 `open-work`(文件夹
926
+ `open-work-assistant`)。`uds init` 与 `uds update` 不会装它;已经有它的项目(6.15.0-beta.1 曾把它装进所有
927
+ 项目)会保留并照常更新。`uds update --plan`、`--apply`、`--skills` 结尾会有一段“Optional skills”,说明
928
+ 这个项目里哪些技能是可选,以及各自的命令。
929
+
930
+ ```bash
931
+ uds update --add-skill open-work # 装进项目所有的 AI 工具文件夹,并记住
932
+ uds update --remove-skill commit # 从这些文件夹删除一个技能(任何技能都可);之后的更新不会装回
933
+ uds update --add-skill commit # 把移除的技能放回去
934
+ uds update --remove-skill tdd --plan # 只说明会做什么,不写任何东西
935
+ ```
936
+
937
+ - 名称可以是技能名(`open-work`)或文件夹名(`open-work-assistant`)。UDS 没有出货的名称会以 1 结束并列出
938
+ 可用名称;同一个命令里有一个坏名称,其他的也不会执行。
939
+ - 选择记在 `.standards/manifest.json` 的 `skills` 底下:`extra`(项目要求的可选技能)与 `excluded`(项目
940
+ 移除的技能)。没有这两个键的 manifest 代表“没有做任何选择”。
941
+ - 用户级别的技能文件夹(`~/.claude/skills`)由这台机器上所有项目共用,所以移除时不动它,并打印路径。
942
+ - 两个选项都会先备份(`uds update --rollback` 可还原)。单独使用是一整个命令;与 `--apply`、`--force`、
943
+ `--skills`、`--commands`、`--standards-only` 并用时,它们先执行,其余接着执行。
944
+
923
945
  ### Claude Code 集成目标文件(`--claude-target`)
924
946
 
925
947
  UDS 默认把 Claude Code 内容写进 `CLAUDE.md`——团队共用、会进版本控制的那个文件。
@@ -1,7 +1,7 @@
1
1
  # UDS 功能参考手册
2
2
 
3
3
  > Universal Development Standards - 完整功能文档
4
- > Auto-generated | Last updated: 2026-10-30
4
+ > Auto-generated | Last updated: 2026-11-04
5
5
 
6
6
  **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | [繁體中文](../../zh-TW/docs/FEATURE-REFERENCE.md) | 简体中文
7
7
 
@@ -158,6 +158,8 @@
158
158
  | `--rollback` | Rollback to the most recent backup (with the series of updates that follow from it) |
159
159
  | `--from` | With --rollback: restore this one backup instead of the most recent series (the id --rollback prints, or its folder name); use it for a backup an older UDS made |
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
+ | `--add-skill` | Add one skill to every AI tool folder this project has, and record it so updates keep it (repeatable). Takes the skill name (open-work) or its folder name (open-work-assistant). Optional skills such as open-work are installed only this way; combine with --apply/--skills to run that too, with --plan to preview |
162
+ | `--remove-skill` | Remove one skill from every AI tool folder this project has, and record it so no update installs it again (repeatable; any skill, not only optional ones). Undo with --add-skill. Combine with --apply/--skills to run that too, with --plan to preview |
161
163
  | `--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
164
  | `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
163
165
  | `--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) |
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  source: ../../CHANGELOG.md
3
- source_version: 6.15.0
4
- translation_version: 6.15.0
5
- last_synced: 2026-11-04
6
- source_hash: f021bb23e372
3
+ source_version: 6.16.0-beta.2
4
+ translation_version: 6.16.0-beta.2
5
+ last_synced: 2026-11-20
6
+ source_hash: 74d8ad482d4d
7
7
  status: current
8
8
  ---
9
9
 
@@ -18,6 +18,36 @@ status: current
18
18
 
19
19
  ## [Unreleased]
20
20
 
21
+ ## [6.16.0-beta.2] - 2026-11-20
22
+
23
+ *6.16.0-beta.1 已打 tag 但未發布:它的 CI 在 Windows 上失敗(可達性檢查有路徑分隔符的錯誤,已在此版修正)。預發布版,以 `npm install -g universal-dev-standards@beta` 安裝。選用技能現在真的是選用,並可用 `uds update --add-skill` / `--remove-skill` 自行選擇;README 的「驗證」欄現在要求每個工具通過五項檢查;刪除 17 個走不到的模組。更新有 `open-work` 的專案前,請先讀「修正」的第一條。*
24
+
25
+ ### 修正
26
+
27
+ - **選用技能現在真的是選用:`uds update` 不再把 `open-work` 裝進沒有要它的專案(issue #298)。** `open-work` 技能(資料夾 `skills/open-work-assistant/`)自己寫著它是選用的、「UDS 裡沒有任何東西要求它」,但 `uds update --apply`(連同 `--skills`、`--commands`)把它裝進每個專案的每個 AI 工具資料夾(`.claude/skills`、`.opencode/skill`、`.agents/skills` 等)。已經有自己同類技能的人,就會看到兩個說法幾乎一樣的技能。原因是:專案該拿到哪些技能,被定義成「這版 UDS 出貨的全部」,而且寫了兩份(reconciler 的規劃與安裝器),沒有任何方式讓某個技能被排除。現在有一份選用技能清單(`cli/src/utils/skill-selection.js` 的 `OPTIONAL_SKILLS`,目前只有 `open-work-assistant`),和一個決定某個工具資料夾該拿哪些技能的函式;reconciler 的規劃,以及 `init`、`update`、`config` 裡每個 `skillNames = null` 的安裝,都問同一個函式,所以規劃不會承諾一組、寫入卻寫另一組。專案拿到的是:UDS 出貨的,減去選用技能,減去它移除的技能,加上它要求的選用技能,加上**已經在該工具資料夾裡的選用技能**。最後一項是給 6.15.0-beta.1 的專案:它們已經有 `open-work`,會被保留並像其他技能一樣更新,`uds update --plan` 不會把它列在 Delete,只有專案自己移除它才會消失。`uds update --plan`、`--apply`、`--skills` 現在結尾多一段「Optional skills」,說明哪些技能是選用、這個專案裝了沒有,以及加裝或移除各自的指令;`uds skills` 說明沒裝的選用技能不算缺少。**既有專案會看到的改變:**已有 `open-work` 的 6.15.0-beta.1 專案什麼都不會少。從 6.14.x 或更舊版本更新的專案不再拿到 `open-work`(6.15.0-beta.1 之前本來也沒有)。要它:`uds update --add-skill open-work`。
28
+ - **本 repository 自己的閘門檢查現在在 Windows 上也用 `/` 比對檔案路徑,`windows-latest` 因此通過(6.16.0-beta.1 就是卡在這裡)。** `check-module-reachability` 用 `path.relative()` 組出每個模組的鍵,這在 Windows 上會得到 `bin\uds.js`,再拿去和寫成 `bin/uds.js` 的入口與基線比對。兩種寫法在 Windows 上永遠對不上,於是入口本身被報成「新增的不可達模組」,`windows-latest` 的單元測試因此失敗。同樣的修正也套用到 `check-command-existence` 與 `check-shipped-stamp-consistency`(共用一個輔助函式,`cli/scripts/lib/posix-path.mjs` 的 `relativePosix`);只有比對用的鍵改了,讀檔仍走平台原生路徑。`uds` 的指令、選項與輸出都沒有變:這些是在本 repository 的 CI 裡跑的檢查,不在套件內。
29
+ - **空的基線清單不再到期,非空的基線清單必須帶有效的到期日。** 到期日是「先不修的清單」的時鐘,不是閘門的時鐘。現在由一條共用規則(`cli/scripts/lib/baseline-expiry.mjs`)統一判斷,套用到 `check-command-existence`、`check-module-reachability`、`check-shipped-stamp-consistency` 與 orphan-matrix 的 allowlist:清單為空就不看日期;清單非空時,日期已過或沒有有效的 `YYYY-MM-DD` 日期都算失敗(以前沒有日期會被當成「未到期」而安靜通過)。基線檔與其日期本身未改。同樣只影響本 repository 的 CI,`uds` 的指令、選項與輸出都沒有變。
30
+
31
+ ### 新增
32
+
33
+ - **`uds update --add-skill <name>` 與 `uds update --remove-skill <name>` 加裝或移除單一技能,而且選擇會被記住(issue #298)。** 兩者都可重複。名稱可以是技能名(`open-work`)或資料夾名(`open-work-assistant`);UDS 沒有出貨的名稱會以 1 結束、列出可用的名稱、什麼都不寫(同一個指令裡有一個壞名稱,其他的也不會執行)。`--add-skill` 立即把技能裝進專案所有的 AI 工具資料夾,若是選用技能,另記在 `manifest.skills.extra`。`--remove-skill` 從每個專案層級的工具資料夾刪除該技能的資料夾,移除它的雜湊紀錄與 `skills.names` 裡的項目,並記在 `manifest.skills.excluded`;任何技能都能移除,不只選用技能,之後的 `uds update`(一般、`--apply`、`--skills`)都不會再裝回——手動刪掉的技能資料夾從來沒有這個保證(下一次更新就寫回來)。對已移除的技能執行 `--add-skill`,會把它從 `excluded` 拿掉。使用者層級的資料夾(`~/.claude/skills`)由這台機器上的所有專案共用,所以移除時不動它,並印出它的路徑。兩者都會先做備份(`uds update --rollback` 可還原),`--plan` 說明會做什麼而不寫任何東西,加裝一個技能也不會改變該資料夾裡其他技能所記錄的版本。單獨使用時,每個旗標就是一整個指令;與 `--apply`、`--force`、`--skills`、`--commands`、`--standards-only` 並用時,它先做自己的部分,其餘再接著執行。不能與 `--rollback`、`--claude-target`、`--with-hooks`、`--sync-refs`、`--integrations-only` 並用。**Manifest 與舊版 manifest:**這兩個鍵是 `skills` 底下的資料夾名清單;在此之前寫的 manifest 兩者都沒有,讀作「專案沒有做任何選擇」,所以不需要遷移,空清單也不會被寫出。這個選擇不放在 `skills.names`:它是 UDS 安裝過的名稱聯集,不是選擇。
34
+
35
+ ### 變更
36
+
37
+ - **README 的「驗證」欄現在只有工具通過全部五項檢查才標勾,所以 Codex 改回「尚未驗證」(XSPEC-357 R8)。** README 寫支援 11 個工具,但只有 Codex 有驗證紀錄,而且那份紀錄只涵蓋對工具要求的五件事裡的一件。現在每個工具有五格(安裝、代理讀到規範、實際任務中遵循、違反時偵測得到、更新後仍正常),每格附日期與證據路徑,沒驗的就寫原因。README 開頭由「1 個經過行為驗證」改為「0 個經過行為驗證」(三種語言都改);Codex 那一列仍保留 2026-07-23 的任務探針結果。新的矩陣頁是 `docs/reference/INTEGRATION-VERIFICATION-MATRIX.md`,由 `integrations/REGISTRY.json` 產生。第 1、5 格(安裝與更新)有從 `uds init` 與 `uds update` 入口觸發的 e2e 測試,讀回各工具設定檔裡的 UDS 區塊:採用者自己的行要留著、區塊列出的每份標準都要在磁碟上、舊版安裝上跑 `uds update` 之後缺的標準要被補回。Continue.dev 在 `uds init` 沒有入口,它的這兩格維持「尚未驗證」。第 4 格只有部分覆蓋,記為「尚未驗證」:`uds check --ci` 對所有工具都能抓到被改過的標準與被刪掉的 UDS 區塊,但格式不合的提交訊息只有需自行開啟的 Claude Code hook 會在提交時擋下。第 2、3 格維持「尚未驗證」,各自寫明原因。`npm run check:liveness` 現在由五格推導整體狀態、逐列比對三種語言的 README,並比對產生出來的矩陣頁。**`uds` 的指令、選項與輸出都沒有改變。**
38
+
39
+ ### 移除
40
+
41
+ - **刪除 `cli/src` 中任何入口都走不到的 17 個模組,連同只測它們的 19 個測試檔。** 它們是 `src/flow/*`(9 個檔案)、`MissionManager`、`agent-communication-protocol`、`auto-sweep`、`workflow-executor`、`workflows-installer`、`e2e-analyzer`、`e2e-detector` 與 `hook-stats`。從 `bin/uds.js`、出貨的 hook 或 script 都沒有路徑走到它們,各自只靠自己的測試活著。`uds` 的指令、選項與輸出都沒有改變;完整測試維持 5423 支通過。可達性檢查(`cli/scripts/check-module-reachability.mjs`)現在也把 repository 根目錄 `scripts/` 的靜態 import 當作入口,所以 `context-chunker`、`md-parser`、`yaml-generator` 正確判為可達。它的基線縮到只剩一個模組 `telemetry-uploader.js`,延到 2027-02-19,因為清除它要改有指紋的出貨 hook。E2E 測試檔占比的上限由 30% 調為 35%,因為刪掉單元測試檔後占比升到 31.6%。
42
+
43
+ ### 相依套件
44
+
45
+ - `cli/` 的相依套件更新:`commander` 15.0.0 → 15.1.0、`vite` 8.3.5 → 8.3.7、`eslint` 10.13.0 → 10.14.0、`globals` 17.13.0 → 17.14.0。不需要改程式碼。
46
+
47
+ ### 測試
48
+
49
+ - 建立 issue #297 與 #298 端對端測試的 git repository 時,不再設定 `GIT_CONFIG_GLOBAL`:它指向 null 裝置時,`git init` 在 `windows-latest` 上以 128 結束,而拋棄式 `HOME` 已經隔離了全域設定。兩支測試現在都檢查結束碼,失敗時印出 git 的錯誤訊息。
50
+
21
51
  ## [6.15.0] - 2026-11-04
22
52
 
23
53
  > **正式版發布**:包含下方 6.15.0-beta.1 與 beta.2 的所有內容,beta.2 之後沒有任何變更。beta.2 已在 Windows、macOS、Linux 完成發布後驗收(0 項失敗),並在一台採用者的 Windows 機器上實測。**請先讀:**`uds check --ci` 現在對兩種原本只印出來的發現以 1 結束(整合檔指向不存在的路徑,以及沒有任何雜湊涵蓋的已安裝斜線指令),所以採用者升級後 CI 可能變紅;詳見 6.15.0-beta.1。beta.2 多一個修正:區塊遺失 END 行時,`uds update` 拒絕寫入,不再另加第二個區塊。
@@ -3,7 +3,7 @@ source: ../../CLAUDE.md
3
3
  source_version: 1.2.0
4
4
  translation_version: 1.2.0
5
5
  last_synced: 2026-10-16
6
- source_hash: a1de69c3a838
6
+ source_hash: 4b07af500a72
7
7
  status: current
8
8
  ---
9
9
 
@@ -260,7 +260,7 @@ cd cli && node scripts/test-discovery.mjs commands development
260
260
  cd cli && npm run test:quick
261
261
 
262
262
  # ✅ Good: Test specific modules
263
- npm test -- tests/commands/ai-context.test.js tests/unit/utils/workflows-installer.test.js
263
+ npm test -- tests/commands/ai-context.test.js tests/unit/utils/workflow-state.test.js
264
264
 
265
265
  # ✅ Good: Use test discovery for targeted testing
266
266
  cd cli && npm run test:discover
@@ -15,7 +15,7 @@ status: current
15
15
 
16
16
  > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
17
17
 
18
- **版本**: 6.15.0 | **發布日期**: 2026-11-04 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
18
+ **版本**: 6.16.0-beta.2 (Pre-release) | **發布日期**: 2026-11-20 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
19
19
 
20
20
  語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
21
21
 
@@ -131,7 +131,7 @@ Markdown 1,271,471 bytes。重現指令見
131
131
 
132
132
  ## 🤖 AI 工具支援
133
133
 
134
- UDS 提供 **11 個現行工具的整合,其中 1 個已通過行為驗證。**
134
+ UDS 提供 **11 個現行工具的整合,其中 0 個已通過行為驗證。**
135
135
 
136
136
  這是刻意分開的兩個數字。**狀態**說的是**我們寫的那份整合**有多完整;
137
137
  **驗證**說的是**有沒有人確認過該工具真的讀得到、且行為確實照做**——
@@ -141,24 +141,27 @@ UDS 提供 **11 個現行工具的整合,其中 1 個已通過行為驗證。*
141
141
 
142
142
  | AI 工具 | 狀態 | 驗證 | Skills | 斜線命令 | 設定檔 |
143
143
  | :--- | :--- | :---: | :---: | :---: | :--- |
144
- | **Claude Code** | ✅ 完整支援 | 🔬 —<sup>◆</sup> | **55** | **51** | `CLAUDE.md` |
145
- | **OpenCode** | ✅ 完整支援 | 🔬 — | **55** | **51** | `AGENTS.md` |
146
- | **Cursor** | ✅ 完整支援 | 🔬 — | **核心** | **模擬支援** | `.cursorrules` |
147
- | **Roo Code** | ✅ 完整支援 | 🔬 — | **核心** | **工作流** | `.roo/rules/` |
148
- | **Cline** | 🔶 部分支援 | 🔬 — | **核心** | **工作流** | `.clinerules` |
149
- | **Windsurf** | 🔶 部分支援 | 🔬 — | **核心** | **規則書** | `.windsurfrules` |
150
- | **GitHub Copilot** | 🔶 部分支援 | 🔬 — | **核心** | **提示詞** | `.github/copilot-instructions.md` |
151
- | **OpenAI Codex** | 🔶 部分支援 | ✅ 2026-07-23 | **核心** | — | `AGENTS.md` |
152
- | **Aider** | 🔶 部分支援 | 🔬 — | — | — | `AGENTS.md` |
144
+ | **Claude Code** | ✅ 完整支援 | 🔬 ①⑤ 2026-11-17<sup>◆</sup> | **55** | **51** | `CLAUDE.md` |
145
+ | **OpenCode** | ✅ 完整支援 | 🔬 ①⑤ 2026-11-17 | **55** | **51** | `AGENTS.md` |
146
+ | **Cursor** | ✅ 完整支援 | 🔬 ①⑤ 2026-11-17 | **核心** | **模擬支援** | `.cursorrules` |
147
+ | **Roo Code** | ✅ 完整支援 | 🔬 ①⑤ 2026-11-17 | **核心** | **工作流** | `.roo/rules/` |
148
+ | **Cline** | 🔶 部分支援 | 🔬 ①⑤ 2026-11-17 | **核心** | **工作流** | `.clinerules` |
149
+ | **Windsurf** | 🔶 部分支援 | 🔬 ①⑤ 2026-11-17 | **核心** | **規則書** | `.windsurfrules` |
150
+ | **GitHub Copilot** | 🔶 部分支援 | 🔬 ①⑤ 2026-11-17 | **核心** | **提示詞** | `.github/copilot-instructions.md` |
151
+ | **OpenAI Codex** | 🔶 部分支援 | 🔬 ①⑤ 2026-11-17 · ③ 2026-07-23 | **核心** | — | `AGENTS.md` |
152
+ | **Aider** | 🔶 部分支援 | 🔬 ①⑤ 2026-11-17 | — | — | `AGENTS.md` |
153
153
  | **Continue.dev** | 🔶 部分支援 | 🔬 — | — | — | `.continue/config.json` |
154
- | **Google Antigravity** | ⚠️ 最低限度 | 🔬 — | —<sup>‡</sup> | — | `.antigravity/rules.md` |
154
+ | **Google Antigravity** | ⚠️ 最低限度 | 🔬 ①⑤ 2026-11-17 | —<sup>‡</sup> | — | `.antigravity/rules.md` |
155
155
  | **Gemini CLI** | ⛔ 已停止服務<sup>†</sup> | — | — | — | `GEMINI.md`(已凍結) |
156
156
 
157
157
  > **狀態圖例**(我們寫的整合有多完整):
158
158
  > ✅ 完整支援 | 🔶 部分支援 | ⚠️ 最低限度 | ⏳ 計畫中 | ⛔ 已停止服務
159
159
  >
160
- > **驗證圖例**(是否有探針實跑確認該工具行為確實照做):
161
- > ✅ *日期* 已驗證 | 🔬 — 尚未驗證 | ⌛ 已過期 | ❌ 未通過
160
+ > **驗證圖例**(是否有實跑確認該工具行為確實照做):一個工具要**五格全過**才算已驗證——
161
+ > ① 安裝、② 代理讀到規範、③ 實際任務中遵循、④ 違反時偵測得到、⑤ `uds update` 之後仍正常。
162
+ > ✅ *日期* 五格全過 | 🔬 未五格全過:列出已通過的格子(①⑤ …)與日期,全沒過則為 — |
163
+ > ⌛ 已過期 | ❌ 未通過。各格、證據與沒過的原因見
164
+ > **[驗證矩陣](../../docs/reference/INTEGRATION-VERIFICATION-MATRIX.md)**(英文)。
162
165
 
163
166
  <sup>◆</sup> Claude Code 是維護者每日實際使用的工具,這也是它的整合最完整的原因——
164
167
  但**每日使用不等於一次留下紀錄的驗證**,且工具不能當自己的裁判。
@@ -14,6 +14,7 @@ status: current
14
14
  <!-- UDS_SUPPORTED_VERSIONS_START -->
15
15
  | 版本 | 支援狀態 |
16
16
  |------|--------|
17
+ | 6.16.0-beta.2 | ✅ 預發布版本 |
17
18
  | 6.15.0 | ✅ 最新正式版 |
18
19
  | < 6.0.0 | ❌ 已終止支援 |
19
20
  <!-- UDS_SUPPORTED_VERSIONS_END -->
@@ -1,6 +1,6 @@
1
1
  # UDS 速查表
2
2
 
3
- > Quick reference for all UDS features | Last updated: 2026-10-30
3
+ > Quick reference for all UDS features | Last updated: 2026-11-04
4
4
 
5
5
  **Language**: [English](../../../docs/user/CHEATSHEET.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CHEATSHEET.md)
6
6
 
@@ -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-30
6
- source_hash: bdccdf225333
5
+ last_synced: 2026-11-04
6
+ source_hash: 598fcbb2167d
7
7
  status: current
8
8
  ---
9
9
 
@@ -920,6 +920,28 @@ uds update --with-hooks --ai-tool antigravity # 直接指定工具,不做
920
920
  - **它不做什麼。** 不更新標準、技能或整合檔(那是一般的 `uds update`),也不會把工具加進 manifest。
921
921
  它不能與 `--skills`、`--commands` 等其他 update 模式合用,合用時會明說。
922
922
 
923
+ ### 選用技能,以及加裝或移除單一技能(`uds update --add-skill` / `--remove-skill`)
924
+
925
+ UDS 出貨 `skills/` 底下所有技能,但自稱選用的技能只會裝進有要求它的專案。目前只有 `open-work`(資料夾
926
+ `open-work-assistant`)。`uds init` 與 `uds update` 不會裝它;已經有它的專案(6.15.0-beta.1 曾把它裝進所有
927
+ 專案)會保留並照常更新。`uds update --plan`、`--apply`、`--skills` 結尾會有一段「Optional skills」,說明
928
+ 這個專案裡哪些技能是選用,以及各自的指令。
929
+
930
+ ```bash
931
+ uds update --add-skill open-work # 裝進專案所有的 AI 工具資料夾,並記住
932
+ uds update --remove-skill commit # 從這些資料夾刪除一個技能(任何技能都可);之後的更新不會裝回
933
+ uds update --add-skill commit # 把移除的技能放回去
934
+ uds update --remove-skill tdd --plan # 只說明會做什麼,不寫任何東西
935
+ ```
936
+
937
+ - 名稱可以是技能名(`open-work`)或資料夾名(`open-work-assistant`)。UDS 沒有出貨的名稱會以 1 結束並列出
938
+ 可用名稱;同一個指令裡有一個壞名稱,其他的也不會執行。
939
+ - 選擇記在 `.standards/manifest.json` 的 `skills` 底下:`extra`(專案要求的選用技能)與 `excluded`(專案
940
+ 移除的技能)。沒有這兩個鍵的 manifest 代表「沒有做任何選擇」。
941
+ - 使用者層級的技能資料夾(`~/.claude/skills`)由這台機器上所有專案共用,所以移除時不動它,並印出路徑。
942
+ - 兩個旗標都會先備份(`uds update --rollback` 可還原)。單獨使用是一整個指令;與 `--apply`、`--force`、
943
+ `--skills`、`--commands`、`--standards-only` 並用時,它們先執行,其餘接著執行。
944
+
923
945
  ### Claude Code 整合目標檔(`--claude-target`)
924
946
 
925
947
  UDS 預設把 Claude Code 內容寫進 `CLAUDE.md`——團隊共用、會進版控的那個檔案。
@@ -1,7 +1,7 @@
1
1
  # UDS 功能參考手冊
2
2
 
3
3
  > Universal Development Standards - 完整功能文件
4
- > Auto-generated | Last updated: 2026-10-30
4
+ > Auto-generated | Last updated: 2026-11-04
5
5
 
6
6
  **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
7
7
 
@@ -158,6 +158,8 @@
158
158
  | `--rollback` | Rollback to the most recent backup (with the series of updates that follow from it) |
159
159
  | `--from` | With --rollback: restore this one backup instead of the most recent series (the id --rollback prints, or its folder name); use it for a backup an older UDS made |
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
+ | `--add-skill` | Add one skill to every AI tool folder this project has, and record it so updates keep it (repeatable). Takes the skill name (open-work) or its folder name (open-work-assistant). Optional skills such as open-work are installed only this way; combine with --apply/--skills to run that too, with --plan to preview |
162
+ | `--remove-skill` | Remove one skill from every AI tool folder this project has, and record it so no update installs it again (repeatable; any skill, not only optional ones). Undo with --add-skill. Combine with --apply/--skills to run that too, with --plan to preview |
161
163
  | `--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
164
  | `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
163
165
  | `--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) |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "universal-dev-standards",
3
- "version": "6.15.0",
3
+ "version": "6.16.0-beta.2",
4
4
  "description": "CLI tool for adopting Universal Development Standards",
5
5
  "keywords": [
6
6
  "documentation",
@@ -75,8 +75,8 @@
75
75
  "devDependencies": {
76
76
  "@eslint/js": "^10.0.1",
77
77
  "@vitest/coverage-v8": "^5.0.0",
78
- "eslint": "10.13.0",
79
- "globals": "17.13.0",
78
+ "eslint": "10.14.0",
79
+ "globals": "17.14.0",
80
80
  "husky": "^9.1.7",
81
81
  "lint-staged": "^17.0.3",
82
82
  "vite": "^8.3.0",
@@ -4,6 +4,7 @@ import { join } from 'path';
4
4
  import { homedir } from 'os';
5
5
  import { getAllSkillNames } from '../utils/registry.js';
6
6
  import { getAvailableSkillNames } from '../utils/skills-installer.js';
7
+ import { OPTIONAL_SKILLS, skillDisplayName } from '../utils/skill-selection.js';
7
8
  import { pruneForeignSkillHashes } from '../utils/skill-hash-ownership.js';
8
9
  import { getSkillsDirForAgent, getAgentDisplayName } from '../config/ai-agent-paths.js';
9
10
  import { readManifest, isInitialized } from '../utils/copier.js';
@@ -278,6 +279,14 @@ export function skillsCommand() {
278
279
  console.log(chalk.gray('─'.repeat(50)));
279
280
  console.log(chalk.gray(`${msg.totalUniqueSkills}: ${totalSkills} / ${knownSkills.length}`));
280
281
 
282
+ // Issue #298: a skill UDS ships but installs only when asked for is not "missing"; say so next to the count.
283
+ const optionalNotInstalled = Object.keys(OPTIONAL_SKILLS)
284
+ .filter((folder) => knownSkills.includes(folder) && !installations.some((i) => i.skills.includes(folder)));
285
+ if (optionalNotInstalled.length > 0) {
286
+ const names = optionalNotInstalled.map((folder) => skillDisplayName(folder)).join(', ');
287
+ console.log(chalk.gray(`Optional, installed only when you ask: ${names}. Add one with: uds update --add-skill <name>`));
288
+ }
289
+
281
290
  // The number `uds check` prints is a count of FILES (a skill is one or more files), so say how the two
282
291
  // relate instead of leaving two different numbers side by side. Counted the way `check` counts them.
283
292
  if (manifestForSkills?.skillHashes) {