@captain_z/zsk-skills 0.1.0

package/sdlc/task/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: zsk:task
+description: Cross-stage task execution mindset — what a task is, how it threads
+  spec → verify, which template to pick by change type, cross-stage hard
+  principles. Not for writing a specific task; use zsk:task-structure for that.
+category: resource
+domain: sdlc
+tier: core
+related:
+  - ../dor-dod/SKILL.md
+  - ../task-structure/SKILL.md
+  - ../task-tracking/SKILL.md
+  - ../task-evidence/SKILL.md
+  - ../feature/SKILL.md
+  - ../bugfix/SKILL.md
+  - ../refactor/SKILL.md
+triggers:
+  - task framework
+  - task execution overview
+  - cross-stage tasks
+  - which task template
+  - FR coverage numbering
+---
+
+# Task Framework — 任务执行框架总览
+
+> **定位**：跨阶段的**任务执行心智模型** — 什么是任务、怎么结构化、怎么执行、怎么验收
+> **与 7 阶段的关系**：task 是 `zsk:coding`（阶段 4）的产物主体，但"任务"作为概念横跨 spec / design / coding / verify 四个阶段
+> **本 skill 角色**：**导航 + 跨阶段原则**；具体模板见其他 task-* skills
+
+## Task 框架覆盖的三件事
+
+| 关注点 | 回答什么 | 权威 skill |
+| --- | --- | --- |
+| **如何制定任务** | 目标 / 粒度（0.5-2 人天）/ 必填字段 / 估算单位 / FR 覆盖编号 | [`zsk:task-structure`](../task-structure/SKILL.md) |
+| **如何拆分任务** | 父子两级（不更深）/ 依赖关系 / 并行度 / FR 全覆盖 | [`zsk:task-structure`](../task-structure/SKILL.md) + [`zsk:task-tracking`](../task-tracking/SKILL.md) §1 |
+| **执行完如何交互** | 更新状态 → 填证据 → 短汇报 → **等人类确认** → 再推下一任务 | [`zsk:task-tracking`](../task-tracking/SKILL.md) §6 |
+
+## Task 在 7 阶段中的位置
+
+```text
+proposal → spec → design → coding → reviewing → verify → archive
+                              ↓
+                       （task 执行主体）
+                       产出 docs/{module}/tasks.md
+                              ↑
+         按变更类型挑模板，按 task-structure 规则填写
+```
+
+但**任务的追溯锚**（FR / AC 编号）在 Spec 就确立，**任务的证据**在 Verify 兜底，**任务的归档**在 Archive 收尾。所以 task 不等同于 coding。
+
+## 跨阶段执行硬原则
+
+| 原则 | 生效阶段 | 载体 |
+| --- | --- | --- |
+| **证据先于断言** | coding / verify | [`zsk:task-evidence`](../task-evidence/SKILL.md) |
+| **Red-Green-Refactor** | coding（Bugfix / Refactor 强制） | [`zsk:bugfix-tasks`](../bugfix-tasks/SKILL.md) / [`zsk:refactor-tasks`](../refactor-tasks/SKILL.md) |
+| **Bug 置信度质疑** | coding（Bugfix） | [`zsk:bugfix-tasks`](../bugfix-tasks/SKILL.md) Step 0 三问 |
+| **技术严谨 > 性能式同意** | reviewing | [`zsk:reviewing`](../reviewing/SKILL.md) |
+| **行为不变契约** | coding（Refactor） | [`zsk:refactor-tasks`](../refactor-tasks/SKILL.md) + [`zsk:task-evidence`](../task-evidence/SKILL.md) |
+| **编号化交叉引用** | spec → coding / verify | [`zsk:task-structure`](../task-structure/SKILL.md) |
+
+## 变更类型 → 任务模板选择
+
+| 变更类型 | 用哪份模板 | 独特纪律 |
+| --- | --- | --- |
+| **Feature（通用）** | [`zsk:task-structure`](../task-structure/SKILL.md) + 自定义 | 两级结构 + FR 全覆盖 |
+| **Feature（组件/前端）** | [`frontend:feature-tasks-frontend`](../../frontend/feature-tasks-frontend/SKILL.md) | 7 类强制任务 |
+| **Bugfix** | [`zsk:bugfix-tasks`](../bugfix-tasks/SKILL.md) | TDD 强制（Red-Green-Regression）+ 置信度三问 |
+| **Refactor** | [`zsk:refactor-tasks`](../refactor-tasks/SKILL.md) | 行为不变 + 小步原子 + Parallel Change（大） |
+| **Maintenance**（依赖升级 / CVE） | 复用 Bugfix 模板（DoR 豁免 TDD） | 升级范围 + 回归覆盖 |
+| **Docs Only** | 不走 tasks.md；PR 自检兜住 | 仅适用于纯文档改动 |
+
+## 启动一个任务的最小动作序列
+
+```text
+1. 读 proposal.md / spec.md / design.md 确认已冻结
+2. 按变更类型挑任务模板
+3. 复制到 docs/{module}/tasks.md
+4. 按 zsk:dor-dod 跑 DoR
+5. 按 zsk:task-structure 细化任务与估算
+6. 按 zsk:task-tracking 画依赖图、建阻塞记录
+7. 开始执行：**每任务完成 → 更新状态 + 填证据 → 短汇报 → 等人类确认 → 再推下一任务**（不自动连跑；详见 [`zsk:task-tracking`](../task-tracking/SKILL.md) §6）
+8. 交付前按 zsk:task-evidence 填证据
+9. 按 zsk:dor-dod 跑 DoD
+10. 进 zsk:reviewing → zsk:verify → zsk:archive
+```
+
+## 与工作流 skill 的边界
+
+| 层级 | 本 skill 及 task-* 系列 | 工作流 skill（[`feature`](../feature/SKILL.md) / [`bugfix`](../bugfix/SKILL.md) / [`refactor`](../refactor/SKILL.md)） |
+| --- | --- | --- |
+| 粒度 | 任务级（一个任务怎么写怎么跑） | 工作流级（7 阶段怎么编排） |
+| 产出 | 填进 `docs/{module}/tasks.md` | 分步指引 + skill 调用序列 |
+| 谁先读 | **先读工作流 skill 建立阶段编排 → 再挑 task 模板填** | |
+
+## 项目适配（跨项目复用）
+
+本 framework 是**项目无关**的方法论；**项目特定约束**在：
+
+| 位置 | 内容 |
+| --- | --- |
+| `SYSTEM-SPEC.md` | 项目宪法级规约 |
+| `project-config.yaml`（CLI init 产出） | 占位符配置 |
+| `docs/system/adrs/` | 已决策的架构选择 |
+| `zsk:quality` / `zsk:frontend` 等 | 项目执行规范 |
+
+coding 阶段实现时，**必须**先读这些层级确认"本项目的约束"，再按任务模板填。
+
+## 反模式（禁止）
+
+- ❌ 跳过 tasks.md 直接写代码（追溯不到覆盖 FR）
+- ❌ 把任务模板改成项目特定的内容（污染通用 framework —— 项目约束放 SYSTEM-SPEC）
+- ❌ DoR 未全绿就启动（后续一定返工）
+- ❌ 证据 "后补"（违反证据先于断言）
+- ❌ 任务颗粒过大（> 2 人天）又不拆

package/sdlc/task-evidence/SKILL.md

@@ -0,0 +1,178 @@
+---
+name: zsk:task-evidence
+description: Task verification evidence discipline — FR coverage matrix (every
+  FR/NFR from spec has coverage task + acceptance evidence), AC checklist with
+  reproducible links, validation records per gate
+  (lint/type-check/test/security/etc.). Enforces "evidence before assertion" —
+  links must be clickable and reproducible.
+category: resource
+domain: sdlc
+tier: core
+related:
+  - ../task/SKILL.md
+  - ../task-structure/SKILL.md
+  - ../verify/SKILL.md
+  - ../../frontend/nfr-web/SKILL.md
+triggers:
+  - FR coverage matrix
+  - AC verification
+  - validation record
+  - evidence links
+  - evidence before assertion
+---
+
+# Evidence Record — FR 覆盖矩阵 / AC 勾选 / 校验记录
+
+> **用途**：交付前填写的**证据链模板**，直接复制到 `docs/{module}/tasks.md`（或独立 `docs/{module}/verify.md`）
+> **核心原则**：**证据先于断言** — 每一行"通过"都必须有**可追溯链接**（CI 构建 / 测试报告 / 截图 / 录屏）
+
+## 1. FR 覆盖矩阵（交叉引用闭环）
+
+> 从 `spec.md` 的 FR / NFR 列表**完整复制**过来，每条必须有"覆盖任务 + 验收证据"。
+
+```md
+## FR 覆盖矩阵
+
+| Spec 编号 | 简述（摘自 Spec） | 覆盖任务 | 验收证据 |
+| --- | --- | --- | --- |
+| FR-1 | {功能描述} | T-2.1, T-5.1 | {测试报告链接} |
+| FR-2 | {功能描述} | T-2.2, T-5.1 | {测试报告链接} |
+| NFR-1 | {性能要求} | T-6, T-7.1 | {性能报告} |
+| NFR-2 | {安全要求} | T-7.1 | {依赖扫描报告} |
+```
+
+### 规则
+
+- **每条 Spec 的 FR / NFR 都必须有至少一条覆盖任务 + 一条验收证据**
+- 废弃的 FR 保留编号并标注 `(废弃)`，不可删除
+- 未覆盖的 FR = DoD 未达 = 不可合并
+- 编号引自 `spec.md`，矩阵只复制不自造
+
+> 前端项目 NFR 常见基线（CWV / WCAG / 三语 / 浏览器矩阵）见 [`frontend:nfr-web`](../../frontend/nfr-web/SKILL.md)
+
+## 2. AC 勾选（BDD 场景验证）
+
+> `spec.md` 的 Acceptance Criteria 清单，**逐条勾选 + 附证据**。
+
+```md
+## Acceptance Verification
+
+| AC 编号 | 场景 | 状态 | 证据 |
+| --- | --- | --- | --- |
+| AC-1 | Happy path：... | ✅ | {E2E 录屏链接} |
+| AC-2 | Edge case：... | ✅ | {截图链接} |
+| AC-3 | Error：... | ✅ | {截图链接} |
+```
+
+### 证据类型
+
+| AC 类型 | 推荐证据形式 |
+| --- | --- |
+| Happy path | E2E 录屏 / 截图 + 测试用例链接 |
+| Edge case | 截图 + 单元测试报告 |
+| Error case | 截图 + 错误日志 / 错误边界行为录屏 |
+| 性能 | 性能报告（按栈选工具）|
+| 安全 | 扫描 / 审计报告 |
+
+### 每条必须可重现
+
+证据链接必须**可点开**。不接受：
+- ❌ "本地跑过"（无链接）
+- ❌ "截图在飞书 / 微信"（链接会失效）
+- ❌ "大概这样"（无具体数据）
+
+## 3. 校验记录（门禁证据表）
+
+> 每个门禁一行，**每行必须有证据链接**。
+
+```md
+## 校验记录（证据先于断言）
+
+| 门禁 | 结果 | 证据链接 |
+| --- | --- | --- |
+| lint（`{{config.scripts.lint}}`） | ✅ | {CI 构建链接} |
+| type-check（`{{config.scripts.type_check}}`） | ✅ | {CI 构建链接} |
+| 单元测试（`{{config.scripts.test}}`） | ✅ | {覆盖率报告} |
+| 集成测试 | ✅ | {测试报告} |
+| E2E 测试 | ✅ | {报告} |
+| 安全（依赖扫描） | ✅ | {audit 输出} |
+```
+
+> 前端项目额外：视觉回归 / a11y / i18n / 性能（Lighthouse）/ 包体积（Bundle Analyzer）— 见 [`frontend:nfr-web`](../../frontend/nfr-web/SKILL.md)
+
+### 门禁类别（按变更类型）
+
+| 类别 | Feature | Bugfix | Refactor |
+| --- | --- | --- | --- |
+| lint / type-check / 单元 | ✅ | ✅ | ✅ |
+| 视觉回归（前端） | ✅ | ✅ | ✅（零差异） |
+| a11y（前端） | ✅ | 相关时 | ✅ |
+| i18n（前端） | ✅ | 相关时 | ✅ |
+| 性能（前端） | ✅ | — | ✅（对照） |
+| 包体积（前端） | — | — | ✅（≤ ±2%） |
+| 安全 | ✅ | ✅ | 相关时 |
+| 回归测试 | — | ✅（必须） | — |
+| Characterization | — | — | ✅（必须） |
+
+## 4. Refactor 专用：行为不变对照
+
+> Refactor 额外需要 before/after 对照证据。
+
+```md
+## 行为不变证据链
+
+| 对照项 | 重构前 | 重构后 | 差异 |
+| --- | --- | --- | --- |
+| 所有测试 | ✅ 全绿 | ✅ 全绿 | 0 |
+| Characterization Test | ✅ 全绿 | ✅ 全绿 | 0 |
+| 视觉快照（前端） | {截图 A} | {截图 B} | 0 差异 |
+| 性能评分（前端） | 92 | 93 | +1（无回退） |
+| Bundle 大小（前端） | 512KB | 508KB | -0.8%（< ±2%） |
+| 公开接口 | {列} | {列} | 无新增 / 删除 |
+```
+
+## 5. Bugfix 专用：复现对照
+
+> Bugfix 额外需要 before（复现）/ after（修复）对照证据。
+
+```md
+## 复现对照
+
+| 步骤 | 修复前 | 修复后 |
+| --- | --- | --- |
+| 原 MCVE 复现步骤 | ❌ bug 复现（录屏 A） | ✅ 不再复现（录屏 B） |
+| 相邻场景 A | ✅ 正常 | ✅ 正常（无回归） |
+| 相邻场景 B | ✅ 正常 | ✅ 正常（无回归） |
+| 回归测试 | 不存在 | ✅ 新增，绿 |
+```
+
+## 证据链规范
+
+### 链接要求
+
+| 类型 | 接受的链接 |
+| --- | --- |
+| CI 构建 | GitLab Pipeline URL / GitHub Actions URL |
+| 测试报告 | CI 的 artifact / 覆盖率报告服务 |
+| 截图 / 录屏 | 仓库内 `docs/{module}/archive/` 或对象存储 URL |
+| 第三方报告 | 工具 HTML 导出 |
+
+### 禁止
+
+- ❌ "localhost" 或本地路径
+- ❌ 聊天工具内消息截图
+- ❌ 仅文字描述无链接
+- ❌ 链接指向 mutable 内容（如"最新构建"）— 必须指向具体构建号 / commit
+
+## 何时填
+
+- 任务执行中：校验记录**随做随填**
+- 交付前：AC 勾选 + FR 覆盖矩阵**汇总填完**
+- 审计时：整份表作为 verify 阶段的输入
+
+## 反模式（禁止）
+
+- ❌ FR 覆盖矩阵"先填 ✅ 后补证据"（审计发现即门禁失败）
+- ❌ 证据链接失效 / 点不开（视作无证据）
+- ❌ 多个任务指同一证据但内容不符（伪造）
+- ❌ 绕过本表直接声称"通过"（违反证据先于断言硬原则）

package/sdlc/task-structure/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: zsk:task-structure
+description: tasks.md authoring discipline — task granularity (0.5-2
+  person-days), two-level structure (parent/child, no deeper), estimation unit
+  (T-shirt or Fibonacci), required fields per task
+  (status/owner/covers-FR/deliverable/verification), FR coverage numbering
+  rules.
+category: resource
+domain: sdlc
+tier: core
+related:
+  - ../task/SKILL.md
+  - ../task-tracking/SKILL.md
+  - ../task-evidence/SKILL.md
+  - ../dor-dod/SKILL.md
+triggers:
+  - task granularity
+  - task estimation
+  - T-shirt sizing
+  - story points
+  - FR coverage numbering
+  - two-level task structure
+---
+
+# Task Structure — 任务粒度 / 估算 / 两级结构 / FR 覆盖编号
+
+> **用途**：写 `docs/{module}/tasks.md` 的任务列表前，按本规则设计任务的**粒度、结构、估算和追溯锚**
+
+## 核心规则
+
+### 1. 两级结构
+
+```text
+1. 父任务（主题级）                  ← 交付一组可验收的能力
+   1.1 子任务（执行级）              ← 半天到两天能做完
+   1.2 子任务
+2. 父任务
+   2.1 子任务
+```
+
+**禁止**：
+- ❌ 三级或更深（`1.1.1`）— 粒度过细，tasks.md 会变成追踪泥潭
+- ❌ 只有父任务无子任务（无法估算与分配）
+- ❌ 只有散落的子任务无父任务（无法组成可验收切片）
+
+### 2. 任务粒度
+
+| 粒度 | 时长 | 信号 |
+| --- | --- | --- |
+| **合理** | 0.5 – 2 人天 | 一个人、一个 PR、一个清晰 acceptance |
+| **过大** | > 2 人天 | 拆！否则 blocker 影响过大 |
+| **过小** | < 0.5 人天 | 并入邻近任务，减少 tracking 开销 |
+
+### 3. 估算单位（二选一，全局统一）
+
+#### T-shirt Size
+
+| Size | 对应人天 | 适用 |
+| --- | --- | --- |
+| XS | 0.5 | 显而易见的小改动 |
+| S | 1 | 常规单点功能 |
+| M | 2 | 带对接 / 集成 |
+| L | 3–5 | 跨文件重构 |
+| XL | > 5 | ⚠️ 必须拆 |
+
+#### Story Points（Fibonacci）
+
+`1 / 2 / 3 / 5 / 8`；超过 8 点必拆。
+
+### 4. 每个任务必含字段
+
+```md
+### {编号}. {任务标题}（{估算}）
+状态：`TODO` / `DOING` / `DONE` / `BLOCKED`
+负责人：@{handle}
+覆盖 FR：FR-1, FR-3（引自 spec.md，前置对齐任务填"无"）
+子任务：
+- [ ] {编号}.1 {动作}
+- [ ] {编号}.2 {动作}
+交付物：
+- {文件 / 代码 / 报告}
+验证：
+- {命令 / 报告链接}
+```
+
+**硬字段**：状态 · 估算 · 覆盖 FR 编号 · 交付物 · 验证方式
+
+### 5. 覆盖 FR 编号规则（交叉引用锚的执行端）
+
+> Spec 是编号的**唯一发源地**（FR / NFR / US / AC），Coding 阶段只引用不自创。
+
+#### 每任务声明
+
+每个任务在任务头显式列 `覆盖 FR: FR-1, FR-3, NFR-2`：
+
+- **引自** `spec.md`，**不自造**新编号
+- 前置对齐任务（事实源核对、环境准备）填 `覆盖 FR: 无`
+- 一个 FR 可被多个任务覆盖
+- 一个任务可覆盖多个 FR
+
+#### 末端兜底
+
+`docs/{module}/tasks.md` 末尾必须有 **FR 覆盖矩阵**（模板见 [`zsk:task-evidence`](../task-evidence/SKILL.md)）。
+
+#### 编号只增不改
+
+```text
+删除功能 → FR-3 (废弃)               # 保留编号
+合并功能 → FR-7 (合并自 FR-3 + FR-5)
+拆分功能 → FR-3 拆分为 FR-9, FR-10   # 原 FR-3 保留
+```
+
+**理由**：下游（Design 实现映射、Task 覆盖矩阵、Bugfix 受影响契约）都用编号做锚。编号漂移 → 追溯链断。
+
+### 6. 任务分类建议
+
+**通用变更**：按"事实源对齐 / 核心实现 / 测试 / 质量门禁准备"四类组织。
+
+**组件 / 前端**（强制 7 类）：见 [`frontend:feature-tasks-frontend`](../../frontend/feature-tasks-frontend/SKILL.md) — 事实源对齐 / Props / UE-MCP / UE 状态 / 测试 / 视觉回归 / 质量门禁。
+
+**Bugfix**：TDD 四步（Red / Green / Regression / Evidence）— 见 [`zsk:bugfix-tasks`](../bugfix-tasks/SKILL.md)。
+
+**Refactor**：Characterization + 小步 + Parallel Change（大）— 见 [`zsk:refactor-tasks`](../refactor-tasks/SKILL.md)。
+
+### 7. 总工作量声明
+
+tasks.md 末尾给出：
+
+```md
+## 总工作量
+- T-shirt：`M`   / 或 Story Points：`13`
+- 人天：`7.0`
+- 工期（日历天）：`{含并行的日历天数}`
+```
+
+**人天 ≠ 工期**：并行任务可压缩工期，但总人天不变。
+
+## Skip 规则（粒度放宽）
+
+| 场景 | 粒度可放宽为 |
+| --- | --- |
+| 小重构（rename / extract function） | 单任务完成，跳过两级结构 |
+| P3 typo / 样式微调 | 单任务 + 单 commit |
+| Spike / 调研任务 | 用 timebox 而非 estimation（"最多 0.5 天"） |
+
+## 反模式（禁止）
+
+- ❌ 任务没有估算（无法预测 release）
+- ❌ 任务没有"覆盖 FR"字段（追溯断链）
+- ❌ "实现功能"这种总概括任务（必须拆具体）
+- ❌ 子任务自造新 FR 编号（只能引用 Spec）
+- ❌ 一个任务 > 2 人天（必拆）
+- ❌ 估算后不校准（实际耗时与估算偏差 > 50% 要分析为什么）

package/sdlc/task-tracking/SKILL.md

@@ -0,0 +1,192 @@
+---
+name: zsk:task-tracking
+description: Task execution tracking — dependencies (Mermaid graph), blockers
+  (dated log with severity H/M/L and escalation rules), milestones (stage exits
+  with committed dates), and task state transitions (TODO → DOING → DONE, with
+  BLOCKED requiring log entry).
+category: resource
+domain: sdlc
+tier: core
+related:
+  - ../task/SKILL.md
+  - ../task-structure/SKILL.md
+  - ../dor-dod/SKILL.md
+triggers:
+  - task dependency graph
+  - blocker log
+  - milestones
+  - task state flow
+  - standup progress
+---
+
+# Task Tracking — 依赖 / 阻塞 / 里程碑
+
+> **用途**：任务执行全程更新的**状态跟踪模板**，直接复制到 `docs/{module}/tasks.md`
+
+## 1. 任务依赖图（Mermaid）
+
+用 `graph LR`（左到右）或 `graph TD`（上到下），显式标节点：
+
+```md
+## 任务依赖
+
+\`\`\`mermaid
+graph LR
+  T1[1. 事实源对齐] --> T2[2. 核心实现]
+  T1 --> T3[3. 资源 / 契约刷新]
+  T2 --> T4[4. 集成测试]
+  T3 --> T4
+  T4 --> T5[5. 质量门禁]
+\`\`\`
+```
+
+**纪律**：
+- 有依赖必画；没依赖才可并行
+- 节点名用"编号 + 简述"（便于对照任务列表）
+- 环 / 孤岛 / 反向箭头都是设计错误（rebuild 图）
+
+### 何时更新
+
+- 任务列表初稿定型后必画
+- 出现新的阻塞 → 重画
+- 范围调整 → 重画
+
+## 2. 阻塞记录（Blocker Log）
+
+**核心约束**：阻塞必须**显式记录**才算存在。口头"等 X"不算。
+
+```md
+## 阻塞记录
+
+| 日期 | 阻塞描述 | 影响任务 | 影响程度 | 责任人 | 预期解决 | 解决日期 | 结论 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| YYYY-MM-DD | 后端 XX 接口未提供 mock 环境 | T-2.1, T-5.2 | H | @backend-lead | YYYY-MM-DD | YYYY-MM-DD | 临时 mock 本地 JSON，待后端联调切换 |
+```
+
+### 字段
+
+| 字段 | 说明 |
+| --- | --- |
+| 日期 | 阻塞**出现**日期 |
+| 阻塞描述 | 是什么阻塞（接口 / 环境 / 人员 / 外部依赖） |
+| 影响任务 | 哪些任务被阻（任务编号） |
+| 影响程度 | H（阻塞主路径）/ M（阻塞可并行线）/ L（仅优化） |
+| 责任人 | 谁来解 |
+| 预期解决 | 预估解锁日期 |
+| 解决日期 | 实际解锁日期（未解锁留空） |
+| 结论 | 怎么解的（或"转规避方案"） |
+
+### 升级规则
+
+- **H 级**：24h 内无解 → 升级到产品 / 架构 / 负责人
+- **M 级**：72h 内无解 → 升级
+- **L 级**：sprint 结束前未解 → 列入下轮 proposal
+
+## 3. 里程碑（Milestones）
+
+```md
+## 里程碑
+- [ ] Spec 冻结 {YYYY-MM-DD}
+- [ ] Design 冻结 {YYYY-MM-DD}
+- [ ] Code Complete {YYYY-MM-DD}
+- [ ] Reviewing 通过 {YYYY-MM-DD}
+- [ ] Verify 通过 {YYYY-MM-DD}
+- [ ] 合并主干 {YYYY-MM-DD}
+- [ ] 发布（含 canary）{YYYY-MM-DD}
+- [ ] Archive 完成 {YYYY-MM-DD}
+```
+
+### 规则
+
+- 里程碑对应**阶段出口**（非中间状态）
+- 日期写**承诺**日期（不是"预估"）；滑动必须在 log 里解释
+- 勾选 = 所有 exit criteria 全过
+
+## 4. 状态流转（任务状态）
+
+```text
+TODO → DOING → DONE
+        ↓ 阻塞时
+      BLOCKED → DOING（解锁后）
+```
+
+| 状态 | 含义 | 转入条件 |
+| --- | --- | --- |
+| `TODO` | 未开始 | 默认初始 |
+| `DOING` | 进行中 | 有人拿起来做 |
+| `BLOCKED` | 阻塞 | 必须同时在**阻塞记录**登记 |
+| `DONE` | 完成 | DoD 对应项全绿 |
+
+**禁止**：
+- ❌ `DONE` 后再改回 `DOING`（有 regression 就新开子任务）
+- ❌ `BLOCKED` 不登记到阻塞记录（"我口头说过了"不算）
+- ❌ 多人同时 `DOING` 一个任务（同一任务一个负责人，协作开子任务）
+
+## 5. 进度汇报模板（stand-up）
+
+tasks.md 可选的 daily 汇报 section：
+
+```md
+## 进度汇报
+
+### {YYYY-MM-DD}（@{owner}）
+- Done today: T-2.1, T-3.1
+- Doing: T-2.2（阻塞在 log #1）
+- Next: T-5.1（等 T-2.2 解锁）
+```
+
+### 汇报三问
+
+1. **今天完成了哪些编号任务**？
+2. **明天要推进哪些**？
+3. **有什么阻塞、谁能解**？
+
+## 6. 每任务交互契约（LLM / 代理执行）
+
+当任务由 LLM 或代理执行时，**单任务完成的交互流程**必须遵守，不自动连跑：
+
+```text
+执行任务
+   ↓
+更新状态（DOING → DONE）+ 填证据链接
+   ↓
+短汇报（1-3 句："做了什么 + 证据位置"）
+   ↓
+等待人类确认 ← 停在这里，不自动推进下一个
+   ↓
+人类决策：
+   ├─ 通过     → 推进下一任务
+   ├─ 需修改   → 状态回 DOING + 追加子任务
+   └─ 范围变动 → 回 spec/design 走变更流程
+```
+
+### 何时可例外
+
+- **纯读取任务**（调研、搜索、只读扫描）可批量推进不等确认
+- **用户显式授权"连跑 N 个"**（如 "跑完 T-1/T-2/T-3 再一起确认"）
+- **CI/CD 内的自动化任务**（独立兜底 + PR review 兜底）
+
+### 为什么
+
+- **证据先于断言**：每步落证据 + 人类审计，防止错误级联
+- **决策归属**：LLM 执行、人类决策——每任务一个 checkpoint
+- **上下文友好**：刚做完时状态最清晰，拖到批末补证据找不回上下文
+- **映射 GSD**：每个 Engage 后回 Reflect，不是无休止 Engage
+
+## 7. 返工 / 重开规则
+
+DoR / DoD 检出问题时：
+
+- **小范围返工**：原任务状态保持 `DOING`，子任务清单追加
+- **大范围返工**：新开任务 `X.R`（R = rework），显式列原因
+- **范围变动**：回 `spec.md` / `design.md` 走变更流程，**不在 tasks.md 偷改 scope**
+
+## 反模式（禁止）
+
+- ❌ 没画依赖图（并行度估错 → 工期错）
+- ❌ 阻塞在群里说但 log 没记（追溯时找不到）
+- ❌ 里程碑一直滑动但不写解释（信任损耗）
+- ❌ `DONE` 后偷改（审计无据）
+- ❌ 一个人同时 `DOING` 3+ 任务（上下文切换毒药）
+- ❌ LLM / 代理自动连跑多任务不停（失去人类审计点；见 §6）
+- ❌ 状态更新延迟到批末（刚做完是最佳落证据窗口）