@gitruck/cli 1.0.6 → 1.0.7

package/AGENT.md

@@ -50,6 +50,26 @@
 - **例外只有一个**：铺自产物的那几条既有链路（`gtrk matrix` 铺轨、`gtrk mg` 铺颗粒、
   `gtrk audio` / `gtrk subtitle` 建新轨）—— 它们只动自己新建的东西，不改既有 clip 的时码。
 
+## 标定数据落点纪律（全局 MUST · 2026-08-29 立 · tighten-distribution-surface）
+
+**新增**的实测标定数据 MUST 写进对应 change 的 `design.md` 附录，MUST NOT 写进代码注释或
+随包分发的 `skills/*/SKILL.md`。
+
+- **什么算标定数据**：写明了**取值理由 / 代价曲线 / 实测分布 / 禁区论证 / 真机实验结论**的内容
+  ——即别人据以能省下试错的东西。例如「MUST NOT ≥1.5：槽位 51→53、扰动 26/51、吃进 9 条真实
+  短镜头」「score 集中于 0.1~0.4，0.25+ 已是强命中」「p10=2.12 / p90=4.97」。
+- **什么不算、MUST NOT 迁走**（这三类留在代码里）：
+  ① **正确性约束**——`MUST NOT` 开头的行为契约、不变量、耦合关系（如「不消耗随机序列」
+     「MUST NOT 复用云端地板的校准假设」「MUST NOT 改吃 candidates 精简集」）；
+  ② **丑话**——副作用、风险、不对称后果（如「误判 stable 丢检索粒度，误判 unstable 只是不省钱」）。
+     丑话属于「怎么用」，是使用者的决策依据；
+  ③ **算法本体**——公式与判定式本身就是代码在做的事，注释是它的可读投影。
+- **代码注释的目标口径**：只讲**是什么 + 怎么用**，不讲**为什么是这个值**。
+- **存量不清洗**（主理人 260829 拍板）：既有注释里的标定数据已随公开镜像与 npm 发布出去，
+  删它们保护为零、却净损失维护者上下文，且那两个文件是承重墙密集区、误伤代价高。
+  本纪律**只管新增**。已知的存量标定已在 `tighten-distribution-surface/design.md 附录 A`
+  留档（含「改值前必须知道什么」速查表）——**改那些常量前先读它**。
+
 ---
 
 ## 0. 一句话流程