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