soloforge 1.1.38 → 1.1.42

package/templates/rules/shared//344/272/244/344/273/230/345/256/214/345/244/207/346/200/247/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,83 +1,106 @@
 ---
 name: delivery-completeness
 type: review_rule
-when: '代码审查, review, 交付检查, 上线前检查, 提交检查, 终局宣言'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-review-rule-交付完备性审查规则
-asset_kind: review_rule
 lifecycle_status: active
 owner_mechanism_id: mc-generic-review
 authority: supporting
-primary_triggers:
-  - 交付完备性审查规则
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["代码审查"]
+triggers: ["代码审查","review","交付检查","上线前检查","提交检查","终局宣言"]
 ---
 
 ## DEL-01: 交付物缺少终局宣言签名
 pattern: /SoloForge Audit: PASS/
-severity: critical
+severity: error
+check_type: deterministic
 scope: [backend, frontend]
 description: 所有交付物末尾必须包含 [SoloForge Audit: PASS - 已通过三重深度推演，确认无潜在隐患]。缺少此签名的交付视为无效
+evidence_required:
+  - "交付物文件路径"
+  - "终局宣言签名存在确认"
 
 ## DEL-02: 验收项缺少边界值覆盖
 pattern: //
 severity: warning
+check_type: deterministic
 scope: [backend, frontend]
-check: boundary_coverage
 description: 验收项应覆盖空值(null/undefined)、极端值(MAX_VALUE/空字符串)、异常输入场景，而非仅 happy path
+evidence_required:
+  - "验收项列表"
+  - "边界值覆盖统计"
 
 ## DEL-03: 涉及外部调用但无异常处理验收
 pattern: /(?:feign|http|restTemplate|webClient|fetch|axios)\s*\(/i
 severity: warning
+check_type: deterministic
 scope: [backend, frontend]
 description: 涉及外部 HTTP 调用的代码必须有超时、异常格式、降级场景的验收覆盖
+evidence_required:
+  - "外部调用点列表"
+  - "异常处理验收覆盖确认"
 
 ## DEL-04: 涉及状态变更但无事务/幂等验收
 pattern: /(?:@Transactional|save\(|insert\(|update\(|delete\()/i
 severity: warning
+check_type: deterministic
 scope: backend
 description: 涉及数据库状态变更的代码必须有事务一致性、幂等性验收覆盖
+evidence_required:
+  - "状态变更操作列表"
+  - "事务/幂等验收确认"
 
 ## DEL-05: 测试断言精度不足（疑似自己证明自己）
 pattern: /(?:toBeTruthy|toBeFalsy|toBeDefined|toBeUndefined|toBeDefined)\s*\(/
 severity: info
+check_type: deterministic
 scope: [backend, frontend]
 description: 大量使用模糊断言(toBeTruthy等)视为测试有效性风险，必须补充精确断言(toBe/toEqual/toThrow)
+evidence_required:
+  - "模糊断言使用统计"
 
 ## SEL-01: 技术选型无行业基准支撑
 pattern: //
-severity: critical
+severity: error
+check_type: deterministic
 scope: [backend, frontend]
-check: selection_benchmark
 description: 技术选型必须通过 sf_explore 检索至少 3 个行业标准方案。禁止凭空推荐方案
+evidence_required:
+  - "技术选型记录路径"
+  - "sf_explore 检索结果路径"
+  - "对比方案数（须≥3）"
 
 ## SEL-02: 推荐方案未说明致命缺点规避策略
 pattern: //
 severity: warning
+check_type: semantic
 scope: [backend, frontend]
-check: selection_mitigation
 description: 最优解宣誓必须明确说明如何规避其他方案的致命缺点。无规避说明视为不完整选型
+evidence_required:
+  - "推荐方案致命缺点列表"
+  - "规避策略说明"
 
 ## TRA-01: 审查发现未按信任分级路由
 pattern: //
 severity: info
+check_type: semantic
 scope: [backend, frontend]
-check: trust_classification
 description: sf_review 结果应按白盒(可跳过)/灰盒(建议审查)/黑盒(强制审查)三级分类展示，禁止平铺所有发现
+evidence_required:
+  - "信任分级统计（白盒/灰盒/黑盒项数）"
 
 ## TRA-02: 审查报告缺少认知透明度标注
 pattern: //
 severity: info
+check_type: semantic
 scope: [backend, frontend]
-check: transparency_label
 description: 审查结果应标注熔断触发状态、变异检测结果、漂移检测结果，确保人类能看到系统内部决策
+evidence_required:
+  - "认知透明度标注内容"

package/templates/rules/shared//344/273/243/347/240/201/345/217/257/347/273/264/346/212/244/346/200/247/344/270/216/345/217/257/350/247/202/346/265/213/346/200/247/345/256/241/346/237/245.md

@@ -6,73 +6,79 @@ products:
   - '*'
 id: ka-review-rule-代码可维护性与可观测性审查
 type: review_rule
-asset_kind: review_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-code-maintainability-observability-contract
-primary_triggers:
-  - 代码审查
-  - review
-  - 验证
-secondary_triggers:
-  - 业务代码
-  - 接口实现
-negative_triggers:
-  - 纯文档
-  - 纯样式
 priority: P1
-specificity: 4
 consumes:
-version: 1.1.0
-last_reviewed: '2026-06-01'
+  - mc-code-maintainability-observability-contract
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["代码审查"]
+triggers: ["代码审查","可维护性","可观测性","日志审查","注释审查"]
 ---
 
-## 审查维度
+# 代码可维护性与可观测性审查规则
 
-### 1. 日志完整性
-检查 changed files 中:
-- 支付/金额/退款操作是否有含对象 ID 和前后值的日志
-- 权限拒绝是否有含操作人和拒绝原因的日志
-- 外部调用是否有含目标、响应码和重试信息的失败日志
-- 状态变更是否有含前后状态和触发原因的流转日志
-- 数据修复/迁移是否有含修复前值和影响行数的审计日志
+## MNT-01: 关键操作缺结构化日志
+- id: MNT-01
+- name: 关键操作缺结构化日志
+- severity: error
+- check_type: semantic
+- evidence_required: 代码审查发现中标注缺失结构化日志的操作类型与建议日志字段
+- pattern: 支付/金额/退款操作无含对象 ID 和前后值的日志；权限拒绝无含操作人和拒绝原因的日志；外部调用无含目标、响应码和重试信息的失败日志；状态变更无含前后状态和触发原因的流转日志
+- description: changed files 中关键操作必须有结构化日志：支付/金额操作须含对象 ID+前后值、权限拒绝须含操作人+拒绝原因、外部调用须含目标+响应码+重试信息、状态变更须含前后状态+触发原因、数据修复须含修复前值+影响行数。
 
-### 2. 敏感信息泄漏
-检查所有日志输出是否:
-- 不包含 token、password、cookie 全量
-- 不包含身份证、手机号、银行卡全量
-- 不包含健康隐私信息
+## MNT-02: 日志泄漏敏感信息
+- id: MNT-02
+- name: 日志泄漏敏感信息
+- severity: error
+- check_type: deterministic
+- evidence_required: 代码审查发现中标注泄漏敏感信息的日志行号与日志内容
+- pattern: "log\\.\\w+\\(.*(?:password|token|secret)"
+- description: 所有日志输出不得包含 token、password、cookie 全量、身份证、手机号、银行卡全量、健康隐私信息。发现泄漏须立即修复。
 
-### 3. 注释质量
-检查 changed files 中:
-- 复杂业务规则是否有说明"为什么"的注释
-- 金额计算是否有设计意图注释
-- 状态机是否有状态流转注释
-- 不检查纯复述代码的废话注释
+## MNT-03: 复杂业务规则缺设计意图注释
+- id: MNT-03
+- name: 复杂业务规则缺设计意图注释
+- severity: error
+- check_type: semantic
+- evidence_required: 代码审查发现中标注缺注释的业务规则位置与建议注释内容
+- pattern: 复杂业务规则/金额计算/状态机缺说明"为什么"的中文注释
+- description: changed files 中复杂业务规则必须有说明"为什么"的中文注释（不检查纯复述代码的废话注释）。金额计算须有中文设计意图注释、状态机须有中文状态流转注释。所有注释必须使用中文，禁止全英文业务注释。
 
-### 4. Logger 使用
-检查是否使用了项目已有 logger:
-- Java/Spring 项目是否使用 Slf4j
-- Node 项目是否使用 pino/winston
-- NestJS 项目是否使用 NestJS Logger
-- 前端项目是否避免裸 console
+## MNT-04: 未使用项目标准 Logger
+- id: MNT-04
+- name: 未使用项目标准 Logger
+- severity: warning
+- check_type: deterministic
+- evidence_required: 代码审查发现中标注非标准 Logger 调用行号与项目标准 Logger 名称
+- pattern: "(?:console\\.log|System\\.out\\.print)"
+- description: Java/Spring 项目使用 Slf4j、Node 项目使用 pino/winston、NestJS 项目使用 NestJS Logger、前端项目避免裸 console.log。
 
-### 5. 异常处理
-检查 catch 块是否:
-- 不吞异常（至少记录日志）
-- 不只输出 "error" / "failed" 这类不可定位信息
+## MNT-05: catch 块吞异常
+- id: MNT-05
+- name: catch 块吞异常
+- severity: error
+- check_type: deterministic
+- evidence_required: 代码审查发现中标注空 catch 块行号与建议的异常处理方式
+- pattern: "catch\\s*\\([^)]*\\)\\s*\\{\\s*\\}"
+- description: catch 块不得为空或仅输出不可定位信息（如 "error"/"failed"）。至少需要记录日志，含异常上下文信息。
 
-## 审查输出格式
-每条 finding 包含:
-- 类别 (category)
-- 严重度 (P0/P1/P2/P3)
-- 文件路径
-- 证据位置
-- 中文修复建议
+## MNT-06: 业务注释未使用中文
+- id: MNT-06
+- name: 业务注释未使用中文
+- severity: error
+- check_type: semantic
+- evidence_required: 代码审查发现中标注全英文注释的文件、行号与建议中文注释内容
+- pattern: 后端类/方法缺中文 Javadoc；关键业务行（状态流转、金额、权限、外部调用）缺中文行注释；DTO/VO/Entity 字段缺中文说明
+- description: 所有业务注释必须使用中文：后端类/接口/枚举须有中文文档注释说明职责和业务边界；业务方法须有中文文档注释说明作用、参数语义和返回值含义；关键业务行须有中文行注释；DTO/VO/Entity/Request/Response 字段须有中文含义说明或注解。允许保留英文代码标识符，但业务说明必须中文表达。纯样式、getter/setter、简单类型定义可豁免。
 
-## 低风险跳过规则
-- 纯样式、文案修改不触发审查
-- 简单 getter/setter 不触发审查
-- 测试 fixture 不触发审查
-- 低风险只读查询（且已有统一 access log）不触发审查
+## MNT-07: 业务日志未使用中文
+- id: MNT-07
+- name: 业务日志未使用中文
+- severity: error
+- check_type: semantic
+- evidence_required: 代码审查发现中标注全英文日志的文件、行号与建议中文事件名
+- pattern: 业务日志首字符串不含中文；日志事件名全英文；catch 块日志无中文上下文
+- description: 所有业务日志必须使用中文事件名或中文动作说明：用户登录/登出、权限拒绝、状态变更、金额变更、外部调用、异步任务、异常处理等日志的事件名或首字符串必须包含中文。日志中必须包含业务对象 ID、操作人、关键状态变化前后值等上下文。禁止只打印英文 "error"/"failed"/"success" 的不可定位日志。

package/templates/rules/shared//344/273/243/347/240/201/346/263/250/351/207/212/344/270/216/346/227/245/345/277/227/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -0,0 +1,122 @@
+---
+name: code-comment-log-contract
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-代码注释与日志契约规则
+type: governance_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-code-maintainability-observability-contract
+priority: P0
+consumes:
+  - mc-coding-readiness
+hard_blocks:
+  - code_observability_work_package_missing
+  - sensitive_log_leak
+  - catch_swallow
+  - missing_log_critical
+  - missing_comment_complex_unresolved
+  - missing_class_doc
+  - missing_method_doc
+  - missing_important_line_comment
+  - non_chinese_log
+  - non_chinese_comment
+fallback: manual_required
+required_evidence:
+  - code_observability_work_package
+  - review_findings
+  - verification_result
+version: 1.1.0
+last_reviewed: '2026-06-01'
+stages: ["*"]
+---
+
+## 注释契约
+
+### 中文 Javadoc 必须具备
+- Java/Kotlin 后端类、接口、枚举、记录必须有中文文档注释，说明类型职责、业务边界和使用场景。
+- 后端每个业务方法必须有中文文档注释，说明方法作用；有入参时说明参数语义；有返回值时说明返回对象或结果含义。
+- Controller、Service、UseCase、DomainService、Repository、Mapper、DTO、VO、Request、Response、Entity 等均适用。
+- 关键业务行必须有中文行注释，尤其是事务双写、状态流转、级联删除、账号联动、外部调用、审计写入、补偿和回滚边界。
+- 允许保留英文代码标识符，但业务说明、风险说明、参数说明、返回说明必须中文表达。
+
+### 必须有注释
+- 业务规则不直观时
+- 领域不变量（如"一个用户同一时间只能有一个有效业务办理"）
+- 金额、账单、折扣、支付、退款、核验逻辑
+- 状态流转逻辑（如 pending → paid → refunded）
+- 幂等、分布式锁、事务、并发控制
+- 权限、安全、审计判断
+- 外部系统兼容、历史包袱、第三方接口限制
+- 复杂 SQL、复杂查询条件、非显而易见算法
+- 前端复杂交互规则：权限控制、状态流转、表单联动、乐观更新/回滚、支付与敏感操作
+
+### 必须禁止
+- 每行废话注释
+- 复述代码字面含义的注释
+- 注释与代码行为不一致
+- 注释承诺了代码没有做到的安全性、幂等性或事务性
+- 用户项目业务注释全英文
+- 只写 `{@inheritDoc}` 但没有说明本实现的业务边界、入参和出参
+
+## 日志契约
+
+### 日志中必须有
+- 用户登录、登出、认证失败
+- 权限拒绝、越权访问
+- 创建、修改、删除关键业务对象
+- 状态变更、金额变更、支付、退款、折扣、核验
+- 合同、业务办理、账单、证照、人员角色变更
+- 外部 API 调用失败、超时、重试
+- 异步任务开始、成功、失败、重试、跳过
+- 数据修复、批处理、迁移脚本
+- 捕获异常后继续执行
+- 降级、兜底、补偿逻辑
+- 前端关键交互：表单提交、状态变更、权限动作、支付/敏感操作、上传导入、API 调用失败
+
+### 日志必须具备的要素
+- 中文事件名或中文动作说明
+- 事件名或动作名
+- 业务对象 ID
+- 操作人或系统来源
+- traceId / correlationId（如果项目已有）
+- 失败原因
+- 关键状态变化前后值
+- 合理日志级别
+
+### 日志中必须禁止
+- 裸 console.log（生产代码）
+- 生产代码遗留调试日志
+- catch 后无日志直接吞异常
+- 只打印 "error"、"failed" 这类不可定位日志
+- 用户项目业务日志全英文
+- 打印 password、token、secret、cookie、身份证全量、手机号全量、银行卡全量、健康隐私
+- 高频循环里刷屏日志
+- 日志拼接大对象导致性能或隐私问题
+
+## 项目 logger 识别
+- Java/Spring: Slf4j + LoggerFactory
+- Node/Express/NestJS: pino, winston, NestJS Logger, 项目封装 logger
+- Python/FastAPI、Go handler、.NET、Ruby 等后端: 使用项目现有 logger 或先建立 logger 包装
+- NestJS: Logger
+- React/Vue/Svelte 等前端: 项目封装 logger、埋点或错误上报，生产环境禁止裸 console
+- 如果项目没有 logger，要求先建立项目 logger 包装
+
+## 跨技术栈适用范围
+- 后端不限定 Spring：Controller、Service、UseCase、Handler、Router、Resolver、ViewSet、Repository、Mapper 等写操作都适用。
+- 前端不限定框架：React、Vue、Svelte、移动端页面和状态 store 的业务提交、状态变更、权限动作和 API 失败都适用。
+- Entity、Request、Response、VO、DTO、Schema、Serializer、Model 等用户项目契约类的业务字段需要中文含义说明或 Schema 注解。
+- Java Entity 使用 Getter/Setter 分层访问策略；DTO、VO、Request、Response 使用 Data 风格承载边界数据，不得混用导致领域模型语义被抹平。
+
+## 严重度
+- P0 阻断: 敏感信息泄漏、catch 吞异常、支付/金额/权限变更无日志
+- P1 阻断: 状态流转无日志、复杂规则无注释、后端类/方法中文 Javadoc 缺失、关键行中文注释缺失、中文日志缺失、外部调用无日志、裸 console.log
+- P2 警告: 日志级别不合理、上下文字段不足
+- P3 建议: 普通可读性优化
+
+## 低风险跳过
+- 纯样式、文案、简单 getter/setter、简单类型定义、测试 fixture
+- 低风险只读查询且已有统一 access log
+- 简单配置修改、一次性本地实验代码

package/templates/rules/shared//345/206/263/347/255/226/345/256/214/346/225/264/346/200/247/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,28 +1,20 @@
 ---
 name: decision-completeness-review
 type: review_rule
-when: '决策研讨, 架构决策, decision review'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-review-rule-决策完整性审查规则
-asset_kind: review_rule
 lifecycle_status: active
 authority: supporting
-primary_triggers:
-  - 决策完整性审查规则
-secondary_triggers:
-  - 决策审查
-  - 架构决策
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["代码审查"]
 owner_mechanism_id: mc-architecture-decision-workshop
+triggers: ["决策研讨","架构决策","decision review"]
 ---
 
 # 决策完整性审查规则
@@ -31,26 +23,41 @@ owner_mechanism_id: mc-architecture-decision-workshop
 
 pattern: 业务流程、数据、安全、后端、前端、基础设施六域必须有决策记录
 severity: warning
+check_type: semantic
 scope: [backend, frontend]
 description: 每个域至少有一个明确的决策点；与当前需求无关的域可以标注"不适用"但不得留空
+evidence_required:
+  - "六域决策覆盖列表"
+  - "每域决策记录路径或不适标注"
 
 ## DEC-02: 每个决策有量化依据
 
 pattern: 决策记录必须包含选型理由、对比方案和量化指标
 severity: warning
+check_type: semantic
 scope: [backend, frontend]
 description: 决策不得仅写"选择 X"，必须包含：为什么选 X、对比了哪些方案、用什么指标衡量的
+evidence_required:
+  - "决策记录路径"
+  - "选型理由+对比方案+量化指标确认"
 
 ## DEC-03: 用户确认证据存在
 
 pattern: 每个关键决策必须有用户确认记录
 severity: warning
+check_type: semantic
 scope: [backend, frontend]
 description: 涉及架构、技术栈、数据结构、API 设计的关键决策，必须有用户确认的证据（确认文本或审批记录）
+evidence_required:
+  - "用户确认记录路径"
+  - "确认时间+确认内容"
 
 ## DEC-04: 决策可追溯
 
 pattern: 每个决策必须关联到具体的需求点
 severity: warning
+check_type: semantic
 scope: [backend, frontend]
 description: 决策不能凭空产生，必须能追溯到触发它的需求或问题；无需求对应的决策标注为"技术优化"
+evidence_required:
+  - "决策-需求追溯映射表"

package/templates/rules/shared//345/210/207/347/211/207/346/211/247/350/241/214/347/272/252/345/276/213/350/247/204/345/210/231.md

@@ -0,0 +1,96 @@
+---
+name: slice-execution-discipline
+type: governance_rule
+stages: ["编码与单元测试"]
+lifecycle_status: active
+owner_mechanism_id: mc-command-router
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+priority: P1
+triggers: ['切片执行', '编码执行', 'slice execution', '开始编码', '实现切片']
+---
+
+# 切片执行纪律规则
+
+## SED-01: 扫描先行
+- id: SED-01
+- name: 扫描先行
+- severity: error
+- check_type: deterministic
+- pattern: 编码前必须扫描所有涉及文件，记录文件/行号/变更类型；扫描时间戳 < 编码开始时间
+- description: 编码前必须扫描所有涉及文件，记录文件/行号/变更类型。扫描结果必须写入执行记录。未完成扫描不得开始编码。
+
+## SED-02: 测试前置≥9 场景
+- id: SED-02
+- name: 测试前置≥9 场景
+- severity: error
+- check_type: deterministic
+- pattern: 每个切片必须有 ≥9 个新测试场景（正常×2 + 边界×3 + 错误×2 + 集成×2）
+- description: 每个切片必须有≥9 个新测试场景覆盖核心逻辑。测试场景必须覆盖：正常路径×2、边界条件×3、错误路径×2、集成场景×2。测试文件必须在编码开始前创建。已有测试的修改也必须增加新场景。
+
+## SED-03: 逐条对账
+- id: SED-03
+- name: 逐条对账
+- severity: error
+- check_type: deterministic
+- pattern: AC × 测试用例映射表完整，每条 AC 有≥1 个测试用例
+- description: 编码完成后，逐条对照验收标准确认完成。每条验收标准必须对应至少一个测试用例。未通过的验收标准必须标注原因和修复计划。
+
+## SED-04: 禁止跨任务修改
+- id: SED-04
+- name: 禁止跨任务修改
+- severity: error
+- check_type: deterministic
+- pattern: git diff --name-only 与涉及文件列表对比，偏差≤2 文件
+- description: 当前切片只能修改涉及文件列表中的文件。偏差超过 2 个文件须触发重规划评估。
+
+## SED-05: 禁止跳过扫描
+- id: SED-05
+- name: 禁止跳过扫描
+- severity: error
+- check_type: deterministic
+- pattern: 扫描记录文件存在且时间戳 < 编码开始时间
+- description: 未完成文件扫描直接编码视为违规。扫描记录必须包含文件路径、行号、变更类型。
+
+## SED-06: 禁止空函数体
+- id: SED-06
+- name: 禁止空函数体
+- severity: error
+- check_type: deterministic
+- pattern: grep -E 'TODO|placeholder|pass;$' 新增函数扫描结果为 0
+- description: 所有新增函数必须有实现，不允许 TODO/placeholder/pass 占位。
+
+## SED-07: 反模式——试错式编码
+- id: SED-07
+- name: 反模式——试错式编码
+- severity: warning
+- check_type: semantic
+- pattern: 未定位根因就修改代码，同一位置修改≥3 次
+- description: 编码时未定位根因就修改代码。发现异常应先分析日志和堆栈，定位根因后再修改。
+
+## SED-08: 反模式——顺手重构
+- id: SED-08
+- name: 反模式——顺手重构
+- severity: warning
+- check_type: semantic
+- pattern: 编码过程中偏离目标进行非计划内的重构
+- description: 编码过程中发现"可以优化"而偏离目标。重构必须单独规划，不得在功能切片中混入。
+
+## SED-09: 反模式——隐式依赖
+- id: SED-09
+- name: 反模式——隐式依赖
+- severity: warning
+- check_type: semantic
+- pattern: 新增未在计划中声明的文件依赖
+- description: 新增的 import/require 必须在切片计划的涉及文件列表中声明。未声明的依赖须触发重规划。
+
+## SED-10: 反模式——吞异常
+- id: SED-10
+- name: 反模式——吞异常
+- severity: error
+- check_type: deterministic
+- pattern: 空 catch 块扫描结果为 0（grep -E 'catch\s*\([^)]*\)\s*\{\s*\}' 匹配 0）
+- description: catch 块中不处理也不上报。空 catch 扫描必须为 0，至少需要记录日志或明确注释忽略原因。

package/templates/rules/shared//345/210/207/347/211/207/350/247/204/345/210/222/350/247/204/345/210/231.md

@@ -0,0 +1,64 @@
+---
+name: slice-planning
+type: governance_rule
+stages: ["任务规划"]
+lifecycle_status: active
+owner_mechanism_id: mc-command-router
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+priority: P1
+triggers: ['切片规划', '切片计划', 'slice planning', '任务拆分', '功能拆分']
+---
+
+# 切片规划规则
+
+## SLP-01: 最小闭环
+- id: SLP-01
+- name: 最小闭环
+- severity: error
+- check_type: semantic
+- pattern: 切片 AC 不得引用其他切片的输出作为前置条件
+- description: 每个切片必须能独立完成并验证，不依赖后续切片的产出。AC 中引用的输入必须是上游设计产物（DD-*/ARCH-*），而非同层级其他切片的输出。
+
+## SLP-02: 可独立测试
+- id: SLP-02
+- name: 可独立测试
+- severity: error
+- check_type: semantic
+- pattern: 每个切片的测试文件可独立执行，不需要等待其他切片完成
+- description: 切片完成后必须能独立运行测试验证。若需其他切片的数据，须通过 fixture/mock 提供，不得依赖真实执行顺序。
+
+## SLP-03: 单一职责
+- id: SLP-03
+- name: 单一职责
+- severity: warning
+- check_type: semantic
+- pattern: 切片描述≤2 个功能点
+- description: 每个切片只聚焦一个功能点或一个变更维度。描述超过 2 个功能点的切片应拆分。复合切片须用前置依赖字段关联。
+
+## SLP-04: 上游引用完备
+- id: SLP-04
+- name: 上游引用完备
+- severity: error
+- check_type: deterministic
+- pattern: 每个切片的上游引用字段包含 DD-* 和 ARCH-* 编号
+- description: 每个切片必须引用详细设计文档中的 DD-* 编号（接口/模块）和架构设计文档中的 ARCH-* 编号（架构决策）。无上游设计引用的切片不得进入执行阶段。
+
+## SLP-05: 验收标准三路径
+- id: SLP-05
+- name: 验收标准三路径
+- severity: error
+- check_type: deterministic
+- pattern: 每个切片≥3 条 AC，覆盖功能/质量/边界三路径
+- description: 每个切片必须有 AC-* 验收标准，至少包含：功能验收（核心功能点的预期行为）、质量验收（测试覆盖率、无 lint 错误）、边界验收（边界条件和错误处理）。
+
+## SLP-06: ID 命名规范
+- id: SLP-06
+- name: ID 命名规范
+- severity: error
+- check_type: deterministic
+- pattern: 切片 ID 格式 SLC-{模块简称}-{序号}，AC ID 格式 AC-SLC-{模块}-{序号}-{N}
+- description: 任务 ID 格式：`SLC-{模块简称}-{序号}`（如 SLC-Auth-01）。验收标准 ID 格式：`AC-{任务ID}-{序号}`（如 AC-SLC-Auth-01-01）。依赖声明使用任务 ID，不允许使用描述性文字。ID 不得重复或缺失。