agents-skills/ticket-management/templates/issue.md at a70eaae12572bcb48a9eac453477e3cb7fa6c25b

Files

T

xuxiang a70eaae125 feat(ticket-management)!: 「任务全貌」四段 → 五段，新增必备段「经验教训」

用户 2026-09-24 指出漏了一个要点：**经验教训**也应是**重点结构**的一部分。

【改动】
- SKILL §8.1：正文骨架加第 ⑤ 段 `## 经验教训`（**必备**，排在 `效果对比` 之后）——
  必须是**可复用结论**（对象 + 动作 / 判据）；**尚未定性写「暂无（原因）」**，
  **不许留空壳，也不许写「加强测试」这类套话**。
- §8.2 闸门 B：**四问 → 五问**（新增「它给出『下次怎么避免 / 怎么做』的可复用结论吗？」）。
- §8.3 整洁性自检：加「经验教训须是可复用结论、非套话；未定性须显式写『暂无（原因）』」。
- §3.2 骨架 / §8.0 定全貌 / §8.1 标题 / §5 assess 表 / §7 分工注 / §8.3 有效性 —— 措辞全部同步。
- `bin/ticket.mjs`：`SECTIONS` 加第 5 段（词表 `经验教训` / `教训` / `复盘`）；`assess` 表头改「五段」；
  **必备段缺失提示按段区分**（教训 ⇒ 指「暂无（原因）」；提案 ⇒ 指「结论即提案 / 无需处置」）；
  `selftest` 20 → **21**。
- `templates/issue.md` 加 `## 经验教训`；README 技能行改「五段任务全貌」。
- （顺带更正）README 里「本机已按此接好 ticket-management」**与实测不符**（本机无该 junction）⇒
  去掉机器特有断言 —— 可复用文档不写本地状态。

【验证 · E1 · 本机】
- `node --check` 通过；`selftest` **21/21**；`grep 四段|四问` ⇒ **0 残留**。
- `assess 158`（真跑）⇒ 五段中**恰好第 ⑤ 段未识别**（正是用户指出的缺口，`#158` 待补经验教训）；
  顺序 OK · 空壳 无。
- 合成「五段齐」正文 ⇒ 五段全 ✓ · 顺序 OK · 空壳 无。

2026-09-24 10:50:33 +08:00

1.6 KiB

Raw Blame History

域=-- | 闸门=<可开工|等口径|等取证|等部署> | 优先级=<立即|本迭代|排队> | 类型=<安全|数据|性能|可用|债务> | 模式=<…|全模式> | 端=<后端|前端|小程序|运维> | 环境=<正式服|测服> | 证据=<E1|E2|需生产取证> （域内层级用半角连字符 -：断言 3 取 域 的 - 前第一段与标题主域比对，写成斜杠必挂）

问题背景

现象：<谁在什么场景下会看到什么坏结果>

影响面：<受影响对象 / 计数 / 频率>

根因（含证据）：<根因判定>

<仓库相对路径>: —— <该行代码 / 配置原文片段>

复现（只读 · 在仓库根执行）

<只读命令>

处置提案

<打算怎么做 / 已选路线 / 为什么；执行窗口与风险；回退>

处置结果

<实际做了什么 · 当前状态>

效果对比

指标	口径	时点	改前	改后
<…>	<…>	<…>	<…>	<…>

经验教训

<对象>：<下次怎么避免 / 怎么做（可复用到别的单）>

判据与遗留

验收判据：<通过 / 失败怎么判>

反证条件：<出现什么就说明本判定不成立>

遗留：<未决项 + owner>

1.6 KiB Raw Blame History Unescape Escape