@captain_z/zsk-skills 0.1.0

package/sdlc/feature/SKILL.md

@@ -0,0 +1,162 @@
+---
+name: zsk:feature
+description: Feature end-to-end orchestration across 7 SDLC stages —
+  brainstorming → writing-plans → plan-eng-review → executing-plans+TDD →
+  requesting/receiving-code-review → verification-before-completion →
+  finishing-a-development-branch.
+category: workflow
+domain: sdlc
+tier: core
+change_type: feature
+related:
+  - ../proposal/SKILL.md
+  - ../spec/SKILL.md
+  - ../design/SKILL.md
+  - ../coding/SKILL.md
+  - ../reviewing/SKILL.md
+  - ../verify/SKILL.md
+  - ../archive/SKILL.md
+  - ../../frontend/feature-tasks-frontend/SKILL.md
+triggers:
+  - new feature workflow
+  - feature end to end
+  - start feature
+  - feature stages
+  - brand new capability
+---
+
+# Workflow: Feature（新功能端到端）
+
+> **定位**：在 7 阶段基础上，针对"**新增功能**"编排完整工作流
+> **阶段映射**：proposal → spec → design → coding → reviewing → verify → archive
+> **适用**：新组件 / 新页面 / 新能力 / 新接入点
+
+## 总览
+
+```text
+[Capture/Clarify]  [Organize]   [Reflect]   [Engage]         [Review]      [Verify]         [Knowledge]
+   proposal    →     spec    →   design   →   coding     →   reviewing  →  verify        →   archive
+ brainstorming  writing-plans  plan-review  executing-plans  requesting   verification        graphify
+                                            + TDD            receiving    before-completion
+```
+
+## 分步流程
+
+### Step 1：Proposal — 为什么做
+
+**Primary Skill**: `superpowers:brainstorming` · `zsk:proposal` · GSD: Capture → Clarify
+
+**Addendum**:
+- 按 [`zsk:proposal`](../proposal/SKILL.md) 的 Feature 型模板
+- 必须关联 `{{config.paths.srs}}`（设计交付时补 `{{config.paths.figma_index}}`）
+- 目标 SMART + 备选方案 ≥ 2 + RACI + 风险分级
+
+**Output**: `docs/{module}/proposal.md`
+
+**Exit**: "为什么做" 3 分钟能讲清 · "不做什么" 明确 · 事实源指向真实路径
+
+---
+
+### Step 2：Spec — 做什么
+
+**Primary Skill**: `superpowers:writing-plans` · `zsk:spec` · `think` · GSD: Organize
+
+**Addendum**:
+- 按 [`zsk:spec`](../spec/SKILL.md) 的 Feature 型模板
+- User Stories 满足 INVEST
+- BDD Given/When/Then ≥ 1 Happy + 1 Edge
+- FR / NFR / US / AC 编号完整
+- **前端模块补** [`frontend:spec-frontend`](../../frontend/spec-frontend/SKILL.md)：Props / Event Contract / UE 状态矩阵 / Figma 引用
+
+**Output**: `docs/{module}/spec.md`（+ 前端模块的 `ue-mcp.md` / `api-contract.md`）
+
+**Exit**: Spec 质量门禁全过 · UE / API 支撑文档齐全（前端）
+
+---
+
+### Step 3：Design — 怎么落地
+
+**Primary Skill**: `zsk:design` · `plan-eng-review` · `plan-design-review` · `plan-ceo-review` · `codex` · `graphify` · GSD: Reflect
+
+**Addendum**:
+- 按 [`zsk:design`](../design/SKILL.md) 的 Feature 型模板
+- 关键决策都走 ADR（模板 [`zsk:adr`](../../system/adr/SKILL.md)）
+- 上下文图 + 时序图（Mermaid 内联）
+- **前端模块补** [`frontend:design-frontend`](../../frontend/design-frontend/SKILL.md)：Props/UE 实现映射 + Figma → 实现 + 性能预算（CWV）
+- 错误 / 降级 / 回滚策略
+- 未新增 Spec 未声明的行为
+
+**Output**: `docs/{module}/design.md`
+
+**Exit**: Design 质量门禁全过 · 至少走完 `plan-eng-review`
+
+---
+
+### Step 4：Coding — 开发 + 测试
+
+**Primary Skill**: `superpowers:executing-plans` · `superpowers:test-driven-development` · `zsk:coding` · `superpowers:using-git-worktrees`（需隔离时）· `code-commit` · GSD: Engage
+
+**Addendum**:
+- 任务模板：通用用 [`zsk:task-structure`](../task-structure/SKILL.md)；组件/前端用 [`frontend:feature-tasks-frontend`](../../frontend/feature-tasks-frontend/SKILL.md)（7 类强制任务）
+- 遵循 [`zsk:coding`](../coding/SKILL.md) 的分支 / commit / 依赖卫生
+- 遵循 [`quality:testing-pyramid`](../../quality/testing-pyramid/SKILL.md)
+- 契约驱动：类型引自 Spec / 后端契约（`system/project-constraints-template`）
+
+**Exit**: 测试金字塔三层均有任务且绿 · 本地 lint / type-check / test 零 error · Commit 遵循 Conventional Commits
+
+---
+
+### Step 5：Reviewing — 代码评审
+
+**Primary Skill**: `superpowers:requesting-code-review` · `superpowers:receiving-code-review` · `zsk:reviewing` / `review` / `merge-review` / `codex review`
+
+**Addendum**:
+- 自评清单（通用见 [`zsk:reviewing`](../reviewing/SKILL.md)；前端补 [`frontend:review-frontend`](../../frontend/review-frontend/SKILL.md)）全绿
+- 至少 1 轮 Code Review 通过（高风险改动 ≥ 2 人）
+- Conventional Comments：`blocking:` / `issue:` / `suggestion:` / `nitpick:`
+- 分歧验证技术事实再决策
+
+**Exit**: 所有 `blocking:` 评论 resolved · Reviewer Approve · 合并轮次 ≤ 3
+
+---
+
+### Step 6：Verify — 验收
+
+**Primary Skill**: `superpowers:verification-before-completion` · `zsk:verify` · `self-review` / `check` · `qa` / `qa-only` · `design-review`（前端视觉）/ `benchmark`（前端性能）
+
+**Addendum**:
+- DoD 全绿（见 [`zsk:dor-dod`](../dor-dod/SKILL.md)）
+- FR 覆盖矩阵完整（Spec 每条 P0 FR 都有任务 + 验收证据）
+- AC 逐条勾选，每条有证据链接
+- 校验记录全绿（通用 + 前端项目补 `frontend:nfr-web` 的视觉 / a11y / i18n / 性能 / 安全）
+
+**Output**: `docs/{module}/tasks.md`（全程更新）· 代码 + 测试 · PR / MR · Changelog 条目 · 证据链
+
+**Exit**: DoD 全满足 · 合并主干 · canary 无异常（若有发布监控）
+
+---
+
+### Step 7：Archive — 归档 / 知识沉淀
+
+**Primary Skill**: `zsk:archive` · `graphify` · `document-release` · `retro`（可选）
+
+**Addendum**:
+- Changelog `Added` 条目引用 Spec FR 编号
+- 归档入 `SYSTEM-SPEC.md`（如有系统级约定）
+- 历史快照保存到 `docs/{module}/archive/{YYYY-MM-DD}-{需求名}/`
+- 遵循 [`quality:release`](../../quality/release/SKILL.md)（SemVer / Changelog / 回滚预案）
+- 发布后 30 分钟 canary 观察（若适用）
+
+## Skip 规则
+
+- 微调型 Feature（文案 / 样式微调）：可跳过 Proposal，从 Spec 开始
+- 接入型 Feature（仅组装现有组件）：可简化 Design，保留核心 ADR
+
+## 质量门禁（端到端）
+
+- [ ] 七阶段产物齐全
+- [ ] 支撑文档按需（前端：ue-mcp / api-contract）
+- [ ] Standards 规范遵守（code-hygiene / i18n / testing / release）
+- [ ] 每步都有对应 skill 调用记录
+- [ ] 证据链完整
+- [ ] PR 合并 + canary 通过

package/sdlc/proposal/SKILL.md

@@ -0,0 +1,271 @@
+---
+name: zsk:proposal
+description: New-change framing (feature / bugfix / refactor) before spec work —
+  why, success criteria, out-of-scope boundary, alternatives considered, and
+  risks. Always the first stage of the 7-stage SDLC.
+category: stage
+domain: sdlc
+tier: core
+stage: 1
+variants:
+  - feature
+  - bugfix
+  - refactor
+related:
+  - ../spec/SKILL.md
+  - ../feature/SKILL.md
+  - ../bugfix/SKILL.md
+  - ../refactor/SKILL.md
+  - ../dor-dod/SKILL.md
+  - ../../meta/philosophy/SKILL.md
+triggers:
+  - new feature proposal
+  - bug report
+  - refactor trigger
+  - SMART goals
+  - RACI
+  - problem framing
+  - why are we doing this
+  - out of scope
+---
+
+# Stage 1: Proposal
+
+> **阶段定位**：需求设计 - Problem Framing / Discovery
+> **回答的问题**：为什么做、做到哪里算完成、这次明确不做什么
+> **参考规范**：Amazon Working Backwards、Lean Canvas、5W1H、RACI
+> **明确排除**：不进入组件拆分、接口细节、实现细节（那是 Spec / Design 的职责）
+
+## Skill 映射
+
+| 场景 | Primary Skill | 角色 |
+| --- | --- | --- |
+| 开放式探索 | `superpowers:brainstorming` | 澄清用户意图、探索需求与设计 |
+| 项目启动 | `zsk:proposal`（本 skill） | 轻量提案对齐意图与边界 |
+| GSD 心智 | Capture → Clarify | 先收集，再澄清，不直接落笔设计 |
+| 深度研究 | `deep-research` / `sc:research` | 外部知识 / 竞品 / 先例 |
+| 知识地图 | `graphify`（可选） | 把利益相关者 / 模块依赖映射成图 |
+
+## 变更类型差异
+
+| 类型 | Proposal 侧重 |
+| --- | --- |
+| **Feature** | 业务价值 + SMART 指标 + 备选方案 + 风险 + RACI |
+| **Bugfix** | Bug 报告（严重度 / 影响范围 / 复现条件） + 根因假设（待 Design 验证） |
+| **Refactor** | 触发条件（不能没有理由重构）+ Fowler 分级（小/中/大）+ 行为不变声明 |
+| **Maintenance** | 外部驱动（CVE / 依赖弃用 / 环境变化）+ 适配范围 |
+
+## 标准结构
+
+1. 模块唯一标识与事实源
+2. 背景与问题（Problem Statement）
+3. 利益相关者与 RACI
+4. 目标与成功指标（SMART）
+5. 不做什么（Out of Scope）
+6. 备选方案（Alternatives Considered）
+7. 风险与缓解（Risks & Mitigations）
+8. 命名与目录映射
+9. 约束与依赖
+10. 估算与里程碑（T-shirt Size + 关键节点）
+
+## 核心要求
+
+### 1. 事实源必填
+
+必须显式写出：
+
+- `{{config.paths.srs}}`（业务事实源）
+- 设计稿索引（如有设计交付）：`{{config.paths.figma_index}}`
+- 若已有接口输入或现有代码入口，同时写明
+
+**设计稿缺失时**，允许 `⚠️ 待补充：设计稿 URL`，但**禁止**写成"已按设计稿还原"。
+
+### 2. 目标必须 SMART
+
+每条目标都满足：
+
+- **S**pecific — 明确对象与范围
+- **M**easurable — 量化指标（例："根节点首屏 < 500ms"）
+- **A**chievable — 当前资源可达
+- **R**elevant — 与业务目标一致
+- **T**ime-bound — 有时间边界
+
+2–4 条，避免长清单稀释优先级。
+
+### 3. 利益相关者 RACI
+
+按团队实际列角色（典型前端项目为例：产品负责人、设计负责人、前端负责人、后端负责人、测试负责人）。
+每人标 **R**esponsible / **A**ccountable / **C**onsulted / **I**nformed。
+
+### 4. 备选方案必写（Feature）
+
+至少 2 个方案，每方案含：简述、成本、收益、放弃原因。
+避免"唯一解陷阱"。
+
+### 5. 风险分级
+
+每项标：概率（H/M/L）、影响（H/M/L）、缓解措施、触发回滚条件。
+
+### 6. 不做什么
+
+显式排除容易引起 scope 膨胀的内容；不要写成"后续再看"的待办。
+
+## Feature 型模板
+
+```md
+# {模块} 提案
+
+> 模块唯一标识：`{module-id}`
+> 变更类型：Feature
+> 原始需求文档：`{{config.paths.srs}}`
+> 设计索引（如有）：`{{config.paths.figma_index}}`
+> 责任人：{姓名} ｜ 创建日期：{YYYY-MM-DD}
+
+## 背景与问题
+
+## 利益相关者与 RACI
+
+| 角色 | 姓名 | RACI |
+| --- | --- | --- |
+
+## 目标与成功指标（SMART）
+
+- G1：{Specific} — 指标：{Measurable} — 截止：{Time-bound}
+
+## 不做什么
+
+## 备选方案
+
+| 方案 | 简述 | 成本 | 收益 | 放弃原因 |
+| --- | --- | --- | --- | --- |
+
+## 风险与缓解
+
+| 风险 | 概率 | 影响 | 缓解 | 回滚触发条件 |
+| --- | --- | --- | --- | --- |
+
+## 命名与目录映射
+
+| 文档目录 | 代码目录 | 说明 |
+| --- | --- | --- |
+
+## 约束与依赖
+
+## 估算与里程碑
+
+- T-shirt：`XS / S / M / L / XL`
+- 里程碑：Spec 冻结 / Design 冻结 / Code Complete / 上线
+```
+
+## Bugfix 型模板
+
+```md
+# Bug: {简要描述}
+
+> 变更类型：Bugfix
+> 严重度：P0 / P1 / P2 / P3
+> 责任人：{姓名} ｜ 报告日期：{YYYY-MM-DD}
+
+## 基本信息
+- Bug ID / Issue: #{number}
+- 环境：dev / test / pre / prod
+- 运行时 / 版本：
+- 影响范围：
+
+## 复现步骤
+1. ...
+2. ...
+
+## 预期 vs 实际
+- 预期：
+- 实际：
+
+## 证据
+- 截图 / 录屏 / 日志 / trace ID
+
+## 初步影响评估
+- 用户影响：
+- 业务流程影响：
+- 数据影响：
+
+## 根因假设（待 Design 阶段 RCA 验证）
+- 假设 1：...
+- 假设 2：...
+
+## 修复边界
+- 做：修正 {X}
+- 不做：不做 {Y}（原因：超出范围 / 另立需求）
+
+## 是否需要 Hotfix
+- [ ] 是（触发 `zsk:release` 的 Hotfix 流程）
+- [ ] 否
+```
+
+## Refactor 型模板
+
+```md
+# Refactor: {简要描述}
+
+> 变更类型：Refactor
+> Fowler 分级：小 / 中 / 大
+> 责任人：{姓名} ｜ 日期：{YYYY-MM-DD}
+
+## 触发条件（为什么现在重构）
+- [ ] 即将新增的功能会被当前结构阻塞（Preparatory Refactoring）
+- [ ] 已验证的代码坏味（命名混乱 / 重复 / 过长函数 / 圈复杂度高）
+- [ ] 性能瓶颈（有 profile 证据）
+- [ ] 历史妥协已具备清理条件（依赖已升级、测试已补齐）
+- [ ] ⚠️ 不能以"我觉得该重构了"为理由
+
+## 证据
+- 代码坏味指标 / profile / 维护成本数据
+
+## 行为不变声明（强制）
+- 本重构**不改变可观察行为**
+- Characterization 测试基线：{位置}
+- 验证方式：{回归测试 / 视觉对照 / 快照}
+
+## Fowler 分级
+
+### 小重构（Micro, 分钟级）
+- 适用：rename / extract function / inline variable
+- 流程：PR 自检清单兜住，不走完整 7 阶段
+
+### 中重构（Medium, 小时级）
+- 适用：extract function/module / 拆模块 / 替换实现
+- 流程：独立 PR + 特征测试先行 + 每步原子 commit
+
+### 大重构（Large, 迭代级）
+- 适用：跨模块 / 架构迁移
+- 流程：走完整 7 阶段 + ADR + Parallel Change / Strangler Fig
+
+## 影响面
+- 文件数：
+- 调用方：
+- 测试覆盖：
+
+## 范围与排除
+- 做：
+- 不做：
+
+## 风险与回滚
+| 风险 | 缓解 | 回滚条件 |
+| --- | --- | --- |
+```
+
+## 质量门禁
+
+- [ ] 能在 3 分钟内回答"为什么做"
+- [ ] 目标全部满足 SMART 五要素
+- [ ] 至少列出 2 个备选方案（Feature）
+- [ ] 风险已分级且有触发回滚条件
+- [ ] 显式列出"不做什么"
+- [ ] 引用了真实存在的事实源路径
+- [ ] 未进入 Props / 接口 / 文件拆分等实现细节
+- [ ] 变更类型声明明确
+
+## 出口条件（可以进 `zsk:spec`）
+
+- [ ] 质量门禁全过
+- [ ] 利益相关者已 review（至少产品 + 技术负责人）
+- [ ] 严重度 / T-shirt 评估已落地

package/sdlc/refactor/SKILL.md

@@ -0,0 +1,220 @@
+---
+name: zsk:refactor
+description: Behavior-preserving refactor discipline — Fowler catalog,
+  characterization tests as baseline, small atomic commits, Parallel Change /
+  Strangler Fig for large refactors. Enforces "behavior preserved" as a hard
+  contract (any behavior change means it is not a refactor).
+category: workflow
+domain: sdlc
+tier: core
+change_type: refactor
+related:
+  - ../proposal/SKILL.md
+  - ../spec/SKILL.md
+  - ../design/SKILL.md
+  - ../coding/SKILL.md
+  - ../refactor-tasks/SKILL.md
+  - ../../system/adr/SKILL.md
+triggers:
+  - refactor workflow
+  - Fowler refactoring
+  - characterization test
+  - Parallel Change
+  - Strangler Fig
+  - behavior preserved
+  - preparatory refactoring
+---
+
+# Workflow: Refactor（重构端到端）
+
+> **定位**：在 7 阶段基础上，针对"**不改变可观察行为、只改结构**"的重构编排工作流
+> **阶段映射**：proposal（触发评估）→ spec（行为不变契约）→ design（重构手法）→ coding（Characterization + 小步 TDD）→ reviewing（commit 序列可 replay）→ verify（行为不变证据）→ archive（ADR + 知识图）
+> **吸收硬原则**：Red-Green-Refactor + 行为不变（Fowler）
+
+## 核心纪律
+
+**重构不能以"我觉得该重构了"为理由**。必须满足以下之一：
+
+1. 即将新增的功能会被当前结构阻塞（**准备性重构** Preparatory Refactoring）
+2. 已验证的代码坏味（有度量证据）
+3. 性能瓶颈（有 profile 证据）
+4. 历史妥协已具备清理条件（依赖升级 / 测试补齐）
+
+**禁止**：
+- 借 bug 修复顺手重构
+- 借 feature 实现顺手重构
+- 无测试保护下的重构
+
+## 总览
+
+```text
+[Trigger Check]    [Behavior Baseline]    [Catalog]        [Small Steps]     [Verify]     [Integrate]
+   Proposal    →       Spec           →   Design    →        Coding      →    Verify   →     Ship
+触发+分级           行为不变+基线       Fowler手法       Red→小步→Green      视觉+性能零差     正常合并
+```
+
+## Fowler 分级
+
+| 级别 | 场景 | 时长 | 流程 |
+| --- | --- | --- | --- |
+| **小（Micro）** | rename / extract function / inline variable | 分钟级 | PR 自检兜住，**跳过完整 7 阶段** |
+| **中（Medium）** | extract component / 拆模块 / 替换实现 | 小时级 | 独立 PR + 特征测试先行 + 每步原子 commit |
+| **大（Large）** | 跨模块 / 架构迁移 | 迭代级 | 完整 7 阶段 + ADR + Parallel Change / Strangler Fig |
+
+## 分步流程（中 / 大级别）
+
+### Step 1：Trigger Check & Proposal — 为什么现在重构
+
+**Primary Skill**: `think` · `zsk:proposal`（Refactor 模板）· `graphify`（可视化结构坏味）· `codex`（二意见）· GSD: Capture → Clarify
+
+**Addendum**:
+- 按 [`zsk:proposal`](../proposal/SKILL.md) Refactor 模板
+- 触发条件必须从 4 条中勾选至少一条
+- 提供度量证据
+- Fowler 分级
+- **行为不变声明**（强制）
+
+**Exit**: 触发条件有证据 · 分级明确 · 行为不变声明
+
+---
+
+### Step 2：Behavior Baseline & Spec — 固化当前行为
+
+**Primary Skill**: `zsk:spec` · GSD: Organize
+
+**Addendum**:
+- 按 [`zsk:spec`](../spec/SKILL.md) Refactor 模板
+- **公开接口保留清单**
+- **Characterization Test 基线位置**
+  - 已有测试够用 → 列出覆盖范围
+  - 测试不足 → 先补齐 Characterization Test 再进入 Design
+- 禁止在 Spec 中"顺便"改契约
+
+**Exit**: 公开接口清单完整 · Characterization Test 全绿作为基线 · 视觉基线已留档（前端）
+
+---
+
+### Step 3：Catalog & Design — 使用的重构手法
+
+**Primary Skill**: `zsk:design` · `plan-eng-review`（大重构必走）· `codex`（challenge 模式）· `context7`（最新库实践）· GSD: Reflect
+
+**Addendum**:
+- 按 [`zsk:design`](../design/SKILL.md) Refactor 模板
+- 重构手法引用 **Fowler catalog**（Extract / Inline / Rename / Move / Replace Conditional with Polymorphism / ...）
+- **大重构必须 Parallel Change / Strangler Fig**：
+  1. Expand — 新实现并存
+  2. Migrate — 调用方逐个迁移
+  3. Contract — 移除旧实现
+- 回滚策略（每一步独立 revert）
+
+**Exit**: 每个手法都有应用位置与理由 · 大重构的 Parallel Change 三阶段清晰 · 回滚策略可执行
+
+---
+
+### Step 4：Coding — 小步原子执行
+
+**Primary Skill**: `superpowers:test-driven-development` · `zsk:coding` · `superpowers:using-git-worktrees`（大重构隔离）· `code-commit`
+
+**Addendum**: 按 [`zsk:refactor-tasks`](../refactor-tasks/SKILL.md) 模板
+
+重复执行：
+- [ ] 应用**一个** Fowler 手法
+- [ ] 跑测试确认全绿
+- [ ] 单独 commit（`refactor(scope): {手法}`）
+- [ ] 若红 → 立即 revert 这一步
+- [ ] 返回继续下一个手法
+
+**铁律**：
+- **一次只做一个重构**
+- **测试不绿不提交**
+- **不改变外部可观察行为**
+
+**Exit**: commit 全部单一手法 · 每个 commit 测试全绿 · 本地 lint / type-check / build 零 error
+
+---
+
+### Step 5：Reviewing — commit 序列可 replay
+
+**Primary Skill**: `zsk:reviewing` · `codex review`
+
+**Addendum**:
+- Reviewer 必须能在 commit 序列上**逐步 replay**
+- 任何 commit 失败视为整个重构不可接受
+- 分歧时 `receiving-code-review` 原则：技术验证 > 情感同意
+- 高风险大重构强制第二 Reviewer
+
+**Exit**: commit 序列每步可 replay · Reviewer Approve
+
+---
+
+### Step 6：Verify — 行为不变硬门禁
+
+**Primary Skill**: `superpowers:verification-before-completion` · `zsk:verify` · `qa` · `benchmark`（前端性能对照）· `design-review`（前端视觉对照）
+
+**Addendum**:
+- [ ] 所有现有测试全绿
+- [ ] Characterization Test 全绿
+- [ ] 视觉回归**零差异**（前端）
+- [ ] 性能不回退（有量化对照数据）
+- [ ] 包体积变化 ≤ ±2%（前端）
+- [ ] 对外契约零变化
+
+**Output**: 原子 commit 序列 · 行为不变证据链
+
+**Exit**: 行为不变验证全过 · 合并主干
+
+---
+
+### Step 7：Archive — ADR 沉淀
+
+**Primary Skill**: `zsk:archive` · `graphify`（更新知识图）· `document-release`
+
+**Addendum**:
+- 更新 `design.md` 中的 ADR（Proposed → Accepted）
+- Changelog 仅 **Changed** / **Removed** 章节（**不在** Added / Fixed）
+- 遵循 [`quality:release`](../../quality/release/SKILL.md)
+- 大重构若用 feature flag，登记 flag 清理计划
+- 大重构归档到 `docs/{module}/archive/{YYYY-MM-DD}-refactor-{简述}/`
+
+## Skip 规则（小重构）
+
+小重构（rename / extract function / inline）**可以跳过完整 7 阶段**，但必须：
+- [ ] 与 feature / bugfix 分开提交
+- [ ] 测试前后全绿
+- [ ] commit message 使用 `refactor(scope):`
+- [ ] 单一手法一次 commit
+
+**绝不允许**：
+- 小重构混进 feature PR
+- 小重构混进 bugfix PR
+- 测试不全的代码上直接重构
+
+## 大重构专项规则
+
+### Parallel Change 模式
+
+```text
+Phase 1 (Expand):    保留 OldApi + 新增 NewApi（并存）
+Phase 2 (Migrate):   调用方逐个迁移 Old → New（每个一 PR）
+Phase 3 (Contract):  移除 OldApi
+```
+
+每个 phase 可独立部署 + 回滚。
+
+### Strangler Fig 模式
+
+- 新模块从**边缘**开始替换旧模块
+- 旧模块**逐步失去职责**直至可移除
+- 整个过程**对外行为持续保持**
+
+## 质量门禁（端到端）
+
+- [ ] 触发条件有证据
+- [ ] 行为不变声明明确
+- [ ] Characterization Test 基线全绿
+- [ ] 使用 Fowler catalog 的具名手法
+- [ ] 每个 commit 单一手法且测试全绿
+- [ ] 视觉 / 性能 / 包体积对照无回退
+- [ ] 未顺带修 bug 或加 feature
+- [ ] 大重构走 Parallel Change / Strangler Fig
+- [ ] 回滚路径可执行