merge: 结构评估先行（本席 47f82df）+ 参数两写法 / selftest / DSH 接法（bae7302）

两条并行改动落在同一批文件上 ⇒ 逐个文件按「谁更对」合入，未整边取用：

【取 bae7302】
- bin/ticket.mjs parseArgs：取值型选项 `--x=v` 与 `--x v` 两种写法都收（本席旧版只认等号）；
  本席新增的 `--dump` 一并纳入 VALUE_OPTS。
- bin/ticket.mjs `selftest`（不联网、不需要令牌）—— 本席在其上补 4 条 §8 结构判定用例（共 13 条）。
- README「接到 DSH」整节：技能发现只有一层、逐技能 junction、rank 表、用户级接法
  （本席原稿「整仓当作技能根」是错的，已弃）。
- SKILL §6「参数写法的坑（已修 · 留档）」；templates 的「域内层级用 - 而非 /」提示行。

【取本席】
- SKILL：闸门 A 先评结构（§8.0）+ 闸门 B 只记要点（§8.2）+ 四段任务全貌（§8.1）
  + 结构有效性与整洁性自检（§8.3）；修 §1 规则 2 与 §2 的双括号/单括号自相矛盾。
- bin/ticket.mjs：assess / update / comments（含 --dump 删前备份）/ comment-add / comment-del。
- templates：正文改四段骨架。README：技能清单行。

【同步废止的旧口径】
- SKILL §9「`--repo` 必须用等号形式」⇒ 改为「两种写法都可 · 旧口径已废止」，并指向 §6 成因留档。

【验证 · E1 · 本机】
- `node --check` 通过；`selftest` 13/13；`verify 157 158 159` = 21/21；
- 两种参数写法各跑一次 `verify` 均 7/7；`assess` 对三单正文的段位 / 顺序 / 空壳判定与实况相符。

ticket-management/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ticket-management
-description: 用 Gitea 工单库做「人读 + 机读」双面管理，并**始终维护工单的结构有效性与整洁性**。**动工单（新建或更新）前先做结构评估**：把本轮信息按「问题背景 / 处置提案 / 处置结果 / 效果对比」四段**任务全貌**出「落点表」，再过「只记要点」四问闸门（改不了全貌的不进工单）；正文 = 现行唯一权威叙事，评论只留必须可执行物，外部来源只进末尾机读引用块。含 bin/ticket.mjs 的 labels/milestones/list/verify/assess/create/update/comments/comment-add/comment-del/rename。适用于：建单、更新工单正文或评论、整理精简既有工单、校验工单是否合规、用 API 读写 Gitea issue。
+description: 用 Gitea 工单库做「人读 + 机读」双面管理，并**始终维护工单的结构有效性与整洁性**。**动工单（新建或更新）前先做结构评估**：把本轮信息按「问题背景 / 处置提案 / 处置结果 / 效果对比」四段**任务全貌**出「落点表」，再过「只记要点」四问闸门（改不了全貌的不进工单）；正文 = 现行唯一权威叙事，评论只留必须可执行物，外部来源只进末尾机读引用块。含 bin/ticket.mjs 的 labels/milestones/list/verify/assess/create/update/comments/comment-add/comment-del/rename，以及不联网、不需要令牌的 selftest 自检。适用于：建单、更新工单正文或评论、整理精简既有工单、校验工单是否合规、用 API 读写 Gitea issue。
 ---
 
 # ticket-management（Gitea 工单管理）
@@ -84,7 +84,11 @@ refs:
 ## 5 工具 `bin/ticket.mjs`
 
 ```bash
+# 自检：不联网、不需要令牌 —— 改完脚本先跑这条
+node bin/ticket.mjs selftest
+
 # 令牌：GITEA_TOKEN 环境变量，或 --token-file=<含 key=value 的文件>（不落盘、不回显）
+# 取值型选项两种写法等价：--repo=xbc/xbc 与 --repo xbc/xbc
 node bin/ticket.mjs labels     --repo=xbc/xbc
 node bin/ticket.mjs milestones --repo=xbc/xbc
 node bin/ticket.mjs list       --repo=xbc/xbc --state=open
@@ -103,6 +107,7 @@ node bin/ticket.mjs rename 142 --repo=xbc/xbc --domain=平台 [--gate=等口径]
 |---|---|---|
 | `labels` / `milestones` / `list` | 读（标签 id 是创建时唯一可传的形式） | `read:issue` |
 | `verify <n>` | **校验**（只读）：见 §7 七项断言（含标签非空） | `read:issue` |
+| `selftest` | **自检**（不联网、不需要令牌）：解析器两种写法 + §7 七项断言正反 + §8 结构判定 | 无 |
 | `assess <n>` / `assess --body-file=f` | **结构评估**（只读）：四段现状 / 缺段 / 空壳段 + 评论清单 ⇒ §8.0 落点表底稿 | `read:issue` |
 | `create` | 建单（**先按标题查重**；**`--label` 必传**，缺失 / id 不存在 ⇒ 拒建） | `write:issue` |
 | `update <n>` | 改正文（**标题与正文同一次 PATCH**，§8.1 第 4 条）；过自检，不过 ⇒ 拒改 | `write:issue` |
@@ -116,6 +121,7 @@ node bin/ticket.mjs rename 142 --repo=xbc/xbc --domain=平台 [--gate=等口径]
 - **HTTP 分块解码**：`let d = ''; res.on('data', c => d += c)` 会把**跨块的多字节字符**打成 `U+FFFD`（中文标签名就被打坏过）⇒ 必须 `res.setEncoding('utf8')`，或用 `fetch` 的 `text()`。
 - **建单前必须查重**：按标题查，否则会重复建单。
 - **标签传 id**：`POST /issues` 的 `labels` 是**标签 id 数组**，不是名字。
+- **参数写法的坑（已修 · 留档）**：早先 `parseArgs` 只认 `--repo=o/r`，而文档示例写的是 `--repo o/r` ⇒ `xbc/xbc` 被当成位置参数、`repo` 变成布尔 `true`，请求打到 `/repos/true/…`，报出来的是 **403「缺 read 权限」/ 405「方法不允许」—— 全是假故障**，白排查三轮。现在**取值型选项两种写法都收**；改完脚本一律先跑 `selftest` 兜底。
 - **批量改首行时必须保持 ` | ` 形态**（空格 + 竖线 + 空格）：把 `域=…` 换成新值时若顺手吃掉它后面的空格，`闸门=` 会与 `域` 黏成一段 ⇒ **断言 4 全线 FAIL**（实测 14/14 中招，工具拦住了）。
 - **改标题与正文**：都是 `PATCH /repos/{owner}/{repo}/issues/{n}`；**要同一次提交**（用 `update`，见 §8.1 第 4 条）。
 - **令牌 scope**：只读 `read:issue,read:repository` 建不了单（403，报错会写 required scope）；建 / 改需 `write:issue`；`GET /user` 另需 `read:user`。
@@ -216,7 +222,7 @@ node bin/ticket.mjs rename 142 --repo=xbc/xbc --domain=平台 [--gate=等口径]
 
 ## 9 本工具实测补充（2026-09-24）
 
-- **`--repo` 必须用等号形式**：`--repo=xbc/xbc`。写成空格形式（`--repo xbc/xbc`）时，`xbc/xbc` 会被当成**单号**去请求 ⇒ 报 `读取失败 status=404` 且后面紧跟一行 `#xbc/xbc 读取失败` —— 这是**参数错位**，不是权限问题。
+- **`--repo` 两种写法都可以**：`--repo=xbc/xbc` 与 `--repo xbc/xbc`。❗**旧口径已废止**（早期只认等号形式，示例写成空格 ⇒ 参数错位，症状是 403 / 405 / 404 的**假故障**）；**改完脚本先跑 `selftest`**。
 - **令牌**：`GITEA_TOKEN` 环境变量，或 `--token-file=<含 `token`/`accessToken` 的 key=value 文件>`（按行匹配 `/token/i`）。缺令牌时报错但**错误信息可能表现为 404**（私有仓隐藏权限差异）⇒ 先查令牌再怀疑工单。`assess --body-file` **只评正文，不需要令牌**。
 - **评论的增删改已收进工具**：`comments`（清单 / `--dump` 备份）· `comment-add` · `comment-del`（**默认只预览**，`--yes` 才删）。底层仍是 `POST /issues/{n}/comments` · `PATCH /issues/comments/{id}` · `DELETE /issues/comments/{id}`（204）。
 - **改工单正文用 `update`**：它把**标题与正文在同一次 PATCH 提交**（§8.1 第 4 条的机器保证）；只想改标题用 `rename`。