universal-dev-standards 6.7.5 → 6.9.0

package/bundled/locales/zh-CN/core/governance-layer.md

@@ -1,9 +1,9 @@
 ---
 source: ../../../core/governance-layer.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-10
-source_hash: faff51e79a15
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-08-20
+source_hash: 15ca18717240
 status: current
 ---
 
@@ -11,8 +11,8 @@ status: current
 
 > **语言**: [English](../../../core/governance-layer.md) | [繁體中文](../../zh-TW/core/governance-layer.md) | 简体中文
 
-**版本**: 1.0.0
-**最后更新**: 2026-05-07
+**版本**: 1.1.0
+**最后更新**: 2026-08-20
 **适用范围**: 所有具有多 Agent 或多角色 AI 工作流程的软件项目
 **范畴**: universal
 **产业标准**: 无（UDS 原创）
@@ -131,9 +131,79 @@ Vision（方向）→ Mission（边界 + 红线）→ Goals（可量测的 KPI
 | `signatory` | 接受风险的人员或角色 |
 | `gates_bypassed` | 列举所有绕过的人工闸门 |
 | `risks_accepted` | 明确描述已接受的风险 |
+| `review_by` | 本次接受失效、必须重新做一次判断的日期 |
 
 若无有效的风险接受条款，pipeline **必须拒绝启动（fail-closed）**。
 
+### 接受到期
+
+`review_by` 已过的条款**不是有效条款**。pipeline 必须 fail closed，与完全没有条款时一模一样。
+
+`date` 记录的是「何时接受了这个风险」，不是「何时该重新判断」。没有 `review_by`，签过一次的接受就永远有效——当初支持它的条件可能已经改变、签署人可能已经离开项目，而条款里每一个字段读起来仍然完全正确。
+
+到期时，必须施用且只能施用下列三种处置之一，与[技术债标准 → 到期处置](tech-debt-standards.md#到期处置)所定义的三种相同：
+
+| 处置 | 含义 |
+|------|------|
+| **重新接受** | 由当下的签署人重新签署，并给出新的 `review_by` |
+| **撤销** | 移除该绕过，恢复人工闸门 |
+| **延期** | 新的 `review_by` **与**书面理由，一起记下 |
+
+**禁止自动延长 `review_by`。** 那会把一道 fail-closed 的闸门变成 fail-open，而所有字段看起来都还是对的——失效之所以隐形，正是因为条款仍然验证得过。
+
+---
+
+## 待裁决事项
+
+「还没决定」是一种治理状态，不是治理的缺席。规格里的未决问题、提出但未批准的红线、没有 owner 的 KPI——每一项都是有人被期待要做的决定，而每一项对「只读已做成决定」的检查都是隐形的。
+
+待裁决事项与已接受风险**同级受治理**：它们带时钟，而且必须可被列举。
+
+**规则 GOV-PD-001（必要）**——项目必须声明待裁决事项**记在哪里**，以及**什么标记代表一项待裁决**：一个固定的 token（状态值、标签、字面标记字符串），不得是自由书写的散文。列举不该取决于读者猜中当初用了哪些字。三份分别写「TBD」「待拍板」「待确认」的文件，是三份无法被列举的文件；一个声明过的标记让三份都找得到。
+
+**规则 GOV-PD-002（必要）**——列举待裁决事项时，必须同时报告总数**与**无法解析的来源份数（见[汇总报告](#汇总报告)）。「查无待裁决事项」在不知道走访集合有多大时，不带任何信息。
+
+**规则 GOV-PD-003（必要）**——每一项待裁决事项都带一个**裁决期限日期**。到期时适用与逾期技术债相同的三种处置——**做出决定**、**撤回这个问题**、或**延期并写明理由**。禁止自动延期。
+
+**规则 GOV-PD-004（必要）**——若没有任何东西在排程上列举待裁决事项，项目必须带一份**无人看管声明**，写明负责人、复查频率与最后复查日期——与技术债登记表被要求的两态规则相同。没有被列举是可接受的；没有被列举又没有声明则不可接受。
+
+> 一项没有日期的待裁决事项，在行为上与「决定不做」完全相同。差别只在于待裁决的形式让人以为还有人会去看它。
+
+---
+
+## 汇总报告
+
+每一份治理报告——合规摘要、闸门报告、KPI 汇总、红线扫描——都是对某个集合提出的宣称。这个宣称的价值，恰好等于它对「自己判不了什么」的交代的价值。
+
+**规则 GOV-RPT-001（必要）**——报告必须打印三个数字，不能只打印两个：**通过**、**失败**、**判不了**（无法解析的文件、缺字段、来源不可达、不支持的格式）。
+
+**规则 GOV-RPT-002（必要）**——「判不了」**不得**并入「通过」，也**不得**省略。一份解析不了的文件不是一份干净的文件。只打印「N 项检查通过」的报告，不论 N 是多少都不合规。
+
+**规则 GOV-RPT-003（必要）**——报告必须写出自己的**分母**以及分母是怎么推导出来的。范围来自硬编码清单的报告，是一份关于那份清单的报告，不是关于这个项目的报告：清单之外的东西全部腐坏，它照样是绿的。要用「走访并排除」推导集合，不要用列举——见[类别层级修正](../../../core/class-level-fix.md)。
+
+**规则 GOV-RPT-004（必要）**——正向与负向计数分开报告；绝不合并成单一的合规分数。**一个「什么都不做」与「把工作做完」得分相同的指标，量的不是那份工作。**「11 项中通过 5 项」与「检查器从未启动」产生同一个数字，而单一分数分不出这两者。
+
+**规则 GOV-RPT-005（建议）**——当报告的正确性取决于它自己的工具能运作时，加一只金丝雀：一个输入已知会失败、因此**必须**失败的检查。若金丝雀通过了，整份报告不可信，必须整份报告为「判不了」，而不是绿灯。
+
+---
+
+## 新鲜度指标
+
+**规则 GOV-FRESH-001（必要）**——任何新鲜度／停滞指标都必须指名它读的是下列哪一个时钟：
+
+| 时钟 | 回答的问题 | 可以从哪里读 |
+|------|-----------|-------------|
+| **编辑时间** | 这份产物上次被改动是多久以前？ | 文件 mtime、最后动到它的 commit、「最后更新」字段 |
+| **对账时间** | 这份产物上次与它宣称在描述的真实来源做比对是多久以前？ | 那次比对被记下的日期——没有别的东西能提供它 |
+
+**规则 GOV-FRESH-002（必要）**——两者**不得**共用同一个字段或同一个字段标题。它们回答不同的问题，而同一份产物可以在其中一个上满分、在另一个上任意地旧：一份今天刚编辑、内容从未与现实对过的文件，以编辑时间算是零天，以对账时间算是无上限。
+
+**规则 GOV-FRESH-003（必要）**——只有编辑时间可取得时，报告必须把该栏标示为编辑时间，**并且**把对账时间报告为「判不了」（GOV-RPT-001）——绝不能标成新鲜，也绝不能省略不提。
+
+**规则 GOV-FRESH-004（建议）**——对账时间只有在「由执行该比对的东西自己记下」时才有意义。事后由人手动填入的日期是一项断言，不是一次量测；请如实标示。
+
+> 这是「单轴装多维」的失败：一个字段，被两个不同的问题读取。这个字段永远不会被抓到是错的，因为从来没有人问过它在回答哪一个问题。
+
 ---
 
 ## 治理文件结构
@@ -157,4 +227,46 @@ governance/
 - [ ] Goals 清单存在，每个 KPI 均含：id、metric_name、threshold、measurement_method
 - [ ] 没有任何 KPI 使用模糊词汇（「改善」、「提升」、「更好」）
 - [ ] 若 `gate.mode = trace_only`，`mission.md` 中存在风险接受条款
+- [ ] 每一份风险接受条款都有 `review_by` 日期，且没有任何一份已经过期
+- [ ] 项目已声明待裁决事项记在哪里、以及哪一个固定标记代表一项待裁决
+- [ ] 每一项待裁决事项都有裁决期限日期
+- [ ] 待裁决事项要么被某个会执行的东西列举，要么被无人看管声明涵盖
+- [ ] 每一份治理报告都分开打印「通过／失败／**判不了**」，并写出分母与分母的推导方式
+- [ ] 没有任何报告把正向与负向计数合并成单一分数
+- [ ] 每一个新鲜度指标都指名自己读的是编辑时间或对账时间，且两者不共用字段
 - [ ] 所有 AI 评估器以 0.4/0.3/0.3 权重评分，且任一轴 < 0.3 即不通过
+
+---
+
+## 执行现实
+
+> **本标准对它的任何一条规则都不提供检查器——不只是 1.1.0 新增的那些，也包括自 1.0.0 起就在里面的那条 fail-closed 风险接受要求。这是已知代价，写在这里，而不是留给采用者自己撞到。**
+> 
+> 2026-08-20 实测：`review_by`、`risks_accepted`、`gates_bypassed` **没有出现在任何程序里**——UDS CLI 没有，任何消费端也没有。那句写着 pipeline「必须拒绝启动」的条款，在它被写下来的三个半月里，**从来没有让任何一条 pipeline 拒绝启动过**。把这件事讲明白不是外加的但书，它就是本节自己的规则套用在本节身上；而本节的初稿只列出新规则为未执行，那会让人以为旧的那条有在执行。
+>
+> UDS 定义的是这些要求，它不提供执行这些要求的程序。想要它们被执行的采用者必须自己写那支列举器、那支三态计数报告器、那个对账日期记录器——而多数人不会写。那正是本标准所描述的失败，现在同样适用于本标准自己。
+>
+> 所以最低标准**不是**「去把工具做出来」，而是：**任何被记载为待裁决、已接受、或新鲜的东西，要么指向一个会执行的检查，要么明白说出没有东西在看它。** 声明「无人看管」是合规的。无人看管却不声明，才是这些规则真正禁止的唯一结果，因为只有它会让读者对「有没有东西在看」产生误解。
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.1.0 | 2026-08-20 | 新增：风险接受条款的 `review_by` 字段 + 接受到期的三种处置与禁止自动延期；待裁决事项（GOV-PD-001..004）；汇总报告（GOV-RPT-001..005——通过／失败／判不了、分母推导、不得合并成单一分数、金丝雀）；新鲜度指标（GOV-FRESH-001..004——编辑时间与对账时间不得共用字段）；执行现实说明；合规检查清单扩充 |
+| 1.0.0 | 2026-05-07 | 初始版本：Vision/Mission/Goals 三层架构、红线格式、评估器整合、风险接受条款、合规检查清单 |
+
+---
+
+## 相关标准
+
+- [技术债标准](tech-debt-standards.md) — 「到期处置」定义了本标准沿用的三种处置
+- [类别层级修正](../../../core/class-level-fix.md) — 以走访并排除而非列举推导集合（GOV-RPT-003）
+- [验证证据](verification-evidence.md) — 为何绿灯必须被证明来自一个真的在运作的检查（GOV-RPT-005）
+
+---
+
+## 授权
+
+本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。

package/bundled/locales/zh-CN/core/retrospective-standards.md

@@ -3,7 +3,7 @@ source: ../../../core/retrospective-standards.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-03-26
-status: current
+status: stale
 ---
 
 # 回顾标准

package/bundled/locales/zh-CN/core/tech-debt-standards.md

@@ -1,14 +1,14 @@
 ---
 source: ../../../core/tech-debt-standards.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-04-10
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-08-20
 status: current
 ---
 
 # 技术债管理标准
 
-> 版本: 1.0.0 | 最后更新: 2026-04-01
+> 版本: 1.1.0 | 最后更新: 2026-08-20
 
 ## 概述
 
@@ -48,6 +48,73 @@ status: current
 | 10 | **Created Date** | 登记日期 |
 | 11 | **Target Resolution Date** | 计划解决日期 |
 
+### 登记表存储选项
+
+登记表可存放于下列任一位置，但每个选项**只有在同时满足右栏的到期检查条件时才合法**：
+
+| 选项 | 适用对象 | 到期检查条件 |
+|------|---------|-------------|
+| `docs/tech-debt-registry.md` | 小型团队 | 有一支 repo 检查会解析该表格，并在有行超过 Target Resolution Date 时失败——**或**该文件带有「无人看管声明」 |
+| Issue tracker（GitHub Issues、Jira） | 较大团队 | 有一个排程查询实际会**执行**并发出告警；没有人打开的保存查询不算检查——**或**带有「无人看管声明」 |
+| 专用电子表格 | 非技术利益相关者 | 仅当该表以明确频率导出到某个会被检查读取的位置时才合法——**或**带有「无人看管声明」 |
+
+> **这一栏为什么必须加。** 一份没有任何程序读得到的登记表，满足本节其余每一条要求：11 个字段齐全、有 Owner、有 Target Resolution Date。它没有任何地方是错的——直到日期过了，然后什么都没发生。电子表格选项**刻意不移除**（电子表格常是出钱的人唯一会打开的格式）；不再合法的是「任何一种存储方式成为日期无声过期的地方」。
+
+### 到期处置
+
+一个过了却没有任何后果的 **Target Resolution Date**，与根本没有日期无从分辨。本小节定义「日期到了」是什么意思。
+
+#### 三种合法处置
+
+项目到达 Target Resolution Date 时，必须发生且只能发生下列三者之一，并且必须留下痕迹：
+
+| 处置 | 含义 | 必留痕迹 |
+|------|------|---------|
+| **做掉（Resolve）** | 把事情做完 | 关闭登记项 + `Tech-Debt: TD-NNN resolved` commit footer |
+| **撤销（Withdraw）** | 决定不做，并删掉这条记载 | 标记为撤销，附理由与日期。它不再被计为技术债，因为它已经不是了 |
+| **延期（Extend）** | 设定新的 Target Resolution Date | 新日期**与**书面理由必须一起记下；先前的日期保持可见（用追加，不要覆盖） |
+
+没有第四种处置。「仍然开着、日期过了、没有人看」不是本标准允许的状态——那正是本小节存在要指名的失败。
+
+**规则 TD-EXP-001（必要）**——项目超过 Target Resolution Date 而三种处置皆未施用，该登记表即不合规。到期是一个发现，不是中性的背景状态。
+
+**规则 TD-EXP-002（必要，禁止事项）**——到期**不得**被实现成**自动延期**或**自动关闭**。
+
+- 自动延期使日期变得不可证伪：它永远不会被错过，所以它从未量到任何东西。
+- 自动关闭在没有任何人做出决定的情况下删掉了那条记载。
+
+两者都让时钟停止，且都不留下「时钟停了」的痕迹。一个唯一的消费者是「把它往后推的排程」的日期，只是装饰。
+
+**规则 TD-EXP-003（必要）**——延期时理由必须记在新日期旁边。只改日期不是延期，那是一次盖了时间戳的删除。
+
+**规则 TD-EXP-004（建议）**——被延期三次以上、期间没有记录任何进度的项目，应重新分流为**撤销**候选。反复延期是「没有人打算做这件事」的证据；老实记下这件事，比第四个日期对下一位读者更有用。
+
+#### 无人看管声明
+
+不是每个团队都有能力跑一支检查。**没有自动到期检查的登记表仍然合规——但前提是它把这件事写出来。**
+
+「无人看管声明」是写在登记表内部、可见且带日期的一段陈述：
+
+```
+无人看管——没有任何自动检查在读这份登记表的到期项目。
+由 <负责人> 以 <频率> 人工复查。最后复查日期：<日期>。
+```
+
+**规则 TD-EXP-005（必要）**——登记表必须处于下列两种状态之一，且必须让读者看得到它处于哪一种：
+
+1. **已受检（Checked）**——有一支具名、跑得起来的检查在读这份登记表，并在项目超过 Target Resolution Date 时失败。
+2. **无人看管（Unattended）**——没有这样的检查，但带有无人看管声明，且声明中写明负责人、复查频率与最后复查日期。
+
+两种状态都不处于的登记表即为不合规。这份声明不是形式：它就是「知道没有东西在看的读者」与「以为有东西在看的读者」之间的全部差别。
+
+**规则 TD-EXP-006（必要）**——无人看管声明里的「最后复查日期」本身，受该声明自己所写的频率约束。最后复查日期比自己声明的频率还旧的声明，本身就是一个到期项目，三种处置同样适用于它。
+
+> **本标准不提供任何检查器，这是已知代价——写在这里，而不是留给采用者自己撞到。**
+>
+> UDS 定义的是要求，它不提供一支执行该要求的程序。想要**已受检**状态的采用者必须自己写那支检查，而多数团队不会写——那正是上面描述的失败模式，现在同样适用于本小节自己。
+>
+> 所以这里的最低标准**不是**「去建一支检查器」，而是**「绝不让一份登记表在无声中变成无人看管」**。声明 `无人看管` 只要一段文字，而且完全合规。无人看管**却不声明**才是本标准真正禁止的唯一结果，因为只有它会让读者对「有没有东西在看」产生误解。
+
 ## 3. 预算分配
 
 | 团队状态 | 预算 | 说明 |

package/bundled/locales/zh-CN/core/turn-completion-integrity.md

@@ -0,0 +1,190 @@
+---
+source: ../../../core/turn-completion-integrity.md
+source_version: 1.3.0
+translation_version: 1.3.0
+last_synced: 2026-09-08
+source_hash: c396baa28423
+status: current
+---
+
+# 回合收尾完整性
+
+> **语言**: [English](../../../core/turn-completion-integrity.md) | [繁體中文](../../zh-TW/core/turn-completion-integrity.md) | 简体中文
+
+**版本**: 1.3.0
+**最后更新**: 2026-09-08
+**适用范围**: 任何由 agent 结束回合、把控制权交还给人的执行环境
+**Scope**: universal
+**行业标准**: 不声称任何来源——由实际观察到的失败归纳，见「证据」
+
+---
+
+## 目的
+
+agent 写下「我接着做 X」，然后结束回合，而 X 没有做。
+
+人读到的是一句描述着从未发生的工作的话。没有任何错误、没有任何检查变红，
+对话记录读起来像有进展。下一个回合从一个「人以为比实际更靠前」的状态开始。
+
+这不是知识上的失败——agent 说对了下一步。这是**收尾**的失败：
+回合结束在工作本该开始的那一刻。
+
+---
+
+## 规则
+
+**R1.** 若 agent 最后一条消息做出了第一人称的下一步声明，
+回合**不得**结束，除非那件事做了，或说出它卡在什么。
+
+**R2.** 「卡在什么」的意思是逐项指名每一件事在等谁、等什么。
+「主要的都做完了」不是阻塞点陈述；
+「部署等你的密钥，文档不卡任何人而我现在就做」才是。
+
+**R3.** 只写在 agent 指令里的规则不是执法。R1 必须**在回合结束的那一刻**、
+由**不是 agent 的东西**来判断。
+
+---
+
+## R3 为什么存在
+
+这条规则的指令形式曾写进某项目的 agent 指令，
+而**在读到它的同一个 session 内就被违反**。
+接着它被写成已发布的标准、标为 optional、没有任何检查器在读，
+七天后同样的违反再来一次。
+
+指令是一种输入。失败发生在一个决策点——「我正要结束这个回合」——
+而一个在那一刻不会被读到的输入，就是没有在生效。
+一般形式是：**一项有文档而在其决策点上没有执法的要求，是建议；
+它的遵循度不是很高，是没有被量过。**
+
+---
+
+## 这个检查**不得**做的事
+
+**R4. 不得因为「永远还有待办」而拦截。** 仓库永远有未关闭的 TODO，
+待办清单永远有条目。一道每个回合都为真的闸门会被关掉，然后它什么都不保护。
+这个检查**只**在 agent 于那条消息里做出的声明上触发。
+
+**R5. 一律 fail open。** 任何错误——读不到对话记录、字段缺失、JSON 损坏、
+结构不符——都**必须**让回合结束。一个会把 session 困住的 hook 比没有 hook 更糟，
+因为人唯一的补救手段是把它关掉，而他会永久关掉它。
+
+**R6. 拦截要有上界。** 检查**必须**同时具备
+(a) 两次拦截之间的冷却期，与
+(b) **滚动时间窗**内的拦截次数上限。
+
+以 session 计且永不重置的上限不是安全阀——它是一个有延迟的关闭开关，
+而且会在「这条规则最重要的那种长 session」里悄无声息地自我解除。
+
+---
+
+## 使用者可以结束回合，而 agent 的用词说不出这件事
+
+**R9.** 检查**必须**豁免由人要求结束的回合，
+而且**必须**从人自己最近一条消息判断，不是从 agent 的消息判断。
+
+这条规则的存在是因为它的缺席被量到过一次——就在本标准上线后的第一次真实触发。
+人写的是「先暂停，我要回家了」；agent 照做并列出回来要接的事；
+检查把它读成未兑现的承诺并拦下。
+
+检测器对模式的判断没有错。**由指令结束的回合，与由未兑现承诺结束的回合，
+在 agent 的用词上一模一样**，因为两种情况下 agent 都在指名自己现在不做的工作。
+那条消息里没有任何东西分得出来，所以只读那条消息的检查也分不出来。
+
+**R10.** 叫停模式**必须**写窄，而且它的语料**必须**包含
+「只是含有停止字眼的工作指令」。误豁免不是漏拦一次，
+而是把检查在该 session 的剩余时间全部静音。
+实现期间该模式曾匹配到「先停用那份硬编码清单，改成遍历注册表」
+——一句要求做事的指令，被读成叫停。
+
+**R11.** 检查自己的拦截消息会以人的回合回到对话记录。
+它**必须**认得出自己的输出，并在寻找人的最后一条消息时跳过它。
+
+没有这一条，R9 只会生效一次。拦截消息会在下一次执行成为「人最近一条消息」，
+真正那句叫停被盖在它后面，豁免就消失——而且是悄无声息地、
+只在它被建立的那种情境里消失。
+
+这与「检测器匹配到解释它的散文」同一族，再往前一步：**检查读到自己的输出。**
+在拦截消息里带一个固定标记字符串，跳过任何含有它的人类回合。
+
+**R12.** 检查**必须**认得出 R2 所定义的那个结束方式。
+一个执行 R2 却看不见逐项阻塞点清单的检查，会拦下标准自己要求的唯一停法
+——它在惩罚正确行为，而那比漏抓一次违规更快被卸载。
+
+识别需要三个条件，实测拿掉任何一个都会坏：
+
+| 条件 | 为什么 |
+|---|---|
+| 两项以上的清单 | 只有一项带归属的是句子，不是逐项列出 |
+| 归属词出现在消息任何位置，不要求每项都有 | 真实写法把它放在前言——「剩下的每一项都卡在你手上，逐项列：」——而要求每项都有，第一次拿真实消息一比就漏 |
+| 没有含糊的完成语 | 「其余都做完了」正是 R2 拒绝的摘要；靠这种句子把剩下的带过的清单，是穿着清单外衣的摘要 |
+
+🔴 **归属词的搜索必须排除检查自己的结构。**
+「要你决定什么」这个标题本身含有「要你」，于是一份「已经做完了什么」的清单，
+靠着它上方的标题就满足了归属条件。**检测器读到了自己的结构**——与 R11 同一个失败，低一层。
+
+---
+
+## 语言覆盖是正确性问题，不是翻译工作
+
+这个检查读的是 agent 写的散文，所以**它的检测器与语言绑定**。
+一个只带着某一种语言模式的检测器，交付给以另一种语言工作的采用者，
+会得到一个装好了、每回合都执行、exit 0、而**结构上永远不会触发**的 hook。
+每一个可观察的信号，都与「agent 表现良好」一模一样。
+
+**R7.** 每一个支持的语言**必须**以 locale 包交付，
+各自带着**自己的语料**（必须拦截的用例与必须放行的用例），
+而该包的自测**必须**在 CI 里运行。语料不通过的 locale 包不交付。
+
+**R8.** 语言没有对应包的采用者**必须**被告知这个检查对他们是失效的。
+在这里沉默，等于把本标准要防的失败在上一层重演一次。
+
+---
+
+## 检测器匹配什么
+
+形状是：**第一人称将来标记，接一个动作动词，在同一个句子里**，再减掉三个排除项。
+
+| 元素 | 作用 | 缺了会怎样 |
+|---|---|---|
+| 第一人称＋将来标记 | 把声明与描述分开 | 会匹配到被引述回来的用户原话 |
+| 动作动词 | 把「做」与「讲」分开 | 「我来解释为什么」会算成工作 |
+| 限定同一句 | 让两半保持相关 | 一个否定从句与后面一个真承诺会并成一个不匹配 |
+| 排除报告动词 | 「我会说／提／记」不是工作 | 检查会在自己的摘要上触发 |
+| 排除否定 | 「我不会改那个」是决定，不是承诺 | 一句拒绝会被读成承诺 |
+| 排除引用与表格 | 模式的**例子**不是模式的**实例** | 检查会在自己的文档上触发 |
+
+上表每一个排除项，都是因为它的缺席在测试中造成过一次误拦才加上去的。
+少做其中任何一项的实现，会重现那次误拦。
+
+---
+
+## 证据
+
+单一项目的观察，2026-08 至 2026-09：
+
+| 观察 | 次数 |
+|---|---|
+| 用户就「说了下一步却没做」提出同一个抱怨 | 5 |
+| 指令形式已存在、而在同一个 session 内被违反 | ≥1 |
+| 检测器版本被自己源码或例子中的模式击败 | 5 |
+| 上线前被语料抓到的检测器误拦 | 3 |
+
+最后一行就是 R7 的论据。五个检测器缺陷里有三个**只因为语料存在**才被抓到；
+交付出去的那两个，正是没有任何用例覆盖的那两个。
+
+---
+
+## 检查清单
+
+- [ ] 检查在回合结束时执行，不是写成给 agent 的指令
+- [ ] 每一条失败路径都不拦截、直接放行
+- [ ] 冷却期与滚动时间窗上限两者都在
+- [ ] 每个交付语言都有语料，而语料在 CI 里运行
+- [ ] 语言不支持的采用者被告知检查失效
+- [ ] 检查不读取仓库状态（未关闭的 TODO、待办清单）
+- [ ] 由人要求结束的回合被豁免，且由人的消息判断
+- [ ] 叫停语料包含「含有停止字眼的工作指令」
+- [ ] 检查认得出自己的拦截消息，不把它读成人说的话
+- [ ] 检查认得出 R2 定义的逐项阻塞点结束，而且不拦它
+- [ ] 归属词的搜索排除检查自己的标题与结构

package/bundled/locales/zh-CN/docs/CHEATSHEET.md

@@ -1,6 +1,6 @@
 # UDS 速查表
 
-> Quick reference for all UDS features | Last updated: 2026-08-17
+> Quick reference for all UDS features | Last updated: 2026-09-14
 
 **Language**: [English](../../../docs/user/CHEATSHEET.md) | [繁體中文](../../zh-TW/docs/CHEATSHEET.md) | 简体中文
 
@@ -12,13 +12,27 @@
 |---------|-------------|
 | `uds list` | List available standards |
 | `uds init` | Initialize standards in current project |
-| `uds configure` | Modify options for initialized project |
-| `uds check` | Check adoption status of current project |
+| `uds config` | Manage UDS configuration and project settings |
+| `uds hitl` | Human-in-the-Loop controls |
+| `uds configure` | Alias for "uds config" — Modify project settings |
+| `uds check` | Check file integrity and adoption status (quick validation). For deep health diagnosis, use "uds audit" |
+| `uds lint` | Check spec dependency validity and size against installed specs (specs/*.md) |
+| `uds simulate` | Simulate a standard check with input (Predictive Validation) |
+| `uds fix` | Auto-fix standard violations (Self-Healing) |
 | `uds update` | Update standards to latest version |
 | `uds skills` | List installed Claude Code skills |
-| `uds agent` | Manage UDS agents (list, install, info) |
-| `uds workflow` | Manage UDS workflows (list, install, info, execute, status) |
-| `uds ai-context` | Manage AI context configuration (init, validate, graph) |
+| `uds audit` | Deep health diagnosis with pattern detection and feedback (strategic). For quick file check, use "uds check" |
+| `uds deps` | Compare the versions you test against the versions your declared ranges resolve to |
+| `uds uninstall` | Remove UDS standards, integrations, skills, and hooks |
+| `uds compile` | Compile enforcement standards into hook configurations |
+| `uds report` | Analyze hook telemetry and show adoption report |
+| `uds release` | Manage release process (promote, deploy, manifest, verify) |
+| `uds spec` | Manage lightweight micro-specs for vibe coding. For full spec lifecycle with review, use "/sdd" |
+| `uds quickstart` | Interactive workflow guide — find the right commands quickly |
+| `uds agent` | Manage UDS agents for AI tools |
+| `uds ai-context` | Manage .ai-context.yaml configuration for AI-friendly architecture |
+| `uds mcp` | MCP server commands for AI tool integration |
+| `uds run` | Run a project command by intent (test/lint/build/security) via uds.project.yaml |
 
 ## 💬 斜线命令
 
@@ -204,6 +218,7 @@
 | `data-migration-testing` | Data Migration Testing |
 | `data-pipeline` | Data Pipeline Standards |
 | `database-standards` | This standard defines guidelines for database desi |
+| `deferred-item-exit` | Several standards require documents that **produce |
 | `deployment-standards` | This standard defines guidelines for safely deploy |
 | `deprecation-standards` | Deprecation & Sunset Standards |
 | `design-document-standards` | Design Document Standards |
@@ -302,6 +317,7 @@
 | `timeout-standards` | Timeout Standards |
 | `token-budget` | Token Budget Zone Standard |
 | `translation-lifecycle-standards` | Translation lifecycle standards: MISSING vs OUTDAT |
+| `turn-completion-integrity` | An agent writes *"I'll do X next"* and then ends t |
 | `user-journey-testing` | User Journey Testing Standard |
 | `user-story-mapping` | User Story Mapping Standards |
 | `verification-evidence` | Establish an "Iron Law" that no task can be claime |
@@ -323,6 +339,7 @@
 | `check-ai-agent-sync.ps1` | Check Ai Agent Sync |
 | `check-ai-agent-sync.sh` | AI Agent Sync Checker |
 | `check-ai-yaml-parses.mjs` | Every shipped .ai.yaml must parse, and must parse  |
+| `check-bump-sync-roundtrip.mjs` | check-bump-sync-roundtrip — 測「跑完 bump 之後 check 必須通 |
 | `check-cli-docs-sync.ps1` | Check Cli Docs Sync |
 | `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
 | `check-commands-sync.ps1` | Check Commands Sync |
@@ -332,6 +349,7 @@
 | `check-docs-integrity.sh` | Documentation Integrity Checker |
 | `check-docs-sync.ps1` | Check Docs Sync |
 | `check-docs-sync.sh` | Documentation Sync Checker |
+| `check-error-exit.mjs` | 🔴 沒填就是沒設定，而沒設定會 exit 2， |
 | `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ- |
 | `check-orphan-specs.ps1` | Check Orphan Specs |
 | `check-orphan-specs.sh` | Orphan Spec Detection Script |
@@ -345,6 +363,7 @@
 | `check-standards-reference-sync.sh` | check-standards-reference-sync.sh |
 | `check-standards-sync.ps1` | Check Standards Sync |
 | `check-standards-sync.sh` | Standards Consistency Checker |
+| `check-translation-hash-ratchet.sh` | XSPEC-392 R6 棘輪：新的翻譯必須帶 source_hash，既有的欠債冷凍為基線。 |
 | `check-translation-sync.ps1` | Check Translation Sync |
 | `check-translation-sync.sh` | Translation Sync Checker |
 | `check-usage-docs-sync.ps1` | Check if usage documentation needs to be regenerat |
@@ -356,7 +375,9 @@
 | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
 | `fix-manifest-paths.ps1` | Fix Manifest Paths |
 | `fix-manifest-paths.sh` | Manifest Path Fixer |
+| `generate-adoption-skills.mjs` | Self-Adoption Skill Copy Generator and Drift Gate  |
 | `generate-docs.mjs` | Look up the release date for `version` from CHANGE |
+| `generate-llms-txt.mjs` | llms.txt Generator and Drift Gate — XSPEC-385 |
 | `generate-locale-coverage.mjs` | Locale Coverage Generator |
 | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9 |
 | `install-hooks.mjs` | Install Hooks |