@hcmai/cli 0.3.8 → 0.3.9

package/dist/skills/hcm-delivery-gate0/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: hcm-delivery-gate0
+title: 成稿闸：技能里不许钉环境取值
+description: 写交付技能的最后一道自查。字段名、中文标签、枚举值、模型名、码值、业务键、口径——这七类换个客户就全错，在写下的当时就该判，不必等到下一个现场。
+category: cli-operations
+stages:
+  - baseline
+actionSurface: cli
+requires:
+  - hcm-delivery-doctor
+---
+
+# 成稿闸：技能里不许钉环境取值
+
+一份交付技能里钉着上一个租户的字段名，这件事**在写下的当时**就已经成立，
+却要等到下一个现场才暴露。门 0 把判定挪到成稿期：判据是那份基线本身，**不连任何环境**。
+
+```
+hcm delivery gate0 --skills <技能目录> --recon <基线产物目录> --mapping <映射工件> --output table
+```
+
+`--recon` 指的是**产物目录本身**（`hcm delivery recon` 打出来的那一层，与
+`hcm delivery recon round --dir` 收的是同一个），不是它的上级。
+
+## 退出码三档，不许合并
+
+| rc | 含义 | 下一步 |
+|---|---|---|
+| `0` | 扫过，没判红 | 看一眼 `[gaps]` 段（见下），再发 |
+| `1` | 判红了 | 逐条改稿。判词点名了通道和 token |
+| `2` | **前提不成立** | 先修前提。这一轮的绿**不算数** |
+
+🔴 **`2` 压过 `1`**：前提不成立时，那份判红清单本身不可信。
+但清单**照打** —— rc 是给脚本的闸，清单是给人的依据。
+
+## 三件容易误判的事
+
+**不带 `--mapping` 就报 rc=2，是预期不是出错。** `naturalKey` 那一类没有来源
+⇒ 它此刻**没人守**，而门 0 不肯把「没查」说成「查过且干净」。
+手上确实有映射工件时把它加回来，那一类才真被守住。
+
+**`rc=0` 不等于干净。** 这道闸有两个自己声明的缺口，落进去的逐条印在 `[gaps]` 段里、
+**不顶 rc**：
+
+- **纯数字 / 单字符的取值** —— 码表里的排序号、只有一个汉字的枚举值都算，**不分中英**。
+  它们本来就该判红；放行只为不把一份中文文档淹成红海。
+- **汉字打头或结尾的取值，紧挨着的还是汉字** —— 中文没有分词边界，说不准。
+  ⚠️ 反过来**不成立**：两侧不是汉字时（字母、数字、标点、空白都算）它**照常判红**。
+
+⇒ ASCII 那一半也不是自动干净的（第一个缺口对它同样成立）。跑完把 `[gaps]` 段逐条读过再发。
+
+**基线不是一轮完整跑出来的，也是 rc=2。** A 类事实是从这份基线**现算**的；
+基线混着不同轮次，「判红 0 条」对哪一轮都不算数。先跑
+`hcm delivery recon round` 看是哪几份，或回到连得上的地方重跑一次 `hcm delivery recon`。
+
+## 扫描面
+
+正文与 `references/` 全目录逐 token 扫，**点目录照扫**（`grep -r` 进不去的那种）。
+**软链目录不跟随**：发现即点名那条链、按前提不成立退 rc=2（指向文件的软链照旧扫）。
+
+## 判红分五条通道
+
+| 通道 | 判什么 | 有没有豁免 |
+|---|---|---|
+| `aclass` | 七类环境事实：字段名 / 中文标签 / 枚举值 / 模型名 / 码值 / 业务键 / 口径 | **没有** |
+| `protocol-unregistered` | 像端点 / wire 形态，但不在登记册里 | 登记过就豁免 |
+| `registered-but-is-aclass` | 登记册里那条自己也是环境事实 | 没有 —— 登记买不到「它不是环境事实」 |
+| `no-probe` | 条目登记被拒（没进登记册、也没上账本） | 没有 |
+| `artifact-path` | 产物路径 | **没有** |
+
+🔴 **协议事实登记册是编译进包的常量，现场登记不了新条目** —— 登记要附一条真跑的探针，
+而探针不随包走。命中 `protocol-unregistered` 时正确的动作是**把那个形态从正文里拿掉**
+（换成「按 `hcm describe <模型>` 现查」这类说法），不是想办法把它登记进去。
+
+## 什么时候跑
+
+**每次改完技能正文，发之前。** 它零网络、亚秒级，没有理由攒到最后。
+基线换了一轮就重跑一次 —— 上一轮的 rc=0 盖不住这一轮的取值。

package/dist/skills/llms.txt

@@ -9,3 +9,4 @@
 ## 清单
 
 - `hcm-delivery-doctor` — 到客户现场敲的第一条命令：连不上 / 身份不对 / 没权限 / 站错层，四件事分开问。 → `hcm-delivery-doctor/SKILL.md`
+- `hcm-delivery-gate0` — 写交付技能的成稿闸：七类环境事实 / 未登记的协议形态 / 产物路径，在写下的当时就判掉。 → `hcm-delivery-gate0/SKILL.md`

package/dist/skills/manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "cliVersion": "0.3.8",
+  "cliVersion": "0.3.9",
   "commands": [
     {
       "path": "action",
@@ -714,6 +714,27 @@
           "sha256": "6339629ad101b6391b657985f92b2e27f28d5df0b06669aa9e83dd56b42bcc3c"
         }
       ]
+    },
+    {
+      "id": "hcm-delivery-gate0",
+      "title": "成稿闸：技能里不许钉环境取值",
+      "description": "写交付技能的最后一道自查。字段名、中文标签、枚举值、模型名、码值、业务键、口径——这七类换个客户就全错，在写下的当时就该判，不必等到下一个现场。",
+      "category": "cli-operations",
+      "stages": [
+        "baseline"
+      ],
+      "actionSurface": "cli",
+      "requires": [
+        "hcm-delivery-doctor"
+      ],
+      "bytes": 4118,
+      "files": [
+        {
+          "path": "SKILL.md",
+          "bytes": 4118,
+          "sha256": "7d5f4e99ea951ad401d8a8dab8d85770d0d18ac28fddcd5f2bde124edd0879c1"
+        }
+      ]
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hcmai/cli",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "Official HCM Next CLI for business APIs, tenant delivery, workspaces, and AI agents.",
   "license": "Apache-2.0",
   "type": "module",
@@ -37,7 +37,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@hcmai/sdk": "0.3.8",
+    "@hcmai/sdk": "0.3.9",
     "axios": "^1.6.0",
     "commander": "^12.0.0",
     "ink": "^7.0.5",