universal-dev-standards 6.5.0 → 6.6.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.
@@ -3,10 +3,13 @@
3
3
 
4
4
  id: ai-response-navigation
5
5
  meta:
6
- version: "1.1.0"
7
- updated: "2026-06-10"
6
+ version: "1.2.0"
7
+ updated: "2026-08-17"
8
8
  source: core/ai-response-navigation.md
9
- description: Every substantive AI response must include contextual next-step suggestions with recommended options
9
+ description: >
10
+ Every substantive AI response must include contextual next-step suggestions with recommended
11
+ options (rules 1-6, required). Optional rules 7-9 govern the answer itself: lead with the
12
+ finding, restate state across turns, no preamble.
10
13
 
11
14
  rules:
12
15
  - id: navigation-footer
@@ -77,7 +80,44 @@ rules:
77
80
  Localized notation: 〔模型:Fast〕 / 〔模型:Standard〕 / 〔模型:Capable〕
78
81
  priority: optional
79
82
 
83
+ # ── Rules 7-9 (v1.2.0): the answer itself, not the navigation after it ──
84
+ # Borrowed from ayghri/i-have-adhd (MIT), 3 of its 10 rules. The other 7 were dropped:
85
+ # 2 duplicate navigation-footer/recommendation-marking above, and 5 conflict with this
86
+ # standard ("no recap/no closers" contradicts navigation-footer; "cap lists at 5" would
87
+ # truncate evidence tables) or duplicate estimation-standards.
88
+ # Optional in the same sense as model-tier-annotation: a project MAY promote them to required.
89
+ # Their triggers are deliberately precise — a rule too loose to fire is not a rule.
90
+
91
+ - id: lead-with-the-finding
92
+ trigger: a response that answers a question, reports an investigation result, or presents a decision
93
+ instruction: >
94
+ Open with what was found or what to do — not the method, not a restatement of the request,
95
+ not a plan for answering. Evidence (file:line, command output, tables, measurements) is
96
+ support and belongs after the claim it supports. This orders the evidence; it does not
97
+ license omitting it.
98
+ priority: optional
99
+
100
+ - id: restate-state-each-turn
101
+ trigger: work spanning 3 or more exchanges, or a task with 3 or more steps
102
+ instruction: >
103
+ Restate in one line where the work stands. The reader cannot be assumed to hold
104
+ "we are on step 3 of 5" across messages. Composes with the in-progress template:
105
+ this rule governs the opening, that template governs the footer.
106
+ priority: optional
107
+
108
+ - id: no-preamble
109
+ trigger: any substantive response
110
+ instruction: >
111
+ Start with the answer. Do not open with a summary of what you are about to do, an
112
+ acknowledgement of the request, or an assessment of the question. Generalizes the
113
+ anti-sycophancy-prompting prohibition on "opening critique with positive affirmation"
114
+ from critiques to every substantive response — for a different reason: not flattery,
115
+ but the delay it puts between the reader and the answer.
116
+ Does NOT apply to closers: navigation-footer still stands.
117
+ priority: optional
118
+
80
119
  related_standards:
81
120
  - ai-command-behavior
82
121
  - ai-instruction-standards
83
122
  - ai-agreement-standards
123
+ - anti-sycophancy-prompting
@@ -3,7 +3,7 @@
3
3
 
4
4
  id: spec-driven-development
5
5
  meta:
6
- version: "1.3.0"
6
+ version: "1.4.0"
7
7
  updated: "2026-08-12"
8
8
  source: methodologies/guides/sdd-guide.md
9
9
  description: Spec-Driven Development workflow where documentation precedes implementation
@@ -198,6 +198,33 @@ rules:
198
198
  instruction: Archive spec with links to commits/PRs
199
199
  priority: required
200
200
 
201
+ - id: SDD-AC-VERIFIED
202
+ name: An AC with no verification item is not an AC
203
+ name_zh: 沒有驗證項的 AC 不是 AC
204
+ severity: high
205
+ rule: >
206
+ Every acceptance criterion MUST have a verification item pointing at it —
207
+ a test, a check, a gate, or an explicitly recorded manual step. An AC that
208
+ no verification item references MUST be demoted to a design intent rather
209
+ than carried as an AC.
210
+ rule_zh: >
211
+ 每一條 AC 必須有指向它的驗證項(測試/檢查/閘門/明確記錄的手動步驟)。
212
+ 沒有任何驗證項引用的 AC 必須降級為設計意圖,不得繼續掛在 AC 欄。
213
+ rationale: >
214
+ An unverified AC does not fail loudly — it stops being true while the spec
215
+ continues to assert it. Measured instance (XSPEC-380): a spec's AC-7 required
216
+ a component be "fully preserved, no regression"; its Test Plan had seven items
217
+ and none pointed at AC-7. The component stopped running on the day the AC was
218
+ written and was found three months later by accident.
219
+ rationale_zh: >
220
+ 未經驗證的 AC 不會大聲失敗——它安靜地停止成立,而規格繼續宣稱它為真。
221
+ 實測案例:某規格的 AC-7 要求「完整保留、無回歸」,Test Plan 七項無一指向它;
222
+ 它保護的東西死在該 AC 被寫下的同一天,三個月後偶然才被發現。
223
+ anti_pattern: >
224
+ Treating "the reviewer will notice" as a verification item. A reviewer reads
225
+ the spec, and the spec says the AC holds. An AC is a claim about the world;
226
+ only something that touches the world can falsify it.
227
+
201
228
  best_practices:
202
229
  do:
203
230
  - Keep specs focused and atomic (one change per spec)
@@ -2,8 +2,8 @@
2
2
 
3
3
  > **Language**: English | [繁體中文](../locales/zh-TW/core/ai-response-navigation.md) | [简体中文](../locales/zh-CN/core/ai-response-navigation.md)
4
4
 
5
- **Version**: 1.1.0
6
- **Last Updated**: 2026-06-10
5
+ **Version**: 1.2.0
6
+ **Last Updated**: 2026-08-17
7
7
  **Applicability**: All projects using AI-assisted development
8
8
  **Scope**: universal
9
9
  **Industry Standards**: None (Emerging AI tool practice)
@@ -19,6 +19,12 @@ This standard defines navigation behavior for AI responses: every substantive AI
19
19
 
20
20
  **Solution**: A standard "Navigation Footer" appended to every substantive AI response, with contextual templates, recommendation marking, and adaptive option quantities.
21
21
 
22
+ **Scope note (v1.2.0)**: Rules 1–6 govern what comes *after* the answer. Rules 7–9 — added in 1.2.0
23
+ and **optional** — govern the answer itself: lead with the finding, restate state across turns, no
24
+ preamble. They were added because a response can satisfy every one of Rules 1–6 while burying its
25
+ conclusion, and a reader who cannot find the answer is not helped by a correct footer telling them
26
+ what to do next.
27
+
22
28
  ---
23
29
 
24
30
  ## Core Rules
@@ -97,6 +103,69 @@ Tier names are **vendor-neutral**. Each tool or platform maps these tiers to its
97
103
 
98
104
  ---
99
105
 
106
+ ## The Answer Before the Navigation (Rules 7–9, Optional)
107
+
108
+ > **Borrowed from**: [`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd) (MIT), 3 of its 10 rules.
109
+ > The other 7 were dropped: 2 are already covered by Rules 1–2 above, and 5 either conflict with
110
+ > this standard (its "no recap / no closers" contradicts Rule 1's Navigation Footer; its
111
+ > "cap lists at 5" would truncate evidence tables and traversal denominators) or duplicate
112
+ > [estimation-standards](estimation-standards.md).
113
+
114
+ **Why this section exists**: Rules 1–6 govern what follows the answer. Nothing governed the answer
115
+ itself — a response could bury its conclusion under a wall of evidence and still satisfy every rule
116
+ in this standard by appending a correct Navigation Footer. A reader who cannot find the answer is
117
+ not helped by being told what to do next.
118
+
119
+ **These three rules are optional**, in the same sense as Rule 6: adopting projects are not required
120
+ to enable them, and existing skills need no retroactive update. A project MAY promote any of them to
121
+ required in its own configuration. What is *not* optional is that they have precise triggers — a rule
122
+ phrased so loosely that it never fires is indistinguishable from not having the rule.
123
+
124
+ ### Rule 7: Lead With the Finding, Not the Process (Optional)
125
+
126
+ **Trigger**: a response that answers a question, reports an investigation result, or presents a decision.
127
+
128
+ The first line states **what was found or what to do**. Not the method, not a restatement of the
129
+ request, not a plan for answering.
130
+
131
+ Evidence — file:line references, command output, tables, measurements — is **support**, and belongs
132
+ after the claim it supports. Leading with evidence forces the reader to reconstruct the conclusion
133
+ themselves, which is the work they asked to have done.
134
+
135
+ | Instead of | Write |
136
+ |-----------|-------|
137
+ | "I checked 44 days of data across 63 domains and found that…" | "Delete those three queries. 46% of what they return is download pages." |
138
+ | "Let me look at how this is configured." | "It is configured in `x.yaml:12`; the value is wrong because…" |
139
+
140
+ **This does not license omitting the evidence.** It orders it.
141
+
142
+ ### Rule 8: Restate State in Multi-Turn Work (Optional)
143
+
144
+ **Trigger**: work spanning 3 or more exchanges, or a task with 3 or more steps.
145
+
146
+ Each response restates where the work stands, in one line. The reader cannot be assumed to hold
147
+ "we are on step 3 of 5" across messages, and the cost of restating it is one sentence.
148
+
149
+ This composes with Template 4 (*In Progress*) below: Rule 8 governs the **opening**, Template 4
150
+ governs the **footer**.
151
+
152
+ ### Rule 9: No Preamble (Optional)
153
+
154
+ **Trigger**: any substantive response.
155
+
156
+ Start with the answer. Do not open with a summary of what you are about to do, an acknowledgement
157
+ of the request, or an assessment of the question.
158
+
159
+ This generalizes one existing prohibition: [anti-sycophancy-prompting](anti-sycophancy-prompting.md)
160
+ already forbids *"Opening critique with positive affirmation"* — but only for critiques. Rule 9
161
+ extends the same prohibition to every substantive response, for a different reason: not flattery,
162
+ but the delay it puts between the reader and the answer.
163
+
164
+ **Rule 9 does not apply to closers.** Rule 1 requires a Navigation Footer, and that requirement
165
+ stands — the end of a response is where this standard puts the reader's next move.
166
+
167
+ ---
168
+
100
169
  ## Contextual Templates
101
170
 
102
171
  ### Template 1: Task Completed
@@ -284,6 +353,9 @@ Each tool's integration layer is responsible for rendering the Navigation Footer
284
353
  | R4 | 1–5 options, adapt to context |
285
354
  | R5 | Use `/command` format when applicable |
286
355
  | R6 | *(Optional)* Append `〔model: Fast\|Standard\|Capable〕` when tier is clear |
356
+ | R7 | *(Optional)* Lead with the finding; evidence follows the claim it supports |
357
+ | R8 | *(Optional)* 3+ turns or 3+ steps → restate state in one line |
358
+ | R9 | *(Optional)* No preamble. Closers still required — see R1 |
287
359
 
288
360
  | Exempt | Not Exempt |
289
361
  |--------|------------|
@@ -307,6 +379,7 @@ Each tool's integration layer is responsible for rendering the Navigation Footer
307
379
 
308
380
  | Version | Date | Changes |
309
381
  |---------|------|---------|
382
+ | 1.2.0 | 2026-08-17 | Add optional R7–R9 governing the answer itself (lead with the finding, restate state, no preamble). Borrowed from `ayghri/i-have-adhd` (MIT), 3 of its 10 rules; the other 7 were dropped as duplicated by R1–R2, in conflict with R1, or covered by estimation-standards. Rules 1–6 could all be satisfied by a response that buries its conclusion — R7–R9 close that |
310
383
  | 1.1.0 | 2026-06-10 | Add R6 optional model tier annotation (`〔model: Fast\|Standard\|Capable〕`); vendor-neutral; no forced changes to existing skills |
311
384
  | 1.0.0 | 2026-03-25 | Initial release |
312
385
 
@@ -1,7 +1,7 @@
1
1
  # Spec-Driven Development (SDD) Standards
2
2
 
3
- **Version**: 2.3.0
4
- **Last Updated**: 2026-06-08
3
+ **Version**: 2.4.0
4
+ **Last Updated**: 2026-08-17
5
5
  **Applicability**: All projects adopting Spec-Driven Development
6
6
  **Scope**: universal
7
7
  **Industry Standards**: None (Emerging 2025+ methodology)
@@ -50,6 +50,61 @@ UDS supports two AC notations. **GWT is the default and preferred** (Forward Der
50
50
 
51
51
  Provide **GWT or EARS** per AC (`.ac.yaml`: `given/when/then` **or** `ears`). Prefer GWT for BDD-derivable behaviour; reach for EARS when GWT feels forced. Do not require both; do not remove GWT.
52
52
 
53
+ ## An AC With No Verification Item Is Not an AC | 沒有驗證項的 AC 不是 AC
54
+
55
+ Every acceptance criterion must have a **verification item that points at it** — a test, a
56
+ check, a gate, or an explicitly recorded manual step. An AC that no verification item
57
+ references is a **promise nobody kept**, and it does not fail loudly: it simply stops being
58
+ true while the spec continues to assert it.
59
+
60
+ 每一條驗收標準都必須有一個**指向它的驗證項**——測試、檢查、閘門,或一則明確記錄的
61
+ 手動步驟。沒有任何驗證項引用的 AC 是**一張沒有人兌現的支票**,而且它不會大聲失敗:
62
+ 它只是安靜地停止成立,而規格繼續宣稱它為真。
63
+
64
+ **Rule**: an AC without a verification item must be **demoted to a design intent**, not
65
+ carried as an AC. Demotion is honest; an unverified AC is not.
66
+ **規則**:沒有驗證項的 AC 必須**降級為設計意圖**,不得繼續掛在 AC 欄。降級是誠實的,
67
+ 未經驗證的 AC 不是。
68
+
69
+ ### The measured instance | 實測案例
70
+
71
+ A 2026-05-14 spec carried `AC-7: the legacy system-report is fully preserved, no
72
+ regression`. Its Test Plan had seven items and **none of them pointed at AC-7**. The
73
+ report's timer was disabled and its deploy function was never called — **from the same day
74
+ the AC was written**. It was found three months later, by accident, while verifying an
75
+ unrelated install.
76
+
77
+ **It was never wired to a check and later came loose. It was never wired at all.**
78
+
79
+ 一份 2026-05-14 的規格寫著 `AC-7:舊版系統報告完整保留(無回歸)`。它的 Test Plan
80
+ 有七項,**沒有一項指向 AC-7**。該報告的 timer 是 disabled、部署函式從未被呼叫——
81
+ **從那條 AC 被寫下的同一天起**。三個月後在驗證另一件無關的安裝時偶然發現。
82
+
83
+ **它不是後來斷線的。它從來沒有被接上過。**
84
+
85
+ ### Why "someone will check it" is not a verification item
86
+
87
+ A verification item must be **executable or recorded**, not implied. "The reviewer will
88
+ notice" is not one, because a reviewer reads the spec — and the spec says the AC holds.
89
+ An AC is a claim **about the world**, and only something that touches the world can
90
+ falsify it.
91
+
92
+ 「有人會檢查」不是驗證項。它必須**可執行或有紀錄**,不能是隱含的。「審查者會注意到」
93
+ 不算——因為審查者讀的是規格,而規格說那條 AC 成立。**AC 是一個關於世界的宣稱,
94
+ 只有碰得到世界的東西才能證偽它。**
95
+
96
+ ### Related | 關聯
97
+
98
+ - [verification-evidence](verification-evidence.md) — VE-011 requires evidence to come from a
99
+ fresh run **after the last edit**; this standard is the upstream question of whether any
100
+ run was ever pointed at the claim in the first place.
101
+ - [class-level-fix](class-level-fix.md) — the same discipline applied to *scope*: traverse the
102
+ set rather than enumerate it.
103
+
104
+ ## What's New in v2.4.0
105
+
106
+ - **An AC with no verification item is not an AC** (XSPEC-380 R5). Every acceptance criterion must have a verification item pointing at it; one that has none is demoted to a design intent rather than carried as an AC. Measured instance: a spec's `AC-7` had no matching Test Plan item, and the thing it protected stopped running **on the day the AC was written** — found three months later by accident. An AC is a claim about the world, and only something that touches the world can falsify it.
107
+
53
108
  ## What's New in v2.3.0
54
109
 
55
110
  - **EARS notation** as an optional AC format (XSPEC-263): 5 EARS templates + `.ac.yaml` `ears` field. GWT remains default & preferred; `given/when/then` relaxed from `required` (backward compatible).
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  source: ../../CHANGELOG.md
3
- source_version: 6.5.0
4
- translation_version: 6.5.0
5
- last_synced: 2026-08-14
3
+ source_version: 6.6.0
4
+ translation_version: 6.6.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  ---
8
8
 
@@ -17,6 +17,18 @@ status: current
17
17
 
18
18
  ## [Unreleased]
19
19
 
20
+ ## [6.6.0] - 2026-08-17
21
+
22
+ ### 新增
23
+
24
+ - **`ai-response-navigation` 1.1.0 → 1.2.0 —— 可选规则 R7–R9,管答案本身**(XSPEC 借鉴 B-10,来源 [`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd),MIT)。规则 1–6 管的是答案**之后**要附什么:导航区块、标记过的推荐、匹配响应类型的模板。**答案本身没有任何规则在管。** 于是一个响应可以把结论埋在一整面证据底下,只要结尾附上正确的导航区块,它仍然满足**本标准的每一条**——而找不到答案的读者,不会因为被告知下一步而得到帮助。
25
+ - **R7 —— 先讲发现,不要先讲过程。** *触发*:回答问题、汇报调查结果、或提出决策的响应。第一行写**查到了什么**或**该做什么**——不是方法、不是把问题复述一遍、不是回答的计划。证据(`file:line`、命令输出、表格、测量数字)是**佐证**,应放在它所支持的论断之后;以证据开场会迫使读者自行重建结论,而那正是他请你做的工作。本条规范的是**顺序**,**不**代表可以省略证据。
26
+ - **R8 —— 每一轮重述进度。** *触发*:跨 3 轮以上的对话,或含 3 个以上步骤的任务。用一行说明工作进行到哪里。不能假设读者能在消息之间记住「我们在 5 步中的第 3 步」,而重述它的成本是一个句子。与模板 4(进行中)互补:**R8 管开头,模板管结尾。**
27
+ - **R9 —— 不要开场白。** *触发*:任何实质性响应。本条把一项既有禁令一般化:[`anti-sycophancy-prompting`](../../core/anti-sycophancy-prompting.md) 已经禁止「以正面肯定开场批评」,但**仅限批评情境**。R9 把同一项禁令扩及每一个实质响应,理由不同——不是为了防拍马屁,而是为了消除它在读者与答案之间制造的延迟。**R9 不适用于结语**;R1 的导航区块要求依然成立。
28
+ - **来源十条只取三条,其余七条的淘汰理由写进标准本文**,不是只写在待办清单里。两条与 R1–R2 重复。三条与本标准或其他标准冲突:它的「不要 recap/不要结语」**与 R1 的导航区块直接矛盾**;它的「列表上限 5 项」会截断证据表格与遍历分母;它的「具体时间估计」已由 [`estimation-standards`](../../core/estimation-standards.md) 涵盖。
29
+ - **可选的语义同 R6**(模型级别标注):采用者不必启用、既有 skill 不需回头补,项目**可以**在自己的配置中把任一条提升为必须。**不可选的是每一条都带有精确的触发条件**——一条松到永远不会启动的规则,与没有这条规则无从分辨,那正是 XSPEC-378 记录的失效模式。
30
+ - **扩充既有标准而非新建一支**:再开一支管「AI 怎么对人类写回答」的标准,会让同一条轴出现两个实现。
31
+
20
32
  ## [6.5.0] - 2026-08-14
21
33
 
22
34
  > ⚠️ **本节简体译文待补。** 本次发布包含两批内容:XSPEC 借鉴 B-01 的五条标准补强
@@ -15,7 +15,7 @@ status: current
15
15
 
16
16
  > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
17
17
 
18
- **版本**: 6.5.0 | **发布日期**: 2026-08-14 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
18
+ **版本**: 6.6.0 | **发布日期**: 2026-08-17 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
19
19
 
20
20
  语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流,确保不同技术栈之间的一致性、质量和可维护性。
21
21
 
@@ -13,7 +13,7 @@ status: current
13
13
  <!-- UDS_SUPPORTED_VERSIONS_START -->
14
14
  | 版本 | 支持状态 |
15
15
  |------|--------|
16
- | 6.5.0 | ✅ 最新正式版 |
16
+ | 6.6.0 | ✅ 最新正式版 |
17
17
  | < 6.0.0 | ❌ 已终止支持 |
18
18
  <!-- UDS_SUPPORTED_VERSIONS_END -->
19
19
 
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  source: ../../../core/ai-response-navigation.md
3
- source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-06-10
3
+ source_version: 1.2.0
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  ---
8
8
 
@@ -10,8 +10,8 @@ status: current
10
10
 
11
11
  > **语言**: [English](../../../core/ai-response-navigation.md) | [繁體中文](../../zh-TW/core/ai-response-navigation.md) | 简体中文
12
12
 
13
- **版本**: 1.1.0
14
- **最后更新**: 2026-06-10
13
+ **版本**: 1.2.0
14
+ **最后更新**: 2026-08-17
15
15
  **适用范围**: 所有使用 AI 辅助开发的项目
16
16
  **范围**: universal
17
17
  **行业标准**: 无(新兴 AI 工具实践)
@@ -27,6 +27,11 @@ status: current
27
27
 
28
28
  **解决方案**:在每个实质性 AI 响应结尾附加标准化的「导航区块」,包含情境模板、推荐标记和弹性选项数量。
29
29
 
30
+ **范围注记(v1.2.0)**:规则 1–6 管的是答案**之后**要附什么。规则 7–9 于 1.2.0 新增、属**可选**,
31
+ 管的是答案本身:先讲发现、每轮重述进度、不要开场白。新增的理由是——
32
+ 一个响应可以满足规则 1–6 的每一条,同时把结论埋起来;
33
+ **而找不到答案的读者,不会因为结尾有一个正确的导航区块被告知下一步而得到帮助。**
34
+
30
35
  ---
31
36
 
32
37
  ## 核心规则
@@ -103,6 +108,61 @@ status: current
103
108
 
104
109
  ---
105
110
 
111
+ ## 导航之前的那个答案(规则 7–9,可选)
112
+
113
+ > **借鉴自**:[`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd)(MIT),十条中取三条。
114
+ > 其余七条删去:两条已被上方规则 1–2 涵盖,五条与本标准冲突
115
+ > (它的「不要 recap/不要结语」与规则 1 的导航区块直接矛盾;它的「列表上限 5 项」
116
+ > 会截断证据表格与遍历分母)或与 [estimation-standards](estimation-standards.md) 重复。
117
+
118
+ **这一节为何存在**:规则 1–6 管的是答案**之后**要附什么,而答案本身没有任何规则在管——
119
+ 一个响应可以把结论埋在一整面证据底下,只要结尾附上正确的导航区块,
120
+ 它仍然满足本标准的每一条。**找不到答案的读者,不会因为被告知下一步而得到帮助。**
121
+
122
+ **这三条是可选的**,语义同规则 6:采用项目不必启用,既有 skill 也不需回头补。
123
+ 项目**可以**在自己的配置中把任一条提升为必须。**不可选的是它们必须有精确的触发条件**——
124
+ 一条松到永远不会启动的规则,与没有这条规则无从分辨。
125
+
126
+ ### 规则 7:先讲发现,不要先讲过程(可选)
127
+
128
+ **触发条件**:回答问题、汇报调查结果、或提出决策的响应。
129
+
130
+ 第一行写**查到了什么**或**该做什么**。不是方法、不是把问题复述一遍、不是回答的计划。
131
+
132
+ 证据——`file:line`、命令输出、表格、测量数字——是**佐证**,应放在它所支持的论断**之后**。
133
+ 以证据开场会迫使读者自行重建结论,而那正是他请你做的工作。
134
+
135
+ | 不要写 | 改写成 |
136
+ |---|---|
137
+ | 「我检查了 44 天、63 个域名的数据,发现……」 | 「那三组查询删掉。它返回的东西有 46% 是下载页。」 |
138
+ | 「让我看看这是怎么配置的。」 | 「配置在 `x.yaml:12`,值是错的,因为……」 |
139
+
140
+ **这不代表可以省略证据**,它规范的是顺序。
141
+
142
+ ### 规则 8:多轮工作中每一轮重述进度(可选)
143
+
144
+ **触发条件**:跨 3 轮以上的对话,或含 3 个以上步骤的任务。
145
+
146
+ 每条响应用一行说明工作进行到哪里。不能假设读者能在消息之间记住
147
+ 「我们在 5 步中的第 3 步」,而重述它的成本是一个句子。
148
+
149
+ 本条与下方模板 4(进行中)互补:**规则 8 管开头,模板 4 管结尾。**
150
+
151
+ ### 规则 9:不要开场白(可选)
152
+
153
+ **触发条件**:任何实质性响应。
154
+
155
+ 从答案开始。不要以「我接下来要做什么」的预告、对请求的确认、或对问题本身的评价开场。
156
+
157
+ 本条把一项既有禁令一般化:[anti-sycophancy-prompting](anti-sycophancy-prompting.md)
158
+ 已经禁止「以正面肯定开场批评」,但**仅限批评情境**。规则 9 把同一项禁令扩及每一个实质响应,
159
+ 理由不同:不是为了防拍马屁,而是为了消除它在读者与答案之间制造的延迟。
160
+
161
+ **规则 9 不适用于结语。** 规则 1 要求的导航区块依然成立——
162
+ 响应的结尾正是本标准安放「读者下一步」的位置。
163
+
164
+ ---
165
+
106
166
  ## 情境模板
107
167
 
108
168
  ### 模板 1:任务完成
@@ -290,6 +350,9 @@ AI 需要用户做出选择或提供信息时使用。
290
350
  | R4 | 1–5 个选项,依情境调整 |
291
351
  | R5 | 适用时使用 `/command` 格式 |
292
352
  | R6 | *(可选)* 级别明确时附加 `〔模型:Fast|Standard|Capable〕` |
353
+ | R7 | *(可选)* 先讲发现;证据放在它所支持的论断之后 |
354
+ | R8 | *(可选)* 跨 3 轮或 3 步以上 → 用一行重述进度 |
355
+ | R9 | *(可选)* 不要开场白。结语仍为必须——见 R1 |
293
356
 
294
357
  | 豁免 | 不豁免 |
295
358
  |------|--------|
@@ -313,6 +376,7 @@ AI 需要用户做出选择或提供信息时使用。
313
376
 
314
377
  | 版本 | 日期 | 变更 |
315
378
  |------|------|------|
379
+ | 1.2.0 | 2026-08-17 | 新增可选规则 R7–R9,管答案本身(先讲发现、重述进度、不要开场白)。借鉴自 `ayghri/i-have-adhd`(MIT),十条取三;其余七条因已被 R1–R2 涵盖、与 R1 冲突、或与 estimation-standards 重复而删去。规则 1–6 全部可以被一个把结论埋起来的响应满足——R7–R9 补上这个缺口 |
316
380
  | 1.1.0 | 2026-06-10 | 新增规则 R6 可选模型级别标注(`〔模型:Fast|Standard|Capable〕`);与厂商无关;不强制既有技能回改 |
317
381
  | 1.0.0 | 2026-03-25 | 初始版本 |
318
382
 
@@ -4,7 +4,7 @@ source_version: 2.3.0
4
4
  translation_version: 2.3.0
5
5
  last_synced: 2026-06-10
6
6
  source_hash: 08dd8c2bee20
7
- status: current
7
+ status: stale
8
8
  ---
9
9
 
10
10
  # 规格驱动开发 (SDD) 标准
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  source: ../../CHANGELOG.md
3
- source_version: 6.5.0
4
- translation_version: 6.5.0
5
- last_synced: 2026-08-14
3
+ source_version: 6.6.0
4
+ translation_version: 6.6.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  ---
8
8
 
@@ -17,6 +17,18 @@ status: current
17
17
 
18
18
  ## [Unreleased]
19
19
 
20
+ ## [6.6.0] - 2026-08-17
21
+
22
+ ### 新增
23
+
24
+ - **`ai-response-navigation` 1.1.0 → 1.2.0 —— 選用規則 R7–R9,管答案本身**(XSPEC 借鑒 B-10,來源 [`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd),MIT)。規則 1–6 管的是答案**之後**要附什麼:導航區塊、標記過的推薦、匹配回應類型的模板。**答案本身沒有任何規則在管。** 於是一個回應可以把結論埋在一整面證據底下,只要結尾附上正確的導航區塊,它仍然滿足**本標準的每一條**——而找不到答案的讀者,不會因為被告知下一步而得到幫助。
25
+ - **R7 —— 先講發現,不要先講過程。** *觸發*:回答問題、回報調查結果、或提出決策的回應。第一行寫**查到了什麼**或**該做什麼**——不是方法、不是把問題複述一遍、不是回答的計畫。證據(`file:line`、指令輸出、表格、量測數字)是**佐證**,應放在它所支持的主張之後;以證據開場會迫使讀者自行重建結論,而那正是他請你做的工作。本條規範的是**順序**,**不**代表可以省略證據。
26
+ - **R8 —— 每一輪重述進度。** *觸發*:跨 3 輪以上的對話,或含 3 個以上步驟的任務。用一行說明工作進行到哪裡。不能假設讀者能在訊息之間記住「我們在 5 步中的第 3 步」,而重述它的成本是一個句子。與模板 4(進行中)互補:**R8 管開頭,模板管結尾。**
27
+ - **R9 —— 不要開場白。** *觸發*:任何實質性回應。本條把一項既有禁令一般化:[`anti-sycophancy-prompting`](../../core/anti-sycophancy-prompting.md) 已經禁止「以正面肯定開場批評」,但**僅限批評情境**。R9 把同一項禁令擴及每一個實質回應,理由不同——不是為了防拍馬屁,而是為了消除它在讀者與答案之間製造的延遲。**R9 不適用於結語**;R1 的導航區塊要求依然成立。
28
+ - **來源十條只取三條,其餘七條的淘汰理由寫進標準本文**,不是只寫在待辦清單裡。兩條與 R1–R2 重複。三條與本標準或其他標準衝突:它的「不要 recap/不要結語」**與 R1 的導航區塊直接矛盾**;它的「清單上限 5 項」會切斷證據表格與走訪分母;它的「具體時間估計」已由 [`estimation-standards`](../../core/estimation-standards.md) 涵蓋。
29
+ - **選用的語義同 R6**(模型級別標注):採用者不必啟用、既有 skill 不需回頭補,專案**可以**在自己的設定中把任一條提升為必須。**不可選的是每一條都帶有精確的觸發條件**——一條鬆到永遠不會啟動的規則,與沒有這條規則無從分辨,那正是 XSPEC-378 記錄的失效模式。
30
+ - **擴充既有標準而非新建一支**:再開一支管「AI 怎麼對人類寫回答」的標準,會讓同一條軸出現兩個實作。
31
+
20
32
  ## [6.5.0] - 2026-08-14
21
33
 
22
34
  ### 新增
@@ -15,7 +15,7 @@ status: current
15
15
 
16
16
  > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
17
17
 
18
- **版本**: 6.5.0 | **發布日期**: 2026-08-14 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
18
+ **版本**: 6.6.0 | **發布日期**: 2026-08-17 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
19
19
 
20
20
  語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
21
21
 
@@ -13,7 +13,7 @@ status: current
13
13
  <!-- UDS_SUPPORTED_VERSIONS_START -->
14
14
  | 版本 | 支援狀態 |
15
15
  |------|--------|
16
- | 6.5.0 | ✅ 最新正式版 |
16
+ | 6.6.0 | ✅ 最新正式版 |
17
17
  | < 6.0.0 | ❌ 已終止支援 |
18
18
  <!-- UDS_SUPPORTED_VERSIONS_END -->
19
19
 
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  source: ../../../core/ai-response-navigation.md
3
- source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-06-10
3
+ source_version: 1.2.0
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  ---
8
8
 
@@ -10,8 +10,8 @@ status: current
10
10
 
11
11
  > **語言**: [English](../../../core/ai-response-navigation.md) | 繁體中文 | [简体中文](../../zh-CN/core/ai-response-navigation.md)
12
12
 
13
- **版本**: 1.1.0
14
- **最後更新**: 2026-06-10
13
+ **版本**: 1.2.0
14
+ **最後更新**: 2026-08-17
15
15
  **適用範圍**: 所有使用 AI 輔助開發的專案
16
16
  **範圍**: universal
17
17
  **產業標準**: 無(新興 AI 工具實踐)
@@ -27,6 +27,11 @@ status: current
27
27
 
28
28
  **解決方案**:在每個實質性 AI 回應結尾附加標準化的「導航區塊」,包含情境模板、推薦標記和彈性選項數量。
29
29
 
30
+ **範圍註記(v1.2.0)**:規則 1–6 管的是答案**之後**要附什麼。規則 7–9 於 1.2.0 新增、屬**選用**,
31
+ 管的是答案本身:先講發現、每輪重述進度、不要開場白。新增的理由是——
32
+ 一個回應可以滿足規則 1–6 的每一條,同時把結論埋起來;
33
+ **而找不到答案的讀者,不會因為結尾有一個正確的導航區塊被告知下一步而得到幫助。**
34
+
30
35
  ---
31
36
 
32
37
  ## 核心規則
@@ -103,6 +108,61 @@ status: current
103
108
 
104
109
  ---
105
110
 
111
+ ## 導航之前的那個答案(規則 7–9,選用)
112
+
113
+ > **借鑒自**:[`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd)(MIT),十條中取三條。
114
+ > 其餘七條刪去:兩條已被上方規則 1–2 涵蓋,五條與本標準衝突
115
+ > (它的「不要 recap/不要結語」與規則 1 的導航區塊直接矛盾;它的「清單上限 5 項」
116
+ > 會切斷證據表格與走訪分母)或與 [estimation-standards](estimation-standards.md) 重複。
117
+
118
+ **這一節為何存在**:規則 1–6 管的是答案**之後**要附什麼,而答案本身沒有任何規則在管——
119
+ 一個回應可以把結論埋在一整面證據底下,只要結尾附上正確的導航區塊,
120
+ 它仍然滿足本標準的每一條。**找不到答案的讀者,不會因為被告知下一步而得到幫助。**
121
+
122
+ **這三條是選用的**,語義同規則 6:採用專案不必啟用,既有 skill 也不需回頭補。
123
+ 專案**可以**在自己的設定中把任一條提升為必須。**不可選的是它們必須有精確的觸發條件**——
124
+ 一條鬆到永遠不會啟動的規則,與沒有這條規則無從分辨。
125
+
126
+ ### 規則 7:先講發現,不要先講過程(選用)
127
+
128
+ **觸發條件**:回答問題、回報調查結果、或提出決策的回應。
129
+
130
+ 第一行寫**查到了什麼**或**該做什麼**。不是方法、不是把問題複述一遍、不是回答的計畫。
131
+
132
+ 證據——`file:line`、指令輸出、表格、量測數字——是**佐證**,應放在它所支持的主張**之後**。
133
+ 以證據開場會迫使讀者自行重建結論,而那正是他請你做的工作。
134
+
135
+ | 不要寫 | 改寫成 |
136
+ |---|---|
137
+ | 「我檢查了 44 天、63 個網域的資料,發現……」 | 「那三組查詢刪掉。它回傳的東西有 46% 是下載頁。」 |
138
+ | 「讓我看看這是怎麼設定的。」 | 「設定在 `x.yaml:12`,值是錯的,因為……」 |
139
+
140
+ **這不代表可以省略證據**,它規範的是順序。
141
+
142
+ ### 規則 8:多輪工作中每一輪重述進度(選用)
143
+
144
+ **觸發條件**:跨 3 輪以上的對話,或含 3 個以上步驟的任務。
145
+
146
+ 每則回應用一行說明工作進行到哪裡。不能假設讀者能在訊息之間記住
147
+ 「我們在 5 步中的第 3 步」,而重述它的成本是一個句子。
148
+
149
+ 本條與下方模板 4(進行中)互補:**規則 8 管開頭,模板 4 管結尾。**
150
+
151
+ ### 規則 9:不要開場白(選用)
152
+
153
+ **觸發條件**:任何實質性回應。
154
+
155
+ 從答案開始。不要以「我接下來要做什麼」的預告、對請求的確認、或對問題本身的評價開場。
156
+
157
+ 本條把一項既有禁令一般化:[anti-sycophancy-prompting](anti-sycophancy-prompting.md)
158
+ 已經禁止「以正面肯定開場批評」,但**僅限批評情境**。規則 9 把同一項禁令擴及每一個實質回應,
159
+ 理由不同:不是為了防拍馬屁,而是為了消除它在讀者與答案之間製造的延遲。
160
+
161
+ **規則 9 不適用於結語。** 規則 1 要求的導航區塊依然成立——
162
+ 回應的結尾正是本標準安放「讀者下一步」的位置。
163
+
164
+ ---
165
+
106
166
  ## 情境模板
107
167
 
108
168
  ### 模板 1:任務完成
@@ -290,6 +350,9 @@ AI 需要使用者做出選擇或提供資訊時使用。
290
350
  | R4 | 1–5 個選項,依情境調整 |
291
351
  | R5 | 適用時使用 `/command` 格式 |
292
352
  | R6 | *(選用)* 等級明確時附加 `〔模型:Fast|Standard|Capable〕` |
353
+ | R7 | *(選用)* 先講發現;證據放在它所支持的主張之後 |
354
+ | R8 | *(選用)* 跨 3 輪或 3 步以上 → 用一行重述進度 |
355
+ | R9 | *(選用)* 不要開場白。結語仍為必須——見 R1 |
293
356
 
294
357
  | 豁免 | 不豁免 |
295
358
  |------|--------|
@@ -313,6 +376,7 @@ AI 需要使用者做出選擇或提供資訊時使用。
313
376
 
314
377
  | 版本 | 日期 | 變更 |
315
378
  |------|------|------|
379
+ | 1.2.0 | 2026-08-17 | 新增選用規則 R7–R9,管答案本身(先講發現、重述進度、不要開場白)。借鑒自 `ayghri/i-have-adhd`(MIT),十條取三;其餘七條因已被 R1–R2 涵蓋、與 R1 衝突、或與 estimation-standards 重複而刪去。規則 1–6 全部可以被一個把結論埋起來的回應滿足——R7–R9 補上這個缺口 |
316
380
  | 1.1.0 | 2026-06-10 | 新增規則 R6 選用模型級別標注(`〔模型:Fast|Standard|Capable〕`);與廠商無關;不強制既有技能回改 |
317
381
  | 1.0.0 | 2026-03-25 | 初始版本 |
318
382
 
@@ -4,7 +4,7 @@ source_version: 2.3.0
4
4
  translation_version: 2.3.0
5
5
  last_synced: 2026-06-10
6
6
  source_hash: 08dd8c2bee20
7
- status: current
7
+ status: stale
8
8
  ---
9
9
 
10
10
  # 規格驅動開發 (SDD) 標準
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "universal-dev-standards",
3
- "version": "6.5.0",
3
+ "version": "6.6.0",
4
4
  "description": "CLI tool for adopting Universal Development Standards",
5
5
  "keywords": [
6
6
  "documentation",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "version": "6.5.0",
3
+ "version": "6.6.0",
4
4
  "lastUpdated": "2026-05-13",
5
5
  "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
6
6
  "formats": {
@@ -58,14 +58,14 @@
58
58
  "standards": {
59
59
  "name": "universal-dev-standards",
60
60
  "url": "https://github.com/AsiaOstrich/universal-dev-standards",
61
- "version": "6.5.0"
61
+ "version": "6.6.0"
62
62
  },
63
63
  "skills": {
64
64
  "name": "universal-dev-standards",
65
65
  "url": "https://github.com/AsiaOstrich/universal-dev-standards",
66
66
  "localPath": "skills",
67
67
  "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
68
- "version": "6.5.0",
68
+ "version": "6.6.0",
69
69
  "note": "Skills are now included in the main repository under skills/"
70
70
  }
71
71
  },
@@ -2260,7 +2260,7 @@
2260
2260
  "id": "license-compliance",
2261
2261
  "name": "License Compliance Standards",
2262
2262
  "nameZh": "授權合規標準",
2263
- "version": "6.5.0",
2263
+ "version": "6.6.0",
2264
2264
  "source": {
2265
2265
  "human": "core/license-compliance.md",
2266
2266
  "ai": "ai/standards/license-compliance.ai.yaml"
@@ -2272,7 +2272,7 @@
2272
2272
  "id": "verification-oracle",
2273
2273
  "name": "Verification Oracle Standards",
2274
2274
  "nameZh": "驗證 Oracle 標準",
2275
- "version": "6.5.0",
2275
+ "version": "6.6.0",
2276
2276
  "source": {
2277
2277
  "human": "core/verification-oracle.md",
2278
2278
  "ai": "ai/standards/verification-oracle.ai.yaml"
@@ -2284,7 +2284,7 @@
2284
2284
  "id": "model-provenance",
2285
2285
  "name": "Model Provenance Policy Standards",
2286
2286
  "nameZh": "模型來源政策標準",
2287
- "version": "6.5.0",
2287
+ "version": "6.6.0",
2288
2288
  "source": {
2289
2289
  "human": "core/model-provenance.md",
2290
2290
  "ai": "ai/standards/model-provenance.ai.yaml"
@@ -2296,7 +2296,7 @@
2296
2296
  "id": "resource-cost-boundary",
2297
2297
  "name": "Resource / Cost Boundary Declaration Standards",
2298
2298
  "nameZh": "資源/成本邊界宣告標準",
2299
- "version": "6.5.0",
2299
+ "version": "6.6.0",
2300
2300
  "source": {
2301
2301
  "human": "core/resource-cost-boundary.md",
2302
2302
  "ai": "ai/standards/resource-cost-boundary.ai.yaml"