@captain_z/zsk-skills 0.1.0

package/sdlc/archive/SKILL.md

@@ -0,0 +1,267 @@
+---
+name: zsk:archive
+description: Iteration closing / archive — move historical snapshots to
+  docs/{module}/archive/, write postmortem (P0/P1 mandatory), update changelog
+  (SemVer + Keep a Changelog), flush ADRs, update SYSTEM-SPEC if cross-module
+  constraints emerged, feed back to standards/system docs. Stage 7 of the
+  7-stage SDLC.
+category: stage
+domain: sdlc
+tier: core
+stage: 7
+variants:
+  - feature
+  - bugfix
+  - refactor
+related:
+  - ../verify/SKILL.md
+  - ../proposal/SKILL.md
+  - ../../system/adr/SKILL.md
+  - ../../quality/release/SKILL.md
+triggers:
+  - archive iteration
+  - postmortem
+  - changelog
+  - ADR flush
+  - blameless
+  - retrospective
+  - knowledge capture
+  - close the loop
+---
+
+# Stage 7: Archive
+
+> **阶段定位**：归档 / 知识沉淀 - Archive & Knowledge Capture
+> **回答的问题**：这一轮做完了，**什么知识要留下**来让下一轮能吃到？文档怎么收尾、Postmortem 怎么写、系统规约是否要更新？
+> **参考规范**：Blameless Postmortem（Google SRE）、ADR（Michael Nygard）、SemVer、Keep a Changelog
+> **吸收硬原则**：
+> - **归档即沉淀**：如果归档只是"挪文件"，价值为零。真正的价值是**把个案提炼成通用约束**（ADR / SYSTEM-SPEC / standards/ 更新）。
+> - **Blameless**：Postmortem 对事不对人，目标是系统改进，不是追责
+
+## Skill 映射
+
+| 场景 | Primary Skill |
+| --- | --- |
+| 归档流程 | `zsk:archive`（本 skill） |
+| 知识图 | `graphify` |
+| 写作提炼 | `learn` |
+| 发布收尾 | `document-release` |
+| 里程碑复盘 | `retro` |
+
+## 变更类型差异
+
+| 类型 | Archive 侧重 |
+| --- | --- |
+| **Feature** | Changelog `Added` + ADR 更新 + 模块文档封存 + 反哺上游 `standards/*` |
+| **Bugfix** | **Postmortem（P0 / P1 强制）** + Changelog `Fixed` + 归档复现材料 + 回归测试保留 |
+| **Refactor** | Changelog `Changed` / `Removed` + ADR 更新（为什么这样改）+ 性能对照数据归档 |
+
+## 1. 模块文档归档
+
+### 触发条件
+
+模块本轮迭代完成（合并主干 + 发布）后：
+
+- 本轮的 `proposal.md` / `spec.md` / `design.md` / `tasks.md` **保留在 `docs/{module}/`**（不删除、不移动）
+- 历史快照（过去版本、已废弃的设计）移到 `docs/{module}/archive/{YYYY-MM-DD}-{标签}/`
+
+### 目录结构
+
+```text
+docs/{module}/
+├── proposal.md          # 当前有效版本
+├── spec.md              # 当前有效版本
+├── design.md            # 当前有效版本
+├── tasks.md             # 当前有效版本
+└── archive/
+    ├── 2026-04-19-v1-discarded-design/
+    │   ├── design.md    # 废弃的旧设计（保留为历史）
+    │   └── README.md    # 为什么废弃
+    └── 2026-04-19-postmortem-bug-123/
+        ├── postmortem.md
+        ├── repro-before.mov
+        └── repro-after.mov
+```
+
+### 归档不是"清理"
+
+- **不得**删除当前有效文档（即便看起来"过期"）
+- **不得**把主文档移到 `archive/`（让 AI 与人继续读主目录）
+- 归档只做两件事：
+  1. 历史快照挪到 `archive/{日期}-{标签}/`
+  2. 本轮沉淀出的通用知识更新到 `SYSTEM-SPEC.md` / `system/` / `standards/`
+
+## 2. Postmortem（P0 / P1 Bugfix 强制）
+
+### 触发条件
+
+- P0：生产事故、数据损坏、安全事件
+- P1：核心流程不可用、影响多用户
+
+**Blameless 原则**：不针对个人，针对系统 / 流程 / 工具。
+
+### 模板
+
+```md
+# Postmortem: {bug 简述}
+
+> 严重度：P0 / P1
+> 模块：{module}
+> 相关 Issue：#{id}
+> 作者：{姓名} ｜ 日期：{YYYY-MM-DD}
+> Blameless 声明：本文档对事不对人，用于系统改进
+
+## 时间线
+
+| 时间 | 事件 |
+| --- | --- |
+| {t0} | 引入（commit / PR） |
+| {t1} | 发现（谁、如何） |
+| {t2} | 影响开始 |
+| {t3} | 定位根因 |
+| {t4} | 修复合并 |
+| {t5} | 影响结束 |
+
+## 根因（与 `design.md` RCA 一致）
+
+- 直接原因：...
+- 深层原因（5 Whys）：
+  1. Why 1：...
+  2. Why 2：...
+  3. Why 3：...
+  4. Why 4：...
+  5. Why 5：...（系统性根因）
+
+## 影响范围
+
+- 用户：{数量 / 比例}
+- 业务：{功能 / 流程}
+- 数据：{是否有损坏 / 污染}
+- 时长：{开始 → 结束}
+
+## 做对的地方（What went well）
+## 做得不好的地方（What went wrong）
+
+## 检测与响应效率
+
+| 指标 | 值 | 目标 | 评估 |
+| --- | --- | --- | --- |
+| Time to Detect (TTD) | {min} | < 5min | ✅ / ❌ |
+| Time to Mitigate (TTM) | {min} | < 30min | ✅ / ❌ |
+| Time to Resolve (TTR) | {min} | < 4h（P0） | ✅ / ❌ |
+
+## 行动项（Action Items）
+
+| # | 行动 | 类别 | 负责人 | 期限 | 状态 |
+| --- | --- | --- | --- | --- | --- |
+
+## 知识沉淀（供其他模块复用）
+
+- 新约束：{是否更新到 SYSTEM-SPEC.md？}
+- 新模板：{是否更新到 standards/*？}
+- 新 ADR：{链接} 
+```
+
+## 3. Changelog 纪律
+
+遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/) + SemVer（详见 [`quality/release`](../../quality/release/SKILL.md)）。
+
+```md
+## [1.2.0] - 2026-04-19
+
+### Added
+- {新功能描述}（#PR / Refs Spec FR-x）
+
+### Changed
+- {行为修改或重构}
+
+### Deprecated
+- {即将移除的 API / 功能}
+
+### Removed
+- {已移除的内容}
+
+### Fixed
+- {bug 修复}（#issue / Refs Postmortem）
+
+### Security
+- {安全修复 / 依赖升级}
+```
+
+**硬规则**：
+
+- **Refactor**：只能进 `Changed` / `Removed`，**禁止**写 `Added` / `Fixed`（否则违反"行为不变"）
+- **Bugfix**：必须有 `Fixed` 条目，P0 / P1 还要链接 Postmortem
+- **Feature**：`Added` 条目引用 Spec 的 FR 编号（追溯锚）
+
+## 4. SYSTEM-SPEC 更新约定
+
+**何时更新 `SYSTEM-SPEC.md`**（工程级宪法）：
+
+- 本轮迭代发现新的**跨模块约束**
+- 本轮迭代引入新的**技术选型**（如禁用 X 库、强制 Y 库）
+- Postmortem 的 Action Item 指向系统级改进
+- ADR 通过后，其摘要进 SYSTEM-SPEC
+
+**怎么更新**：
+
+1. 打开 `SYSTEM-SPEC.md`，在相关章节追加条目
+2. 链接对应的 ADR 路径（`docs/system/adrs/ADR-NNN-{title}.md`）
+3. 在本阶段归档清单里勾选"SYSTEM-SPEC 已更新"
+4. 同步更新 `standards/` 下相关的落地文档（如果是执行规范级）
+
+## 5. ADR 归档
+
+本轮迭代产生的 ADR（在 `design.md` 中记录的）→ 正式产出到：
+
+```text
+docs/system/adrs/ADR-{NNN}-{kebab-title}.md
+```
+
+编号规则：全工程递增，不按模块划分（便于引用）。模板见 [`zsk:adr`](../../system/adr/SKILL.md)。
+
+## 6. 知识图沉淀（可选，大改动推荐）
+
+使用 `graphify` skill：
+- 把本轮的代码 / 文档 / 决策映射为**节点 + 边**
+- 发现跨模块的**重复模式**（候选抽象）
+- 输出 HTML + JSON + 审计报告到 `docs/{module}/archive/{日期}-graphify/`
+
+适用场景：
+- 涉及 3+ 模块的改动
+- 引入新架构模式
+- 发现了值得复用的设计（可提议进 `standards/` 或 `system/`）
+
+## 7. 反哺上游（把个案变通用）
+
+本轮从个案**向上沉淀**的三个方向：
+
+| 方向 | 目标文件 | 示例 |
+| --- | --- | --- |
+| **standards/** 更新 | `quality/*` / `frontend/*` | 新发现的测试 / a11y / 性能技巧 |
+| **system/** 更新 | `system/adrs/` + `SYSTEM-SPEC.md` | 架构决策 / 跨模块约束 |
+| **templates/** 更新 | 各领域模板 | 新发现的可复用模板 |
+
+**原则**：如果一个"个案经验"在下一轮中大概率还会再遇到 → 立刻上沉。
+
+## 8. 发布同步
+
+使用 `document-release` skill：
+- 更新 `README.md` / `ARCHITECTURE.md` / `CLAUDE.md` / `CONTRIBUTING.md`（若相关）
+- 校正 `CHANGELOG.md`
+- 清理已完成的 TODO
+
+## 质量门禁（关闭本轮迭代前）
+
+- [ ] Changelog 更新到位且符合规约
+- [ ] P0 / P1 Bugfix → Postmortem 完成且入 `docs/{module}/archive/`
+- [ ] Postmortem 的 Action Items 全部有负责人 + 期限
+- [ ] ADR 已产出（若有架构决策）且进 `docs/system/adrs/`
+- [ ] SYSTEM-SPEC.md 已更新（若有跨模块约束）
+- [ ] 本轮沉淀出的通用知识已反哺到 `standards/` / `system/`
+- [ ] 历史快照（不再生效的旧设计）已进 `archive/{日期}-{标签}/`
+- [ ] 当前有效文档**保留在主目录**（proposal / spec / design / tasks 不挪动）
+- [ ] 知识图（大改动可选）已归档
+
+> **前序阶段**：`zsk:verify`  
+> **下一轮循环**：新的 `zsk:proposal` 启动

package/sdlc/bugfix/SKILL.md

@@ -0,0 +1,181 @@
+---
+name: zsk:bugfix
+description: Bugfix end-to-end orchestration — triage → reproduce → RCA (5 Whys
+  with confidence questions) → TDD fix (red first) → regression coverage →
+  postmortem (P0/P1 mandatory). Enforces Superpowers' bug confidence questioning
+  discipline.
+category: workflow
+domain: sdlc
+tier: core
+change_type: bugfix
+related:
+  - ../proposal/SKILL.md
+  - ../spec/SKILL.md
+  - ../design/SKILL.md
+  - ../coding/SKILL.md
+  - ../bugfix-tasks/SKILL.md
+  - ../archive/SKILL.md
+  - ../../quality/release/SKILL.md
+triggers:
+  - bug fix workflow
+  - fix defect
+  - RCA
+  - 5 whys
+  - bug confidence questions
+  - hotfix
+  - postmortem workflow
+---
+
+# Workflow: Bugfix（Bug 修复端到端）
+
+> **定位**：在 7 阶段基础上，针对"**修复已存在的错误行为**"编排工作流
+> **阶段映射**：proposal（Bug 报告）→ spec（Expected vs Actual）→ design（RCA + 修复）→ coding（TDD 红绿）→ reviewing（审 RCA 与回归）→ verify（证据链）→ archive（Postmortem）
+> **吸收硬原则**：Bug 置信度质疑（Superpowers `systematic-debugging`）
+
+## 核心纪律
+
+**动手修 bug 前先问三个问题**：
+
+1. 这个 bug **确实存在**吗？（有复现证据吗）
+2. 这个原因**真的是根因**吗？（还是上游问题的表现）
+3. 我的修复**真的会生效**吗？（有没有测试能断言）
+
+三问都有答案再动手。
+
+## 总览
+
+```text
+[Triage]       [Reproduce]      [RCA]         [TDD Fix]      [Regression]    [Ship]    [Postmortem]
+Proposal   →     Spec      →   Design    →     Coding       →   Verify     →  Ship  →    Archive
+Bug报告         复现+期望        5 Whys        Red→Green       相邻回归+证据    Hotfix?    Blameless
+```
+
+## 分步流程
+
+### Step 1：Triage & Proposal — Bug 报告与分级
+
+**Primary Skill**: `zsk:proposal`（Bugfix 模板） · GSD: Capture
+
+**Addendum**:
+- 按 [`zsk:proposal`](../proposal/SKILL.md) 的 Bugfix 型模板
+- 严重度 P0–P3 明确
+- 是否 Hotfix 决策在此做出（见 [`quality:release`](../../quality/release/SKILL.md)）
+
+**Exit**: 严重度 / 影响范围 / 复现步骤明确 · 证据完整（截图 / 录屏 / 日志 / trace）
+
+---
+
+### Step 2：Reproduce & Spec — 复现并明确期望
+
+**Primary Skill**: `superpowers:systematic-debugging`（先质疑 bug 存在）· `hunt` · `investigate` · 按栈选浏览器/环境复现工具 · GSD: Clarify
+
+**Addendum**:
+- 按 [`zsk:spec`](../spec/SKILL.md) 的 Bugfix 型模板
+- **最小复现用例（MCVE）**
+- Expected vs Actual 行为矩阵
+- BDD 场景描述
+- 回归测试覆盖范围声明
+
+**Output**: `docs/{module}/spec.md`（Bugfix 规格）· 最小复现脚本
+
+**Exit**: 能稳定复现 · Expected vs Actual 清晰 · Bug 存在性通过置信度质疑
+
+---
+
+### Step 3：RCA & Design — 根因分析与修复方案
+
+**Primary Skill**: `superpowers:systematic-debugging` · `debugging` / `investigate` · `codex`（独立二意见）· `graphify`（查调用链）· GSD: Reflect
+
+**Addendum**:
+- 按 [`zsk:design`](../design/SKILL.md) 的 Bugfix 型模板
+- **5 Whys** 根因分析
+- 修复点最小化（不借机重构）
+- 影响面评估（直接 / 上游 / 下游）
+- 防回归方案
+- **通过三问置信度质疑**（bug 存在？RCA 是真根因？修复真的消除？）
+
+**Exit**: 5 Whys 到达根因（不止步于表层）· 修复范围最小 · 有测试能断言修复有效 · 置信度三问全部回答
+
+---
+
+### Step 4：Coding — TDD Fix
+
+**Primary Skill**: `superpowers:test-driven-development`（强制）· `superpowers:executing-plans` · `zsk:coding`
+
+**Addendum**: 按 [`zsk:bugfix-tasks`](../bugfix-tasks/SKILL.md) 模板
+
+- **Red**：先写一个**必然失败**的测试覆盖 bug（用 Step 2 的最小复现）
+- **Green**：按 Design 的 RCA 修复，让测试变绿
+- **Refactor**：清理代码（不借机扩大）
+- 所有现有测试仍全绿
+
+**Exit**: 先红后绿的 commit 证据清晰 · 现有测试仍全绿 · 修复最小化
+
+---
+
+### Step 5：Reviewing — 审 RCA 与回归
+
+**Primary Skill**: `zsk:reviewing` · `codex review` / `merge-review`
+
+**Addendum**:
+- PR 描述包含：Bug 链接 / RCA 摘要 / 修复点 / 回归覆盖范围
+- Reviewer 必须确认：
+  - RCA 合理（非"凑巧 work"）
+  - 修复最小化（无借机重构）
+  - 新增测试能断言 bug 不会回归（可 checkout 修复前验证"确实红"）
+- 高风险 bug（P0 / P1）强制第二 Reviewer
+
+**Exit**: Reviewer Approve · 所有 `blocking:` 评论 resolved
+
+---
+
+### Step 6：Verify — 回归证据链
+
+**Primary Skill**: `superpowers:verification-before-completion` · `zsk:verify` · `qa`
+
+**Addendum**:
+- 原复现步骤走通（截图 / 录屏对照 —— before/after）
+- 相邻场景测试（状态矩阵邻项）
+- 边界条件测试
+- 相关质量维度核对（前端：a11y / i18n / 性能；后端：幂等 / 并发 / 权限）
+- **证据归档**：log 前后对照、测试报告、复现步骤回归
+- **P0 / P1 → Hotfix 流程**（见 [`quality:release`](../../quality/release/SKILL.md)）
+- **P2 / P3 → 常规发布**
+
+**Output**: 修复代码 + 回归测试 · 证据链（前后对照截图 / 报告）
+
+**Exit**: 原 bug 不再复现 · 所有测试全绿 · canary 无新异常
+
+---
+
+### Step 7：Archive — Postmortem（P0 / P1 必做）
+
+**Primary Skill**: `zsk:archive` · `retro`（团队复盘）· `graphify`（识别系统性风险）· `document-release`
+
+**Addendum（Blameless）**:
+- 按 [`zsk:archive`](../archive/SKILL.md) 的 Postmortem 模板
+- 归档位置：`docs/{module}/archive/{YYYY-MM-DD}-postmortem-{id}/`
+- Changelog 更新 **Fixed** 章节，链接 Postmortem
+
+必含：时间线 · 根因（与 RCA 一致）· 影响范围（用户 / 业务 / 数据）· 做对的 · 做得不好的 · **行动项**（可执行 + 负责人 + 期限）
+
+**原则**：对事不对人 · 聚焦系统性改进 · 行动项必须跟进到关闭
+
+**Exit**: Postmortem 已归档 · 行动项已录入后续迭代 · 预防性改进（monitor / 测试 / 文档）已落地
+
+## Skip 规则
+
+- P3 typo / 样式错别字：可跳过 Proposal / Design，直接测试 + 修复
+- P2 以上：不得跳过 RCA（不允许"先改改试试"）
+- P0 / P1：**必做 Postmortem**，不允许跳过
+
+## 质量门禁（端到端）
+
+- [ ] Bug 置信度三问全部回答
+- [ ] 5 Whys 到达真根因
+- [ ] TDD 流程严格执行（先红后绿）
+- [ ] 回归测试覆盖本 bug + 相邻场景
+- [ ] 修复最小化（无借机重构）
+- [ ] 证据链完整（log / 截图 / 报告）
+- [ ] Changelog Fixed 条目更新
+- [ ] P0 / P1 Postmortem 归档

package/sdlc/bugfix-tasks/SKILL.md

@@ -0,0 +1,232 @@
+---
+name: zsk:bugfix-tasks
+description: Bugfix task template with TDD enforcement — Step 1 Red (write
+  failing reproduction test), Step 2 Green (minimal fix, no opportunistic
+  refactor), Step 3 Regression (adjacent scenarios), Step 4 Evidence
+  (before/after reproduction). Requires Superpowers' 3 confidence questions
+  before starting.
+category: resource
+domain: sdlc
+tier: core
+change_type: bugfix
+related:
+  - ../bugfix/SKILL.md
+  - ../dor-dod/SKILL.md
+  - ../task-evidence/SKILL.md
+  - ../task-tracking/SKILL.md
+triggers:
+  - bugfix task template
+  - TDD bug fix
+  - red green regression
+  - bug confidence questions
+---
+
+# Bugfix Tasks — TDD 驱动的 Bug 修复任务模板
+
+> **用途**：Bug 修复的**任务列表模板**，直接复制到 `docs/{module}/tasks.md`
+> **适用**：修复已存在的错误行为
+> **硬原则**：**TDD 强制** — 先写必然失败的复现测试（Red），再修（Green），再回归验证
+
+## 核心纪律
+
+### Superpowers 置信度质疑（修 bug 前必问三问）
+
+1. **这个 bug 确实存在吗**？（有复现证据吗）
+2. **这个原因真的是根因吗**？（还是上游问题的表现）
+3. **我的修复真的会生效吗**？（有没有测试能断言）
+
+三问都有答案再动手。
+
+### TDD 硬流程
+
+```text
+Red（复现） → Green（修复） → Regression（回归）
+  必然失败      最小修复       相邻场景 + 边界
+   的测试      （不借机重构）  + 相关质量维度
+```
+
+## 完整模板（复制到 `docs/{module}/tasks.md`）
+
+```md
+# Bugfix Tasks: {简要描述}
+
+> 变更类型：Bugfix
+> 严重度：P0 / P1 / P2 / P3
+> 关联文档：proposal.md（Bug 报告）/ spec.md（Expected vs Actual）/ design.md（RCA）
+> 责任人：@{handle}
+> 日期：{YYYY-MM-DD}
+> 相关 Issue / Incident：#{id}
+
+## 任务概述
+
+{一句话描述 bug 现象 + 根因摘要，引用 design.md 的 RCA}
+
+## 置信度三问
+
+| 问题 | 答案 | 证据 |
+| --- | --- | --- |
+| bug 确实存在？ | ✅ / ❌ | {复现录屏链接} |
+| RCA 是真根因？ | ✅ / ❌ | {5 Whys 推理链接 → design.md} |
+| 修复点真的能消除？ | ✅ / ❌ | {测试用例能断言} |
+
+三项全 ✅ 方可进入执行。
+
+## DoR（启动前门禁）
+
+见 `zsk:dor-dod` 的 **通用 + Bugfix 专用** 清单。
+
+- [ ] 最小复现用例（MCVE）已捕获
+- [ ] 严重度明确
+- [ ] RCA（5 Whys）到达系统性根因（design.md）
+- [ ] 是否 Hotfix 已决策
+
+---
+
+## TDD 驱动修复流程
+
+### Step 1：复现 bug（Red）
+
+状态：`TODO`
+负责人：@{handle}
+覆盖 FR：{受影响的 FR 编号，引自 spec.md 的 "受影响契约项"}
+
+子任务：
+- [ ] 1.1 最小复现用例（MCVE）代码化（从 proposal.md 的复现步骤转成可执行）
+- [ ] 1.2 写一个**必然失败**的测试覆盖这个 bug
+- [ ] 1.3 运行测试 → 确认红（**不是语法错误**，是断言失败）
+- [ ] 1.4 commit：`test(scope): add failing test for bug #{id}`
+
+交付物：
+- 复现测试代码（单独 commit）
+- 失败输出截图 / CI 链接
+
+验证：
+- 新增测试能在 `git checkout HEAD^` 后仍然失败（真的在测 bug）
+
+---
+
+### Step 2：修复（Green）
+
+状态：`TODO`
+负责人：@{handle}
+覆盖 FR：{受影响的 FR 编号}
+
+子任务：
+- [ ] 2.1 按 design.md 的 RCA 修改代码（**最小改动**，不借机重构）
+- [ ] 2.2 运行 Step 1 的测试 → 变绿
+- [ ] 2.3 运行所有已有测试 → 全绿（无回归）
+- [ ] 2.4 commit：`fix(scope): {bug 简述} (#{id})`
+
+交付物：
+- 修复代码（独立 commit 与 Step 1 分开）
+- 测试全绿输出 / CI 链接
+
+验证：
+- `git diff HEAD~2` 能看到"先加失败测试再修"的 commit 序列
+
+---
+
+### Step 3：回归验证（Regression）
+
+状态：`TODO`
+负责人：@{handle}
+覆盖 FR：{相关 FR / NFR 编号}
+
+子任务：
+- [ ] 3.1 相邻场景测试（状态矩阵邻项）
+- [ ] 3.2 边界条件测试（空 / 极值 / 异常输入）
+- [ ] 3.3 相关质量维度未受影响（前端：a11y / i18n / 视觉；后端：幂等 / 并发 / 权限）
+- [ ] 3.4 性能未回退（若 bug 涉及性能路径）
+
+交付物：
+- 回归测试用例（新增 / 更新）
+- 回归运行报告
+
+验证：
+- 回归套件 100% 绿
+
+---
+
+### Step 4：证据归档（硬规则）
+
+状态：`TODO`
+负责人：@{handle}
+覆盖 FR：兜底 —— 证据链完整
+
+子任务：
+- [ ] 4.1 原复现步骤走通截图 / 录屏（对照 before 录屏）
+- [ ] 4.2 回归测试报告链接（含新增用例）
+- [ ] 4.3 log / trace 前后对照（如适用）
+- [ ] 4.4 AC 勾选（若 spec.md 有 bug 专用 AC）
+
+交付物：
+- 证据文件归档到 `docs/{module}/archive/{YYYY-MM-DD}-bug-{id}/`
+- 填写 `zsk:task-evidence` 的 **复现对照表** + **校验记录**
+
+验证：
+- 证据链接可点开、可追溯
+
+---
+
+## 发布决策（在 verify 阶段执行，此处仅登记）
+
+| 严重度 | 流程 |
+| --- | --- |
+| P0 / P1 | Hotfix 流程（`zsk:release`）+ Postmortem 强制 |
+| P2 / P3 | 常规发布 |
+
+## 任务依赖
+
+\`\`\`mermaid
+graph LR
+  S1[1. Red 复现测试] --> S2[2. Green 修复]
+  S2 --> S3[3. Regression 回归]
+  S3 --> S4[4. 证据归档]
+\`\`\`
+
+严格顺序，不可并行（TDD 纪律）。
+
+## 证据记录
+
+见 `zsk:task-evidence`，Bugfix 重点填：
+- **复现对照**（before/after 录屏）
+- **校验记录**（回归套件 + 相关质量维度）
+- **FR 覆盖矩阵**（受影响的 FR / NFR）
+
+## 总工作量
+
+- T-shirt：`S` / `M` / `L`（按 RCA 复杂度）
+- 人天：`{N}.{M}`
+
+---
+
+## DoD（关闭前门禁）
+
+见 `zsk:dor-dod` 的 **通用 + Bugfix 专用** 清单。
+
+- [ ] 原 bug 不再复现
+- [ ] 所有测试全绿（含新增回归）
+- [ ] 相邻场景无回归
+- [ ] P0 / P1 → Postmortem 已入 `docs/{module}/archive/`
+- [ ] Changelog `Fixed` 章节已写
+```
+
+## Skip 规则
+
+| 场景 | 简化 |
+| --- | --- |
+| P3 typo / 样式错别字 | 可以合并 Step 1+2（同一 commit 加测试 + 修），但必须有测试 |
+| 性能 bug（有 profile） | Step 3 必须补性能对照 |
+| 三方依赖 bug | Step 2 改为升级依赖 + 记 ADR，Step 3 重点回归相邻功能 |
+
+**不能省**：
+- ❌ 不能跳 Step 1（Red）— 违反 TDD 纪律
+- ❌ 不能跳 Step 4（证据）— P0/P1 尤其不能
+
+## 反模式（禁止）
+
+- ❌ **先改代码再补测试**（TDD 倒转，无法证明修复有效）
+- ❌ **借机重构**（扩大 diff，RCA 不清 + 风险放大）
+- ❌ **"大概这样就行"**（未跑回归就 merge）
+- ❌ **跳过置信度三问**（修错地方的典型前兆）
+- ❌ **Postmortem 只写不分析**（P0/P1 必须有 Action Items 到人到期）