npm - @captain_z/zsk-skills - Versions diffs - 0.1.0 - Mend

@captain_z/zsk-skills 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (55) hide show

package/README.md +263 -0
package/bundles.yaml +104 -0
package/design-handoff/.gitkeep +0 -0
package/design-handoff/figma-to-code/SKILL.md +265 -0
package/design-handoff/ue-mcp/SKILL.md +184 -0
package/frontend/.gitkeep +0 -0
package/frontend/a11y-web/SKILL.md +169 -0
package/frontend/api-contract-ts/SKILL.md +275 -0
package/frontend/css-bem/SKILL.md +268 -0
package/frontend/design-frontend/SKILL.md +163 -0
package/frontend/dor-dod-frontend/SKILL.md +114 -0
package/frontend/feature-tasks-frontend/SKILL.md +246 -0
package/frontend/i18n/SKILL.md +296 -0
package/frontend/nfr-web/SKILL.md +258 -0
package/frontend/performance-web/SKILL.md +299 -0
package/frontend/react-components/SKILL.md +211 -0
package/frontend/react-naming/SKILL.md +224 -0
package/frontend/review-frontend/SKILL.md +126 -0
package/frontend/security-web/SKILL.md +286 -0
package/frontend/spec-frontend/SKILL.md +141 -0
package/frontend/testing-web/SKILL.md +252 -0
package/frontend/typescript/SKILL.md +219 -0
package/meta/.gitkeep +0 -0
package/meta/philosophy/SKILL.md +221 -0
package/package.json +24 -0
package/quality/.gitkeep +0 -0
package/quality/a11y-principles/SKILL.md +155 -0
package/quality/code-hygiene/SKILL.md +126 -0
package/quality/release/SKILL.md +209 -0
package/quality/security-owasp/SKILL.md +157 -0
package/quality/testing-pyramid/SKILL.md +173 -0
package/sdlc/.gitkeep +0 -0
package/sdlc/archive/SKILL.md +267 -0
package/sdlc/bugfix/SKILL.md +181 -0
package/sdlc/bugfix-tasks/SKILL.md +232 -0
package/sdlc/coding/SKILL.md +177 -0
package/sdlc/design/SKILL.md +299 -0
package/sdlc/dor-dod/SKILL.md +120 -0
package/sdlc/feature/SKILL.md +162 -0
package/sdlc/proposal/SKILL.md +271 -0
package/sdlc/refactor/SKILL.md +220 -0
package/sdlc/refactor-tasks/SKILL.md +265 -0
package/sdlc/reviewing/SKILL.md +197 -0
package/sdlc/spec/SKILL.md +235 -0
package/sdlc/task/SKILL.md +116 -0
package/sdlc/task-evidence/SKILL.md +178 -0
package/sdlc/task-structure/SKILL.md +153 -0
package/sdlc/task-tracking/SKILL.md +192 -0
package/sdlc/verify/SKILL.md +181 -0
package/system/.gitkeep +0 -0
package/system/adr/SKILL.md +169 -0
package/system/architecture/SKILL.md +182 -0
package/system/glossary/SKILL.md +141 -0
package/system/nfr-baseline/SKILL.md +156 -0
package/system/project-constraints-template/SKILL.md +241 -0

package/sdlc/coding/SKILL.md ADDED Viewed

@@ -0,0 +1,177 @@
+---
+name: zsk:coding
+description: Coding execution after design freeze — write code and tests, follow
+  branch/commit conventions, enforce TDD for bugfix/refactor, respect dependency
+  hygiene, pass local quality gates before review. Stage 4 of the 7-stage SDLC.
+category: stage
+domain: sdlc
+tier: core
+stage: 4
+variants:
+  - feature
+  - bugfix
+  - refactor
+related:
+  - ../design/SKILL.md
+  - ../reviewing/SKILL.md
+  - ../dor-dod/SKILL.md
+  - ../task/SKILL.md
+  - ../../quality/testing-pyramid/SKILL.md
+  - ../../quality/code-hygiene/SKILL.md
+triggers:
+  - implementing design
+  - TDD red green refactor
+  - conventional commits
+  - gitlab flow
+  - dependency hygiene
+  - local quality gates
+  - coding stage
+---
+# Stage 4: Coding
+> **阶段定位**：开发 - Execution
+> **回答的问题**：按什么顺序动手、测试怎么写、什么算可以提交评审
+> **参考规范**：Conventional Commits、GitLab Flow、Mike Cohn 测试金字塔、GSD Engage
+> **吸收硬原则**：
+> - **Red-Green-Refactor**（Superpowers `test-driven-development`）
+> - **证据先于断言**（Superpowers `verification-before-completion`）— 本阶段产出证据链接，`verify.md` 兜底审计
+> - **Bug 置信度质疑**（Superpowers `systematic-debugging`）— 修 bug 前先问三问
+## Skill 映射
+| 场景 | Primary Skill |
+| --- | --- |
+| 执行计划 | `superpowers:executing-plans` |
+| TDD | `superpowers:test-driven-development` |
+| 隔离开发 | `superpowers:using-git-worktrees` |
+| 提交 | `code-commit` |
+| Debug | `superpowers:systematic-debugging` / `debugging` / `hunt` / `investigate` |
+| GSD 心智 | Engage |
+## 阶段职责
+coding 阶段**做三件事**：
+1. **动手实现**：按 spec / design 写代码 + 测试
+2. **按任务框架推进**：用 [`zsk:task`](../task/SKILL.md) 导航、按变更类型挑任务模板填写 `docs/{module}/tasks.md`，每项任务显式声明"覆盖 FR"
+3. **按协作规范提交**：分支 + commit + 依赖卫生 + 本地门禁
+**不做**：
+- ❌ 代码评审（→ `zsk:reviewing`）
+- ❌ 验收断言（→ `zsk:verify`）
+- ❌ 归档 / Postmortem（→ `zsk:archive`）
+## 变更类型差异
+| 类型 | Coding 侧重 | 用的任务模板 |
+| --- | --- | --- |
+| **Feature** | 金字塔三层 + TDD 优先（通用） · 组件类另见 [`frontend/feature-tasks-frontend`](../../frontend/feature-tasks-frontend/SKILL.md) | — |
+| **Bugfix** | TDD 强制：先写失败测试复现 bug（Red） → 修（Green） → 回归 | [`zsk:bugfix-tasks`](../bugfix-tasks/SKILL.md) |
+| **Refactor** | Characterization Test 先行 → 小步原子 commit → 每步行为不变 | [`zsk:refactor-tasks`](../refactor-tasks/SKILL.md) |
+## 测试在 coding 阶段做什么
+测试用例四段归属：
+| What / How | 归属 |
+| --- | --- |
+| What to test（AC / BDD 场景） | `zsk:spec`（阶段 2） |
+| How to test（金字塔分配 / 工具选型） | `zsk:design`（阶段 3） |
+| **Write & run tests**（实现代码） | **本阶段** |
+| Acceptance evidence（跑出来的结果 + AC 勾选） | `zsk:verify`（阶段 6） |
+本阶段**必须**做：
+- 按 spec 的 AC / BDD 写可执行测试（规范见 [`quality/testing-pyramid`](../../quality/testing-pyramid/SKILL.md)）
+- 新功能优先 TDD；Bugfix 强制 TDD（先红后绿）；Refactor 强制 Characterization Test 先行
+- 三层金字塔都要有任务条目：unit / integration / e2e
+- （前端项目）a11y 自动化扫描 — 见 `frontend/a11y-web.md`
+## 分支策略（GitLab Flow）
+- **主干**：`{{config.git.main_branch}}`
+- **功能**：`{{config.git.feature_branch_pattern}}`（如 `feature/{scope}`）
+- **修复**：`{{config.git.fix_branch_pattern}}`（如 `fix/{issue-id}`）
+- **重构**：`{{config.git.refactor_branch_pattern}}`（如 `refactor/{scope}`）
+- **文档**：`{{config.git.docs_branch_pattern}}`（如 `docs/{topic}`）
+- 长期 diverge（> 2 周）必须 rebase
+- 禁止直接向主干提交，必须经 MR / PR
+## Commit 规约（Conventional Commits）
+```text
+<type>(<scope>): <subject>
+<body>
+<footer>
+```
+### type
+| type | 用途 |
+| --- | --- |
+| `feat` | 新功能 |
+| `fix` | 缺陷修复 |
+| `docs` | 仅文档 |
+| `refactor` | 重构（不改行为） |
+| `perf` | 性能优化 |
+| `test` | 测试相关 |
+| `style` | 格式（不影响逻辑） |
+| `chore` | 构建 / 依赖 / 工具 |
+| `ci` | CI 配置 |
+| `revert` | 回滚 |
+### 规则
+- `subject`：祈使句，≤ 50 字符，不加句号
+- `body`：解释 **why**，不复述 **what**，≤ 72 字符/行
+- Breaking change：footer `BREAKING CHANGE:` 开头
+- 关联 issue：`Closes #{issue}` / `Refs #{issue}`
+## 依赖卫生
+- 新增依赖必须在 PR 中说明：**用途 / 许可证 / 体积 / 替代方案**
+- 禁止 `{{config.quality.security.forbidden_licenses}}` 列表中的 license（默认 GPL / AGPL）
+- 版本锁定（`package-lock.json` / `yarn.lock` / `pnpm-lock.yaml` / `Cargo.lock` / `poetry.lock` / `Gemfile.lock` — 按语言栈选）；不手改版本符号
+- 高危漏洞 `{{config.quality.security.cve_response_hours}}` 小时内响应（见 [`quality/security-owasp`](../../quality/security-owasp/SKILL.md)）
+- 优先使用项目统一 SDK（`{{config.stack.sdk_packages}}`）
+## 项目特定约束
+**以下在每个项目各有差异，本阶段动手前必读**：
+| 约束维度 | 位置 |
+| --- | --- |
+| Import 起源（UI / i18n / HTTP / 路由 / 状态） | `SYSTEM-SPEC.md` 的"项目约束速查表"（见 [`system/project-constraints-template`](../../system/project-constraints-template/SKILL.md)） |
+| 禁用模式 | `SYSTEM-SPEC.md` + `system/adrs/` |
+| 必用封装 | `SYSTEM-SPEC.md` 的技术约定章节 |
+| i18n 命名空间 | `{{config.i18n.namespace}}` |
+新项目启动时先运行 `npx @captain_z/zsk project-init` 产出 `project-config.yaml` → 再填 `SYSTEM-SPEC.md`。
+## 本地门禁（进入 reviewing 前必过）
+- `lint` 零 error（项目命令 `{{config.scripts.lint}}`）
+- `type-check` 零 error（项目命令 `{{config.scripts.type_check}}`）
+- `test` 全绿 + 覆盖率达标（项目命令 `{{config.scripts.test}}`）
+- `build` 成功（项目命令 `{{config.scripts.build}}`）
+未跑过命令**不得**声称"通过"（证据先于断言硬原则）。
+## Skip 规则
+- 小重构（rename / extract function / inline）：跳过完整流程，自评清单兜住即可
+- 微调 bug（typo / 样式错别字）：可跳过 proposal，但**仍需测试覆盖**
+- 大型变更（跨模块 / 架构迁移）：**禁止**跳过任何阶段
+## 出口条件（可以进 `zsk:reviewing`）
+- [ ] 变更类型声明明确
+- [ ] DoR 清单全绿（见 [`zsk:dor-dod`](../dor-dod/SKILL.md)）
+- [ ] 任务列表每项都有"覆盖 FR"编号
+- [ ] 测试金字塔三层均有任务且绿
+- [ ] 本地 lint / type-check / test / build 零 error
+- [ ] Commit 信息遵循 Conventional Commits
+- [ ] 阻塞记录已更新
+- [ ] TDD 流程遵守（Bugfix / Refactor 强制）

package/sdlc/design/SKILL.md ADDED Viewed

@@ -0,0 +1,299 @@
+---
+name: zsk:design
+description: FR/NFR → implementation plan translation after spec freeze — ADR
+  decisions, architecture diagrams (C4 + sequence), file responsibilities,
+  FR→code mapping, error handling, rollback, observability. Stage 3 of the
+  7-stage SDLC.
+category: stage
+domain: sdlc
+tier: core
+stage: 3
+variants:
+  - feature
+  - bugfix
+  - refactor
+related:
+  - ../spec/SKILL.md
+  - ../coding/SKILL.md
+  - ../../frontend/design-frontend/SKILL.md
+  - ../../system/adr/SKILL.md
+  - ../../system/architecture/SKILL.md
+triggers:
+  - technical design
+  - ADR architecture decision
+  - C4 diagram
+  - FR mapping
+  - RCA 5 whys
+  - Fowler catalog
+  - Parallel Change
+  - rollback strategy
+---
+# Stage 3: Design
+> **阶段定位**：架构设计 - Solution Design
+> **回答的问题**：怎么落地、文件怎么拆、契约如何映射到实现
+> **参考规范**：C4 Model（Simon Brown）、4+1 架构视图（Kruchten）、ADR（Michael Nygard / MADR）
+> **与 Spec 的边界**：Spec 定"做什么"，Design 定"怎么做"；Design 不新增 Spec 未声明的公开接口或行为
+> **前端专属映射**：Props / UE 状态 / Figma / 性能预算见 [`frontend/design-frontend.md`](../../frontend/design-frontend/SKILL.md)
+## Skill 映射
+| 场景 | Primary Skill |
+| --- | --- |
+| 架构决策 | `zsk:design`（本 skill）+ `zsk:adr` |
+| 设计评审 | `plan-eng-review` / `plan-design-review` / `plan-ceo-review` |
+| 代码映射 | `graphify`（现状 → 图） |
+| 第二意见 | `codex` |
+| 深度研究 | `context7`（最新库实践） |
+## 变更类型差异
+| 类型 | Design 侧重 |
+| --- | --- |
+| **Feature** | ADR + 上下文/时序图 + 文件职责 + FR→落点 + 错误/回滚 |
+| **Bugfix** | **RCA（5 Whys）** + 修复点 + 防回归方案 + 影响面 |
+| **Refactor** | 重构手法（Fowler catalog）+ Parallel Change / Strangler Fig + 回滚步骤 |
+## 标准结构（Feature 型）
+1. 模块映射与事实源承接
+2. 当前实现 / 现状
+3. 架构决策（ADR 列表，详细模板见 `system/adr.md`）
+4. 上下文与关键流程图（Mermaid C4 + sequence）
+5. 文件职责与分层
+6. 目录架构设计
+7. **FR 实现映射**（FR → 入口文件 + 策略要点 + 关联 ADR + 覆盖任务）
+8. **NFR 实现映射**（NFR → 实现手段 + 验证方式）
+9. 错误处理与降级策略
+10. 回滚与迁移策略
+11. 观测性接入
+12. 测试方案（与 `coding.md` 对齐）
+13. 风险与权衡
+14. 变更文件清单
+> 前端项目还需：Props 映射 / UE 状态 → 结构 / Figma → 实现 / 性能预算（Core Web Vitals）→ 见 `frontend/design-frontend.md`
+## 核心要求
+### 1. 关键决策必须 ADR 化
+不可逆 / 跨模块 / 引入新依赖 / 放弃既有方案的决策必须结构化记录（模板见 [`system/adr.md`](../../system/adr/SKILL.md)）：
+```md
+### ADR-{序号}：{决策名}
+- 状态 / 上下文 / 决策 / 理由 / 替代方案 / 后果
+```
+### 2. 架构图（Mermaid 内联）
+至少两张：
+- **上下文图**（C4 Context / Component）：本模块与外部的关系
+- **关键流程时序图**：P0 用户路径的控制流与数据流
+### 3. FR 实现映射（交叉引用核心）
+**规则**：
+- Spec 的每一条 `FR-{n}` 必须对应至少一条落点行，"待定"不被允许
+- 跨多文件 → 展开多行，或用 `入口文件 / 协同文件` 两列
+- 本迭代不实现的 FR → 注明 `本迭代不实现，延后至 {module-next}`
+- NFR 另表：每条 `NFR-{n}` 必须说明**实现手段**与**验证方式**
+- 只引用 Spec 已有的编号，**不自创**；Spec 编号不足 → 回到 Spec 补号再继续
+### 4. 错误处理与降级
+- 请求失败如何呈现（toast / 行内 / 页面级）
+- 可重试 + 重试策略（次数 / 退避）
+- 错误边界位置（适用于前端框架）
+- 降级路径（5xx / 超时 / 越权分别如何）
+### 5. 回滚与迁移
+替换或改造既有代码时必填：
+- 替换范围 + 文件清单
+- 兼容期（双跑 / feature flag / 灰度）
+- 回滚触发条件
+- 数据 / 状态 / i18n key 的迁移步骤
+### 6. 观测性与性能预算
+观测性：
+- 错误上报入口
+- 关键交互埋点
+- 性能标记（`performance.mark` / 平台等价物）
+性能预算：**量化**首屏 / 交互响应 / 包体积增量上限 / 请求数上限（前端项目补 Core Web Vitals，见 `frontend/nfr-web.md`）。
+## Feature 型模板
+```md
+# {模块} 技术设计（Design）
+> 模块唯一标识：`{module-id}`
+> 变更类型：Feature
+> 关联 Spec：`docs/{module}/spec.md`
+## 模块映射
+## 当前实现 / 现状
+## 架构决策（ADRs）
+### ADR-1：{决策名}
+- 状态 / 上下文 / 决策 / 理由 / 替代方案 / 后果
+## 上下文与关键流程图
+\`\`\`mermaid
+flowchart LR
+  A[Caller] --> B[This Module] --> C[Service] --> D[API]
+\`\`\`
+\`\`\`mermaid
+sequenceDiagram
+  participant U as User
+  participant M as Module
+  participant S as Service
+\`\`\`
+## 文件职责与分层
+| 文件 | 职责 | 说明 |
+| --- | --- | --- |
+## 目录架构
+\`\`\`text
+{{config.paths.components_root}}/{module}/
+├── ...
+\`\`\`
+## FR 实现映射
+| FR 编号 | 功能描述（摘自 Spec） | 入口文件 | 实现策略要点 | 关联 ADR | 覆盖任务 |
+| --- | --- | --- | --- | --- | --- |
+| FR-1 |  |  |  | ADR-1 | T-2.1 |
+## NFR 实现映射
+| NFR 编号 | 要求（摘自 Spec） | 实现手段 | 关联文件 | 验证方式 |
+| --- | --- | --- | --- | --- |
+## 本迭代延后的 FR（若有）
+| FR 编号 | 延后原因 | 目标迭代 |
+| --- | --- | --- |
+## 错误处理与降级
+| 错误类别 | 呈现方式 | 可重试 | 降级 |
+| --- | --- | --- | --- |
+## 回滚与迁移
+- 兼容期策略：
+- 回滚触发条件：
+- 迁移步骤：
+## 观测性接入
+| 事件 | 位置 | 上报字段 |
+| --- | --- | --- |
+## 性能预算
+| 指标 | 目标 | 测量方式 |
+| --- | --- | --- |
+## 安全考虑
+## 测试方案
+## 风险与权衡
+## 变更文件清单
+```
+## Bugfix 型模板（核心：RCA + 置信度质疑）
+```md
+# Bugfix Design: {简要描述}
+## RCA（根因分析 - 5 Whys）
+### 表层症状
+### 5 Whys
+1. Why 1：...
+2. Why 2：...
+3. Why 3：...
+4. Why 4：...
+5. Why 5：...（系统性根因）
+### 证据
+- 日志 / trace / reproduce commit
+### Bug 置信度质疑（Superpowers）
+- [ ] 确认 bug 确实存在（有复现）
+- [ ] 确认 RCA 是真根因
+- [ ] 确认修复点真的能消除（有测试能断言）
+## 修复方案
+### 最小修复点
+- 文件 / 改动说明
+### 为什么不是其他方案
+### 影响面（直接 / 上游 / 下游）
+## 防回归
+### 新增测试（先红后绿 / TDD）
+- 单元 / 集成 / 回归
+### 相邻场景核对
+## Postmortem 触发
+- [ ] P0 / P1 → 必走 Postmortem（见 `archive.md`）
+- [ ] P2 / P3 → 可选
+```
+## Refactor 型模板（核心：Fowler + Parallel Change）
+```md
+# Refactor Design: {简要描述}
+## 当前结构坏味证据
+- 位置 / 坏味类型 / 度量证据
+## 目标结构
+## 使用的重构手法（Fowler Catalog）
+| 手法 | 应用位置 | 说明 |
+| --- | --- | --- |
+| Extract Function |  |  |
+| Rename / Move |  |  |
+| Replace Conditional with Polymorphism |  |  |
+## 迁移策略
+### 小 / 中重构
+- 小步原子 commit（每步测试全绿）
+- 一次一个手法
+### 大重构（Parallel Change / Strangler Fig）
+1. **Expand** — 新接口 / 新实现并存
+2. **Migrate** — 调用方逐个迁移
+3. **Contract** — 移除旧实现
+- 每阶段可独立部署 + 回滚
+## 回滚策略
+- 每步独立 commit，可 revert
+## 行为不变验证
+- 现有测试全绿 / Characterization 全绿 / 性能 / 视觉 / 体积对照
+```
+## 质量门禁
+- [ ] 变更类型声明明确
+- [ ] 关键决策都有 ADR（Feature / Refactor-大）
+- [ ] 至少 1 张上下文图 + 1 张时序图（Feature）
+- [ ] **Spec 每条 FR / NFR 都有落点行，无"待定"**
+- [ ] **FR / NFR 编号引自 Spec，未自创**
+- [ ] RCA 完整且通过置信度质疑（Bugfix）
+- [ ] Bugfix 已引用 Spec 的 FR/NFR/AC 编号作为受影响契约项
+- [ ] 重构手法来自 Fowler catalog（Refactor）
+- [ ] Refactor 保留原 FR → 实现落点（外部行为不变）
+- [ ] 错误处理 / 降级 / 回滚策略明确
+- [ ] 观测性接入已声明
+- [ ] 性能预算量化
+- [ ] 未新增 Spec 未声明的行为
+- [ ] 前端模块：已补 `frontend/design-frontend.md` 对应映射
+## 出口条件（可以进 `zsk:coding`）
+- [ ] 质量门禁全过
+- [ ] 至少走完一次 `plan-eng-review`
+- [ ] 所有 ADR 状态为 Accepted

package/sdlc/dor-dod/SKILL.md ADDED Viewed

@@ -0,0 +1,120 @@
+---
+name: zsk:dor-dod
+description: DoR/DoD gates between SDLC stages — generic DoR/DoD for all change
+  types; frontend-specific rows (UE matrix / ue-mcp / 三语 i18n / 视觉回归 / axe) are
+  in frontend:dor-dod-frontend.
+category: resource
+domain: sdlc
+tier: core
+variants:
+  - feature
+  - bugfix
+  - refactor
+related:
+  - ../task/SKILL.md
+  - ../task-structure/SKILL.md
+  - ../task-evidence/SKILL.md
+  - ../verify/SKILL.md
+  - ../../frontend/dor-dod-frontend/SKILL.md
+triggers:
+  - definition of ready
+  - definition of done
+  - DoR DoD
+  - task gate
+  - stage exit
+---
+# DoR & DoD — 任务启动与关闭门禁
+> **用途**：启动一个任务前跑 DoR；交付 / 关闭前跑 DoD
+> **通用版 + 变更类型专用**；前端项目的额外条款（UE / Figma / 三语 / a11y / 视觉回归）见 [`frontend:dor-dod-frontend`](../../frontend/dor-dod-frontend/SKILL.md)
+## Definition of Ready（DoR）— 启动前门禁
+### 通用（所有变更类型）
+- [ ] `proposal.md` 已确认（变更类型 / 责任人 / 事实源明确）
+- [ ] `spec.md` 已冻结（FR / NFR / US / AC **已编号**，无"待定"）
+- [ ] `design.md` 已冻结（ADR / 错误处理 / 回滚齐全，FR/NFR 映射表无空缺）
+- [ ] 依赖的上游任务已完成
+- [ ] 验收标准可测（BDD Given/When/Then）
+### Feature 专用
+- [ ] NFR 六类（性能 / 可靠性 / 安全 / 国际化 / 兼容性 / 可观测性）全覆盖
+- [ ] 后端契约目录（若涉及接口）已对齐
+> 前端模块额外：UE 状态矩阵覆盖、`ue-mcp.md` 登记、Props / Event Contract 完整 — 见 [`frontend:dor-dod-frontend`](../../frontend/dor-dod-frontend/SKILL.md)
+### Bugfix 专用
+- [ ] 最小复现用例（MCVE）已捕获
+- [ ] 严重度分级（P0 / P1 / P2 / P3）明确
+- [ ] 根因假设已写入 `proposal.md`（待 Design 阶段 RCA 验证）
+- [ ] 是否需要 Hotfix 已决策（P0 / P1 默认是）
+### Refactor 专用
+- [ ] 触发条件有度量证据（不能是"我觉得该重构"）
+- [ ] Fowler 分级（小 / 中 / 大）明确
+- [ ] 公开接口保留清单已在 Spec 列出
+- [ ] Characterization Test 基线已准备（或已补齐）
+- [ ] 行为不变声明明确
+---
+## Definition of Done（DoD）— 关闭前门禁
+### 通用（所有变更类型）
+- [ ] 代码通过 `zsk:reviewing` 流程并 Approve
+- [ ] 单元测试通过且覆盖关键分支
+- [ ] 集成 / E2E 测试通过（如适用）
+- [ ] `lint` / `type-check` / `build` 零 error（`{{config.scripts.lint}}` / `{{config.scripts.type_check}}` / `{{config.scripts.build}}`）
+- [ ] 相关文档已更新（`docs/{module}/tasks.md` 勾选到位）
+- [ ] **FR 覆盖矩阵**所有 P0 FR 都有"覆盖任务 + 验收证据"（见 [`zsk:task-evidence`](../task-evidence/SKILL.md)）
+- [ ] **校验记录**每行有证据链接（证据先于断言）
+> 前端模块额外：视觉回归 / i18n 三语 / a11y / CWV — 见 [`frontend:dor-dod-frontend`](../../frontend/dor-dod-frontend/SKILL.md)
+### Feature 专用
+- [ ] NFR 六类全部有证据
+- [ ] AC 逐条勾选，每条有证据（测试报告 / 录屏 / 截图）
+- [ ] Changelog `Added` 章节已写，引用 Spec FR 编号
+### Bugfix 专用
+- [ ] 原复现步骤按 `proposal.md` 执行 → 不再复现（截图 / 录屏）
+- [ ] 新增回归测试在主干绿
+- [ ] 相邻场景回归全绿（无"按下葫芦浮起瓢"）
+- [ ] Changelog `Fixed` 章节已写
+- [ ] P0 / P1 → Postmortem 已入 `docs/{module}/archive/`
+### Refactor 专用
+- [ ] 所有现有测试全绿（含 Characterization Test）
+- [ ] 视觉 / 性能 / 包体积对照无回退
+- [ ] 对外契约零变化
+- [ ] commit 序列可逐步 replay（checkout 每步测试都绿）
+- [ ] Changelog 仅 `Changed` / `Removed`，**禁止** `Added` / `Fixed`
+---
+## Exit Criteria（阶段出口速查）
+| 从 → 到 | 必须满足 |
+| --- | --- |
+| design → coding | DoR 全绿 |
+| coding → reviewing | 本地 lint / type-check / test 零 error + 任务列表覆盖 FR 完整 |
+| reviewing → verify | 所有 `blocking:` 评论 resolved + Reviewer Approve |
+| verify → archive | DoD 全绿 + FR 覆盖矩阵完整 + 校验记录每行有证据 |
+| archive → 下一轮 proposal | Postmortem（P0/P1）+ ADR + Changelog + 反哺判定完成 |
+## 反模式（禁止）
+- ❌ **未跑过命令就声称"通过"**（违反证据先于断言）
+- ❌ **DoR 不全就启动**（后续一定会回工）
+- ❌ **DoD 未核完就 merge**（典型引入 verify 阶段返工）
+- ❌ **FR/AC 没编号**（追溯链断，下游无法锚定）
+- ❌ **"补证据的 PR"**（证据必须在声明"通过"的同一 PR）