universal-dev-standards 6.13.1 → 6.14.0-beta.1

package/bundled/hooks/check-turn-completion-agy.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+/**
+ * UDS Hook: Turn Completion Integrity — Antigravity CLI (agy) adapter
+ *
+ * Runs when the agent is about to stop. Blocks when the agent's final message
+ * states a first-person commitment to a next action that the turn then ended
+ * without taking.
+ *
+ * Contract (Antigravity CLI Stop hook — https://antigravity.google/docs/hooks/,
+ * fetched 2026-09-29, and OBSERVED against a real session the same day: agy
+ * 1.2.12 on PC15, `agy -p`, evidence kept in dev-platform
+ * cross-project/ops/evidence/agy-stop-hook-2026-09-29/):
+ *   config  — <repo>/.agents/hooks.json (or ~/.gemini/config/hooks.json). The
+ *             file maps a hook NAME to its events:
+ *               {"<name>": {"Stop": [{"type":"command","command":"...","timeout":N}]}}
+ *             There is no `hooks` wrapper key and no `hooks[]` nesting around the
+ *             handler, unlike Claude Code / Codex. `timeout` is in seconds.
+ *   stdin   — JSON with artifactDirectoryPath, conversationId, error,
+ *             executionNum (from 0), fullyIdle, modelName, terminationReason,
+ *             transcriptPath, workspacePaths. 🔴 It carries NEITHER the final
+ *             message NOR the human's message: both come from the transcript.
+ *   transcript — JSONL, one record per line with source / type / content:
+ *             the human's message   = source USER_EXPLICIT, type USER_INPUT,
+ *                                     content wrapped in <USER_REQUEST>…</USER_REQUEST>
+ *                                     and followed by <ADDITIONAL_METADATA> etc.
+ *             the model's reply     = source MODEL, type PLANNER_RESPONSE
+ *             a `continue` reason   = source SYSTEM, type SYSTEM_MESSAGE
+ *   output  — {"decision":"continue","reason":"..."} restarts the loop (the
+ *             reason reaches the model); anything else lets it stop. This
+ *             adapter writes "{}" on every allow path so stdout is always
+ *             valid JSON.
+ *
+ * 🔴 The human's last message is taken from USER_EXPLICIT/USER_INPUT ONLY.
+ * This hook's own `continue` reason is written back into the transcript as a
+ * SYSTEM_MESSAGE; reading "any non-MODEL record" as the human would take the
+ * hook's own text for the human's words (R11, same family as the Claude Code
+ * block-message echo). Filtering by `source` is the guard; the SELF_ECHO check
+ * below is a second, weaker one.
+ *
+ * 🔴 agy runs the hook with the working directory set to `.agents/`, not the
+ * project root (measured 2026-09-29, agy 1.2.12), and silently lets a hook that
+ * fails to start through — hence the installed command `node ../scripts/hooks/...`.
+ * Nothing here or in the engine reads process.cwd(): packs load relative to the
+ * module, state lives under ~/.uds (or UDS_TURN_COMPLETION_STATE_DIR), and the
+ * transcript path from stdin is absolute. Tests run the adapter from `.agents/`.
+ *
+ * At the moment the hook runs, the transcript ALREADY holds the model's final
+ * reply (observed, single turn, no tool calls). This is the opposite of Claude
+ * Code, where it does not (see check-turn-completion.mjs). Not verified: multi-
+ * turn, turns with tool calls, fullyIdle:false, a non-empty `error`, interactive
+ * mode. If the final reply is not yet in the transcript in one of those cases,
+ * this adapter would judge the previous reply — see the standard's Supported
+ * harnesses section.
+ *
+ * No `executionNum > 0` loop guard is used (unlike stop_hook_active on the
+ * other adapters): whether executionNum resets between turns in a long
+ * interactive session is unverified, and a guard that never resets is a delayed
+ * off switch. The engine's cooldown and rolling window (R6) bound the loop.
+ *
+ * Judgement (packs, cooldown, rolling window, self-echo) lives in
+ * turn-completion/engine.mjs and is shared with every other adapter.
+ *
+ * Usage: node check-turn-completion-agy.mjs  (reads stdin)
+ *        node check-turn-completion-agy.mjs --self-test
+ *        node check-turn-completion-agy.mjs --languages
+ *
+ * @see core/turn-completion-integrity.md
+ */
+import { readFileSync } from 'node:fs';
+import { decide, isSelfEcho, runSelfTest, printLanguages } from './turn-completion/engine.mjs';
+
+/**
+ * The human's words inside a USER_INPUT record: the text between
+ * <USER_REQUEST> and </USER_REQUEST>. Everything after the closing tag
+ * (<ADDITIONAL_METADATA>, <USER_SETTINGS_CHANGE>, ...) is system-added and is
+ * dropped. A record with no tag is taken whole (defensive: a different agy
+ * version may not wrap it).
+ */
+export function unwrapUserRequest(content) {
+  if (typeof content !== 'string') return '';
+  const m = content.match(/<USER_REQUEST>([\s\S]*?)<\/USER_REQUEST>/);
+  if (m) return m[1].trim();
+  const open = content.indexOf('<USER_REQUEST>');
+  if (open !== -1) {
+    // opening tag without a close: take what follows, up to the next system block
+    const rest = content.slice(open + '<USER_REQUEST>'.length);
+    const next = rest.search(/<(ADDITIONAL_METADATA|USER_SETTINGS_CHANGE|SYSTEM_MESSAGE)>/);
+    return (next === -1 ? rest : rest.slice(0, next)).trim();
+  }
+  return content.trim();
+}
+
+/**
+ * Last model reply and last human message in an agy transcript_full.jsonl.
+ * Unparseable lines are skipped; a read failure throws to the caller.
+ */
+export function lastMessages(transcriptPath) {
+  let assistant = '';
+  let user = '';
+  for (const line of readFileSync(transcriptPath, 'utf8').split('\n')) {
+    if (!line.trim()) continue;
+    let ev;
+    try { ev = JSON.parse(line); } catch { continue; }
+    if (!ev || typeof ev.content !== 'string') continue;
+    if (ev.source === 'MODEL' && ev.type === 'PLANNER_RESPONSE') {
+      if (ev.content.trim()) assistant = ev.content;
+    } else if (ev.source === 'USER_EXPLICIT' && ev.type === 'USER_INPUT') {
+      const text = unwrapUserRequest(ev.content);
+      if (text && !isSelfEcho(text)) user = text;
+    }
+  }
+  return { assistant, user };
+}
+
+async function main() {
+  let out = {};
+  try {
+    const raw = readFileSync(0, 'utf8');
+    const data = JSON.parse(raw);
+    if (data && typeof data === 'object' && typeof data.transcriptPath === 'string' && data.transcriptPath) {
+      const { assistant, user } = lastMessages(data.transcriptPath);
+      const verdict = await decide({
+        sessionId: data.conversationId,
+        assistantText: assistant,
+        userText: user,
+      });
+      if (verdict.fire) out = { decision: 'continue', reason: verdict.reason };
+    }
+  } catch {
+    /* R5: fail open — stdout stays valid JSON, the agent stops */
+  }
+  process.stdout.write(JSON.stringify(out));
+}
+
+const arg = process.argv[2];
+if (arg === '--self-test') {
+  process.exit((await runSelfTest('turn-completion-agy')) ? 0 : 1);
+} else if (arg === '--languages') {
+  await printLanguages();
+} else {
+  try {
+    await main();
+  } catch {
+    // R5, belt and braces — see check-turn-completion-codex.mjs.
+    process.stdout.write('{}');
+  }
+}

package/bundled/locales/zh-CN/CHANGELOG.md

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 6.13.1
-translation_version: 6.13.1
-last_synced: 2026-09-28
+source_version: 6.14.0-beta.1
+translation_version: 6.14.0-beta.1
+last_synced: 2026-09-29
 status: current
 ---
 
@@ -17,6 +17,18 @@ status: current
 
 ## [Unreleased]
 
+## [6.14.0-beta.1] - 2026-09-29
+
+> **测试版**——以 `npm install -g universal-dev-standards@beta` 安装。要测什么、如何退回正式版：[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
+>
+> **已知限制（2026-09-29 把安装包装进全新项目实测发现）：** Antigravity CLI 的关卡**只有**在“**全新**项目、且已经有 `.agents/AGENTS.md`”时，由 `uds init --with-hooks` 装上（init 靠这个文件判断项目在用 Antigravity）。既有项目执行 `uds update` **不会**补装，而 `uds init` 不能对同一个项目跑第二次。因此这个测试版里，既有项目拿不到 agy 关卡；预计下一版修正。
+
+### Added
+
+- **`open-work-tracking` 1.1.0：在 OWT-016 之后新增三条要求——意图与进度分开存放、意图被修改要留痕、下一步要点名对象。** OWT-017（warning）：承载一件工作之目标、验收条件或限制的载体，不同时承载它的进度或下一步，以遍历各载体的结构判定、绝不看文件名，所以更新进度不必碰目标。OWT-018（error）：对该意图的每次修改都留下改了什么、谁核可、为什么的记录；没有核可者的修改在 OWT-007 交回点被列出、不得静默，且列出永不阻断（OWT-008）。OWT-019（warning）：「下一步」字段点名文件路径、测试名称、命令或需求编号之一，只有动词不算；这个检查判断有没有点名对象，不判断句子写得好不好。严重度的理由写在标准里。标准也记下对促成本次修改之提示词刻意**不**采纳的部分——那是用户转贴、作者不明、没有实现的文字，只借了设计形状：以手写状态文件当状态真相（会过期，而戳比过期内容新是隐形的）、固定的开工仪式（由各代理工具设置，且会变成没有任何 artefact 检查判定得了的要求）。新增 `scripts/check-open-work-tracking.mjs`，是这三条要求的参考判定程序，作为 OWT-015 证据而非闸门提供（UDS 仍不设闸门，也没有接进 `pre-release-check.sh`）：`next-action` 报告「点名且已找到／点名但未找到／未点名」，`revision` 比对两个版本（或一个文件对 `--base <git rev>`）的验收／目标／限制区段并要求一条新增且完整的记录、把没有核可者的修改列给交回点，`separation` 检查没有任何载体同时装着两者。它判定前先跑自己的自测臂、判定不了时 exit 2（不是 0），并写明自己判定不了的事——记录是否诚实描述了修改、被点名的对象是否正确。**每次跑测试都被观察到会红：**测试套件复制该脚本、改它的源码文字，要求对真脚本通过的断言对 17 个突变版失败（每条要求的永远通过与永远失败、每个辨认分支逐一关掉、旧记录被当成新记录、不完整的记录被接受）。**未校准（OWT-016）：标题词汇、命令清单、扩展名清单与编号样式都是初始判断，不是量测**——例如 `已知限制` 会被读成限制区段；采用者应传入自己的编号样式。在真实历史上重放，它报告 XSPEC-436 的验收条件有变动而没有修订记录，以及 dev-platform 工作记录里一条未点名的下一步。
+
+- **`turn-completion-integrity` 1.5.0：Antigravity CLI（`agy`）现已支持，依据是真实会话观察到的契约。** 这份标准过去写 agy「尚未支持」，因为它的 Stop hook 契约还没被观察过（R3：不对未经观察的契约出适配层）。2026-09-29 已观察（agy 1.2.12、`agy -p`、单轮、无工具调用），适配层 `scripts/hooks/check-turn-completion-agy.mjs` 建立在那次实跑的产出上，而不只是文档：hook 传入数据只有 `transcriptPath`，所以最后一条回复取最后一条 `MODEL`/`PLANNER_RESPONSE`，人的消息取最后一条 `USER_EXPLICIT`/`USER_INPUT`（从 `<USER_REQUEST>` 内取出，后面的系统区块丢掉）。`SYSTEM_MESSAGE` 记录绝不当成人说的话——agy 会把这个 hook 自己的 `continue` 理由写回成这种记录，读成人的话会让 R9 叫停豁免失效。拦截是 `{"decision":"continue","reason":...}`，放行是 `{}`，所有失败路径都放行。`uds init --with-hooks` 在选了 Google Antigravity 时写入 `.agents/hooks.json`（遇到无法解析的 `hooks.json` 不覆盖），`uds uninstall` 只移除 UDS 自己的 handler、保留用户其他 hook。**已验证范围：单轮、无工具调用、`agy -p`。未验证：多轮、含工具调用的回合、交互模式、`fullyIdle: false`、`error` 非空、`.agents/hooks.json` 是否需要已登记的 Antigravity 项目、以及工作目录是否永远是 `.agents/`**——标准、适配层与安装输出都写明了这一点。**同日实测：agy 执行 hook 时的工作目录是 `.agents/`（不是项目根目录），且对启动失败的 hook 静默放行，所以安装的命令是 `node ../scripts/hooks/check-turn-completion-agy.mjs`。**
+
 ## [6.13.1] - 2026-09-28
 
 > **修补版**：修复 6.13.0 暴露的两个“以 `uds update` 升级既有项目”的缺陷（繁中的提交消息语言段落变成英文；AGENTS.md 被改写成另一种格式且少了“这是索引”提醒），并新增一道发版前检查，实际从上一个正式版升级一次。**若你已用 `uds update` 升到 6.13.0，请在升级至 6.13.1 后再执行一次 `uds update`**，以还原那些段落。

package/bundled/locales/zh-CN/README.md

@@ -15,7 +15,7 @@ status: current
 
 > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 6.13.1 | **发布日期**: 2026-09-28 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 6.14.0-beta.1 (Pre-release) | **发布日期**: 2026-09-29 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
 语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。
 

package/bundled/locales/zh-CN/SECURITY.md

@@ -13,6 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支持状态 |
 |------|--------|
+| 6.14.0-beta.1 | ✅ 预发布版本 |
 | 6.13.1 | ✅ 最新正式版 |
 | < 6.0.0 | ❌ 已终止支持 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->

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

@@ -1,9 +1,9 @@
 ---
 source: ../../../core/turn-completion-integrity.md
-source_version: 1.4.1
-translation_version: 1.4.1
-last_synced: 2026-09-28
-source_hash: 0c04676006c0
+source_version: 1.5.0
+translation_version: 1.5.0
+last_synced: 2026-09-29
+source_hash: 08579653d9a4
 status: current
 ---
 
@@ -11,8 +11,8 @@ status: current
 
 > **语言**: [English](../../../core/turn-completion-integrity.md) | [繁體中文](../../zh-TW/core/turn-completion-integrity.md) | 简体中文
 
-**版本**: 1.4.1
-**最后更新**: 2026-09-28
+**版本**: 1.5.0
+**最后更新**: 2026-09-29
 **适用范围**: 任何由 agent 结束回合、把控制权交还给人的执行环境
 **Scope**: universal
 **行业标准**: 不声称任何来源——由实际观察到的失败归纳，见「证据」
@@ -144,13 +144,14 @@ agent 写下「我接着做 X」，然后结束回合，而 X 没有做。
 ## 支持的执行环境
 
 这个检查只在「适配层存在，且 hook 真的被接入该执行环境自己的配置」时才生效。
-截至 v1.4.1：
+截至 v1.5.0：
 
 | 执行环境 | 事件 | 配置文件 | 拦截契约 |
 |---|---|---|---|
 | Claude Code | Stop | `.claude/settings.json` | stdout 输出 `{"decision":"block","reason":...}`，exit 0；沉默即放行 |
 | Codex | Stop | `.codex/hooks.json` | stdout 输出 `{"decision":"block","reason":...}`，exit 0——官方文档写明这个事件纯文本或空输出无效 |
 | Gemini CLI（过时） | AfterAgent | `.gemini/settings.json` | stdout 输出 `{"decision":"deny","reason":...}`，exit 0——官方文档标记为优先于 exit code 2 的做法 |
+| Antigravity CLI（`agy`） | Stop | `.agents/hooks.json` | stdout 输出 `{"decision":"continue","reason":...}`，exit 0；`{}` 即放行 |
 
 在 Codex 上，接上了不等于会执行。Codex 会跳过项目级的 hook，直到项目被信任、**而且**
 这一支 hook 的定义在交互式 Codex 会话里通过 `/hooks` 被信任为止；信任记录绑定在定义的
@@ -173,12 +174,42 @@ agent 的最后一条消息，却不给出用户的；要拿到用户那一侧
 
 Gemini CLI 已过时。Google 于 2026-06-18 对个人账号停用 Gemini CLI，
 改由 Antigravity CLI（`agy`）取代；企业账号两者都还能用。这个适配层为那些用户保留，
-但它从未在真实的 Gemini CLI 会话中验证过；使用 Google 工具的新采用者应预期的是
-Antigravity CLI，而它**尚未支持**。它文档记载的 Stop hook 契约，在关键之处与上表每一个
-适配层都不同：hook 配置在 `.agents/hooks.json`、传入数据只有 `transcriptPath`
-（没有最后一条回复、也没有人的消息）、拦截是 `{"decision":"continue","reason":...}`
-而不是 `block` 或 `deny`。等这份契约在真实会话中观察到之后才会加入适配层——
-与下方 Cursor 没有适配层是同一个理由。
+但它从未在真实的 Gemini CLI 会话中验证过；使用 Google 工具的新采用者应使用下面的
+Antigravity CLI 适配层。
+
+Antigravity CLI 已支持，依据是真实会话观察到的契约（2026-09-29，agy 1.2.12），
+而不只是它的文档。这份契约在关键之处与上表每一个适配层都不同：
+
+- **配置**在 `.agents/hooks.json`，以 hook 名称为键——
+  `{"<名称>": {"Stop": [{"type":"command","command":"...","timeout":N}]}}`，
+  `timeout` 单位为秒。没有 `hooks` 外层，handler 也不嵌套在 `hooks[]` 里。
+- **stdin 既没有最后一条回复、也没有人的消息**，只有 `transcriptPath` 与元数据，所以两者
+  都要从转录读（JSONL，每条有 `source`、`type`、`content`）。最后一条回复是最后一条
+  `source: MODEL`、`type: PLANNER_RESPONSE`。人的消息是最后一条
+  `source: USER_EXPLICIT`、`type: USER_INPUT`，取 `<USER_REQUEST>…</USER_REQUEST>` 之内的文字——
+  后面接着的系统区块（`<ADDITIONAL_METADATA>` 等）不是人说的话。
+- **`SYSTEM_MESSAGE` 记录绝不可当成人的消息读。** agy 会把这个 hook 自己的 `continue` 理由
+  写回转录，成为这种记录（`source: SYSTEM`、`type: SYSTEM_MESSAGE`，内容为
+  「Stop hook blocked termination: …」）。若把「不是模型的任何记录」都当成人，就会把 hook
+  自己的话当成人说的，R9 豁免随之失效——也就是 R11 的失败，换成这份转录的形状重演。
+- **拦截是 `{"decision":"continue","reason":...}`**，不是 `block` 或 `deny`；`{}` 即放行。
+- **hook 执行时的工作目录是 `.agents/`，不是项目根目录**（2026-09-29 实测，agy 1.2.12）。
+  因此安装的命令是 `node ../scripts/hooks/check-turn-completion-agy.mjs`；以项目根目录为准的
+  `node scripts/hooks/...` 会解析成 `<项目>/.agents/scripts/hooks/...`，出现
+  「Cannot find module」，而且**agy 对执行失败的 hook 静默放行**——没有任何消息、stdout 照常，
+  回合就这样结束。路径刻意用相对路径（这个文件本来就是要提交并共用的，绝对路径只属于某一台机器），
+  也不用任何 shell 语法（`sh -c`、`$(...)`），因为 agy 是否经过 shell 执行 `command` 没有证据。
+- **与 Claude Code 相反，hook 被调用时转录已经写到最后一条回复。**
+
+已验证：agy 1.2.12、非交互的 `agy -p`、**单轮且没有工具调用**——hook 被调用时最后一条回复
+已在转录里，`continue` 确实生效（模型又回了一轮），且没有遇到信任提示（与 Codex 不同）。
+**未验证**：多轮对话、含工具调用的回合（此时最后一条 `PLANNER_RESPONSE` 是不是最后回复、
+hook 执行时是否已写入）、`fullyIdle: false`、`error` 非空、交互模式、项目级
+`.agents/hooks.json` 是否像 `.agents/skills/` 一样只对已登记的 Antigravity 项目生效，
+以及工作目录是否永远是 `.agents/`（只对项目级文件量测过；`uds init` 不会写用户级的
+`~/.gemini/config/hooks.json`）。在未验证的情境下，适配层可能判断的是
+较早的一条回复而不是最后一条；读取失败时仍一律放行（R5）。`uds init --with-hooks` 会在安装
+那一行旁边打印已验证的范围。
 
 Cursor 已评估但不支持：截至撰写本文时，Cursor 的 stop hook 能不能真的
 拦下一个回合仍未确定，若对着一个没人验证过的契约交付一份适配层，
@@ -240,3 +271,5 @@ Cursor 已评估但不支持：截至撰写本文时，Cursor 的 stop hook 能
 - [ ] 归属词的搜索排除检查自己的标题与结构
 - [ ] 每个支持的执行环境的拦截契约都对照该环境自己的官方文档验证过，不是照搬另一个环境
 - [ ] 安装器只为采用者实际选择的执行环境写入该环境的 hook 配置
+- [ ] 转录里会出现系统代写消息的执行环境，只从「人的记录」读人的消息，绝不从「不是模型写的任何东西」读
+- [ ] 一份执行环境契约只对「真实会话观察过的范围」交付，并注明没观察到的范围

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

@@ -1,6 +1,6 @@
 # UDS 速查表
 
-> Quick reference for all UDS features | Last updated: 2026-09-23
+> Quick reference for all UDS features | Last updated: 2026-09-29
 
 **Language**: [English](../../../docs/user/CHEATSHEET.md) | [繁體中文](../../zh-TW/docs/CHEATSHEET.md) | 简体中文
 
@@ -352,8 +352,10 @@
 | `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-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 /  |
 | `check-orphan-specs.ps1` | Check Orphan Specs |
 | `check-orphan-specs.sh` | Orphan Spec Detection Script |
+| `check-prompt-footprint.mjs` | Prompt Footprint Ratchet — DEC-117 D2/L2 |
 | `check-scope-sync.ps1` | Check Scope Sync |
 | `check-scope-sync.sh` | Scope Consistency Check Script |
 | `check-skill-next-steps-sync.ps1` | Check Skill Next Steps Sync |
@@ -367,6 +369,7 @@
 | `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-upgrade-fidelity.sh` | Upgrade Fidelity Checker |
 | `check-usage-docs-sync.ps1` | Check if usage documentation needs to be regenerat |
 | `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
 | `check-version-sync.ps1` | Check Version Sync |

package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../docs/CLI-INIT-OPTIONS.md
-source_version: 3.7.0
-translation_version: 3.7.0
-last_synced: 2026-09-26
+source_version: 3.7.1
+translation_version: 3.7.1
+last_synced: 2026-09-29
 status: current
 ---
 
@@ -10,8 +10,8 @@ status: current
 
 > **语言**: [English](../../../docs/CLI-INIT-OPTIONS.md) | [简体中文](../../zh-TW/docs/CLI-INIT-OPTIONS.md) | 简体中文
 >
-> **版本**: 3.7.0
-> **最后更新**: 2026-09-26
+> **版本**: 3.7.1
+> **最后更新**: 2026-09-29
 
 本文档详细说明 `uds init` 命令的每一个选项，包含使用情境、影响范围和建议选择。
 
@@ -870,16 +870,17 @@ UDS 的项目——并在 `[pre-commit]` 下回报同样的修复方式；此警
 
 `--with-hooks` 一定会安装进 `.claude/settings.json`。四个有 hook 支持的标准
 之一——`turn-completion-integrity`（见 CHANGELOG，Unreleased）——也会装进
-**Codex** 与 **Gemini CLI**，门槛是你有没有在 [AI 工具选择](#1-ai-工具选择)
+**Codex**、**Gemini CLI**（过时）与 **Antigravity CLI**（`agy`），门槛是你有没有在 [AI 工具选择](#1-ai-工具选择)
 里选了那个工具（或用非交互模式的工具标志带入）：
 
 | 工具 | 写入的配置文件 | 触发条件 |
 |------|---------------|---------|
 | Codex | `.codex/hooks.json` | 选了 **OpenAI Codex** |
 | Gemini CLI | `.gemini/settings.json` | 选了 **Gemini CLI** |
+| Antigravity CLI | `.agents/hooks.json` | 选了 **Google Antigravity** |
 
-没选的工具不会写入任何东西——`uds init` 不会在没用到 Codex 或 Gemini CLI
-的项目里创建 `.codex/` 或 `.gemini/` 目录。其余三个有 hook 支持的标准
+没选的工具不会写入任何东西——`uds init` 不会在没用到 Codex、Gemini CLI 或 Antigravity
+的项目里创建 `.codex/`、`.gemini/` 或 `.agents/` 目录。其余三个有 hook 支持的标准
 （commit message 校验、logging、security）目前仍只支持 Claude Code；
 为什么目前只推广 turn-completion-integrity，以及 Cursor 的现状
 （已评估、不支持），见

package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md

@@ -1,7 +1,7 @@
 # UDS 功能参考手册
 
 > Universal Development Standards - 完整功能文档
-> Auto-generated | Last updated: 2026-09-23
+> Auto-generated | Last updated: 2026-09-29
 
 **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | [繁體中文](../../zh-TW/docs/FEATURE-REFERENCE.md) | 简体中文
 
@@ -15,9 +15,9 @@
 4. [代理](#agents) (5)
 5. [工作流程](#workflows) (5)
 6. [核心规范](#core-standards) (153)
-7. [脚本](#scripts) (59)
+7. [脚本](#scripts) (62)
 
-**Total Features: 351**
+**Total Features: 354**
 
 ---
 
@@ -478,7 +478,7 @@
 | `deployment-standards` | 1.1.0 | This standard defines guidelines for safely deploying software to production, co |
 | `deprecation-standards` | 1.1.0 |  |
 | `design-document-standards` | 1.0.0 |  |
-| `developer-memory` | 1.1.1 | This standard defines a structured system for capturing, retrieving, and surfaci |
+| `developer-memory` | 1.2.0 | This standard defines a structured system for capturing, retrieving, and surfaci |
 | `disaster-recovery-drill` | - |  |
 | `documentation-lifecycle` | 1.0.0 | This standard defines **when** to update documentation, **when** to check it, an |
 | `documentation-structure` | 1.5.0 | This standard defines a consistent documentation structure for software projects |
@@ -516,7 +516,7 @@
 | `mutation-testing` | 1.1.0 | Mutation testing evaluates test suite effectiveness by injecting artificial bugs |
 | `no-cicd-deployment` | - |  |
 | `observability-standards` | 1.0.0 |  |
-| `open-work-tracking` | 1.0.0 | The deferred-item-exit standard requires that a deferred item leave its document |
+| `open-work-tracking` | 1.1.0 | The deferred-item-exit standard requires that a deferred item leave its document |
 | `packaging-standards` | 1.1.0 | This standard defines a Recipe-based packaging framework that enables user proje |
 | `performance-standards` | 1.2.0 | This standard defines comprehensive guidelines for software performance engineer |
 | `pii-classification` | 1.1.0 | **Status**: Active | **Updated**: 2026-06-19 |  |
@@ -574,7 +574,7 @@
 | `timeout-standards` | - |  |
 | `token-budget` | - |  |
 | `translation-lifecycle-standards` | 1.0.1 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
-| `turn-completion-integrity` | 1.3.0 | An agent writes *"I'll do X next"* and then ends the turn without doing X. |
+| `turn-completion-integrity` | 1.5.0 | An agent writes *"I'll do X next"* and then ends the turn without doing X. |
 | `user-journey-testing` | - |  |
 | `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `verification-evidence` | 1.3.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
@@ -610,8 +610,10 @@
 | `check-docs-sync.sh` | Documentation Sync Checker |
 | `check-error-exit.mjs` | 🔴 沒填就是沒設定，而沒設定會 exit 2， |
 | `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ-5, AC-7) |
+| `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 / OWT-018 / OWT-019. |
 | `check-orphan-specs.ps1` | Check Orphan Specs |
 | `check-orphan-specs.sh` | Orphan Spec Detection Script |
+| `check-prompt-footprint.mjs` | Prompt Footprint Ratchet — DEC-117 D2/L2 |
 | `check-scope-sync.ps1` | Check Scope Sync |
 | `check-scope-sync.sh` | Scope Consistency Check Script |
 | `check-skill-next-steps-sync.ps1` | Check Skill Next Steps Sync |
@@ -625,6 +627,7 @@
 | `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-upgrade-fidelity.sh` | Upgrade Fidelity Checker |
 | `check-usage-docs-sync.ps1` | Check if usage documentation needs to be regenerated |
 | `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
 | `check-version-sync.ps1` | Check Version Sync |

package/bundled/locales/zh-TW/CHANGELOG.md

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 6.13.1
-translation_version: 6.13.1
-last_synced: 2026-09-28
+source_version: 6.14.0-beta.1
+translation_version: 6.14.0-beta.1
+last_synced: 2026-09-29
 status: current
 ---
 
@@ -17,6 +17,18 @@ status: current
 
 ## [Unreleased]
 
+## [6.14.0-beta.1] - 2026-09-29
+
+> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版：[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
+>
+> **已知限制（2026-09-29 把安裝包裝進全新專案實測發現）：** Antigravity CLI 的關卡**只有**在「**全新**專案、且已經有 `.agents/AGENTS.md`」時，由 `uds init --with-hooks` 裝上（init 靠這個檔案判斷專案在用 Antigravity）。既有專案執行 `uds update` **不會**補裝，而 `uds init` 不能對同一個專案跑第二次。因此這個測試版裡，既有專案拿不到 agy 關卡；預計下一版修正。
+
+### Added
+
+- **`open-work-tracking` 1.1.0：在 OWT-016 之後新增三條要求——意圖與進度分開存放、意圖被修改要留痕、下一步要點名對象。** OWT-017（warning）：承載一件工作之目標、驗收條件或限制的載體，不同時承載它的進度或下一步，以走訪各載體的結構判定、絕不看檔名，所以更新進度不必碰目標。OWT-018（error）：對該意圖的每次修改都留下改了什麼、誰核可、為什麼的紀錄；沒有核可者的修改在 OWT-007 交回點被列出、不得靜默，且列出永不阻斷（OWT-008）。OWT-019（warning）：「下一步」欄位點名檔案路徑、測試名稱、指令或需求編號之一，只有動詞不算；這個檢查判斷有沒有點名對象，不判斷句子寫得好不好。嚴重度的理由寫在標準裡。標準也記下對促成本次修改之提示詞刻意**不**採納的部分——那是使用者轉貼、作者不明、沒有實作的文字，只借了設計形狀：以手寫狀態檔當狀態真相（會過期，而戳比過期內容新是隱形的）、固定的開工儀式（由各代理工具設定，且會變成沒有任何 artefact 檢查判定得了的要求）。新增 `scripts/check-open-work-tracking.mjs`，是這三條要求的參考判定程序，作為 OWT-015 證據而非閘門提供（UDS 仍不設閘門，也沒有接進 `pre-release-check.sh`）：`next-action` 回報「點名且已找到／點名但未找到／未點名」，`revision` 比對兩個版本（或一個檔案對 `--base <git rev>`）的驗收／目標／限制區段並要求一筆新增且完整的紀錄、把沒有核可者的修改列給交回點，`separation` 檢查沒有任何載體同時裝著兩者。它判定前先跑自己的自測臂、判定不了時 exit 2（不是 0），並寫明自己判定不了的事——紀錄是否誠實描述了修改、被點名的對象是否正確。**每次跑測試都被觀察到會紅：**測試套件複製該腳本、改它的原始碼文字，要求對真腳本通過的斷言對 17 個突變版失敗（每條要求的永遠通過與永遠失敗、每個辨認分支逐一關掉、舊紀錄被當成新紀錄、不完整的紀錄被接受）。**未校準（OWT-016）：標題詞彙、指令清單、副檔名清單與編號樣式都是初始判斷，不是量測**——例如 `已知限制` 會被讀成限制區段；採用者應傳入自己的編號樣式。在真實歷史上重放，它回報 XSPEC-436 的驗收條件有變動而沒有修訂紀錄，以及 dev-platform 工作紀錄裡一筆未點名的下一步。
+
+- **`turn-completion-integrity` 1.5.0：Antigravity CLI（`agy`）現已支援，依據是真實工作階段觀察到的契約。** 這份標準過去寫 agy「尚未支援」，因為它的 Stop hook 契約還沒被觀察過（R3：不對未經觀察的契約出適配層）。2026-09-29 已觀察（agy 1.2.12、`agy -p`、單輪、無工具呼叫），適配層 `scripts/hooks/check-turn-completion-agy.mjs` 建立在那次實跑的產出上，而不只是文件：hook 傳入資料只有 `transcriptPath`，所以最後一則回覆取最後一筆 `MODEL`/`PLANNER_RESPONSE`，人的訊息取最後一筆 `USER_EXPLICIT`/`USER_INPUT`（從 `<USER_REQUEST>` 內取出，後面的系統區塊丟掉）。`SYSTEM_MESSAGE` 紀錄絕不當成人說的話——agy 會把這個 hook 自己的 `continue` 理由寫回成這種紀錄，讀成人的話會讓 R9 叫停豁免失效。攔截是 `{"decision":"continue","reason":...}`，放行是 `{}`，所有失敗路徑都放行。`uds init --with-hooks` 在選了 Google Antigravity 時寫入 `.agents/hooks.json`（遇到無法解析的 `hooks.json` 不覆蓋），`uds uninstall` 只移除 UDS 自己的 handler、保留使用者其他 hook。**已驗證範圍：單輪、無工具呼叫、`agy -p`。未驗證：多輪、含工具呼叫的回合、互動模式、`fullyIdle: false`、`error` 非空、`.agents/hooks.json` 是否需要已登記的 Antigravity 專案、以及工作目錄是否永遠是 `.agents/`**——標準、適配層與安裝輸出都寫明了這一點。**同日實測：agy 執行 hook 時的工作目錄是 `.agents/`（不是專案根目錄），且對啟動失敗的 hook 靜默放行，所以安裝的指令是 `node ../scripts/hooks/check-turn-completion-agy.mjs`。**
+
 ## [6.13.1] - 2026-09-28
 
 > **修補版**：修正 6.13.0 暴露的兩個「以 `uds update` 升級既有專案」的缺陷（繁中的提交訊息語言段落變成英文；AGENTS.md 被改寫成另一種格式且少了「這是索引」提醒），並新增一道發版前檢查，實際從上一個正式版升級一次。**若你已用 `uds update` 升到 6.13.0，請在升級至 6.13.1 後再執行一次 `uds update`**，以還原那些段落。

package/bundled/locales/zh-TW/README.md

@@ -15,7 +15,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 6.13.1 | **發布日期**: 2026-09-28 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 6.14.0-beta.1 (Pre-release) | **發布日期**: 2026-09-29 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 

package/bundled/locales/zh-TW/SECURITY.md

@@ -13,6 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支援狀態 |
 |------|--------|
+| 6.14.0-beta.1 | ✅ 預發布版本 |
 | 6.13.1 | ✅ 最新正式版 |
 | < 6.0.0 | ❌ 已終止支援 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->