xuxiang
47f82dfde8
用户 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 属「待产研负责人决定」。
40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
域=<L1>-<L2>-<L3> | 闸门=<可开工|等口径|等取证|等部署> | 优先级=<立即|本迭代|排队> | 类型=<安全|数据|性能|可用|债务> | 模式=<…|全模式> | 端=<后端|前端|小程序|运维> | 环境=<正式服|测服> | 证据=<E1|E2|需生产取证>
|
||
|
||
## 问题背景
|
||
**现象**：<谁在什么场景下会看到什么坏结果>
|
||
|
||
**影响面**：<受影响对象 / 计数 / 频率>
|
||
|
||
**根因（含证据）**：<根因判定>
|
||
- <仓库相对路径>:<line> —— <该行代码 / 配置原文片段>
|
||
<permalink>
|
||
|
||
**复现（只读 · 在仓库根执行）**
|
||
- <只读命令>
|
||
|
||
## 处置提案
|
||
<打算怎么做 / 已选路线 / 为什么；执行窗口与风险；回退>
|
||
|
||
## 处置结果
|
||
<!-- 未发生就整段删除（不留空壳） -->
|
||
<实际做了什么 · 当前状态>
|
||
|
||
## 效果对比
|
||
<!-- 未测就整段删除（不留空壳） -->
|
||
| 指标 | 口径 | 时点 | 改前 | 改后 |
|
||
|---|---|---|---|---|
|
||
| <…> | <…> | <…> | <…> | <…> |
|
||
|
||
## 判据与遗留
|
||
**验收判据**：<通过 / 失败怎么判>
|
||
|
||
**反证条件**：<出现什么就说明本判定不成立>
|
||
|
||
**遗留**：<未决项 + owner>
|
||
|
||
<!-- 机器可读 · 引用登记（正文已自包含，本段不参与人读）
|
||
ref-owner: <外部资料拥有者>
|
||
refs:
|
||
- <外部编号>
|
||
-->
|