universal-dev-standards 6.14.1 → 6.15.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.
- 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 +57 -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 +57 -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/actual-state-scanner.js +7 -1
- package/src/reconciler/backup-locations.js +3 -2
- package/src/reconciler/backup-manager.js +14 -11
- package/src/reconciler/diff-engine.js +19 -1
- 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/marker-locator.js +48 -4
- 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
package/bin/uds.js
CHANGED
|
@@ -230,7 +230,7 @@ program
|
|
|
230
230
|
.option('--commands', 'Install/update slash commands for configured AI tools')
|
|
231
231
|
.option('--debug', 'Show debug output for Skills/Commands detection')
|
|
232
232
|
.option('--plan', 'Show reconciliation plan without executing (like terraform plan); combines with --skills/--commands to plan just that scope, still writing nothing')
|
|
233
|
-
.option('--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')
|
|
233
|
+
.option('--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')
|
|
234
234
|
.option('--force', 'Force update all files, ignoring hash comparison')
|
|
235
235
|
.option('--prune', 'Delete .standards/ files UDS wrote but no longer ships (listed without this flag; never touches files UDS did not write)')
|
|
236
236
|
.option('--rollback', 'Rollback to the most recent backup (with the series of updates that follow from it)')
|
|
@@ -238,7 +238,7 @@ program
|
|
|
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
239
|
.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
240
|
.option('--locale <locale>', 'Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env')
|
|
241
|
-
.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)')
|
|
241
|
+
.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)')
|
|
242
242
|
.option('--ai-tool <tools>', 'With --with-hooks: comma-separated tools to install hooks for (claude-code, codex, gemini-cli, antigravity) instead of detecting them')
|
|
243
243
|
.action(updateCommand);
|
|
244
244
|
|
|
@@ -15,7 +15,7 @@ standard:
|
|
|
15
15
|
|
|
16
16
|
meta:
|
|
17
17
|
version: "1.2.1"
|
|
18
|
-
updated: "2026-10-
|
|
18
|
+
updated: "2026-10-30"
|
|
19
19
|
source: core/developer-memory.md
|
|
20
20
|
description: Structured system for capturing, retrieving, and surfacing developer experience insights across conversations and projects
|
|
21
21
|
|
|
@@ -25,7 +25,7 @@ standard:
|
|
|
25
25
|
belongs_in: "使用者自己的 AI 工具記憶"
|
|
26
26
|
why: "去識別化會把它剝掉,所以它不能是一筆記憶條目;那種記憶綁一個使用者、一台機器,不被分享"
|
|
27
27
|
- what: "跨專案的工作協調(誰在等誰)"
|
|
28
|
-
belongs_in: "open-work-tracking
|
|
28
|
+
belongs_in: "選用技能 /open-work(參考文件 core/open-work-tracking.md,OWT-027~OWT-029)"
|
|
29
29
|
why: "那是開放工作,不是記憶"
|
|
30
30
|
|
|
31
31
|
schema:
|
|
@@ -9,7 +9,7 @@ standard:
|
|
|
9
9
|
|
|
10
10
|
meta:
|
|
11
11
|
version: "1.3.0"
|
|
12
|
-
updated: "2026-
|
|
12
|
+
updated: "2026-11-01"
|
|
13
13
|
source: core/full-coverage-testing.md
|
|
14
14
|
replaces: "testing pyramid thresholds (UT≥80%/IT≥70%/E2E happy-path-only)"
|
|
15
15
|
xspec: "XSPEC-178, XSPEC-444, XSPEC-470"
|
|
@@ -112,7 +112,7 @@ standard:
|
|
|
112
112
|
reported_when: "none of the test's assertions is a real one (same rule as expect(true).toBe(true))"
|
|
113
113
|
undecidable: "stays silent; left to the reviewer (when in doubt, miss it rather than accuse it)"
|
|
114
114
|
accepted_costs:
|
|
115
|
-
- "Differential tests are named: expect(fastTotal(items)).toBe(items.reduce(...)) with a reference implementation as oracle looks like the textbook example. Settle it with one assertion against a hand-computed literal in the same test, or list the file under `ignore` in .standards/test-policy.json (whole file, no reason field). A test name does not exempt it and the `exempt` list does not apply to this scanner."
|
|
115
|
+
- "Differential tests are named: expect(fastTotal(items)).toBe(items.reduce(...)) with a reference implementation as oracle looks like the textbook example. Settle it with one assertion against a hand-computed literal in the same test, or exempt that one test with an ANTI_FAKE_EXEMPT comment that gives a reason, or list the file under `ignore` in .standards/test-policy.json (whole file, no reason field). A test name does not exempt it and the `exempt` list does not apply to this scanner."
|
|
116
116
|
- "Easy to get around: wrapping the VALUE UNDER TEST in Number(...), adding .valueOf() or [0] to it, or passing items.slice() each stop the scanner from seeing it (doing the same to the EXPECTED value changes nothing: it is still named). It is a prompt for the reviewer, not a gate against deliberate avoidance (an AI agent writing the test included); a clean scan is not evidence that expected values are independent."
|
|
117
117
|
left_alone_on_purpose:
|
|
118
118
|
- "expect(priceOf(ids)).toEqual(ids.map(id => KNOWN_PRICES[id])) // lookup in a fixed table is an independent source"
|
|
@@ -226,10 +226,12 @@ standard:
|
|
|
226
226
|
scripts: # written to scripts/ by `uds init`; never overwritten
|
|
227
227
|
- file: scripts/check-anti-fake-tests.mjs
|
|
228
228
|
finds: [no-assertion, tautology, all-skipped] # tautology: always-true, plus (JS/TS, XSPEC-470) same-call and recomputed expected values
|
|
229
|
-
exit: "0 clean | 1 findings | 2 could not judge (never a pass)"
|
|
229
|
+
exit: "0 clean | 1 findings | 2 could not judge, or the search was INCOMPLETE (file limit reached, a directory or file could not be read) and found nothing in the part it saw (never a pass)"
|
|
230
|
+
file_limit: "at most 200000 files listed (--max-files N lowers it); the next file makes the run INCOMPLETE"
|
|
231
|
+
exempt_one_test: "comment `ANTI_FAKE_EXEMPT: <reason>` on the test's own line or in the comment lines directly above it; reason >= 8 letters/digits/Chinese characters and not a placeholder (TODO, TBD, N/A); reaches only the test it is attached to; exempted tests are listed in every run and in --json as `exempted`"
|
|
230
232
|
- file: scripts/check-stubs.mjs
|
|
231
233
|
finds: [stub-marker, not-implemented, empty-function]
|
|
232
|
-
exit: "0 clean | 1 findings | 2 could not judge (never a pass)"
|
|
234
|
+
exit: "0 clean | 1 findings | 2 could not judge, or the search was INCOMPLETE (file limit reached, a directory or file could not be read) and found nothing in the part it saw (never a pass)"
|
|
233
235
|
pre_commit_checks: # run by `uds check` on what is staged
|
|
234
236
|
- id: code-without-test
|
|
235
237
|
finds: "code files changed and no test file changed in the same commit"
|
|
@@ -14,7 +14,7 @@ standard:
|
|
|
14
14
|
|
|
15
15
|
meta:
|
|
16
16
|
version: "1.2.1"
|
|
17
|
-
updated: "2026-10-
|
|
17
|
+
updated: "2026-10-30"
|
|
18
18
|
source: core/project-context-memory.md
|
|
19
19
|
description: System for capturing, retrieving, and enforcing project-specific context, architectural decisions, and domain knowledge
|
|
20
20
|
|
|
@@ -24,7 +24,7 @@ standard:
|
|
|
24
24
|
belongs_in: "使用者自己的 AI 工具記憶"
|
|
25
25
|
why: "專案情境在 repo 裡,會被每個 clone 它的人看到;這類資訊不是專案情境"
|
|
26
26
|
- what: "跨專案的工作協調(誰在等誰)"
|
|
27
|
-
belongs_in: "open-work-tracking
|
|
27
|
+
belongs_in: "選用技能 /open-work(參考文件 core/open-work-tracking.md,OWT-027~OWT-029)"
|
|
28
28
|
why: "那是開放工作,不是情境"
|
|
29
29
|
|
|
30
30
|
schema:
|
|
@@ -646,7 +646,7 @@ A tool without a session-start hook still satisfies this standard through either
|
|
|
646
646
|
Two kinds of information are outside this standard, and writing them here is a mistake:
|
|
647
647
|
|
|
648
648
|
- **Personal, cross-project, identifiable facts** (who owns what, how to reach a particular environment). De-identification (see the schema above) would strip exactly these, so they cannot live in a memory entry. They belong in the memory of the user's own AI tool, which is bound to that user and that machine and is not shared.
|
|
649
|
-
- **Coordination between projects** (which piece of work is waiting on which other). That is open work, not memory:
|
|
649
|
+
- **Coordination between projects** (which piece of work is waiting on which other). That is open work, not memory: the optional skill [`/open-work`](../skills/open-work-assistant/SKILL.md) is the working guidance, and the rules are in the reference document [Open Work Tracking](open-work-tracking.md) (OWT-027–OWT-029).
|
|
650
650
|
|
|
651
651
|
---
|
|
652
652
|
|
|
@@ -95,7 +95,7 @@ These look similar and are **left alone on purpose**, because the text cannot te
|
|
|
95
95
|
|
|
96
96
|
**Two costs that are accepted, not hidden.**
|
|
97
97
|
|
|
98
|
-
1. **Differential tests are named.** A test that uses a reference implementation as its oracle, `expect(fastTotal(items)).toBe(items.reduce((s, i) => s + i.price, 0))`, looks exactly like the textbook example, so the scanner names it. Such a test is legitimate (see the table above, "a second, independently written implementation"); the ways to settle it are: put one assertion against a hand-computed literal in the same test (a test is reported only when none of its assertions is a real one), or list the file under `ignore` in `.standards/test-policy.json` (this removes the whole file from every check of this scanner, and `ignore` takes no reason, so say why in a comment). A test name such as "matches the reference implementation" does **not** exempt it, and the `exempt` list does not apply to this scanner (it belongs to the code-without-a-test check).
|
|
98
|
+
1. **Differential tests are named.** A test that uses a reference implementation as its oracle, `expect(fastTotal(items)).toBe(items.reduce((s, i) => s + i.price, 0))`, looks exactly like the textbook example, so the scanner names it. Such a test is legitimate (see the table above, "a second, independently written implementation"); the ways to settle it are: put one assertion against a hand-computed literal in the same test (a test is reported only when none of its assertions is a real one), or exempt that one test with an `ANTI_FAKE_EXEMPT: <reason>` comment (see "Two scanner scripts" below; the reason is required and the test is listed in every run), or list the file under `ignore` in `.standards/test-policy.json` (this removes the whole file from every check of this scanner, and `ignore` takes no reason, so say why in a comment). A test name such as "matches the reference implementation" does **not** exempt it, and the `exempt` list does not apply to this scanner (it belongs to the code-without-a-test check).
|
|
99
99
|
2. **The rule is easy to get around.** Wrapping the **value under test** in `Number(...)`, adding `.valueOf()` or `[0]` to it, or passing `items.slice()` instead of `items` is enough to stop the scanner from seeing it. (Doing the same to the **expected** value changes nothing: that is still named.) It is a prompt for the reviewer, not a gate that holds against someone who means to avoid it, and that includes an AI agent writing the test: do not read a clean scan as evidence that the expected values are independent. The reviewer's questions below are the control; the script only points at the cheapest cases.
|
|
100
100
|
|
|
101
101
|
As with `expect(true).toBe(true)`, a test is reported only when **none** of its assertions is a real one; a self-comparison next to an assertion against a literal is left to the reviewer. When the text cannot decide, the scanner stays silent — a scanner that cries wolf is switched off.
|
|
@@ -281,11 +281,13 @@ The rules above used to depend on scripts the standard told you to write yoursel
|
|
|
281
281
|
|
|
282
282
|
- Pure Node, no dependencies, no test framework assumed. They are **your files**: edit them, wire them into CI. Run on its own, each exits non-zero when it finds something — `node scripts/check-stubs.mjs` is the pre-push/deploy gate this standard's deployment gates describe.
|
|
283
283
|
- `uds init` never overwrites a file that exists, and `uds update` never overwrites one either; for a project initialised earlier, `uds update` offers to write them (the prompt defaults to no; `uds update -y` answers it yes).
|
|
284
|
-
- With files staged they read only those files; with nothing staged (a CI run, a manual `uds check`) each walks the whole project — the walk
|
|
284
|
+
- With files staged they read only those files; with nothing staged (a CI run, a manual `uds check`) each walks the whole project — the walk lists at most 200,000 files (`--max-files N` lowers that), and `uds check` gives each scanner 120 seconds (past that it reports "could not judge", never a pass) — so in a very large repository run them in CI rather than expecting them to be instant. A walk that hits the file limit, cannot open a directory or cannot read a file prints `INCOMPLETE`, and exits `2` when it found nothing in the part it did see (findings still exit `1`): a partial search is never reported as a clean one.
|
|
285
285
|
- A placeholder is *declared* by `STUB` or `COVERAGE_EXEMPT` on its line or the three above; a declared placeholder is reported once, as its marker.
|
|
286
286
|
- **Languages.** Test-file rules exist for JavaScript/TypeScript, Python, Java/Kotlin/Scala/C#, Go, Rust, Ruby, Elixir, PHP, Swift, Dart, Lua and C/C++. A test file in any **other** language is listed as "NOT scanned" — never counted as clean. Empty-function rules exist for JavaScript/TypeScript, Python, Go, Rust, Ruby and PHP; elsewhere markers and "not implemented" bodies are still found and the output says which languages had no empty-function rule.
|
|
287
287
|
- They read text; they do not run your tests. A helper that asserts under a name the scanner cannot recognise is reported as "no-assertion": name it `assert*` / `verify*` / `expect*`, or list its pattern under `assertionPatterns` in the policy file.
|
|
288
288
|
- Each run first checks itself against known fakes and known good tests; if that fails it exits `2` ("could not judge"), which is never a pass.
|
|
289
|
+
- Exit codes of both scripts: `0` nothing found, `1` findings, `2` could not judge (the self-test failed, git could not be read in `--staged` mode, or the search was INCOMPLETE and found nothing in the part it saw). `2` is never a pass.
|
|
290
|
+
- `check-anti-fake-tests` only: one test can be exempted by a comment `ANTI_FAKE_EXEMPT: <reason>` on its own line or in the comment lines directly above it. The reason must be at least 8 letters, digits or Chinese characters and not a placeholder such as `TODO`; a marker without a usable reason does nothing and the finding says so. It reaches only the test it is attached to (a blank line or code in between breaks it; if two tests start on one line it exempts neither). Exempted tests are listed in every run and in `--json` under `exempted`.
|
|
289
291
|
|
|
290
292
|
### Code changed without a test (`uds check`, on staged changes)
|
|
291
293
|
|
|
@@ -1,5 +1,18 @@
|
|
|
1
1
|
# Open Work Tracking Standard
|
|
2
2
|
|
|
3
|
+
<!-- UDS:REFERENCE-ONLY -->
|
|
4
|
+
> **Reference only — UDS no longer installs this standard.** Its machine-readable
|
|
5
|
+
> `.ai.yaml` and its registry entry were removed. It was calibrated on one project,
|
|
6
|
+
> and that project's own use did not confirm it, so it is no longer something every
|
|
7
|
+
> adopter follows. The document is kept for adopters who already built on it, and is
|
|
8
|
+
> **not distributed by `uds init` or `uds update`**. What was worth keeping is now the
|
|
9
|
+
> **optional skill** [`/open-work`](../skills/open-work-assistant/SKILL.md): use it when
|
|
10
|
+
> you want it, nothing requires it. The reference checks remain available as
|
|
11
|
+
> `uds open-work`. A copy already installed in your `.standards/` is removed by
|
|
12
|
+
> `uds update --apply` (the plan lists it under Delete, and a backup is taken first). The list this notice is checked against is
|
|
13
|
+
> [`scripts/reference-only-standards.json`](../scripts/reference-only-standards.json);
|
|
14
|
+
> the change is recorded in the [CHANGELOG](../CHANGELOG.md) (Unreleased).
|
|
15
|
+
|
|
3
16
|
> **Language**: English | [繁體中文](../locales/zh-TW/core/open-work-tracking.md)
|
|
4
17
|
|
|
5
18
|
**Version**: 1.4.0
|
|
@@ -235,7 +235,7 @@ We use **Split-File Storage** (one Markdown file per topic) rather than a single
|
|
|
235
235
|
## Boundary: What This Standard Does Not Hold
|
|
236
236
|
|
|
237
237
|
- **Personal, cross-project, identifiable facts** (who owns what, how to reach a particular environment) are not project context: entries here live in the repository and are shared with everyone who clones it. Keep them in the user's own AI tool memory, not in `.project-context/`.
|
|
238
|
-
- **Coordination between projects** (which piece of work is waiting on which other) is open work, not context:
|
|
238
|
+
- **Coordination between projects** (which piece of work is waiting on which other) is open work, not context: the optional skill [`/open-work`](../skills/open-work-assistant/SKILL.md) is the working guidance, and the rules are in the reference document [Open Work Tracking](open-work-tracking.md) (OWT-027–OWT-029).
|
|
239
239
|
|
|
240
240
|
---
|
|
241
241
|
|
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
> Auto-generated by `scripts/generate-locale-coverage.mjs` on 2026-07-16.
|
|
4
4
|
> Do not edit manually — re-run the script.
|
|
5
5
|
|
|
6
|
-
> **Canonical**: `skills/` (
|
|
6
|
+
> **Canonical**: `skills/` (57) + `core/` (149). **Locales tracked**: `zh-CN`, `zh-TW`.
|
|
7
7
|
|
|
8
|
-
## Skills (
|
|
8
|
+
## Skills (57 canonical)
|
|
9
9
|
|
|
10
10
|
| Skill | zh-CN | zh-TW |
|
|
11
11
|
| :-- | :-: | :-: |
|
|
@@ -43,6 +43,7 @@
|
|
|
43
43
|
| metrics-dashboard-assistant | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
|
|
44
44
|
| migration-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
45
45
|
| observability-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
46
|
+
| open-work-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
46
47
|
| orchestrate | :white_check_mark: 2.0.0 | :white_check_mark: 2.0.0 |
|
|
47
48
|
| plan | :white_check_mark: 2.0.0 | :white_check_mark: 2.0.0 |
|
|
48
49
|
| pr-automation-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
@@ -66,8 +67,8 @@
|
|
|
66
67
|
| test-coverage-assistant | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
|
|
67
68
|
| testing-guide | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
|
|
68
69
|
|
|
69
|
-
**zh-CN skills coverage**:
|
|
70
|
-
**zh-TW skills coverage**:
|
|
70
|
+
**zh-CN skills coverage**: 57/57 (100%)
|
|
71
|
+
**zh-TW skills coverage**: 57/57 (100%)
|
|
71
72
|
|
|
72
73
|
## Standards (`core/` — 149 canonical)
|
|
73
74
|
|
|
@@ -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.2
|
|
4
|
+
translation_version: 6.15.0-beta.2
|
|
5
|
+
last_synced: 2026-11-04
|
|
6
|
+
source_hash: 6241fbc376cf
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -18,6 +18,59 @@ status: current
|
|
|
18
18
|
|
|
19
19
|
## [Unreleased]
|
|
20
20
|
|
|
21
|
+
## [6.15.0-beta.2] - 2026-11-04
|
|
22
|
+
|
|
23
|
+
*预发布版,以 `npm install -g universal-dev-standards@beta` 安装。在 6.15.0-beta.1 之上的一个修正,由采用者在 Windows 测 beta.1 时发现:区块丢失 END 行时,`uds update` 拒绝写入,不再另加第二个区块。*
|
|
24
|
+
|
|
25
|
+
### Fixed
|
|
26
|
+
|
|
27
|
+
- **`uds update` 不再在区块丢失 END 行的文件后面再加一个 UDS 区块,而是拒绝写入并指出没有收尾的那一行(issue #297)。** 集成文件(例如 `AGENTS.md`)有 `<!-- UDS:STANDARDS:START -->` 却没有 `<!-- UDS:STANDARDS:END -->`(复制时被截断,或那一行被手动删除)时,计划显示“missing UDS markers”,`--apply` 会在文件末尾再加一整个区块;同一次运行接着因 START 重复而失败,之后每次运行都一样失败,直到有人手动合并两个区块。现在只有一半的标记、或 END 在 START 之前,都与重复标记同样处理:计划显示 `UDS markers damaged, will not be written`,`--apply` 让文件逐字节保持原样、退出码为 1,并打印哪一行没有收尾。两个标记都没有的文件仍会照常在后面加上区块。
|
|
28
|
+
|
|
29
|
+
## [6.15.0-beta.1] - 2026-11-04
|
|
30
|
+
|
|
31
|
+
> **测试版**——以 `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」。
|
|
32
|
+
|
|
33
|
+
### 变更
|
|
34
|
+
|
|
35
|
+
- **行为改变——`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)上检查:没有一个出现这两项发现,所以没有任何一个的结果改变。
|
|
36
|
+
|
|
37
|
+
- **`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 机器跑过这一项。
|
|
38
|
+
|
|
39
|
+
- **`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 失败:那是它以前没有说出口的事实。**
|
|
40
|
+
|
|
41
|
+
- **`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 没有这方面的遥测。
|
|
42
|
+
|
|
43
|
+
- **已安装的技能不再带着打不开的链接:指向安装目录之外的链接,现在会变成它原本要指的文件的 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/` 已重新产生,因为产生器的契约是「安装会产生的东西」(从同一个模组汇入的同一个转换)。斜线命令由下一项涵盖。
|
|
44
|
+
|
|
45
|
+
- **已安装的斜线命令不再带着打不开的链接:指向安装目录之外的链接,现在会变成它原本要指的文件的 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` 会询问安装位置,测试没有跑它;它呼叫的是同一个函式。
|
|
46
|
+
|
|
47
|
+
- **`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)
|
|
48
|
+
|
|
49
|
+
### 新增
|
|
50
|
+
|
|
51
|
+
- **`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 套件里没有它的任何部分。
|
|
52
|
+
- **`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` 带出。
|
|
53
|
+
|
|
54
|
+
### 修正
|
|
55
|
+
|
|
56
|
+
- **`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)。
|
|
57
|
+
|
|
58
|
+
- **`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 机器跑过这一项。
|
|
59
|
+
- **`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 写的文件开始。
|
|
60
|
+
- **`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)
|
|
61
|
+
- **`uds update --skills`(与 `--apply`)现在会拿掉它所删除的技能文件的 `skillHashes` 记录。**安装器会移除技能不再出货的顶层文件,但 manifest 一直只合并、从不修剪,所以被删文件的记录留了下来,`uds check` 把每一笔都报成遗失,而那些文件没有人能还原,因为是更新本身移除的(VibeOps:记录 140 个文件,磁盘上 125 个,15 行假的「遗失」)。记录以该次执行改写的技能为单位替换;没碰的技能保留自己的记录。已经处于这个状态的项目,下一次 `uds update --skills`(或 `--apply`)就会清掉。**行为改变:**`uds check` 不再列出那些文件,更新后 `manifest.skillHashes` 会变小。(dev-platform #46)
|
|
62
|
+
- **当 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)
|
|
63
|
+
|
|
64
|
+
- **当真正的问题是权限错误时,`uds init` 不再叫你去看防毒软件(XSPEC-516 R2)。**复制标准失败并出现 `EPERM` 或 `EACCES` 时,消息说文件「locked by another program」,并列出防毒软件、搜寻索引器与云端同步。这对 Windows 短暂的文件锁是对的,但 Windows 对只读文件或被拒绝的文件夹也汇报同样两个代码。现在,这些代码在重试之后仍持续失败时,UDS 会自己试着写入(开启来源、开启目的地写入,或在文件夹内置立再移除一个临时文件;不用 `fs.access`,因为它在 Windows 上忽略 ACL):只要其中一个被拒绝,消息就说「permission denied」,点名它找到的东西并列出该检查什么(只读属性、拥有者与权限、安全性索引标签、只读磁盘机);不提防毒软件。如果文件能开启写入,那就是锁,旧消息保留。在 Windows 之外,这两个代码本来就不重试;它们现在会得到同样的权限消息,而不是裸错误(原始错误文字仍在消息结尾,代码不变)。**未验证:**Windows 分支(重试,然后询问文件系统)由注入平台的单元测试涵盖;没有 Windows 机器为这一项跑过。
|
|
65
|
+
- **`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 机器。
|
|
66
|
+
|
|
67
|
+
### 测试
|
|
68
|
+
|
|
69
|
+
- **删除 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` 现在针对每个验收测试,列出哪一支真正的测试涵盖它,或没有任何测试涵盖。
|
|
70
|
+
- **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` 提及,它就变红。
|
|
71
|
+
- **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`、注册表与自采用分支,并新增了把这三者读成不存在的分支。
|
|
72
|
+
- **互动测试依提示问什么来作答,从未出现的问题会让测试失败(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)。
|
|
73
|
+
|
|
21
74
|
## [6.14.1] - 2026-10-30
|
|
22
75
|
|
|
23
76
|
> **正式版发布**:包含下方 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-TW/README.md) | 简体中文
|
|
17
17
|
|
|
18
|
-
**版本**: 6.
|
|
18
|
+
**版本**: 6.15.0-beta.2 (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 -->
|
|
@@ -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)` 相同,只有在测试的**所有**断言都不是真断言时才报告;自我比较旁边还有一个对字面值的断言,就留给审查者。文本判不了的,扫描脚本保持沉默——会乱叫的扫描脚本迟早被关掉。
|
|
@@ -292,11 +292,13 @@ legacy 降级模式(外部服务失败时的 fallback、重试、部分结果
|
|
|
292
292
|
|
|
293
293
|
- 纯 Node、零依赖、不预设任何测试框架。它们是**你的文件**:可以改、可以接入 CI。单独运行时,找到东西就以非 0 退出——`node scripts/check-stubs.mjs` 就是本标准部署闸门所说的 pre-push/部署闸门。
|
|
294
294
|
- `uds init` 不会覆盖已存在的文件,`uds update` 也不会;较早初始化的项目,`uds update` 会询问是否写入(提示的默认为否;`uds update -y` 会直接回答是)。
|
|
295
|
-
- 有暂存文件时只读那些文件;没有暂存任何东西时(CI 运行、手动 `uds check
|
|
295
|
+
- 有暂存文件时只读那些文件;没有暂存任何东西时(CI 运行、手动 `uds check`)每个都会遍历整个项目——遍历最多列出 200,000 个文件(`--max-files N` 可调低),`uds check` 给每个 120 秒(超过就报告“无法判定”,绝不算通过)——所以在很大的仓库里,请在 CI 运行,不要期待立刻完成。遍历撞到文件数上限、打不开某个目录、或读不了某个文件时,会打印 `INCOMPLETE`;若在已看到的部分没有发现,就以 `2` 退出(有发现仍是 `1`):只查了一部分的结果,绝不当成干净。
|
|
296
296
|
- 同一行或上面三行内出现 `STUB` 或 `COVERAGE_EXEMPT`,该临时实现就算已**声明**;已声明的只以标记报告一次。
|
|
297
297
|
- **语言范围。**测试文件规则覆盖 JavaScript/TypeScript、Python、Java/Kotlin/Scala/C#、Go、Rust、Ruby、Elixir、PHP、Swift、Dart、Lua 与 C/C++。其他语言的测试文件会被列为“未扫描”——绝不当成干净。空函数规则覆盖 JavaScript/TypeScript、Python、Go、Rust、Ruby 与 PHP;其他语言仍会找标记与“尚未实现”的函数体,输出也会写明哪些语言没有空函数规则。
|
|
298
298
|
- 它们读的是文本,不运行你的测试。若某个辅助函数用扫描器认不出的名称做断言,会被报为“no-assertion”:把它命名为 `assert*`/`verify*`/`expect*`,或把它的模式列在策略文件的 `assertionPatterns`。
|
|
299
299
|
- 每次运行都先拿已知的假测试与已知的好测试检验自己;检验失败就以 `2`(“无法判定”)退出,这绝不算通过。
|
|
300
|
+
- 两个脚本的退出码:`0` 没找到东西,`1` 有发现,`2` 无法判定(自我检验失败、`--staged` 时读不了 git,或查询不完整且在已看到的部分没有发现)。`2` 绝不算通过。
|
|
301
|
+
- 只有 `check-anti-fake-tests`:可以用注释 `ANTI_FAKE_EXEMPT: <理由>` 豁免一个测试,写在该测试同一行,或写在紧贴其正上方的注释行。理由至少要有 8 个字母、数字或汉字,且不能是 `TODO` 这类占位字;没有可用理由的标记不生效,发现会说明原因。它只作用于所附着的那一个测试(中间隔了空行或代码就失效;同一行起头两个测试时,两个都不豁免)。被豁免的测试每次运行都会列出,`--json` 以 `exempted` 字段记录。
|
|
300
302
|
|
|
301
303
|
### 改了代码却没动测试(`uds check`,针对已暂存的变更)
|
|
302
304
|
|
|
@@ -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
|
|
|
@@ -94,4 +94,4 @@ Create lightweight specification documents for past changes that were committed
|
|
|
94
94
|
|
|
95
95
|
- SDD workflow: [sdd command](sdd.md)
|
|
96
96
|
- Commit standards: [commit command](commit.md)
|
|
97
|
-
- Spec: [SPEC-011](
|
|
97
|
+
- Spec: [SPEC-011](../../../../docs/specs/cli/shared/SPEC-011-retroactive-spec-tracking.md)
|
|
@@ -3,7 +3,7 @@ source: ../../../../skills/dev-workflow-guide/SKILL.md
|
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.1.0
|
|
5
5
|
last_synced: 2026-08-17
|
|
6
|
-
source_hash:
|
|
6
|
+
source_hash: 66f5ad727df3
|
|
7
7
|
status: current
|
|
8
8
|
description: |
|
|
9
9
|
[UDS] 把目前的软件开发阶段对应到正确的 UDS 命令与 Skill。
|
|
@@ -14,7 +14,7 @@ description: |
|
|
|
14
14
|
|
|
15
15
|
# 开发工作流程指南
|
|
16
16
|
|
|
17
|
-
> **语言**: [English](
|
|
17
|
+
> **语言**: [English](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/skills/dev-workflow-guide/SKILL.md) | 简体中文
|
|
18
18
|
|
|
19
19
|
将你目前的软件开发阶段对应到正确的 UDS 命令与技能。即时了解在开发的每个阶段应该使用哪些工具。
|
|
20
20
|
|
|
@@ -165,7 +165,7 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
|
|
|
165
165
|
2. **阶段参数**:显示该阶段的详细指引,包含所有相关命令与示例
|
|
166
166
|
3. **场景参数**:显示该场景的推荐逐步工作流程
|
|
167
167
|
|
|
168
|
-
此技能会从 [workflow-phases.md](
|
|
168
|
+
此技能会从 [workflow-phases.md](./workflow-phases.md) 读取详细的阶段信息。
|
|
169
169
|
|
|
170
170
|
## 下一步引导
|
|
171
171
|
|
|
@@ -182,10 +182,10 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
|
|
|
182
182
|
|
|
183
183
|
## 参考
|
|
184
184
|
|
|
185
|
-
- [详细阶段指南](
|
|
186
|
-
- [日常工作流程指南](
|
|
187
|
-
- [功能开发工作流程](
|
|
188
|
-
- [集成流程工作流程](
|
|
185
|
+
- [详细阶段指南](./workflow-phases.md) - 完整的逐阶段参考
|
|
186
|
+
- [日常工作流程指南](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/adoption/DAILY-WORKFLOW-GUIDE.md) - 综合日常工作流程指南
|
|
187
|
+
- [功能开发工作流程](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/skills/workflows/feature-dev.workflow.yaml) - 自动化功能开发工作流程
|
|
188
|
+
- [集成流程工作流程](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/skills/workflows/integrated-flow.workflow.yaml) - 完整的 ATDD/SDD/BDD/TDD 工作流程
|
|
189
189
|
|
|
190
190
|
---
|
|
191
191
|
|