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
|
@@ -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-TW/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-TW/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 \
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# UDS 功能参考手册
|
|
2
2
|
|
|
3
3
|
> Universal Development Standards - 完整功能文档
|
|
4
|
-
> Auto-generated | Last updated: 2026-10-
|
|
4
|
+
> Auto-generated | Last updated: 2026-10-08
|
|
5
5
|
|
|
6
6
|
**Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | [繁體中文](../../zh-TW/docs/FEATURE-REFERENCE.md) | 简体中文
|
|
7
7
|
|
|
@@ -15,9 +15,9 @@
|
|
|
15
15
|
4. [代理](#agents) (5)
|
|
16
16
|
5. [工作流程](#workflows) (5)
|
|
17
17
|
6. [核心规范](#core-standards) (153)
|
|
18
|
-
7. [脚本](#scripts) (
|
|
18
|
+
7. [脚本](#scripts) (65)
|
|
19
19
|
|
|
20
|
-
**Total Features:
|
|
20
|
+
**Total Features: 359**
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
| `--lang` | Language extension (csharp, php) |
|
|
49
49
|
| `--framework` | Framework extension (fat-free) |
|
|
50
50
|
| `--locale` | Locale extension (zh-tw) |
|
|
51
|
-
| `--skills-location` | Skills location (
|
|
51
|
+
| `--skills-location` | Skills location (project, user, marketplace, none) [default: project] |
|
|
52
52
|
| `--content-mode` | Content mode for integration files (minimal, index) [default: index]; full is retired and resolves to index |
|
|
53
53
|
| `--agents-md` | Generate AGENTS.md universal summary |
|
|
54
54
|
| `--no-agents-md` | Skip AGENTS.md generation |
|
|
@@ -116,7 +116,7 @@
|
|
|
116
116
|
|
|
117
117
|
### `uds simulate`
|
|
118
118
|
|
|
119
|
-
**说明**: Simulate a standard check with input (Predictive Validation)
|
|
119
|
+
**说明**: 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
|
|
120
120
|
|
|
121
121
|
**选项**:
|
|
122
122
|
| Option | 说明 |
|
|
@@ -156,6 +156,7 @@
|
|
|
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 |
|
|
159
|
+
| `--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) |
|
|
159
160
|
| `--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 |
|
|
160
161
|
| `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
|
|
161
162
|
| `--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; with --plan, writes nothing; --force also overwrites edited hook scripts) |
|
|
@@ -201,6 +202,7 @@
|
|
|
201
202
|
| `--path` | Directory containing package.json (default: cwd) |
|
|
202
203
|
| `--json` | Output raw JSON |
|
|
203
204
|
| `--concurrency` | Parallel registry lookups (default: 8) |
|
|
205
|
+
| `--if-present` | Exit 0 and say that nothing was checked when there is no package.json or no runtime dependency (default: exit 1) |
|
|
204
206
|
|
|
205
207
|
### `uds uninstall`
|
|
206
208
|
|
|
@@ -281,7 +283,7 @@
|
|
|
281
283
|
|
|
282
284
|
### `uds open-work`
|
|
283
285
|
|
|
284
|
-
**说明**: Reference checks for open-work-tracking (OWT-017
|
|
286
|
+
**说明**: Reference checks for open-work-tracking (OWT-017 to OWT-028). Exit 0 no violation, 1 violation, 2 cannot decide (not a pass)
|
|
285
287
|
|
|
286
288
|
### `uds run`
|
|
287
289
|
|
|
@@ -469,7 +471,7 @@
|
|
|
469
471
|
| `checkin-standards` | 1.8.0 | This standard defines quality gates that MUST be passed before committing code t |
|
|
470
472
|
| `circuit-breaker` | - | |
|
|
471
473
|
| `class-level-fix` | 1.1.0 | A defect is almost never alone. It is one member of a set — one flag in a dispat |
|
|
472
|
-
| `code-review-checklist` | 1.
|
|
474
|
+
| `code-review-checklist` | 1.6.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
|
|
473
475
|
| `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
|
|
474
476
|
| `container-image-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
|
|
475
477
|
| `container-security` | - | |
|
|
@@ -486,7 +488,7 @@
|
|
|
486
488
|
| `deployment-standards` | 1.1.0 | This standard defines guidelines for safely deploying software to production, co |
|
|
487
489
|
| `deprecation-standards` | 1.1.0 | |
|
|
488
490
|
| `design-document-standards` | 1.0.0 | |
|
|
489
|
-
| `developer-memory` | 1.2.
|
|
491
|
+
| `developer-memory` | 1.2.1 | This standard defines a structured system for capturing, retrieving, and surfaci |
|
|
490
492
|
| `disaster-recovery-drill` | - | |
|
|
491
493
|
| `documentation-lifecycle` | 1.0.0 | This standard defines **when** to update documentation, **when** to check it, an |
|
|
492
494
|
| `documentation-structure` | 1.5.0 | This standard defines a consistent documentation structure for software projects |
|
|
@@ -524,18 +526,18 @@
|
|
|
524
526
|
| `mutation-testing` | 1.1.0 | Mutation testing evaluates test suite effectiveness by injecting artificial bugs |
|
|
525
527
|
| `no-cicd-deployment` | - | |
|
|
526
528
|
| `observability-standards` | 1.0.0 | |
|
|
527
|
-
| `open-work-tracking` | 1.
|
|
529
|
+
| `open-work-tracking` | 1.4.0 | The deferred-item-exit standard requires that a deferred item leave its document |
|
|
528
530
|
| `packaging-standards` | 1.1.0 | This standard defines a Recipe-based packaging framework that enables user proje |
|
|
529
531
|
| `performance-standards` | 1.2.0 | This standard defines comprehensive guidelines for software performance engineer |
|
|
530
532
|
| `pii-classification` | 1.1.0 | **Status**: Active | **Updated**: 2026-06-19 | |
|
|
531
533
|
| `pipeline-integration-standards` | - | |
|
|
532
|
-
| `pipeline-security-gates` |
|
|
534
|
+
| `pipeline-security-gates` | 1.1.0 | |
|
|
533
535
|
| `policy-as-code-testing` | - | |
|
|
534
536
|
| `postmortem-standards` | 1.0.0 | |
|
|
535
537
|
| `prd-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
|
|
536
538
|
| `privacy-standards` | 1.1.0 | |
|
|
537
539
|
| `product-metrics-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
|
|
538
|
-
| `project-context-memory` | 1.2.
|
|
540
|
+
| `project-context-memory` | 1.2.1 | This standard defines a structured system for capturing, retrieving, and enforci |
|
|
539
541
|
| `project-structure` | 1.2.0 | This standard defines conventions for project directory structure beyond documen |
|
|
540
542
|
| `prompt-regression` | - | |
|
|
541
543
|
| `property-based-testing` | - | |
|
|
@@ -619,7 +621,7 @@
|
|
|
619
621
|
| `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
|
|
620
622
|
| `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ-5, AC-7) |
|
|
621
623
|
| `check-home-untouched.mjs` | check-home-untouched — did this run write anywhere UDS writes under HOME? |
|
|
622
|
-
| `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017
|
|
624
|
+
| `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 to OWT-028 — repo entry point. |
|
|
623
625
|
| `check-orphan-specs.ps1` | Check Orphan Specs |
|
|
624
626
|
| `check-orphan-specs.sh` | Orphan Spec Detection Script |
|
|
625
627
|
| `check-prompt-footprint.mjs` | Prompt Footprint Ratchet — DEC-117 D2/L2 |
|
|
@@ -642,6 +644,7 @@
|
|
|
642
644
|
| `check-version-sync.ps1` | Check Version Sync |
|
|
643
645
|
| `check-version-sync.sh` | Version Sync Checker |
|
|
644
646
|
| `check-workflow-compliance.sh` | Thin wrapper — scripts/check-workflow-compliance.ts is the only copy of the |
|
|
647
|
+
| `ci-vitest-summary.mjs` | ci-vitest-summary — say how many tests ran, passed, failed and were skipped (dev-platform XSPEC-469 R4). |
|
|
645
648
|
| `commitlint-bilingual-rule.mjs` | commitlint-bilingual-rule.mjs — custom commitlint rules enforcing the |
|
|
646
649
|
| `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
|
|
647
650
|
| `fix-manifest-paths.ps1` | Fix Manifest Paths |
|
|
@@ -35,7 +35,7 @@ status: current
|
|
|
35
35
|
|
|
36
36
|
**配置方式**:
|
|
37
37
|
- 安裝时选择 `standardsScope: minimal`
|
|
38
|
-
- Skills
|
|
38
|
+
- Skills 位置:装进项目(`--skills-location project`,默认);插件市场是有限制的替代方式(只支持 Claude Code、只有英文技能文本、只跟正式版)
|
|
39
39
|
- 最小化规范文件複制到项目
|
|
40
40
|
|
|
41
41
|
**包含内容**:
|
|
@@ -147,7 +147,7 @@ status: current
|
|
|
147
147
|
| 团队同步 | 需各自安裝 | Git 同步 | 混合 |
|
|
148
148
|
|
|
149
149
|
**说明**:
|
|
150
|
-
- Skills
|
|
150
|
+
- 装进项目的 Skills(默认)可以提交到 Git;来自插件市场的 Skills 由 Claude Code 管理,不在项目内
|
|
151
151
|
- 规范文件可放入 Git,团队自动同步
|
|
152
152
|
- 自订規則需要修改规范文件
|
|
153
153
|
|
|
@@ -180,7 +180,7 @@ status: current
|
|
|
180
180
|
|
|
181
181
|
**配置方式**:
|
|
182
182
|
```bash
|
|
183
|
-
uds init -y --skills-location
|
|
183
|
+
uds init -y --skills-location project
|
|
184
184
|
# standardsScope 將自动设为 minimal
|
|
185
185
|
```
|
|
186
186
|
|
|
@@ -195,7 +195,7 @@ uds init -y --skills-location marketplace
|
|
|
195
195
|
|
|
196
196
|
**配置方式**:
|
|
197
197
|
```bash
|
|
198
|
-
uds init -y --skills-location
|
|
198
|
+
uds init -y --skills-location project --content-mode index
|
|
199
199
|
# 在互动提示中选择多个 AI 工具
|
|
200
200
|
```
|
|
201
201
|
|
|
@@ -296,11 +296,11 @@ uds init -y --skills-location none --content-mode index
|
|
|
296
296
|
```
|
|
297
297
|
个人开发者 + Claude Code
|
|
298
298
|
└─ 推荐:僅 Skills(模式 A)
|
|
299
|
-
└─ 配置:standardsScope: minimal +
|
|
299
|
+
└─ 配置:standardsScope: minimal + 技能装进项目
|
|
300
300
|
|
|
301
301
|
团队开发 + 混合工具
|
|
302
302
|
└─ 推荐:Skills + 规范文件(模式 C)
|
|
303
|
-
└─ 配置:standardsScope: full +
|
|
303
|
+
└─ 配置:standardsScope: full + 技能装进项目
|
|
304
304
|
└─ 规范文件納入 Git 管理
|
|
305
305
|
|
|
306
306
|
企业環境 + 合規要求
|
|
@@ -59,7 +59,13 @@ npm link
|
|
|
59
59
|
|
|
60
60
|
## 安装 Claude Code Skills
|
|
61
61
|
|
|
62
|
-
|
|
62
|
+
**主要路径:装进项目**(支持多种 AI 工具、有繁体与简体中文文本、跟随你装的 UDS 版本)
|
|
63
|
+
```bash
|
|
64
|
+
npx universal-dev-standards init # 新项目
|
|
65
|
+
npx universal-dev-standards update --apply --skills # 已设置好的项目
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
**替代方式(有限制):Claude Code 插件市场**(只支持 Claude Code、只有英文技能文本、只跟正式版、项目内不放文件)
|
|
63
69
|
```bash
|
|
64
70
|
/plugin marketplace add AsiaOstrich/universal-dev-standards
|
|
65
71
|
/plugin install universal-dev-standards@asia-ostrich
|
|
@@ -57,6 +57,50 @@ CLAUDE.md ← 已更新 UDS 指引(Claude Code)
|
|
|
57
57
|
|
|
58
58
|
---
|
|
59
59
|
|
|
60
|
+
## 技能怎么装
|
|
61
|
+
|
|
62
|
+
获取 UDS 技能有两种方式,两种都受支持。主要路径是装进项目;Claude Code 插件市场是有限制的替代方式。
|
|
63
|
+
|
|
64
|
+
> **默认是装进项目。** `uds init` 与不带 `--skills-location` 的 `uds init --yes` 会把技能装进项目(Claude Code 是 `.claude/skills/`)。6.14 之前它们一个技能文件都不装,把 Claude Code 的技能留给插件。要改用插件,请加 `--skills-location marketplace`:项目内不会写入任何技能文件,安装结尾会说明技能从哪里来。
|
|
65
|
+
|
|
66
|
+
| | 装进项目(主要路径) | Claude Code 插件市场(替代方式) |
|
|
67
|
+
|---|---|---|
|
|
68
|
+
| 指令 | 新项目:`uds init`(这是默认)<br>已设置过的项目:`uds update --apply --skills` | `/plugin marketplace add AsiaOstrich/universal-dev-standards`,再 `/plugin install universal-dev-standards@asia-ostrich` |
|
|
69
|
+
| AI 工具 | Claude Code、OpenCode、Cursor、Codex、Copilot、Windsurf 等 | 只支持 Claude Code |
|
|
70
|
+
| 技能文本的语言 | 英文、繁体中文、简体中文。中文文本放在 npm 包内,所以安装它们不需要网络;缺少这些文本的 UDS 会改装英文并明说 | 只有英文:插件设置没有语言选项 |
|
|
71
|
+
| UDS 版本 | 你装的那个版本,包含测试版 | 只跟正式版 |
|
|
72
|
+
| 项目内的文件 | 有,例如 `.claude/skills/`;`uds check` 会逐文件验证 | 没有 |
|
|
73
|
+
| 更新 | 升级 UDS 后,自己再运行一次 `uds update --apply --skills` | 由 Claude Code 管理插件(`/plugin`) |
|
|
74
|
+
|
|
75
|
+
**请二选一。** Claude Code 执行插件技能是 `/<插件名>:<技能名>`,执行项目技能是 `/<技能名>`,所以两种都装时每个技能会出现两次(例如 `/commit` 与 `/universal-dev-standards:commit`),而且每个技能的名称与描述每回合都会放进上下文,重复装等于重复占用。`uds check` 发现项目内有 UDS 技能、同时又装了 UDS 插件时,会打印警告;警告只是信息,不改变判定与退出码。要留项目这份,在 Claude Code 执行 `/plugin uninstall universal-dev-standards@asia-ostrich`。要留插件,删掉 `.claude/skills/` 下的 UDS 技能文件夹。
|
|
76
|
+
|
|
77
|
+
**为什么 `uds check` 与 `uds update` 叫你运行 `uds update --apply --skills`。** `uds check` 在项目里的技能文件缺失或被改过时说这句,`uds update` 在已装的技能版本落后时说这句。只有装进项目的技能有文件,UDS 才能拿它和当初装的内容比对、放回去,所以修法就是那个指令。插件不在你的项目里放文件,`uds check` 没有东西可比对,也就没有这类消息。
|
|
78
|
+
|
|
79
|
+
`uds skills` 会列出装了什么、装在哪里,并打印同样的两种方式与各自的限制。
|
|
80
|
+
|
|
81
|
+
### 个人技能与 UDS 技能同名时
|
|
82
|
+
|
|
83
|
+
Claude Code 对同一个名称只执行一个技能,而且漏掉另一个时不会告诉你。哪一个执行,取决于各自从哪里来(Claude Code 技能文档,2026-10-07 读取):
|
|
84
|
+
|
|
85
|
+
| 同名出现在 | 执行哪一个 |
|
|
86
|
+
|---|---|
|
|
87
|
+
| 企业层(组织下发的 managed settings 目录)、个人层(`~/.claude/skills/<名称>/`)、项目层(`.claude/skills/<名称>/`) | 企业层高于个人层,个人层高于项目层 |
|
|
88
|
+
| 项目技能与子目录里的嵌套技能 | 两个都加载:`/<名称>` 执行项目根目录那个,嵌套那个是 `/<目录>:<名称>` |
|
|
89
|
+
| 插件技能与上面任一处的技能 | 两个都加载:插件技能是 `/<插件名>:<名称>` |
|
|
90
|
+
| 技能与 `.claude/commands/<名称>.md` 文件 | 技能 |
|
|
91
|
+
|
|
92
|
+
技能的名称是 `SKILL.md` frontmatter 里的 `name:`,没有就用文件夹名称;文件夹名称同样能调用该技能,所以两者任一撞名都算。
|
|
93
|
+
|
|
94
|
+
**对 UDS 的意思。** `uds init --skills-location project` 与 `uds update --apply --skills` 写进去的是项目技能。你若已有同名的个人技能,执行的是你的,UDS 那个永远不会执行,而且没有任何消息说明。UDS 有几个技能名称短而通用(`plan`、`push`、`sweep`、`orchestrate`,以及文件夹叫 `commit-standards` 的 `/commit`),所以有个人技能库的人都可能遇到。UDS 不为此改名:改名会破坏所有既有的调用。
|
|
95
|
+
|
|
96
|
+
**怎么看见。** `uds check` 会拿项目里的 UDS 技能与 `~/.claude/skills/` 的技能比对,打印一条警告并点名每一组;`uds init` 与 `uds update --apply --skills` 在安装结尾打印同一条警告。它只是信息,不改变判定也不改变退出码。它有限制,而且**没有警告不等于没有撞名**:它看不到组织以企业层下发的技能(优先级高于个人层),也看不到它运行之后你才新增的个人技能,所以新增之后请再运行一次 `uds check`。
|
|
97
|
+
|
|
98
|
+
**怎么解。** 二选一。两个都留:把你的个人技能改名(文件夹名称,以及 `SKILL.md` 里的 `name:`)。只留你的:删掉 `.claude/skills/` 下那个 UDS 技能文件夹。
|
|
99
|
+
|
|
100
|
+
给新的 UDS 技能取名以避免撞名,属于贡献者的事:见 `skills/SKILL_NAMING.md`。
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
60
104
|
## 步骤 3 — 你的第一份 Spec(`/sdd`)
|
|
61
105
|
|
|
62
106
|
在写代码之前,先创建一份 spec:
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: options/code-review/pr-review.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
source_hash: 3fafa7b1a9c3
|
|
5
6
|
status: current
|
|
6
7
|
---
|
|
7
8
|
|
|
@@ -35,6 +36,7 @@ Pull Request(PR)审查是传统的异步代码审查流程,在合并前先
|
|
|
35
36
|
- 链接相关 issue
|
|
36
37
|
- 指派适当的 reviewer
|
|
37
38
|
- 确保 CI 检查通过
|
|
39
|
+
- 写明合并风险:门(双向或单向)与影响范围,一个词;单向门要在合并前让决策者知情
|
|
38
40
|
|
|
39
41
|
### 2. 审查
|
|
40
42
|
|
|
@@ -127,6 +129,15 @@ Brief description of changes
|
|
|
127
129
|
- [ ] Unit tests added/updated
|
|
128
130
|
- [ ] Manual testing performed
|
|
129
131
|
|
|
132
|
+
## Merge Danger
|
|
133
|
+
Door (tick one):
|
|
134
|
+
- [ ] Two-way door: after merging, it can be taken back easily
|
|
135
|
+
- [ ] One-way door: irreversible or hard to take back (data migration, deletion, changed default behavior, changed exit code, renamed public interface)
|
|
136
|
+
|
|
137
|
+
Blast radius (one word, e.g. docs, cli, adopters):
|
|
138
|
+
|
|
139
|
+
A one-way door must be made known to whoever decides to merge before the merge.
|
|
140
|
+
|
|
130
141
|
## Checklist
|
|
131
142
|
- [ ] Code follows project style guidelines
|
|
132
143
|
- [ ] Self-review completed
|