feat(ticket-management)!: 结构评估先行 —— 四段任务全貌 + 只记要点闸门 + 有效性与整洁性自检

用户 2026-09-24 交办:工单 skill 在**新建 / 更新**时须**优先评估正文 + 评论该有的结构**,
以合适的安排把关键内容记进工单;**不可事无巨细**,只记能组成「任务全貌」的要点
(**问题背景 / 处置提案 / 处置结果 / 效果对比**);skill 须**始终维护所编辑工单的结构有效性与整洁性**。

【本轮整改】
- SKILL.md
  · 新增**闸门 A「先评结构」**(§8.0 五步 + 落点表)与**闸门 B「只记要点」**(§8.2 四问),
    置于 §1 硬规则之首 —— 动工单前的第一动作,不能事后补。
  · 重写 §8.1 正文骨架为**四段任务全貌**;③处置结果 / ④效果对比**未发生不写空壳**。
  · 新增 §8.3 **有效性 + 整洁性自检清单**,并升为 §1 规则 4(可交付条件)。
  · 修 §1 规则 2 与 §2 的自相矛盾(「可选【闸门】」vs「并进同一括号」)⇒ 统一为【域-闸门】。
  · §3.2 补四段段序;§7 写明 verify=有效性 / assess=结构 的分工。
- bin/ticket.mjs
  · 新增 assess(只读结构体检:四段 / 缺段 / 顺序 / 空壳 + 评论清单)
    · update(**标题与正文同一次 PATCH**,过自检才放行)
    · comments(清单 / --dump **删前全量备份**)· comment-add · comment-del(**默认只预览**,--yes 才删)。
  · create 也先打印结构评估;令牌改**延迟读取**(assess --body-file 无需令牌)。
  · 结构判定取「最长词优先」+「同级标题界定空壳」+「更正/补充小节不计顺序」。
- templates/issue.md:改为四段骨架;修 `域=<L1>/<L2>/<L3>` 与 §3.1 / 代码不一致(应为 `-` 分隔)。
- README.md:技能清单说明同步。

【收录此前在途未提交改动】(原属他方;依 86 §13.26 三「待技能属主 / 委托人提交」,本轮一并收束)
- 建单 `--label` 必传 + 断言 7「已带标签」;§1 规则 1b/1c;§8 时间线纪律;§9 实测补充。

【验证 · E1 · 本机】
- `node --check bin/ticket.mjs` 通过。
- `verify 157 158 159 --repo=xbc/xbc` ⇒ **21/21 通过**(七断言未改 ⇒ 向后兼容)。
- `assess --body-file=_body157/158/159.md` ⇒ 段位与顺序判定与三单实际结构相符;
  合成反例(缺必备段 + 乱序 + 空壳)三项全部命中。
- `update 159 --dry-run` 与 `comment-del 534`(仅预览)均未落盘。

【遗留】
- 本仓只改文件不推送时,工作树在 `分析/_tmp/`(可删)⇒ 需推送 `origin/main` 才算持久。
- 接入本工作区(`.dsh/skills/agents-skills` junction)依 86 §12.43 属「待产研负责人决定」。
This commit is contained in:
2026-09-24 10:21:28 +08:00
parent 47226f78be
commit 47f82dfde8
4 changed files with 388 additions and 45 deletions
+26 -9
View File
@@ -1,22 +1,39 @@
域=<L1>/<L2>/<L3> | 闸门=<可开工|等口径|等取证|等部署> | 优先级=<立即|本迭代|排队> | 类型=<安全|数据|性能|可用|债务> | 模式=<…|全模式> | 端=<后端|前端|小程序|运维> | 环境=<正式服|测服> | 证据=<E1|E2|需生产取证>
域=<L1>-<L2>-<L3> | 闸门=<可开工|等口径|等取证|等部署> | 优先级=<立即|本迭代|排队> | 类型=<安全|数据|性能|可用|债务> | 模式=<…|全模式> | 端=<后端|前端|小程序|运维> | 环境=<正式服|测服> | 证据=<E1|E2|需生产取证>
**现象**:<一句话说清「谁在什么场景下会看到什么坏结果」>
## 问题背景
**现象**:<谁在什么场景下会看到什么坏结果>
**证据锚点(仓库 <owner>/<repo> @ <sha8>)**
- <path>:<line> —— <该行代码 / 配置原文片段>
**影响面**:<受影响对象 / 计数 / 频率>
**根因(含证据)**:<根因判定>
- <仓库相对路径>:<line> —— <该行代码 / 配置原文片段>
<permalink>
**复现(只读 · 在仓库根执行)**
- <只读命令>
**影响面**
- <受影响对象 / 计数 / 频率>
## 处置提案
<打算怎么做 / 已选路线 / 为什么;执行窗口与风险;回退>
**反证条件**
- <出现什么就说明本判定不成立>
## 处置结果
<!-- 未发生就整段删除(不留空壳) -->
<实际做了什么 · 当前状态>
## 效果对比
<!-- 未测就整段删除(不留空壳) -->
| 指标 | 口径 | 时点 | 改前 | 改后 |
|---|---|---|---|---|
| <…> | <…> | <…> | <…> | <…> |
## 判据与遗留
**验收判据**:<通过 / 失败怎么判>
**反证条件**:<出现什么就说明本判定不成立>
**遗留**:<未决项 + owner>
<!-- 机器可读 · 引用登记(正文已自包含,本段不参与人读)
ref-owner: <外部资料拥有者>
refs:
- <外部编号>
-->
-->