pomaster 0.3.0 → 0.4.0

package/seeds/specs/hard/backend/index.md

@@ -0,0 +1,177 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/universal/index.md
+seed_source_sha256: b50c1fdcab5d1a3217a6e28059580195f681b6e68f465eb8e055bd8e5310c479
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend:index
+injection_mode: always
+stages: [prepare, implement, check, release]
+---
+
+# 后端通用硬规范索引
+
+本目录包含 32 个编号协议和本索引。语义 ID、编号和 canonical filename 是稳定地址；编号只追加，不表示 criticality 或激活优先级。协议正文只定义跨项目治理，不保存项目 endpoint、table、column、业务状态、环境阈值或责任人。
+
+## 使用规则
+
+本目录协议由 init 一次性播种到 `.pomaster/specs/hard/backend/`（seed-once：缺席才写、在座零触碰）；开发/验收上下文的协议激活由 `pomaster context compile --role <role>` 投影承载（frontmatter 的 injection_mode/stages/triggers 为移植保留的 info 性注记，非执行语义）。`criticality` 只决定违规严重度，不参与默认选择。
+
+## 维护 spec：主题 → 协议路由表
+
+**要给本项目补充/修改后端规则时，MUST 就地编辑下表命中的编号协议文件，MUST NOT 新建平行文件。**
+把规则写进目标文件的 `MUST` / `MUST NOT` / `SHOULD` / `Contract` / `Checklist` 章节；
+技术栈特有规则进 `stacks/<slug>/<slug>-overlay.md`。
+
+| 你要维护的主题（关键词） | 就地编辑这个文件 |
+|---|---|
+| 架构治理、架构决策、ADR | `01-architecture-governance-protocol.md` |
+| 工程结构、模块划分、包组织 | `02-project-structure-governance-protocol.md` |
+| 目录边界、依赖方向 | `03-directory-boundary-protocol.md` |
+| 分层架构、Controller/Service/Repository 职责 | `04-layering-architecture-protocol.md` |
+| 任务流程、开发工作流 | `05-task-workflow-protocol.md` |
+| AI 生成代码约束 | `06-ai-generated-code-protocol.md` |
+| 证据、验收标准 | `07-evidence-acceptance-protocol.md` |
+| 契约变更、破坏性改动、兼容窗口 | `08-contract-change-protocol.md` |
+| Owner、角色责任 | `09-role-responsibility-protocol.md` |
+| 认证授权、加密、注入防护、安全边界 | `10-security-protocol.md` |
+| 环境变量、配置中心、多环境 | `11-environment-configuration-protocol.md` |
+| API 契约、OpenAPI、REST 风格、版本 | `12-api-contract-protocol.md` |
+| 隐私、数据留存与删除、脱敏 | `13-privacy-data-lifecycle-protocol.md` |
+| 业务规则、领域状态机 | `14-business-rules-state-protocol.md` |
+| 实体、DTO、领域模型、字段语义 | `15-data-model-protocol.md` |
+| 错误码、异常体系、错误响应 | `16-error-code-protocol.md` |
+| 权限模型、RBAC、数据范围 | `17-permission-authorization-protocol.md` |
+| 数据库 schema、migration、Flyway/Liquibase | `18-database-schema-migration-protocol.md` |
+| SQL、索引、慢查询、查询优化 | `19-query-index-sql-protocol.md` |
+| 事务边界、传播行为、回滚 | `20-transaction-boundary-protocol.md` |
+| 并发、锁、乐观/悲观锁、竞态 | `21-concurrency-locking-protocol.md` |
+| 幂等、重复请求、去重 | `22-idempotency-protocol.md` |
+| 缓存、Redis 一致性、缓存失效 | `23-cache-redis-consistency-protocol.md` |
+| 外部集成、熔断、降级、重试、超时 | `24-external-integration-resilience-protocol.md` |
+| 异步任务、定时调度、消息消费 | `25-async-job-scheduler-protocol.md` |
+| 构建工具、静态检查、CI | `26-engineering-tooling-protocol.md` |
+| 依赖管理、供应链安全 | `27-dependency-supply-chain-protocol.md` |
+| 单元/集成/契约测试、覆盖率 | `28-testing-protocol.md` |
+| 日志、链路追踪、可观测性、指标 | `29-observability-logging-tracing-protocol.md` |
+| 性能、容量、压测、限流 | `30-performance-capacity-protocol.md` |
+| 运行时、部署、容器、健康检查 | `31-runtime-deployment-protocol.md` |
+| 发布、版本、回滚 | `32-release-versioning-rollback-protocol.md` |
+| 语言/框架/中间件特有细则（Java、Spring、MyBatis、MySQL、Redis、Nginx…） | `stacks/<slug>/<slug>-overlay.md` |
+
+只有当一条规则在上表与所有 overlay 里**找不到任何归属主题**时，才允许新增协议文件；此时必须同步
+下方「协议目录」与「任务命中矩阵」，保持双向索引完整。
+
+重跑播种（init）默认只补齐缺失文件、不覆盖已存在的协议，所以就地维护不会被覆盖。
+
+## 协议目录
+
+| No | Semantic ID | Canonical filename | Criticality | Injection | Stages | Triggers | 核心职责 |
+|---:|---|---|---|---|---|---|---|
+| 01 | `backend:architecture-governance-protocol` | `01-architecture-governance-protocol.md` | critical | reference | prepare,check | architecture,technology-baseline,deployment-topology | 架构边界、ADR 与演进门禁 |
+| 02 | `backend:project-structure-governance-protocol` | `02-project-structure-governance-protocol.md` | standard | triggered | prepare,implement,check | project-structure,module-layout | 项目目录分区与结构检查 |
+| 03 | `backend:directory-boundary-protocol` | `03-directory-boundary-protocol.md` | critical | always | implement,check | - | 公开入口、依赖方向与越界识别 |
+| 04 | `backend:layering-architecture-protocol` | `04-layering-architecture-protocol.md` | critical | triggered | prepare,implement,check | layering,module-boundary,domain-design | 后端分层职责与边界 |
+| 05 | `backend:task-workflow-protocol` | `05-task-workflow-protocol.md` | critical | always | prepare,implement,check,release | - | Backend Ready 与阶段路由 |
+| 06 | `backend:ai-generated-code-protocol` | `06-ai-generated-code-protocol.md` | critical | always | prepare,implement,check | - | Agent 事实边界与验证 |
+| 07 | `backend:evidence-acceptance-protocol` | `07-evidence-acceptance-protocol.md` | critical | always | prepare,check,release | - | 证据、验收与例外门禁 |
+| 08 | `backend:contract-change-protocol` | `08-contract-change-protocol.md` | critical | always | prepare,implement,check,release | - | 公共契约兼容与迁移 |
+| 09 | `backend:role-responsibility-protocol` | `09-role-responsibility-protocol.md` | advisory | reference | prepare,check | ownership,handoff | Owner、RACI 与交接 |
+| 10 | `backend:security-protocol` | `10-security-protocol.md` | critical | triggered | prepare,implement,check,release | security,api-input,authentication,authorization,file-processing,secrets | 服务端安全控制 |
+| 11 | `backend:environment-configuration-protocol` | `11-environment-configuration-protocol.md` | critical | triggered | prepare,implement,check,release | environment-configuration,configuration,secrets,runtime | 环境、secret 与配置漂移 |
+| 12 | `backend:api-contract-protocol` | `12-api-contract-protocol.md` | critical | triggered | prepare,implement,check | api-contract,api-change | API 与兼容契约 |
+| 13 | `backend:privacy-data-lifecycle-protocol` | `13-privacy-data-lifecycle-protocol.md` | critical | triggered | prepare,implement,check,release | sensitive-data,privacy,data-export | 隐私与数据生命周期 |
+| 14 | `backend:business-rules-state-protocol` | `14-business-rules-state-protocol.md` | critical | triggered | prepare,implement,check | business-rules,state-transition | 服务端规则与状态机 |
+| 15 | `backend:data-model-protocol` | `15-data-model-protocol.md` | standard | triggered | prepare,implement,check | data-model,dto,mapping | 边界模型与映射 |
+| 16 | `backend:error-code-protocol` | `16-error-code-protocol.md` | standard | triggered | prepare,implement,check | error-code,error-handling | 稳定错误语义 |
+| 17 | `backend:permission-authorization-protocol` | `17-permission-authorization-protocol.md` | critical | triggered | prepare,implement,check | authorization,tenant,data-scope | 权限、租户与数据范围 |
+| 18 | `backend:database-schema-migration-protocol` | `18-database-schema-migration-protocol.md` | critical | triggered | prepare,implement,check,release | database-schema,migration,data-repair | Schema、迁移与修复 |
+| 19 | `backend:query-index-sql-protocol` | `19-query-index-sql-protocol.md` | standard | triggered | implement,check | sql,query,index,pagination | SQL、分页与索引证据 |
+| 20 | `backend:transaction-boundary-protocol` | `20-transaction-boundary-protocol.md` | critical | triggered | prepare,implement,check | transaction | 事务边界与失败语义 |
+| 21 | `backend:concurrency-locking-protocol` | `21-concurrency-locking-protocol.md` | critical | triggered | prepare,implement,check | concurrency,locking | 并发、锁与冲突 |
+| 22 | `backend:idempotency-protocol` | `22-idempotency-protocol.md` | critical | triggered | prepare,implement,check | idempotency,callback,replay | 写操作幂等与重放 |
+| 23 | `backend:cache-redis-consistency-protocol` | `23-cache-redis-consistency-protocol.md` | critical | triggered | prepare,implement,check,release | redis,cache | 缓存与权威源一致性 |
+| 24 | `backend:external-integration-resilience-protocol` | `24-external-integration-resilience-protocol.md` | critical | triggered | prepare,implement,check,release | external-integration,resilience | 超时、重试、补偿与对账 |
+| 25 | `backend:async-job-scheduler-protocol` | `25-async-job-scheduler-protocol.md` | standard | triggered | prepare,implement,check,release | async-job,scheduler,import-export | Job 生命周期与调度 |
+| 26 | `backend:engineering-tooling-protocol` | `26-engineering-tooling-protocol.md` | standard | triggered | prepare,implement,check | build,tooling,ci | 构建、生成与 CI |
+| 27 | `backend:dependency-supply-chain-protocol` | `27-dependency-supply-chain-protocol.md` | critical | triggered | prepare,implement,check,release | dependency,supply-chain | 依赖与供应链风险 |
+| 28 | `backend:testing-protocol` | `28-testing-protocol.md` | critical | triggered | prepare,check,release | testing,acceptance | 风险导向测试 |
+| 29 | `backend:observability-logging-tracing-protocol` | `29-observability-logging-tracing-protocol.md` | standard | triggered | implement,check,release | observability,logging,tracing | 日志、指标、追踪与审计 |
+| 30 | `backend:performance-capacity-protocol` | `30-performance-capacity-protocol.md` | standard | triggered | prepare,check,release | performance,capacity | 性能预算与容量证据 |
+| 31 | `backend:runtime-deployment-protocol` | `31-runtime-deployment-protocol.md` | critical | triggered | prepare,implement,check,release | runtime,deployment,configuration | 运行时、入口与部署拓扑 |
+| 32 | `backend:release-versioning-rollback-protocol` | `32-release-versioning-rollback-protocol.md` | critical | triggered | prepare,check,release | release,rollback,versioning | 发布、版本与恢复 |
+
+## 默认激活基线
+
+默认激活面严格只有以下 5 个短协议和索引；实际命中按任务特征（见「任务命中矩阵」）继续收窄。
+
+```text
+backend:index
+backend:task-workflow-protocol
+backend:ai-generated-code-protocol
+backend:directory-boundary-protocol
+backend:contract-change-protocol
+backend:evidence-acceptance-protocol
+```
+
+| Stage | 建议纳入上下文 |
+|---|---|
+| prepare | index、task workflow、AI generated code、contract change、evidence acceptance |
+| implement | index、task workflow、AI generated code、directory boundary、contract change |
+| check | index 加全部 5 个基线协议 |
+| release | index、task workflow、contract change、evidence acceptance |
+
+## 任务命中矩阵
+
+| 任务特征 | 建议命中的协议特征 |
+|---|---|
+| 架构、技术栈或部署形态选择 | 显式展开 `backend:architecture-governance-protocol`，并命中 `project-structure`、`layering`、`environment-configuration`、`build`、`dependency`、`performance`、`runtime`、`release` |
+| 新增或修改 API | `api-contract`、`data-model`、`error-code`、`data-scope`、`idempotency`、`testing`、`observability`、`release` |
+| 业务规则或状态流转 | `layering`、`business-rules`、`state-transition`、`data-model`、`error-code`、`data-scope`、`transaction`、`concurrency`、`testing` |
+| 数据库结构或迁移 | `database-schema`、`migration`、`sql`、`transaction`、`concurrency`、`testing`、`observability`、`rollback` |
+| 查询、分页、报表或导出 | `api-contract`、`data-model`、`data-scope`、`query`、`pagination`、`cache`、`testing`、`performance` |
+| 事务写流程 | `business-rules`、`error-code`、`transaction`、`concurrency`、`idempotency`、`external-integration`、`testing`、`observability` |
+| Redis 或缓存变更 | `environment-configuration`、`concurrency`、`idempotency`、`redis`、`testing`、`observability`、`capacity` |
+| 外部系统集成 | `environment-configuration`、`api-contract`、`error-code`、`idempotency`、`external-integration`、`resilience`、`async-job`、`testing`、`observability` |
+| 导入、导出或异步任务 | `api-contract`、`error-code`、`data-scope`、`idempotency`、`cache`、`async-job`、`scheduler`、`testing`、`observability`、`performance` |
+| 认证、权限或敏感数据 | `security`、`authentication`、`sensitive-data`、`privacy`、`error-code`、`data-scope`、`testing`、`observability` |
+| 运行时、部署或配置 | `environment-configuration`、`external-integration`、`deployment`、`observability`、`performance`、`release` |
+| 依赖升级 | `build`、`dependency`、`supply-chain`、`testing`、`performance`、`release` |
+| 发布、灰度或回滚 | `environment-configuration`、`testing`、`observability`、`performance`、`deployment`、`release`、`rollback` |
+
+矩阵只产生候选特征；实际纳入由 `pomaster context compile --role <role>` 投影承载（Overlay 依赖与冲突按「冲突与责任边界」收窄），纳入/排除决策可经 `pomaster context explain` 逐条审计。
+
+## 协议固定结构
+
+所有编号协议严格使用以下顺序：
+
+1. `Scope`
+2. `Non-Scope`
+3. `Terms`
+4. `MUST`
+5. `MUST NOT`
+6. `SHOULD`
+7. `Contract`
+8. `Checklist`
+9. `Examples`
+10. `Anti-patterns`
+11. `Ownership`
+12. `Change Policy`
+
+## 冲突与责任边界
+
+- 安全规则优先于便利性；最终服务端授权优先于客户端展示。
+- 正式 API、schema、消息和配置契约优先于 Mock、历史示例和聊天记录。
+- 业务规则协议定义权威语义；数据模型协议只定义边界转换。
+- 错误码协议定义调用方语义；可观测性协议定义内部诊断与审计信号。
+- 事务协议定义原子边界；并发协议定义竞争、锁与冲突。
+- 测试协议选择验证方式；证据协议决定声明与门禁是否成立。
+- Stack Overlay 只能收紧或具体化本目录规则，不能保存项目事实或放宽底线。
+
+## 维护规则
+
+协议编号、语义 ID 与 canonical filename 只追加不重排。新增或修改规则必须同步索引、模板、播种清单与 catalog 锁校验；废弃规则必须提供替代 ID、兼容窗口和迁移说明。

package/seeds/specs/hard/frontend/01-development-checklist-protocol.md

@@ -0,0 +1,86 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/universal/01-development-checklist-protocol.md
+seed_source_sha256: fa8914b29dbf7af25c8128aa1b8936fd658e37854e0a4f457175e2e3c82c3a03
+seed_version: B6B-1
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# 01 开发检查项协议
+
+## Scope
+
+P0。把规范转成每次开发前、开发中、开发后的强制动作，适用于功能、修复、重构、配置和文档驱动变更。
+
+## Non-Scope
+
+不定义技术栈命令，不替代测试协议、验收门禁和发布审批。
+
+## Terms
+
+- Change Classification：局部、同类模式、公共能力、契约、平台或工程变更。
+- Impact Set：必须修改、需要同步、明确禁止修改的范围。
+- Evidence：搜索、测试、截图、构建、契约差异等可复核证据。
+- Spec Update Review：开发完成后判断是否需要补充 spec 的强制复核。
+
+## MUST
+
+- 开发前完成变更分类、协议选择、复用搜索和影响范围。
+- 写代码前列出 Must Change、Must Sync、Must Not Change。
+- 缺少正式字段、状态、权限、接口或业务规则时先补契约或阻塞确认。
+- 开发中发现范围扩大时重新分类并更新计划。
+- 开发后提供检查结果、影响说明和残余风险。
+- 开发后、任务关闭或收口（closeout）流程前必须完成 Spec Update Review。
+- 发现新规则、重复坑点、接口/组件/目录/测试约定时必须更新对应 spec；无更新时必须记录原因。
+
+## MUST NOT
+
+- MUST NOT 先实现后补范围。
+- MUST NOT 用“应该没问题”代替证据。
+- MUST NOT 混入无关清理、升级或重构。
+- MUST NOT 跳过 Spec Update Review 后直接归档、收口或发布。
+- MUST NOT 将一次性实现细节写入长期 spec。
+
+## SHOULD
+
+- SHOULD 将检查项集成任务模板、PR 模板和自动化门禁。
+- SHOULD 按风险扩大检查，而非机械执行无关项目。
+
+## Contract
+
+```text
+Goal, Classification, ProtocolsLoaded, SpecStatus, ReuseSearch,
+MustChange, MustSync, MustNotChange, ContractsAffected,
+ValidationRequired, Evidence, SpecUpdateDecision, ResidualRisk
+```
+
+## Checklist
+
+- [ ] 已分类并加载协议。
+- [ ] 已搜索已有能力。
+- [ ] 已声明影响与禁止范围。
+- [ ] 已确认契约、安全和数据边界。
+- [ ] 已提供验证证据。
+- [ ] 已完成 Spec Update Review，并记录更新或不更新的原因。
+
+## Examples
+
+### 内容示例，可删除
+
+修复单页列宽时，先证明根因属于页面 schema，只修改该 schema 和页面测试，并明确禁止修改全局样式。
+
+## Anti-patterns
+
+直接修改公共组件，既不搜索调用方，也不验证同类页面，把局部问题扩散成全局回归。
+
+## Ownership
+
+实现者负责填写，Reviewer 核验范围与证据，协议 Owner 裁决歧义。
+
+## Change Policy
+
+新增检查项必须定义触发、验证和失败动作；降级 P0 检查项必须批准并记录期限。

package/seeds/specs/hard/frontend/02-ai-generated-code-protocol.md

@@ -0,0 +1,82 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/universal/02-ai-generated-code-protocol.md
+seed_source_sha256: a80ea1c51c9afc0b96001cfffa0675edafb1572563652840bcf88770d81203c8
+seed_version: B6B-1
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# 02 AI 生成代码协议
+
+## Scope
+
+P0。约束 AI 分析、生成、修改、评审和验证代码时的行为。
+
+## Non-Scope
+
+不替代人工需求决策、代码所有权、测试、合规审批或上线责任。
+
+## Terms
+
+- AI Change Plan：写代码前声明的协议、事实、范围和验证计划。
+- Invented Contract：无正式来源而猜测的字段、状态、权限、API 或规则。
+- Unrelated Change：当前目标不需要的修改。
+
+## MUST
+
+- AI 写代码前读取适用协议并输出 Change Plan。
+- AI 必须先搜索已有组件、抽象、契约、工具和同类实现。
+- AI 必须区分事实、推断和待确认项。
+- AI 必须说明为什么修改这些文件、为什么不修改其他层。
+- AI 必须运行可用检查并如实报告未验证项。
+- AI 必须保留与任务无关的用户现有改动。
+
+## MUST NOT
+
+- MUST NOT 发明正式字段、枚举、公式、权限码、接口、路由或配置。
+- MUST NOT 重复创建已有能力。
+- MUST NOT 删除测试、降低断言、关闭规则或用类型逃逸掩盖问题。
+- MUST NOT 声称执行了实际未运行的验证。
+
+## SHOULD
+
+- SHOULD 把重复决策沉淀为协议、contract 或自动检查。
+- SHOULD 为高风险公共变更提供迁移和回滚。
+
+## Contract
+
+```text
+Goal, Protocols, Facts, Assumptions, TODO_CONFIRM,
+ReuseSearch, FilesToChange, FilesNotToChange,
+Validation, ResidualRisk
+```
+
+## Checklist
+
+- [ ] 已读协议和正式契约。
+- [ ] 已证明新建必要性。
+- [ ] 未猜测业务和接口事实。
+- [ ] 修改与同步范围明确。
+- [ ] 验证结果真实可复核。
+
+## Examples
+
+### 内容示例，可删除
+
+AI 修复报表列宽前识别列 schema 所属层级，验证相同表格类型，再修改领域 preset。
+
+## Anti-patterns
+
+未搜索组件库便新建相似组件，并顺手重构 store、API 和全局样式。
+
+## Ownership
+
+AI 仅为 Contributor；任务、代码、评审和上线分别由对应人类 Owner 负责。
+
+## Change Policy
+
+放宽 AI 禁止规则必须由工程治理和领域 Owner 批准；新型 AI 错误应转为协议或门禁。

package/seeds/specs/hard/frontend/03-acceptance-gate-protocol.md

@@ -0,0 +1,86 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/universal/03-acceptance-gate-protocol.md
+seed_source_sha256: 646dcbd7035d43d84ca592218a356c08a4baca36619109797322d90ba3d99b73
+seed_version: B6B-1
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# 03 验收门禁协议
+
+## Scope
+
+P0。定义变更何时可以进入 Review、提测和上线，以及各阶段的必备证据。
+
+## Non-Scope
+
+不指定测试框架，不替代业务验收、发布平台操作或人工批准责任。
+
+## Terms
+
+- Ready for Review：实现和自检完成。
+- Ready for Test：评审阻塞关闭，构建可测试。
+- Ready for Release：质量、安全、监控和回滚可用。
+- Ready for Development：相关项目级和需求级 spec 已达到 Baseline 或批准的 Candidate。
+- Blocker：不满足即禁止进入下一阶段的问题。
+
+## MUST
+
+- 每个阶段输出 pass、fail 或有期限的 exception，并附证据。
+- P0 门禁失败时禁止进入下一阶段。
+- 契约、权限、安全、数据迁移和回滚风险必须确认。
+- 公共能力变更必须验证全部受影响调用方。
+- 例外必须记录负责人、风险、补偿措施和期限。
+- 开发前必须确认命中的项目级、需求级、组件级和接口级 spec 状态。
+- Review、提测、上线或任务关闭前必须确认 Spec Update Review 已完成。
+
+## MUST NOT
+
+- MUST NOT 以时间紧、人工点过或本地正常绕过 P0。
+- MUST NOT 在测试失败、契约未冻结或回滚不可用时放行。
+- MUST NOT 将未知风险标记为通过。
+- MUST NOT 在 spec 仍为 Draft 且无批准 Candidate 的情况下进入正式开发。
+- MUST NOT 将收口（closeout）、归档、发布记录当作 Spec Update Review 的替代品。
+
+## SHOULD
+
+- SHOULD 自动采集 lint、类型、测试、构建、安全和包体证据。
+- SHOULD 按风险设置附加门禁。
+
+## Contract
+
+```text
+Gate, SpecStatus, Result, Evidence[], Blockers[], Risks[],
+Approver, ExceptionExpiry?, RollbackVerified?, SpecUpdateReviewed?
+```
+
+## Checklist
+
+- [ ] Review 前范围、契约、自检齐全。
+- [ ] 提测前评审关闭、构建成功、环境明确。
+- [ ] 上线前回归、安全、监控、灰度、回滚通过。
+- [ ] 例外有负责人和到期时间。
+- [ ] 开发前 Ready for Development 已通过。
+- [ ] 收尾前 Spec Update Review 已完成。
+
+## Examples
+
+### 内容示例，可删除
+
+公共表格变更在组件测试、代表页面 E2E 和视觉回归通过后才可提测。
+
+## Anti-patterns
+
+仅凭“改动很小”跳过构建和调用方验证，直接交付测试或发布。
+
+## Ownership
+
+实现者提供 Review 证据，Reviewer/QA 确认提测，发布和风险 Owner 确认上线。
+
+## Change Policy
+
+门禁降级或删除必须有书面风险评估、批准人和恢复计划。