soloforge 1.1.47 → 1.1.49

package/templates/operate/UI/350/247/206/350/247/211/351/252/214/346/224/266/347/272/252/345/276/213.md

@@ -0,0 +1,85 @@
+---
+id: ka-guidance-UI视觉验收纪律
+kind: guidance
+title: UI视觉验收纪律
+sync_policy: copy_to_project
+status: active
+triggers:
+  - UI 视觉
+  - 视觉验收
+  - 界面样式
+  - 前端样式
+  - 界面布局
+  - 切片交付
+  - 切片构建
+  - 前端切片
+target_artifact:
+  - release_note
+extra:
+  name: ui-visual-acceptance
+  scope:
+    - frontend
+  products:
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-20'
+  verification_layer: L2
+  stage: operate
+  domain: operate
+  owner_mechanism: mc-stage-gate-engine
+---
+
+# UI视觉验收纪律
+
+> **本纪律仅适用于含前端 UI 的项目。纯后端/无 UI 项目跳过本节，发布说明「UI 视觉验收」行填「无前端」。**
+
+> **为什么是 L2 软规则**：SLICE-E2E（playwright e2e）只验**交互链路与接口响应**，不验**UI 视觉样式**（布局/颜色/间距/响应式视觉/与设计稿一致）。引擎不调 LLM、看不懂截图，**无法确定性判定"界面长得对不对"**——强行硬判必造假（有截图 ≠ 视觉对）。故 UI 视觉正确性归 **L2 客户端 AI 视觉审查**（主）+ **L3 人工确认**（兜底），引擎只做：注入本纪律提醒 + 提供发布说明留痕载体 + 文案不假装确定性验过。
+
+## 主流程：L2 客户端 AI 视觉审查（分两层：切片级局部 + 交付前整体）
+
+**shift-left**：视觉审查分两层——切片级做局部自查（早发现局部 bug），交付前做整体审查（跨切片一致性）。不一刀切压交付前（局部 bug 积压难倒查）。
+
+### 切片级视觉自查（每切片交付时，软）
+
+每完成一个含 UI 的切片（slice-gate 时），AI 看本切片涉及页面 screenshot，判**局部视觉**：本切片新增/改动页面的布局/颜色/响应式无明显错误；按钮/表单/交互元素可见可点；与已交付切片视觉无明显冲突。**软（不硬判）**：截图给 AI 看给局部结论，局部 bug 当场修不积压。
+
+### 交付前整体审查（产出发布说明时）
+
+交付前（产出发布说明时）对前端各端做**整体视觉审查**，**看截图判断**：
+
+1. **布局**：核心页面在 desktop/移动 viewport 下无塌陷、无错位、关键元素可见可点
+2. **颜色/主题**：配色与设计稿/主题一致，无对比度缺陷（文字可读）
+3. **响应式视觉**：断点切换无溢出、无横向滚动、组件自适应
+4. **与设计稿一致**：关键页对照设计稿/截图基线，记录差异点
+
+**产出结论**（非"看过"二字了事）：每个审查维度给 通过/差异/未覆盖，差异项附截图 ref + 说明。
+
+## L3 兜底：人工确认主观项
+
+以下归人工确认，AI 不得替人拍板：
+- 主观审美（视觉风格是否"对"、品牌调性）
+- AI 不确定的视觉差异（像素级 flaky）
+- 设计稿未覆盖的边界视觉态
+
+发布说明「UI 视觉验收」行须列明**需人工确认的视觉点**（对应 `manual_review_steps_zh`），人工逐项确认后方可判定交付完成。
+
+## 留痕（发布说明「UI 视觉验收」行）
+
+发布说明「5. 验证结果」表「UI 视觉验收」行填写：
+- **结果**：通过 / 差异（附说明）/ 待人工确认
+- **证据**：截图 ref + AI 视觉结论摘要 / 人工确认结果
+
+## 诚实纪律（反造假）
+
+- **没验标 gap，不假装 passed**：若未做视觉审查，发布说明该行填「未验收」并标限制，**不得填"通过"**——填"通过"而无证据 = 重蹈 SLICE-E2E 名不副实的覆辙。
+- **不在确定性 e2e 里偷验视觉**：UI 视觉是 L2/L3 域，不往 SLICE-E2E 塞视觉断言冒充确定性覆盖。
+- **纯前端无后端的项目也须做**：只要含 UI 就适用，不因"无后端接口"跳过视觉验收。
+
+## L1 备选：视觉回归（成熟项目可选）
+
+成熟项目可加 `playwright` `toHaveScreenshot()` 基线对比做**视觉回归**（L1 确定性，防"这次和上次不一样"）。注意：
+- 视觉回归只防**回归**，不验**设计符合度**（基线本身可能就是错的）——不替代 L2 设计符合度审查。
+- 需建基线截图 + 维护，像素对比易 flaky（字体渲染/动画），需稳定测试环境。
+- 新建项目默认走 L2+L3，待视觉稳定后再补 L1 回归。

package/templates/operate/enforced.md

@@ -11,7 +11,7 @@ checks:
   - id: OPR-G01
     executor: file_evidence
     rule: "发布后 5xx 错误率在基线 ±20% 范围内，无突增趋势"
-    severity: error
+    severity: warning
     check_type: deterministic
     evidence_required: ["基线错误率 / 发布后错误率 / 偏差百分比（±20% 内）"]
     gate: operate-gate
@@ -19,7 +19,7 @@ checks:
   - id: OPR-G02
     executor: file_evidence
     rule: "发布后 P99 延迟不超过基线的 1.5 倍"
-    severity: error
+    severity: warning
     check_type: deterministic
     evidence_required: ["P99 基线 / 发布后 P99 / 比值（<= 1.5x）"]
     gate: operate-gate
@@ -35,7 +35,7 @@ checks:
   - id: OPR-G04
     executor: file_evidence
     rule: "回滚预案已在预发环境演练验证，总耗时不超过 5 分钟"
-    severity: error
+    severity: warning
     check_type: deterministic
     evidence_required: ["回滚演练记录 + 总耗时（<= 5 分钟）"]
     gate: operate-gate
@@ -43,25 +43,61 @@ checks:
   - id: OPR-G05
     executor: file_evidence
     rule: "发布后数据一致性校验 SQL 全部通过，覆盖所有变更涉及的表"
-    severity: error
+    severity: warning
     check_type: deterministic
     evidence_required: ["校验 SQL 结果 + 覆盖表/记录数"]
     gate: operate-gate
     target: "self"
+  - id: OPR-DEPLOY-STRUCT
+    executor: document_structure
+    rule: "部署配置须含「环境规划」「环境变量与密钥」「部署方式」「健康检查与资源」「监控告警」「回滚方案」「完成判定」章节"
+    severity: error
+    check_type: deterministic
+    evidence_required: ["deploy/部署配置.md"]
+    gate: operate-gate
+    target: "self"
   - id: RELNOTE-STRUCT
     executor: document_structure
     check_type: deterministic
     severity: warning
     gate: operate-gate
     required_artifact: 发布说明模版
-    rule: "发布说明须包含「1. 版本信息」「2. 变更摘要」「5. 验证结果」「6. 回滚方案」章节"
+    rule: "发布说明须含「版本信息」「变更摘要」「数据库迁移」「验证结果」「回滚方案」「部署步骤」「监控」「已知问题」「完成判定」章节"
     evidence_required: ["docs/audits/04-发布说明.md"]
     target: "self"
+  - id: DEPLOY-BLOCK
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: operate-gate
+    required_artifact: 部署配置模版
+    rule: "部署必填表格章节（环境/变量/依赖/健康/监控/回滚）须有表格行（反退化：禁空单元格/...占位）"
+    block_check:
+      item_pattern: '^##\s+(1|2|3|5|6|7)\.'
+      require_table: true
+      min_table_rows: 1
+    evidence_required: ["部署配置模版"]
+    target: "self"
+  - id: RELEASENOTE-BLOCK
+    executor: document_structure
+    check_type: deterministic
+    severity: error
+    gate: operate-gate
+    required_artifact: 发布说明模版
+    rule: "变更摘要/验证结果章节须有表格行（反退化：禁空表/一句话代替）"
+    block_check:
+      item_pattern: '^##\s+(2|5)\.'
+      require_table: true
+      min_table_rows: 1
+    evidence_required: ["发布说明模版"]
+    target: "self"
 ---
 
 # operate-gate 强制检查清单
 
-5 条确定性检查。bridge 从此文件聚合。
+9 条确定性检查（含 RELNOTE-STRUCT）。bridge 从此文件聚合。
+
+> OPR-G01~G05 用 file_evidence（只验证据文件存在+非空）；rule 描述的指标（5xx/P99/日志/回滚/一致性）**须人工确认**，故 severity=warning（不假装 error 确认指标）。
 
 对应工程经验：
 - OPR-G01

package/templates/operate//345/217/221/345/270/203/350/257/264/346/230/216.md

@@ -1,5 +1,5 @@
 ---
-id: ka-artifact_template-发布说明模版
+id: ka-artifact-发布说明
 kind: artifact
 title: 发布说明
 sync_policy: copy_to_project
@@ -24,6 +24,7 @@ extra:
 
 > **产物定位**：operate 阶段产出。记录发布内容/影响/验证/回滚，是上线可追溯的凭证。
 > **核心纪律**：任何上线变更必须有回滚方案（[[开发者宪法]]）；发布说明须含回滚章节（operate-gate RELNOTE-STRUCT 守护）。
+> **反退化纪律**：变更摘要/验证结果等表格须逐条填写，禁止空表、禁止「…」省略；回滚/部署步骤须是可执行的具体步骤，非一句话。
 
 ## 1. 版本信息
 - 版本号：
@@ -36,6 +37,12 @@ extra:
 |--------|---------------------------|--------------|---------|
 | | | | |
 
+### 前端各端版本（涉及 FE-* 时填；纯后端填"无前端"）
+
+| 端（FE-*） | 版本号 | 变更摘要 | 是否独立发布 |
+|-----------|--------|---------|------------|
+| FE-client-01 | | | 是/否 |
+
 ## 3. 数据库迁移
 - [ ] 无数据库变更
 - 迁移脚本路径：
@@ -54,6 +61,7 @@ extra:
 | 单元测试 | | |
 | 集成测试 | | |
 | 端到端验收 | | |
+| UI 视觉验收（前端项目填；纯后端填"无前端"）| | 截图 + AI视觉结论/人工确认 |
 
 ## 6. 回滚方案
 - 触发条件（什么情况下回滚）：
@@ -80,3 +88,13 @@ extra:
 - 通知对象（用户/团队/相关方）：
 - 通知内容：
 - 通知时间：
+
+## 完成判定
+
+- [ ] 版本信息完整（版本号/日期/负责人）
+- [ ] 变更摘要覆盖本次所有变更
+- [ ] 验证结果含三类（正常/边界/异常）
+- [ ] 回滚方案可执行
+- [ ] 部署步骤明确可操作
+- [ ] 前端项目：UI 视觉验收已留痕（截图+结论或人工确认）；纯后端填"无前端"
+- [ ] 变更/验证表格逐条填写，回滚与部署步骤具体可执行（非一句话）

package/templates/operate//351/203/250/347/275/262/351/205/215/347/275/256.md

@@ -23,6 +23,7 @@ extra:
 
 > **产物定位**：operate 阶段必出。把环境、依赖、部署方式、健康检查、回滚定清楚。
 > **核心纪律**：部署可回滚（[[开发者宪法]]）；配置走环境变量不硬编码（[[安全加固]]）。
+> **反退化纪律**：环境变量/依赖服务/监控告警/回滚方案等表格须逐条填写真实值，禁止空单元格、禁止「…」占位。
 > **完成判定**：见文末。
 
 ## 1. 环境规划
@@ -51,6 +52,14 @@ extra:
 - 镜像/制品来源：
 - 部署流程：构建 → 推送 → 拉起 → 健康检查 → 放量
 
+### 多端部署矩阵（涉及前端 FE-* 时填；纯后端填"无前端，单一部署"）
+
+| 端（FE-*） | 部署方式 | 制品来源 | 域名/入口 | 与后端依赖 |
+|-----------|---------|---------|----------|-----------|
+| FE-client-01 | 静态托管/CDN/容器 | | | |
+
+> 每个前端端独立部署（静态资源 CDN / 容器化），后端独立部署；端间依赖（如 admin 依赖后端 API）显式声明。
+
 ## 5. 健康检查与资源
 | 项 | 配置 |
 |----|------|
@@ -81,3 +90,4 @@ extra:
 - [ ] 健康检查（就绪+存活）配置
 - [ ] 监控告警覆盖错误率/延迟/资源
 - [ ] 回滚方案有且可演练
+- [ ] 各配置表格逐条填真实值，无空单元格/无「…」占位

package/templates/shared/enforced.md

@@ -59,6 +59,43 @@ checks:
       - "regex_pattern_scan 扫描结果（命中须确认是否测试 fixture/文档示例，真实密钥必须改走环境变量或密钥管理）"
     gate: shared-gate
     target: self
+  # —— 切片级验证（slice-gate：构建镜像/docker 部署/HTTP 验收/浏览器端到端）——
+  - id: SLICE-BUILD
+    executor: external_command
+    command: docker
+    args: ["compose", "build"]
+    rule: "切片完成后构建最新本地镜像（docker compose build）。有 docker-compose.yml 硬验（error，失败=构建问题）；无则跳过（新项目放行，产 compose 后自动生效）"
+    severity: error
+    check_type: deterministic
+    evidence_required: ["docker compose build exitCode=0"]
+    gate: slice-gate
+    target: self
+  - id: SLICE-UP
+    executor: docker_deployment
+    rule: "docker desktop 部署（docker-compose up）验证部署成功"
+    severity: warning
+    check_type: deterministic
+    evidence_required: ["docker compose up 成功 + 容器健康"]
+    gate: slice-gate
+    target: self
+  - id: SLICE-HTTP
+    executor: local_http_acceptance
+    rule: "HTTP 验收（可访问性）—— 服务可访问 + 核心接口返回 2xx/3xx（local_http_acceptance 逐端口 fetch 验可达；业务返回正确性归人工/E2E，非本 check 确定性覆盖）"
+    severity: warning
+    check_type: deterministic
+    evidence_required: ["HTTP 请求响应通过"]
+    gate: slice-gate
+    target: self
+  - id: SLICE-E2E
+    executor: external_command
+    command: npx
+    args: ["playwright", "test"]
+    rule: "浏览器端到端验证（前端交互 + 后端逻辑）—— playwright e2e（验交互链路与接口响应，不验 UI 视觉样式）。有 playwright.config 硬验（error，失败=e2e 问题）；无跳过（Claude Code npx playwright install + 加配置后生效，新项目放行）。注：UI 视觉样式（布局/颜色/响应式视觉/与设计稿一致）属非确定性判断，不归本 e2e——归 L2 客户端 AI 视觉审查（**切片级局部自查 + 交付前整体**，见 operate 域「UI视觉验收纪律」guidance）+ L3 人工确认。"
+    severity: error
+    check_type: deterministic
+    evidence_required: ["playwright test exitCode=0"]
+    gate: slice-gate
+    target: self
 ---
 
 # shared-gate 共享硬底线

package/templates/shared//345/267/245/344/275/234/346/265/201/345/257/274/350/210/252/345/245/221/347/272/246.md

@@ -27,7 +27,7 @@ extra:
 
 导航必须把用户确认项分为三类：
 
-1. `must_confirm`：影响业务口径、架构决策、权限模型、API/数据库语义、陈旧任务处理等不可由 AI 代决的事项。只有这类确认可以阻塞推进。
+1. `must_confirm`：影响业务口径、架构决策、权限模型、API/数据库语义、陈旧任务处理、**系统形态与交付边界（是否前后端分离、几个端、各端技术栈）**等不可由 AI 代决的事项。只有这类确认可以阻塞推进。
 2. `should_confirm`：确认后准确性更高，但不确认也允许继续只读分析、初始化、模版同步和低风险准备。
 3. `auto_resolvable`：可通过命令、复验或修复动作解决的事项，不应要求用户拍板。
 

package/templates/shared//345/267/245/344/275/234/346/265/201/347/241/254/350/247/204/345/210/231/345/245/221/347/272/246.md

@@ -78,7 +78,7 @@ extra:
       source_ref: src/context/adapters/shared/workflow_template.ts#wf-core-principles
     - rule_id: wf-knowledge-injection
       rule_summary: （已废弃）原三道门知识注入决策，已无运行时调用，保留作历史记录、不再注入
-      user_instruction: 必须通过知识注入边界机制注入匹配的机制知识资产。
+      user_instruction: （已废弃，不再注入；保留作历史记录）
       mechanism_id: mc-knowledge-injection-boundary
       enforcement_status: deprecated
       source_ref: src/context/adapters/shared/workflow_template.ts#wf-knowledge-injection
@@ -146,7 +146,7 @@ extra:
       source_ref: src/context/adapters/shared/workflow_template.ts#wf-no-lazy-code
 ---
 
-# 工作流模版硬规则契约
+# 工作流模板硬规则契约
 
 工作流执行硬规则（条数随下方 hard_rules 清单维护，不在此硬编码）。
 

package/templates/shared//347/240/224/350/256/250/350/256/260/345/275/225.md

@@ -0,0 +1,54 @@
+---
+id: ka-artifact_template-研讨记录
+kind: artifact
+title: 研讨记录
+sync_policy: engine_only
+status: active
+extra:
+  name: deliberation-record
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.0.0
+  type: artifact_template
+  owner_mechanism: mc-generic-artifact
+---
+
+# 研讨记录
+
+> **用途**：对话框交互式研讨后的**总结留痕**（研讨本身在对话框与用户进行，本文件是对话收敛后 AI 写的总结，不是研讨过程）。
+> **下游**：`act` 产出实际产物时承接本研讨结论；cross-artifact 对抗审查复核"研讨充分性"。
+
+## 1. 疑问点扫描
+
+逐点列出本产物的关键决策点（技术选型 / 边界假设 / 信息缺口 / 接口契约 / 异常处理 / 性能与安全取舍…），标记【有疑问】/【无疑问】：
+
+- [决策点 1] — 【有疑问】/【无疑问】
+- [决策点 2] — 【有疑问】/【无疑问】
+
+## 2. 有疑问的点（完整四步法）
+
+对每个【有疑问】的点：
+
+### [点名称]
+
+1. **不确定点**：到底不确定什么（信息缺口？多个候选？边界未定？假设未验证？）
+2. **头脑风暴发散**：列出所有可能方案，暂不评判（数量优先，禁止过早否定）
+   - 方案 A：…
+   - 方案 B：…
+3. **第一性原理收敛**：回到根本约束（用户根本需求 / 物理与成本 / 已有架构 / 可证伪事实），从公理推导，淘汰经不起追问的方案
+4. **收敛结论 + 决策依据**：选定方案 + 为什么（必须可证伪，对抗审查会复核）
+
+## 3. 第一性原理淘汰过程
+
+汇总各疑问点的候选方案如何被根本约束淘汰，保留最终选择（可追溯）：
+
+- [点]：方案 A 被淘汰因为…；方案 B 胜出因为…
+
+## 4. 收敛结论 + 无疑问点举证
+
+- **关键决策**：基于研讨的最终选择（承接进实际产物）
+- **无疑问点举证**（不得空泛，复杂决策必须有依据）：
+  - `[点] 已确认无疑问 — 依据：…`