universal-dev-standards 6.8.0 → 6.9.0
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 +12 -2
- package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +14 -2
- package/bundled/ai/standards/adr-standards.ai.yaml +14 -2
- package/bundled/ai/standards/code-review.ai.yaml +13 -3
- package/bundled/ai/standards/commit-message.ai.yaml +8 -4
- package/bundled/ai/standards/deferred-item-exit.ai.yaml +225 -0
- package/bundled/ai/standards/feature-discovery-standards.ai.yaml +14 -2
- package/bundled/ai/standards/governance-layer.ai.yaml +128 -2
- package/bundled/ai/standards/logging.ai.yaml +2 -2
- package/bundled/ai/standards/retrospective-standards.ai.yaml +14 -2
- package/bundled/ai/standards/reverse-engineering-standards.ai.yaml +73 -2
- package/bundled/ai/standards/security-standards.ai.yaml +2 -2
- package/bundled/ai/standards/spec-driven-development.ai.yaml +14 -2
- package/bundled/ai/standards/tech-debt-standards.ai.yaml +87 -3
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +131 -0
- package/bundled/core/acceptance-criteria-traceability.md +5 -2
- package/bundled/core/adr-standards.md +26 -2
- package/bundled/core/code-review-checklist.md +5 -2
- package/bundled/core/context-aware-loading.md +1 -1
- package/bundled/core/deferred-item-exit.md +254 -0
- package/bundled/core/feature-discovery-standards.md +5 -1
- package/bundled/core/governance-layer.md +114 -2
- package/bundled/core/retrospective-standards.md +4 -2
- package/bundled/core/reverse-engineering-standards.md +81 -2
- package/bundled/core/spec-driven-development.md +8 -2
- package/bundled/core/tech-debt-standards.md +67 -8
- package/bundled/core/turn-completion-integrity.md +196 -0
- package/bundled/hooks/check-dangerous-cmd.mjs +60 -0
- package/bundled/hooks/check-logging-standard.mjs +59 -0
- package/bundled/hooks/check-turn-completion.mjs +233 -0
- package/bundled/hooks/inject-standards.mjs +183 -0
- package/bundled/hooks/telemetry-wrapper.mjs +77 -0
- package/bundled/hooks/turn-completion/detect.mjs +99 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +159 -0
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +166 -0
- package/bundled/hooks/validate-commit-msg.mjs +104 -0
- package/bundled/locales/zh-CN/CHANGELOG.md +47 -3
- package/bundled/locales/zh-CN/CLAUDE.md +1 -1
- package/bundled/locales/zh-CN/README.md +2 -2
- package/bundled/locales/zh-CN/SECURITY.md +1 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +1 -1
- package/bundled/locales/zh-CN/core/governance-layer.md +118 -6
- package/bundled/locales/zh-CN/core/retrospective-standards.md +1 -1
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +71 -4
- package/bundled/locales/zh-CN/core/turn-completion-integrity.md +190 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +8 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +29 -68
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +25 -15
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +1 -2
- package/bundled/locales/zh-CN/integrations/google-antigravity/{INSTRUCTIONS.md → AGENTS.md} +1 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +3 -3
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +22 -12
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +12 -9
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-CN/skills/commands/brainstorm.md +17 -13
- package/bundled/locales/zh-CN/skills/commands/config.md +0 -1
- package/bundled/locales/zh-CN/skills/commands/init.md +1 -2
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +2 -0
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +1 -0
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +3 -0
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +3 -0
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/CHANGELOG.md +47 -3
- package/bundled/locales/zh-TW/CLAUDE.md +1 -1
- package/bundled/locales/zh-TW/README.md +2 -2
- package/bundled/locales/zh-TW/SECURITY.md +1 -1
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +2 -0
- package/bundled/locales/zh-TW/core/adr-standards.md +26 -5
- package/bundled/locales/zh-TW/core/code-review-checklist.md +2 -0
- package/bundled/locales/zh-TW/core/container-image-standards.md +2 -2
- package/bundled/locales/zh-TW/core/contract-testing-standards.md +2 -2
- package/bundled/locales/zh-TW/core/cross-flow-regression.md +8 -7
- package/bundled/locales/zh-TW/core/data-contract.md +2 -2
- package/bundled/locales/zh-TW/core/data-migration-testing.md +2 -2
- package/bundled/locales/zh-TW/core/data-pipeline.md +2 -2
- package/bundled/locales/zh-TW/core/deferred-item-exit.md +251 -0
- package/bundled/locales/zh-TW/core/documentation-writing-standards.md +228 -3
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +15 -2
- package/bundled/locales/zh-TW/core/governance-layer.md +118 -5
- package/bundled/locales/zh-TW/core/iac-design-principles.md +2 -2
- package/bundled/locales/zh-TW/core/incident-response.md +2 -2
- package/bundled/locales/zh-TW/core/model-provenance.md +4 -2
- package/bundled/locales/zh-TW/core/pii-classification.md +42 -6
- package/bundled/locales/zh-TW/core/prd-standards.md +4 -2
- package/bundled/locales/zh-TW/core/product-metrics-standards.md +4 -2
- package/bundled/locales/zh-TW/core/release-readiness-gate.md +2 -2
- package/bundled/locales/zh-TW/core/resource-cost-boundary.md +2 -2
- package/bundled/locales/zh-TW/core/retrospective-standards.md +5 -3
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +83 -5
- package/bundled/locales/zh-TW/core/runbook.md +2 -2
- package/bundled/locales/zh-TW/core/schema-evolution.md +2 -2
- package/bundled/locales/zh-TW/core/secret-management-standards.md +2 -2
- package/bundled/locales/zh-TW/core/slo-sli.md +2 -2
- package/bundled/locales/zh-TW/core/spec-driven-development.md +2 -0
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +71 -4
- package/bundled/locales/zh-TW/core/turn-completion-integrity.md +190 -0
- package/bundled/locales/zh-TW/core/user-journey-testing.md +2 -2
- package/bundled/locales/zh-TW/core/user-story-mapping.md +2 -2
- package/bundled/locales/zh-TW/core/verification-oracle.md +2 -2
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +8 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +29 -68
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +25 -15
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +1 -2
- package/bundled/locales/zh-TW/integrations/google-antigravity/{INSTRUCTIONS.md → AGENTS.md} +1 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +3 -3
- package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +22 -12
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +12 -9
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/commands/brainstorm.md +17 -13
- package/bundled/locales/zh-TW/skills/commands/config.md +0 -1
- package/bundled/locales/zh-TW/skills/commands/init.md +1 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/knowledge-graph/guide.md +2 -2
- package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +3 -0
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +3 -0
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +1 -0
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +2 -0
- package/bundled/skills/atdd-assistant/SKILL.md +2 -0
- package/bundled/skills/bdd-assistant/SKILL.md +2 -0
- package/bundled/skills/brainstorm-assistant/SKILL.md +31 -13
- package/bundled/skills/brainstorm-assistant/guide.md +9 -6
- package/bundled/skills/code-review-assistant/SKILL.md +1 -0
- package/bundled/skills/commands/brainstorm.md +12 -9
- package/bundled/skills/commands/config.md +0 -1
- package/bundled/skills/commands/init.md +2 -3
- package/bundled/skills/commit-standards/SKILL.md +2 -0
- package/bundled/skills/contract-test-assistant/SKILL.md +1 -0
- package/bundled/skills/dev-methodology/SKILL.md +4 -0
- package/bundled/skills/observability-assistant/SKILL.md +1 -0
- package/bundled/skills/project-discovery/SKILL.md +1 -0
- package/bundled/skills/project-structure-guide/SKILL.md +1 -0
- package/bundled/skills/release-standards/SKILL.md +3 -0
- package/bundled/skills/requirement-assistant/SKILL.md +2 -0
- package/bundled/skills/reverse-engineer/SKILL.md +3 -0
- package/bundled/skills/runbook-assistant/SKILL.md +1 -0
- package/bundled/skills/slo-assistant/SKILL.md +1 -0
- package/bundled/skills/tdd-assistant/SKILL.md +2 -0
- package/bundled/templates/.ai-context.yaml.template +194 -0
- package/bundled/templates/CLAUDE.md.template +145 -0
- package/bundled/templates/DESIGN.md +237 -0
- package/bundled/templates/SKILL-BRIEF-TEMPLATE.md +57 -0
- package/bundled/templates/SKILL-CANDIDATES.md +39 -0
- package/bundled/templates/gates/check-error-exit.mjs +309 -0
- package/bundled/templates/mcp-config.json +10 -0
- package/bundled/templates/methodology-template.yaml +209 -0
- package/bundled/templates/migration-template.md +408 -0
- package/bundled/templates/requirement-checklist.md +410 -0
- package/bundled/templates/requirement-document-template.md +591 -0
- package/bundled/templates/requirement-template.md +881 -0
- package/bundled/templates/reverse-spec-template.md +409 -0
- package/bundled/templates/test-case-template.md +74 -0
- package/bundled/templates/test-plan-template.md +74 -0
- package/package.json +7 -5
- package/src/commands/audit.js +82 -0
- package/src/commands/check.js +66 -10
- package/src/commands/init.js +161 -16
- package/src/commands/update.js +286 -14
- package/src/compilers/claude-code-compiler.js +4 -1
- package/src/config/ai-agent-paths.js +62 -17
- package/src/core/constants.js +42 -11
- package/src/core/manifest.js +201 -3
- package/src/core/paths.js +2 -2
- package/src/i18n/messages.js +6 -29
- package/src/installers/hooks-installer.js +167 -75
- package/src/installers/integration-installer.js +9 -5
- package/src/prompts/init.js +14 -14
- package/src/utils/detector.js +21 -1
- package/src/utils/effect-boundary.js +1093 -0
- package/src/utils/hasher.js +166 -1
- package/src/utils/hook-stats.js +1 -1
- package/src/utils/integration-generator.js +79 -1
- package/src/utils/reference-sync.js +4 -1
- package/src/utils/yaml-generator.js +51 -9
- package/standards-registry.json +31 -8
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/tech-debt-standards.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
last_synced: 2026-08-20
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# 技术债管理标准
|
|
10
10
|
|
|
11
|
-
> 版本: 1.
|
|
11
|
+
> 版本: 1.1.0 | 最后更新: 2026-08-20
|
|
12
12
|
|
|
13
13
|
## 概述
|
|
14
14
|
|
|
@@ -48,6 +48,73 @@ status: current
|
|
|
48
48
|
| 10 | **Created Date** | 登记日期 |
|
|
49
49
|
| 11 | **Target Resolution Date** | 计划解决日期 |
|
|
50
50
|
|
|
51
|
+
### 登记表存储选项
|
|
52
|
+
|
|
53
|
+
登记表可存放于下列任一位置,但每个选项**只有在同时满足右栏的到期检查条件时才合法**:
|
|
54
|
+
|
|
55
|
+
| 选项 | 适用对象 | 到期检查条件 |
|
|
56
|
+
|------|---------|-------------|
|
|
57
|
+
| `docs/tech-debt-registry.md` | 小型团队 | 有一支 repo 检查会解析该表格,并在有行超过 Target Resolution Date 时失败——**或**该文件带有「无人看管声明」 |
|
|
58
|
+
| Issue tracker(GitHub Issues、Jira) | 较大团队 | 有一个排程查询实际会**执行**并发出告警;没有人打开的保存查询不算检查——**或**带有「无人看管声明」 |
|
|
59
|
+
| 专用电子表格 | 非技术利益相关者 | 仅当该表以明确频率导出到某个会被检查读取的位置时才合法——**或**带有「无人看管声明」 |
|
|
60
|
+
|
|
61
|
+
> **这一栏为什么必须加。** 一份没有任何程序读得到的登记表,满足本节其余每一条要求:11 个字段齐全、有 Owner、有 Target Resolution Date。它没有任何地方是错的——直到日期过了,然后什么都没发生。电子表格选项**刻意不移除**(电子表格常是出钱的人唯一会打开的格式);不再合法的是「任何一种存储方式成为日期无声过期的地方」。
|
|
62
|
+
|
|
63
|
+
### 到期处置
|
|
64
|
+
|
|
65
|
+
一个过了却没有任何后果的 **Target Resolution Date**,与根本没有日期无从分辨。本小节定义「日期到了」是什么意思。
|
|
66
|
+
|
|
67
|
+
#### 三种合法处置
|
|
68
|
+
|
|
69
|
+
项目到达 Target Resolution Date 时,必须发生且只能发生下列三者之一,并且必须留下痕迹:
|
|
70
|
+
|
|
71
|
+
| 处置 | 含义 | 必留痕迹 |
|
|
72
|
+
|------|------|---------|
|
|
73
|
+
| **做掉(Resolve)** | 把事情做完 | 关闭登记项 + `Tech-Debt: TD-NNN resolved` commit footer |
|
|
74
|
+
| **撤销(Withdraw)** | 决定不做,并删掉这条记载 | 标记为撤销,附理由与日期。它不再被计为技术债,因为它已经不是了 |
|
|
75
|
+
| **延期(Extend)** | 设定新的 Target Resolution Date | 新日期**与**书面理由必须一起记下;先前的日期保持可见(用追加,不要覆盖) |
|
|
76
|
+
|
|
77
|
+
没有第四种处置。「仍然开着、日期过了、没有人看」不是本标准允许的状态——那正是本小节存在要指名的失败。
|
|
78
|
+
|
|
79
|
+
**规则 TD-EXP-001(必要)**——项目超过 Target Resolution Date 而三种处置皆未施用,该登记表即不合规。到期是一个发现,不是中性的背景状态。
|
|
80
|
+
|
|
81
|
+
**规则 TD-EXP-002(必要,禁止事项)**——到期**不得**被实现成**自动延期**或**自动关闭**。
|
|
82
|
+
|
|
83
|
+
- 自动延期使日期变得不可证伪:它永远不会被错过,所以它从未量到任何东西。
|
|
84
|
+
- 自动关闭在没有任何人做出决定的情况下删掉了那条记载。
|
|
85
|
+
|
|
86
|
+
两者都让时钟停止,且都不留下「时钟停了」的痕迹。一个唯一的消费者是「把它往后推的排程」的日期,只是装饰。
|
|
87
|
+
|
|
88
|
+
**规则 TD-EXP-003(必要)**——延期时理由必须记在新日期旁边。只改日期不是延期,那是一次盖了时间戳的删除。
|
|
89
|
+
|
|
90
|
+
**规则 TD-EXP-004(建议)**——被延期三次以上、期间没有记录任何进度的项目,应重新分流为**撤销**候选。反复延期是「没有人打算做这件事」的证据;老实记下这件事,比第四个日期对下一位读者更有用。
|
|
91
|
+
|
|
92
|
+
#### 无人看管声明
|
|
93
|
+
|
|
94
|
+
不是每个团队都有能力跑一支检查。**没有自动到期检查的登记表仍然合规——但前提是它把这件事写出来。**
|
|
95
|
+
|
|
96
|
+
「无人看管声明」是写在登记表内部、可见且带日期的一段陈述:
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
无人看管——没有任何自动检查在读这份登记表的到期项目。
|
|
100
|
+
由 <负责人> 以 <频率> 人工复查。最后复查日期:<日期>。
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
**规则 TD-EXP-005(必要)**——登记表必须处于下列两种状态之一,且必须让读者看得到它处于哪一种:
|
|
104
|
+
|
|
105
|
+
1. **已受检(Checked)**——有一支具名、跑得起来的检查在读这份登记表,并在项目超过 Target Resolution Date 时失败。
|
|
106
|
+
2. **无人看管(Unattended)**——没有这样的检查,但带有无人看管声明,且声明中写明负责人、复查频率与最后复查日期。
|
|
107
|
+
|
|
108
|
+
两种状态都不处于的登记表即为不合规。这份声明不是形式:它就是「知道没有东西在看的读者」与「以为有东西在看的读者」之间的全部差别。
|
|
109
|
+
|
|
110
|
+
**规则 TD-EXP-006(必要)**——无人看管声明里的「最后复查日期」本身,受该声明自己所写的频率约束。最后复查日期比自己声明的频率还旧的声明,本身就是一个到期项目,三种处置同样适用于它。
|
|
111
|
+
|
|
112
|
+
> **本标准不提供任何检查器,这是已知代价——写在这里,而不是留给采用者自己撞到。**
|
|
113
|
+
>
|
|
114
|
+
> UDS 定义的是要求,它不提供一支执行该要求的程序。想要**已受检**状态的采用者必须自己写那支检查,而多数团队不会写——那正是上面描述的失败模式,现在同样适用于本小节自己。
|
|
115
|
+
>
|
|
116
|
+
> 所以这里的最低标准**不是**「去建一支检查器」,而是**「绝不让一份登记表在无声中变成无人看管」**。声明 `无人看管` 只要一段文字,而且完全合规。无人看管**却不声明**才是本标准真正禁止的唯一结果,因为只有它会让读者对「有没有东西在看」产生误解。
|
|
117
|
+
|
|
51
118
|
## 3. 预算分配
|
|
52
119
|
|
|
53
120
|
| 团队状态 | 预算 | 说明 |
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../core/turn-completion-integrity.md
|
|
3
|
+
source_version: 1.3.0
|
|
4
|
+
translation_version: 1.3.0
|
|
5
|
+
last_synced: 2026-09-08
|
|
6
|
+
source_hash: c396baa28423
|
|
7
|
+
status: current
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 回合收尾完整性
|
|
11
|
+
|
|
12
|
+
> **语言**: [English](../../../core/turn-completion-integrity.md) | [繁體中文](../../zh-TW/core/turn-completion-integrity.md) | 简体中文
|
|
13
|
+
|
|
14
|
+
**版本**: 1.3.0
|
|
15
|
+
**最后更新**: 2026-09-08
|
|
16
|
+
**适用范围**: 任何由 agent 结束回合、把控制权交还给人的执行环境
|
|
17
|
+
**Scope**: universal
|
|
18
|
+
**行业标准**: 不声称任何来源——由实际观察到的失败归纳,见「证据」
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## 目的
|
|
23
|
+
|
|
24
|
+
agent 写下「我接着做 X」,然后结束回合,而 X 没有做。
|
|
25
|
+
|
|
26
|
+
人读到的是一句描述着从未发生的工作的话。没有任何错误、没有任何检查变红,
|
|
27
|
+
对话记录读起来像有进展。下一个回合从一个「人以为比实际更靠前」的状态开始。
|
|
28
|
+
|
|
29
|
+
这不是知识上的失败——agent 说对了下一步。这是**收尾**的失败:
|
|
30
|
+
回合结束在工作本该开始的那一刻。
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 规则
|
|
35
|
+
|
|
36
|
+
**R1.** 若 agent 最后一条消息做出了第一人称的下一步声明,
|
|
37
|
+
回合**不得**结束,除非那件事做了,或说出它卡在什么。
|
|
38
|
+
|
|
39
|
+
**R2.** 「卡在什么」的意思是逐项指名每一件事在等谁、等什么。
|
|
40
|
+
「主要的都做完了」不是阻塞点陈述;
|
|
41
|
+
「部署等你的密钥,文档不卡任何人而我现在就做」才是。
|
|
42
|
+
|
|
43
|
+
**R3.** 只写在 agent 指令里的规则不是执法。R1 必须**在回合结束的那一刻**、
|
|
44
|
+
由**不是 agent 的东西**来判断。
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## R3 为什么存在
|
|
49
|
+
|
|
50
|
+
这条规则的指令形式曾写进某项目的 agent 指令,
|
|
51
|
+
而**在读到它的同一个 session 内就被违反**。
|
|
52
|
+
接着它被写成已发布的标准、标为 optional、没有任何检查器在读,
|
|
53
|
+
七天后同样的违反再来一次。
|
|
54
|
+
|
|
55
|
+
指令是一种输入。失败发生在一个决策点——「我正要结束这个回合」——
|
|
56
|
+
而一个在那一刻不会被读到的输入,就是没有在生效。
|
|
57
|
+
一般形式是:**一项有文档而在其决策点上没有执法的要求,是建议;
|
|
58
|
+
它的遵循度不是很高,是没有被量过。**
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 这个检查**不得**做的事
|
|
63
|
+
|
|
64
|
+
**R4. 不得因为「永远还有待办」而拦截。** 仓库永远有未关闭的 TODO,
|
|
65
|
+
待办清单永远有条目。一道每个回合都为真的闸门会被关掉,然后它什么都不保护。
|
|
66
|
+
这个检查**只**在 agent 于那条消息里做出的声明上触发。
|
|
67
|
+
|
|
68
|
+
**R5. 一律 fail open。** 任何错误——读不到对话记录、字段缺失、JSON 损坏、
|
|
69
|
+
结构不符——都**必须**让回合结束。一个会把 session 困住的 hook 比没有 hook 更糟,
|
|
70
|
+
因为人唯一的补救手段是把它关掉,而他会永久关掉它。
|
|
71
|
+
|
|
72
|
+
**R6. 拦截要有上界。** 检查**必须**同时具备
|
|
73
|
+
(a) 两次拦截之间的冷却期,与
|
|
74
|
+
(b) **滚动时间窗**内的拦截次数上限。
|
|
75
|
+
|
|
76
|
+
以 session 计且永不重置的上限不是安全阀——它是一个有延迟的关闭开关,
|
|
77
|
+
而且会在「这条规则最重要的那种长 session」里悄无声息地自我解除。
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## 使用者可以结束回合,而 agent 的用词说不出这件事
|
|
82
|
+
|
|
83
|
+
**R9.** 检查**必须**豁免由人要求结束的回合,
|
|
84
|
+
而且**必须**从人自己最近一条消息判断,不是从 agent 的消息判断。
|
|
85
|
+
|
|
86
|
+
这条规则的存在是因为它的缺席被量到过一次——就在本标准上线后的第一次真实触发。
|
|
87
|
+
人写的是「先暂停,我要回家了」;agent 照做并列出回来要接的事;
|
|
88
|
+
检查把它读成未兑现的承诺并拦下。
|
|
89
|
+
|
|
90
|
+
检测器对模式的判断没有错。**由指令结束的回合,与由未兑现承诺结束的回合,
|
|
91
|
+
在 agent 的用词上一模一样**,因为两种情况下 agent 都在指名自己现在不做的工作。
|
|
92
|
+
那条消息里没有任何东西分得出来,所以只读那条消息的检查也分不出来。
|
|
93
|
+
|
|
94
|
+
**R10.** 叫停模式**必须**写窄,而且它的语料**必须**包含
|
|
95
|
+
「只是含有停止字眼的工作指令」。误豁免不是漏拦一次,
|
|
96
|
+
而是把检查在该 session 的剩余时间全部静音。
|
|
97
|
+
实现期间该模式曾匹配到「先停用那份硬编码清单,改成遍历注册表」
|
|
98
|
+
——一句要求做事的指令,被读成叫停。
|
|
99
|
+
|
|
100
|
+
**R11.** 检查自己的拦截消息会以人的回合回到对话记录。
|
|
101
|
+
它**必须**认得出自己的输出,并在寻找人的最后一条消息时跳过它。
|
|
102
|
+
|
|
103
|
+
没有这一条,R9 只会生效一次。拦截消息会在下一次执行成为「人最近一条消息」,
|
|
104
|
+
真正那句叫停被盖在它后面,豁免就消失——而且是悄无声息地、
|
|
105
|
+
只在它被建立的那种情境里消失。
|
|
106
|
+
|
|
107
|
+
这与「检测器匹配到解释它的散文」同一族,再往前一步:**检查读到自己的输出。**
|
|
108
|
+
在拦截消息里带一个固定标记字符串,跳过任何含有它的人类回合。
|
|
109
|
+
|
|
110
|
+
**R12.** 检查**必须**认得出 R2 所定义的那个结束方式。
|
|
111
|
+
一个执行 R2 却看不见逐项阻塞点清单的检查,会拦下标准自己要求的唯一停法
|
|
112
|
+
——它在惩罚正确行为,而那比漏抓一次违规更快被卸载。
|
|
113
|
+
|
|
114
|
+
识别需要三个条件,实测拿掉任何一个都会坏:
|
|
115
|
+
|
|
116
|
+
| 条件 | 为什么 |
|
|
117
|
+
|---|---|
|
|
118
|
+
| 两项以上的清单 | 只有一项带归属的是句子,不是逐项列出 |
|
|
119
|
+
| 归属词出现在消息任何位置,不要求每项都有 | 真实写法把它放在前言——「剩下的每一项都卡在你手上,逐项列:」——而要求每项都有,第一次拿真实消息一比就漏 |
|
|
120
|
+
| 没有含糊的完成语 | 「其余都做完了」正是 R2 拒绝的摘要;靠这种句子把剩下的带过的清单,是穿着清单外衣的摘要 |
|
|
121
|
+
|
|
122
|
+
🔴 **归属词的搜索必须排除检查自己的结构。**
|
|
123
|
+
「要你决定什么」这个标题本身含有「要你」,于是一份「已经做完了什么」的清单,
|
|
124
|
+
靠着它上方的标题就满足了归属条件。**检测器读到了自己的结构**——与 R11 同一个失败,低一层。
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## 语言覆盖是正确性问题,不是翻译工作
|
|
129
|
+
|
|
130
|
+
这个检查读的是 agent 写的散文,所以**它的检测器与语言绑定**。
|
|
131
|
+
一个只带着某一种语言模式的检测器,交付给以另一种语言工作的采用者,
|
|
132
|
+
会得到一个装好了、每回合都执行、exit 0、而**结构上永远不会触发**的 hook。
|
|
133
|
+
每一个可观察的信号,都与「agent 表现良好」一模一样。
|
|
134
|
+
|
|
135
|
+
**R7.** 每一个支持的语言**必须**以 locale 包交付,
|
|
136
|
+
各自带着**自己的语料**(必须拦截的用例与必须放行的用例),
|
|
137
|
+
而该包的自测**必须**在 CI 里运行。语料不通过的 locale 包不交付。
|
|
138
|
+
|
|
139
|
+
**R8.** 语言没有对应包的采用者**必须**被告知这个检查对他们是失效的。
|
|
140
|
+
在这里沉默,等于把本标准要防的失败在上一层重演一次。
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## 检测器匹配什么
|
|
145
|
+
|
|
146
|
+
形状是:**第一人称将来标记,接一个动作动词,在同一个句子里**,再减掉三个排除项。
|
|
147
|
+
|
|
148
|
+
| 元素 | 作用 | 缺了会怎样 |
|
|
149
|
+
|---|---|---|
|
|
150
|
+
| 第一人称+将来标记 | 把声明与描述分开 | 会匹配到被引述回来的用户原话 |
|
|
151
|
+
| 动作动词 | 把「做」与「讲」分开 | 「我来解释为什么」会算成工作 |
|
|
152
|
+
| 限定同一句 | 让两半保持相关 | 一个否定从句与后面一个真承诺会并成一个不匹配 |
|
|
153
|
+
| 排除报告动词 | 「我会说/提/记」不是工作 | 检查会在自己的摘要上触发 |
|
|
154
|
+
| 排除否定 | 「我不会改那个」是决定,不是承诺 | 一句拒绝会被读成承诺 |
|
|
155
|
+
| 排除引用与表格 | 模式的**例子**不是模式的**实例** | 检查会在自己的文档上触发 |
|
|
156
|
+
|
|
157
|
+
上表每一个排除项,都是因为它的缺席在测试中造成过一次误拦才加上去的。
|
|
158
|
+
少做其中任何一项的实现,会重现那次误拦。
|
|
159
|
+
|
|
160
|
+
---
|
|
161
|
+
|
|
162
|
+
## 证据
|
|
163
|
+
|
|
164
|
+
单一项目的观察,2026-08 至 2026-09:
|
|
165
|
+
|
|
166
|
+
| 观察 | 次数 |
|
|
167
|
+
|---|---|
|
|
168
|
+
| 用户就「说了下一步却没做」提出同一个抱怨 | 5 |
|
|
169
|
+
| 指令形式已存在、而在同一个 session 内被违反 | ≥1 |
|
|
170
|
+
| 检测器版本被自己源码或例子中的模式击败 | 5 |
|
|
171
|
+
| 上线前被语料抓到的检测器误拦 | 3 |
|
|
172
|
+
|
|
173
|
+
最后一行就是 R7 的论据。五个检测器缺陷里有三个**只因为语料存在**才被抓到;
|
|
174
|
+
交付出去的那两个,正是没有任何用例覆盖的那两个。
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## 检查清单
|
|
179
|
+
|
|
180
|
+
- [ ] 检查在回合结束时执行,不是写成给 agent 的指令
|
|
181
|
+
- [ ] 每一条失败路径都不拦截、直接放行
|
|
182
|
+
- [ ] 冷却期与滚动时间窗上限两者都在
|
|
183
|
+
- [ ] 每个交付语言都有语料,而语料在 CI 里运行
|
|
184
|
+
- [ ] 语言不支持的采用者被告知检查失效
|
|
185
|
+
- [ ] 检查不读取仓库状态(未关闭的 TODO、待办清单)
|
|
186
|
+
- [ ] 由人要求结束的回合被豁免,且由人的消息判断
|
|
187
|
+
- [ ] 叫停语料包含「含有停止字眼的工作指令」
|
|
188
|
+
- [ ] 检查认得出自己的拦截消息,不把它读成人说的话
|
|
189
|
+
- [ ] 检查认得出 R2 定义的逐项阻塞点结束,而且不拦它
|
|
190
|
+
- [ ] 归属词的搜索排除检查自己的标题与结构
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# UDS 速查表
|
|
2
2
|
|
|
3
|
-
> Quick reference for all UDS features | Last updated: 2026-
|
|
3
|
+
> Quick reference for all UDS features | Last updated: 2026-09-14
|
|
4
4
|
|
|
5
5
|
**Language**: [English](../../../docs/user/CHEATSHEET.md) | [繁體中文](../../zh-TW/docs/CHEATSHEET.md) | 简体中文
|
|
6
6
|
|
|
@@ -218,6 +218,7 @@
|
|
|
218
218
|
| `data-migration-testing` | Data Migration Testing |
|
|
219
219
|
| `data-pipeline` | Data Pipeline Standards |
|
|
220
220
|
| `database-standards` | This standard defines guidelines for database desi |
|
|
221
|
+
| `deferred-item-exit` | Several standards require documents that **produce |
|
|
221
222
|
| `deployment-standards` | This standard defines guidelines for safely deploy |
|
|
222
223
|
| `deprecation-standards` | Deprecation & Sunset Standards |
|
|
223
224
|
| `design-document-standards` | Design Document Standards |
|
|
@@ -316,6 +317,7 @@
|
|
|
316
317
|
| `timeout-standards` | Timeout Standards |
|
|
317
318
|
| `token-budget` | Token Budget Zone Standard |
|
|
318
319
|
| `translation-lifecycle-standards` | Translation lifecycle standards: MISSING vs OUTDAT |
|
|
320
|
+
| `turn-completion-integrity` | An agent writes *"I'll do X next"* and then ends t |
|
|
319
321
|
| `user-journey-testing` | User Journey Testing Standard |
|
|
320
322
|
| `user-story-mapping` | User Story Mapping Standards |
|
|
321
323
|
| `verification-evidence` | Establish an "Iron Law" that no task can be claime |
|
|
@@ -337,6 +339,7 @@
|
|
|
337
339
|
| `check-ai-agent-sync.ps1` | Check Ai Agent Sync |
|
|
338
340
|
| `check-ai-agent-sync.sh` | AI Agent Sync Checker |
|
|
339
341
|
| `check-ai-yaml-parses.mjs` | Every shipped .ai.yaml must parse, and must parse |
|
|
342
|
+
| `check-bump-sync-roundtrip.mjs` | check-bump-sync-roundtrip — 測「跑完 bump 之後 check 必須通 |
|
|
340
343
|
| `check-cli-docs-sync.ps1` | Check Cli Docs Sync |
|
|
341
344
|
| `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
|
|
342
345
|
| `check-commands-sync.ps1` | Check Commands Sync |
|
|
@@ -346,6 +349,7 @@
|
|
|
346
349
|
| `check-docs-integrity.sh` | Documentation Integrity Checker |
|
|
347
350
|
| `check-docs-sync.ps1` | Check Docs Sync |
|
|
348
351
|
| `check-docs-sync.sh` | Documentation Sync Checker |
|
|
352
|
+
| `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
|
|
349
353
|
| `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ- |
|
|
350
354
|
| `check-orphan-specs.ps1` | Check Orphan Specs |
|
|
351
355
|
| `check-orphan-specs.sh` | Orphan Spec Detection Script |
|
|
@@ -359,6 +363,7 @@
|
|
|
359
363
|
| `check-standards-reference-sync.sh` | check-standards-reference-sync.sh |
|
|
360
364
|
| `check-standards-sync.ps1` | Check Standards Sync |
|
|
361
365
|
| `check-standards-sync.sh` | Standards Consistency Checker |
|
|
366
|
+
| `check-translation-hash-ratchet.sh` | XSPEC-392 R6 棘輪:新的翻譯必須帶 source_hash,既有的欠債冷凍為基線。 |
|
|
362
367
|
| `check-translation-sync.ps1` | Check Translation Sync |
|
|
363
368
|
| `check-translation-sync.sh` | Translation Sync Checker |
|
|
364
369
|
| `check-usage-docs-sync.ps1` | Check if usage documentation needs to be regenerat |
|
|
@@ -370,7 +375,9 @@
|
|
|
370
375
|
| `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
|
|
371
376
|
| `fix-manifest-paths.ps1` | Fix Manifest Paths |
|
|
372
377
|
| `fix-manifest-paths.sh` | Manifest Path Fixer |
|
|
378
|
+
| `generate-adoption-skills.mjs` | Self-Adoption Skill Copy Generator and Drift Gate |
|
|
373
379
|
| `generate-docs.mjs` | Look up the release date for `version` from CHANGE |
|
|
380
|
+
| `generate-llms-txt.mjs` | llms.txt Generator and Drift Gate — XSPEC-385 |
|
|
374
381
|
| `generate-locale-coverage.mjs` | Locale Coverage Generator |
|
|
375
382
|
| `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9 |
|
|
376
383
|
| `install-hooks.mjs` | Install Hooks |
|
|
@@ -45,7 +45,7 @@ status: current
|
|
|
45
45
|
◯ Windsurf (.windsurfrules)
|
|
46
46
|
◯ Cline (.clinerules)
|
|
47
47
|
◯ GitHub Copilot (.github/copilot-instructions.md)
|
|
48
|
-
◯ Google Antigravity (
|
|
48
|
+
◯ Google Antigravity (.agents/AGENTS.md) - Gemini Agent
|
|
49
49
|
── AGENTS.md Tools ──
|
|
50
50
|
◯ OpenAI Codex (AGENTS.md) - OpenAI Codex CLI
|
|
51
51
|
◯ OpenCode (AGENTS.md) - Open-source AI coding agent
|
|
@@ -68,7 +68,7 @@ status: current
|
|
|
68
68
|
| **Windsurf** | `.windsurfrules` | Plaintext | Windsurf IDE 规则文件 |
|
|
69
69
|
| **Cline** | `.clinerules` | Plaintext | Cline 扩展规则文件 |
|
|
70
70
|
| **GitHub Copilot** | `.github/copilot-instructions.md` | Markdown | Copilot 自定义指示 |
|
|
71
|
-
| **Google Antigravity** |
|
|
71
|
+
| **Google Antigravity** | `.agents/AGENTS.md` | Markdown | Gemini Agent 系统指令 |
|
|
72
72
|
| **OpenAI Codex** | `AGENTS.md` | Markdown | OpenAI Codex CLI |
|
|
73
73
|
| **OpenCode** | `AGENTS.md` | Markdown | 开源 AI 编码 Agent(与 Codex 共用文件) |
|
|
74
74
|
| **Gemini CLI** | `GEMINI.md` | Markdown | Google Gemini CLI |
|
|
@@ -626,21 +626,26 @@ uds init
|
|
|
626
626
|
```
|
|
627
627
|
? Select content level:
|
|
628
628
|
❯ Standard (推荐) - Summary + links to full docs
|
|
629
|
-
Full Embed - All rules in one file (larger)
|
|
630
629
|
Minimal - Core rules only (smallest)
|
|
631
630
|
```
|
|
632
631
|
|
|
633
632
|
### 说明
|
|
634
633
|
|
|
635
|
-
决定 AI
|
|
634
|
+
决定 AI 工具集成文件中嵌入多少标准内容。
|
|
635
|
+
|
|
636
|
+
> **第三个模式 `full`(Full Embed)已于 UDS 6.9.0 移除。**
|
|
637
|
+
> 它从来没有产生过与 `index` 不同的文件——生成器只在 `minimal` 上分支,
|
|
638
|
+
> 因此两者在实测的 24 组(工具 × 语言)组合中输出逐位相同。
|
|
639
|
+
> `--content-mode full` 仍然接受,并解析为 `index`;manifest 中记录的 `full`
|
|
640
|
+
> 会在下一次执行时改写为 `index`。**任何项目拿到的文件都不会改变**,
|
|
641
|
+
> 因为两个模式本来就产生相同的字节。详见 XSPEC-357 R7。
|
|
636
642
|
|
|
637
643
|
### 选项
|
|
638
644
|
|
|
639
|
-
| 模式 |
|
|
640
|
-
|
|
641
|
-
| **Standard
|
|
642
|
-
| **
|
|
643
|
-
| **Minimal** | 最小 | 低 | 旧项目迁移 |
|
|
645
|
+
| 模式 | 内容 | 适用情境 |
|
|
646
|
+
|------|------|----------|
|
|
647
|
+
| **Standard**(`index`,推荐) | 标准索引 + MUST/SHOULD 任务对照表 | 大多数项目 |
|
|
648
|
+
| **Minimal**(`minimal`) | 仅文件引用 | 由 Skills 提供任务指引的项目 |
|
|
644
649
|
|
|
645
650
|
### 详细说明
|
|
646
651
|
|
|
@@ -714,47 +719,17 @@ uds init
|
|
|
714
719
|
- ✅ 希望 AI 遵守规范但不想文件太大
|
|
715
720
|
- ✅ AI 工具会读取项目文件
|
|
716
721
|
|
|
717
|
-
#### Full Embed
|
|
718
|
-
|
|
719
|
-
**生成内容**:完整嵌入所有规则
|
|
720
|
-
|
|
721
|
-
```markdown
|
|
722
|
-
## Anti-Hallucination Protocol
|
|
723
|
-
Reference: .standards/anti-hallucination.md
|
|
724
|
-
|
|
725
|
-
### Core Principle
|
|
726
|
-
You are an AI assistant that prioritizes accuracy over confidence...
|
|
727
|
-
|
|
728
|
-
### Evidence-Based Analysis
|
|
729
|
-
1. **File Reading Requirement**
|
|
730
|
-
- You MUST read files before analyzing them
|
|
731
|
-
- Do not guess APIs, class names, or library versions
|
|
732
|
-
...
|
|
733
|
-
|
|
734
|
-
---
|
|
735
|
-
|
|
736
|
-
## Commit Message Standards
|
|
737
|
-
Reference: .standards/commit-message.ai.yaml
|
|
722
|
+
#### Full Embed 模式(已移除)
|
|
738
723
|
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
### Commit Types
|
|
743
|
-
| Type | Description | Example |
|
|
744
|
-
| feat | New feature | feat(auth): add OAuth2 login |
|
|
745
|
-
...
|
|
746
|
-
```
|
|
724
|
+
这一节原本描述一个把完整规则正文嵌入集成文件的模式,声称能「**保证**」AI
|
|
725
|
+
看到所有标准,并产生「比 Index 大 3-5 倍」的文件。
|
|
747
726
|
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
-
|
|
751
|
-
- 文件大小可能是 Index 的 3-5 倍
|
|
727
|
+
**这些从来都没有被实现。** `full` 与 `index` 走同一条代码路径、写出相同的字节。
|
|
728
|
+
它也不可能按描述运作:`.standards/` 约 248k token,远超过任何集成文件装得下的量。
|
|
729
|
+
该模式已于 UDS 6.9.0 移除(XSPEC-357 R7),现在解析为 `index`。
|
|
752
730
|
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
- ✅ AI 可能不读取外部文件
|
|
756
|
-
- ✅ 不能容许 AI 遗漏任何规则
|
|
757
|
-
- ✅ 新团队导入,确保完全了解规范
|
|
731
|
+
若你当初是为了合规理由选择它,你拿到的一直都是 `index` 的输出,
|
|
732
|
+
因此产生的文件不会有任何改变。
|
|
758
733
|
|
|
759
734
|
### 决策流程
|
|
760
735
|
|
|
@@ -763,19 +738,8 @@ Reference: .standards/commit-message.ai.yaml
|
|
|
763
738
|
│
|
|
764
739
|
▼
|
|
765
740
|
┌─────────────────────────────┐
|
|
766
|
-
│
|
|
767
|
-
|
|
768
|
-
│
|
|
769
|
-
┌───┴───┐
|
|
770
|
-
│ │
|
|
771
|
-
是 否
|
|
772
|
-
│ │
|
|
773
|
-
▼ ▼
|
|
774
|
-
Index Full
|
|
775
|
-
│
|
|
776
|
-
▼
|
|
777
|
-
┌─────────────────────────────┐
|
|
778
|
-
│ 是否有严格合规要求? │
|
|
741
|
+
│ 是否已安装 Skills 并由它 │
|
|
742
|
+
│ 提供任务指引? │
|
|
779
743
|
└─────────────────────────────┘
|
|
780
744
|
│
|
|
781
745
|
┌───┴───┐
|
|
@@ -783,10 +747,7 @@ Index Full
|
|
|
783
747
|
是 否
|
|
784
748
|
│ │
|
|
785
749
|
▼ ▼
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
旧项目迁移 / 想要最小改动? → Minimal
|
|
750
|
+
Minimal Index
|
|
790
751
|
```
|
|
791
752
|
|
|
792
753
|
### 使用案例
|
|
@@ -794,11 +755,11 @@ Index Full
|
|
|
794
755
|
| 案例 | 推荐模式 | 理由 |
|
|
795
756
|
|------|----------|------|
|
|
796
757
|
| 创业团队的 SaaS 项目 | **Index** | 平衡效率与规范 |
|
|
797
|
-
| 银行核心系统 | **
|
|
758
|
+
| 银行核心系统 | **Index** | 索引会列出每一条适用标准与适用时机 |
|
|
798
759
|
| 个人 side project | **Minimal** | 轻量就好 |
|
|
799
760
|
| 开源项目 | **Index** | 让贡献者 AI 知道规范 |
|
|
800
761
|
| 从旧设置迁移 | **Minimal** | 保留现有设置 |
|
|
801
|
-
| 新导入 AI 的传统企业 | **
|
|
762
|
+
| 新导入 AI 的传统企业 | **Index** | 与已移除的 `full` 模式产出相同 |
|
|
802
763
|
|
|
803
764
|
---
|
|
804
765
|
|
|
@@ -895,8 +856,8 @@ uds init -y \
|
|
|
895
856
|
--test-levels unit,integration \
|
|
896
857
|
--content-mode index
|
|
897
858
|
|
|
898
|
-
#
|
|
899
|
-
uds init -y --content-mode
|
|
859
|
+
# 最小化集成文件(由 Skills 提供任务指引)
|
|
860
|
+
uds init -y --content-mode minimal
|
|
900
861
|
|
|
901
862
|
# 生成 AGENTS.md 通用摘要(--yes 模式默认生成)
|
|
902
863
|
uds init -y --agents-md
|