soloforge 1.1.46 → 1.1.48

package/templates/shared/enforced.md

@@ -2,17 +2,21 @@
 id: shared-enforced
 kind: enforced
 gate: shared-gate
-title: 跨阶段通用强制检查清单
+title: 共享硬底线
 sync_policy: engine_only
 status: active
+extra:
+  owner_mechanism: mc-stage-gate-engine
 checks:
+  # —— SoloForge 自身架构边界（守护引擎不被污染）——
   - id: SHD-LLM01
     executor: regex_pattern_scan
     rule: "SoloForge 源码禁止直接调用 LLM API（架构边界：编排引擎不绑定模型，产出上限由客户端 AI 决定）"
     severity: error
     check_type: deterministic
     pattern: '/(?:anthropic|openai)\.(?:messages|chat)\.(?:create|completions)|new\s+Anthropic\(|new\s+OpenAI\(/'
-    languages: [通用]
+    languages:
+      - 通用
     evidence_required:
       - "regex_pattern_scan 扫描结果（src/ 无 LLM API 直接调用命中）"
     gate: shared-gate
@@ -23,13 +27,87 @@ checks:
     severity: warning
     check_type: deterministic
     pattern: '/throw\s+new\s+Error\(\s*"[A-Za-z]/'
-    languages: [ts, 通用]
+    languages:
+      - ts
+      - 通用
     evidence_required:
       - "regex_pattern_scan 扫描结果（src/ 无英文 throw Error/日志）"
     gate: shared-gate
     target: self
+  # —— 用户项目代码安全底线 ——
+  - id: SEC-01
+    executor: regex_pattern_scan
+    rule: "禁止提交私钥内容（含 BEGIN PRIVATE KEY 头）"
+    severity: error
+    check_type: deterministic
+    pattern: '/-----BEGIN (RSA |EC |DSA |OPENSSH |)PRIVATE KEY-----/'
+    languages:
+      - 通用
+    evidence_required:
+      - "regex_pattern_scan 扫描结果（git diff 变更文件无私钥泄露）"
+    gate: shared-gate
+    target: self
+  - id: SEC-02
+    executor: regex_pattern_scan
+    rule: "禁止硬编码高熵密钥/密码（password/secret/api_key/token 赋值字面量）"
+    severity: warning
+    check_type: deterministic
+    pattern: "/(password|passwd|secret|api[_-]?key|access[_-]?key|private[_-]?key|auth[_-]?token)\\s*[:=]\\s*[\"'][^\"'\\s]{12,}/i"
+    languages:
+      - 通用
+    evidence_required:
+      - "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 视觉审查 + L3 人工确认（见 operate 域「UI视觉验收纪律」guidance，交付前在发布说明留痕）。"
+    severity: error
+    check_type: deterministic
+    evidence_required: ["playwright test exitCode=0"]
+    gate: slice-gate
+    target: self
 ---
 
-# shared-gate 跨阶段通用强制检查清单
+# shared-gate 共享硬底线
+
+跨所有阶段、不可商量的底线。`gate_registry_bridge` 从此文件聚合到 shared-gate。分两类：
+
+**SoloForge 自身架构边界**（守护引擎源码不被污染）：
+- `SHD-LLM01`：源码不直接调 LLM（error）—— 编排引擎不绑定模型
+- `SHD-COMMENT01`：源码错误/日志中文（warning）
+
+**用户项目代码安全底线**：
+- `SEC-01`：私钥泄露（error，高确定性零误报）
+- `SEC-02`：硬编码密钥（warning，可能误报测试 fixture，命中后人工确认）
 
-跨阶段通用强制规则（所有研发阶段都适用，由 shared-gate 聚合）。
+> 各域代码质量门禁（中文注释/无空 catch/类型安全/Controller 不含业务逻辑等）见对应域 enforced；路径穿越写入由运行时 scope_controller 强制，不在此重复。

package/templates/shared//345/217/215/351/246/210/344/277/256/345/244/215/351/227/255/347/216/257.md

@@ -0,0 +1,86 @@
+---
+id: ka-guidance-反馈修复闭环
+kind: guidance
+title: 反馈修复闭环
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 验证失败
+  - 门禁失败
+  - 检查失败
+  - 修复
+  - fix
+  - 重试
+  - retry
+  - escalate
+  - 反馈
+  - 复验
+  - 修复闭环
+  - gate
+  - 复检
+extra:
+  name: feedback-repair-loop
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: procedure
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-verifier
+---
+
+# 反馈修复闭环：报错怎么修、修完怎么回来
+
+> verify/gate 失败后，按本流程闭环。禁止假修复、禁止跳过。
+> 这是把引擎 Reflexion 机制翻译成可执行步骤。
+
+## 第一步：读懂门禁反馈
+
+verify 失败后，引擎把上次失败的 findings 注入回来。每条 finding 含：
+- `id`：检查项编号（如 ARC-01、SEC-01）
+- `severity`：`error`（必须修）/ `warning`（应当修）/ `info`（advisory 参考）
+- `message`：技术原因（为什么失败）
+- `evidence_required`：补什么证据才算修好
+
+还有一段大白话 `recovery_summary`：整体怎么了、该干什么、有什么 pending 项。
+
+## 第二步：逐条修复（按 severity 分流）
+
+**error 级**（必须全修）：
+1. 看 message 定位根因，不是只看表象（[[工程执行总纲]] 思考先行）
+2. 按 evidence_required 补齐证据
+3. 修复限于同一限界上下文；跨越无关模块必须回到任务拆解
+
+**warning 级**（尽量修）：
+- 影响小可记录风险后放行，但在交付说明里写清放行理由
+
+**info 级（semantic）**：
+- advisory 不阻断，但是给客户端 AI 的评判参考
+- 必须认真评估，不能当没看见；评估结论写进交付说明
+
+## 第三步：修完回到哪一步重验
+
+- 修复的是哪个阶段的产物，就回那个阶段用 `sf_work action=verify` 重验
+- 引擎有 `pending_return` 机制：补产后 verify 通过，可恢复到原域继续推进
+- 不要跨阶段乱跳（跳转受白名单约束）
+
+## 第四步：重试与 escalate
+
+- 最多重试 5 次
+- 5 次仍失败 → escalate，转人工，不要硬撑硬绕
+
+## 禁止
+
+- 假修复（改了但没解决根因，下次还报）
+- 删断言/降覆盖率/加无关 mock 让门禁过（[[工程执行总纲]] 精准修改的硬失败）
+- 隐藏失败 finding
+- 把 advisory 结果当成 required 通过
+- 没有重验就标记完成
+
+## 证据要求
+
+修复后必须给出：改了什么、对应哪条 finding、重验结果（命令 + 输出）。不接受「已修复」三字。

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/347/250/213/346/211/247/350/241/214/346/200/273/347/272/262.md

@@ -0,0 +1,148 @@
+---
+id: ka-guidance-工程执行总纲
+kind: guidance
+title: 工程执行总纲
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 实现
+  - 编码
+  - 开发
+  - 重构
+  - 写代码
+  - 改bug
+  - 修复
+  - 设计
+  - 测试
+  - 验证
+  - 架构
+  - 部署
+  - 需求
+  - 排查
+  - 联调
+  - 改造
+  - 迁移
+extra:
+  name: engineering-execution-charter
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: constraint
+  lifecycle_status: active
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-core-engineering-principles
+---
+
+# 工程执行总纲
+
+> 所有阶段（需求→设计→实现→测试）的元规则。资深工程师干活的四条硬原则。
+> 每条都要证据证明，不接受 AI 自述。
+
+## 四条原则
+
+### 一、思考先行（Think Before Coding）
+
+编码前先明确：问题是什么、目标是什么、输入和约束是什么、哪里不确定。不假设、不隐藏困惑、不把模糊需求直接转成代码。
+
+必须做到：
+- 区分「可推断事实」「假设」「需要用户确认的问题」
+- 只问最小阻塞问题，不把非阻塞细节抛给用户
+- 把不确定项记录为 assumption，不得假装确定
+
+硬失败（命中即停）：
+- 缺必要输入却开始写代码
+- 写入范围不明确却修改文件
+- 外部副作用权限不明确却执行命令
+- 把未知事实写成确定结论
+
+不确定性分级：
+- `blocking`：不问不能继续（写入路径、业务口径、破坏性操作）
+- `material`：可先推进，但必须记录假设和风险
+- `minor`：可合理默认，但在结果里说明
+
+### 二、简单优先（Simplicity First）
+
+用最少代码、最少抽象、最少新增文件解决已确认目标。不为未确认的未来需求提前设计。
+
+必须做到：
+- 最少代码解决问题
+- 引入新抽象/依赖/模块时说明必要性
+- 不为简单 CRUD 强行套复杂模型
+
+硬失败：
+- 为局部问题引入无必要新依赖
+- 为简单修复新增大范围架构层
+- 没有目标支撑却扩展公共 API/配置
+
+「简单」不是少做：
+- 不写测试不叫简单
+- 不接主链路不叫简单
+- 不处理边界/不做错误处理不叫简单
+
+### 三、精准修改（Surgical Changes）
+
+只改必须改的。不顺便重构、不无关格式化、不扩大范围、不污染用户已有改动。
+
+必须做到：
+- 只改必要文件、必要行、必要行为
+- 遇到用户已有修改必须保护，不得回滚
+
+硬失败：
+- 改范围外文件
+- 改与目标无关的行为
+- 未经确认回滚用户已有改动
+- 大范围格式化掩盖真实变更
+- 为让测试过而删断言/降覆盖率/加无关 mock
+
+允许的必要联动：
+- 主链路接入必须改入口文件
+- 类型变化必须改调用方
+- schema 变化必须改 model/query/API
+- contract 状态变化必须改 registry/测试
+
+### 四、目标驱动（Goal-Driven）
+
+先定可验证目标，再执行；执行后必须验证；失败要修并重验，直到通过或明确阻塞。
+
+必须做到：
+- 明确目标和验收标准
+- 禁止「功能正常」「看起来没问题」等模糊成功标准
+- 输出未验证项和人工确认项
+
+硬失败：
+- 没有可验证目标就开始实现
+- 未执行验证却输出「全部通过」
+- 验证失败仍标记完成
+- 隐藏未验证项
+
+## 冲突优先级
+
+原则冲突时按此裁决：
+
+```
+安全/权限/隐私 > 目标驱动 > 思考先行 > 精准修改 > 简单优先
+```
+
+- 不能为了简单牺牲验证
+- 不能为了少改而不接主链路
+- 不能为了快而隐藏阻塞不确定性
+- 必要验证、必要入口接入、必要错误处理 优先于「少写代码」
+
+## 反规避（核心）
+
+四原则必须由证据证明，AI 自述无效。
+
+伪满足示例（都是违规）：
+- 说「已思考清楚」但没有输入/假设/目标证据
+- 说「保持简单」但实际新增大抽象
+- 说「只改必要文件」但 diff 有无关变更
+- 说「验证通过」但没有真实证据
+- 把未执行验证写成「建议验证」后仍标记完成
+- 把用户没确认的业务口径写成事实
+
+自述不能代替：澄清记录 / 假设记录 / 目标定义 / 验证证据。
+required 原则失败不能进入 completed。

package/templates/shared//345/267/245/347/250/213/347/272/252/345/276/213.md

@@ -0,0 +1,71 @@
+---
+id: ka-guidance-工程纪律
+kind: guidance
+title: 工程纪律
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 命名
+  - 注释
+  - 职责
+  - 错误处理
+  - 异常
+  - 日志
+  - 代码风格
+  - 实现
+  - 编码
+  - 写代码
+extra:
+  name: engineering-discipline
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: constraint
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-detail-discipline
+---
+
+# 工程纪律（基本功）
+
+> 合并命名/注释/单一职责/错误处理/日志的基本要求。这是代码质量的底线。
+> 吸收旧的「工程纪律」「细节纪律」「通用机械条款」「代码注释与日志契约」「命名」等碎拆文件。
+
+## 命名
+
+- 表达真实含义，禁止含糊/误导/过度缩写/无意义命名
+- 好命名让人少看注释也能懂
+- 命名和行为必须一致（叫 validate 就真的校验，别混着干别的）
+
+## 注释
+
+- 解释**为什么**这样做、业务约束、历史原因、边界、风险
+- 不复述代码（`// 给 i 加 1` 是废话）
+- 代码注释、日志消息、用户可见错误提示一律简体中文，技术术语/标识符保留原文
+
+## 单一职责
+
+- 一个函数只做一类事
+- 一个函数同时做参数校验+权限判断+数据查询+状态计算+写入+发消息+记日志 → 拆分
+- 单文件/单类职责清晰，避免上帝对象（>20 字段考虑拆分聚合根）
+
+## 错误处理
+
+- 禁止空 catch（至少记日志，不得静默吞异常）
+- 错误信息说清楚：哪步失败、关键参数、可能原因、下一步怎么做
+- 用户可见错误用中文；日志用中文，标识符保留原文
+
+## 日志
+
+- 统一走 logger（`userInfo`/`userWarn`/`userError`/`debug`/`internalWarn`），禁止 `console.log/error/warn` 直接调用
+- 关键路径有可观测日志，便于排查
+- 敏感信息不得进日志（密钥、token、个人隐私）
+
+## 数据写入边界
+
+- 不得向 `.soloforge/tasks/`、`.env`、`.git/`、`node_modules/` 写入（安全底线）
+- 写文件用原子写，避免半写状态

package/templates/shared//345/274/200/345/217/221/350/200/205/345/256/252/346/263/225.md

@@ -1,67 +1,72 @@
 ---
-id: ka-pattern-developer_constitution
-kind: knowledge
+id: ka-guidance-开发者宪法
+kind: guidance
 title: 开发者宪法
-sync_policy: internal
+sync_policy: copy_to_project
 status: active
+triggers:
+  - 架构
+  - 决策
+  - 审查
+  - 审计
+  - 签署
+  - 确认
+  - 变更
+  - 发布
+  - 上线
+  - 危险操作
+  - 删除
+  - 重构
+  - 迁移
+  - 灰度
 extra:
-  name: developer_constitution
+  name: developer-constitution
   scope:
     - '*'
   products:
     - '*'
+  type: constraint
   lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
+  version: 2.0.0
+  last_reviewed: '2026-06-17'
   verification_layer: L2
   stage: _global
-  owner_mechanism: mc-engine-runtime
+  owner_mechanism: mc-decision-sovereignty
 ---
 
-## 决策规则
+# 开发者宪法
 
-- 我是唯一的架构主权者，AI 的建议不代表最终正确
-- 严禁静默交付: 所有 GRAY_BOX 和 BLACK_BOX 级代码审查变更禁止跳过人工确认
-- 人工签署格式: [Human-Audit: APPROVED] 或 [Human-Audit: REJECTED]
-- 未获得签署的 GRAY/BLACK 变更不得标记为"验证通过"
-- 系统随机抽检人类审计真实性: 基于任务摘要生成是/否问题
-- 抽检频率: 每 5 次交付至少抽检 1 次
-- 抽检问题格式: "任务 {task_id} 的变更中，{摘要细节} 是否为 [是/否]？"
-- 人类答错时标记该交付为"待重新审计"
+> 用户是唯一的架构主权者。AI 的建议不代表最终正确。
+> 注意：本宪法原为 knowledge 类（不注入），现改为 guidance 类以保证每次都注入。
 
-## 逻辑奇点警告触发条件
+## 决策主权
 
-- LLM Gateway 返回 circuit_open = true
-- 单任务 Token 超过阈值，remaining_task_budget <= 0
-- 验证 3 次重试仍失败
-- 变异审计发现测试"自己证明自己"且覆盖率联动显示 0% 覆盖
-- 知识漂移 drift_ratio >= 0.5 且根因分析为 code_degradation
+- 用户是唯一的架构主权者，AI 的建议不代表最终正确
+- 重大技术决策须经用户确认，AI 不得自行拍板架构级选型
+- 跳过决策研讨须用户明确声明，AI 不得自行跳过
+- 每条架构决策须有对应记录，禁止口头决策不留痕
 
-## 验收项
+## 禁止静默交付
 
-- [AC-01] GRAY/BLACK 变更展示后等待人类签署
-- [AC-02] 未签署的变更无法推进状态记录
-- [AC-03] 抽检问题基于实际任务摘要生成
-- [AC-04] 逻辑奇点警告以 ⚠ 符号开头并包含具体触发原因
-- [AC-05] core/ 目录下的规则修改需人工签署双重确认
+- 所有 GRAY_BOX 和 BLACK_BOX 级代码审查变更禁止跳过人工确认
+- 人工签署格式：`[Human-Audit: APPROVED]` 或 `[Human-Audit: REJECTED]`
+- 未获签署的 GRAY/BLACK 变更不得标记为「验证通过」
 
-## 何时使用
+## 抽检机制
 
-advisory: 开发者主权的审查建议不 hard block 交付
+- 系统随机抽检人类审计真实性：基于任务摘要生成是/否问题
+- 抽检频率：每 5 次交付至少抽检 1 次
+- 抽检问题格式：`任务 {task_id} 的变更中，{摘要细节} 是否为 [是/否]？`
+- 人类答错时标记该交付为「待重新审计」
 
-## 是否 hard block
+## 敏感操作必须停下确认
 
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
+涉及以下时必须停下等用户确认，不得自作主张：
+- 金额算法 / 状态流转 / 审批规则 / 跨系统同步
+- 破坏性操作（删数据、改 schema、清表、删文件）
+- 外部副作用（发请求、部署、付款、发通知）
+- 权限变更、密钥操作
 
-## 证据要求
+## 与其他规则的关系
 
-- preDeliveryReview 测试通过
-- veto 逻辑测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 治理运行时 + 人工确认
+证据冲突时的处理见 [[证据驱动与反幻觉]]。门禁失败的人工介入见 [[反馈修复闭环]]。

package/templates/shared//346/234/272/345/210/266/350/257/264/346/230/216.md

@@ -0,0 +1,67 @@
+---
+id: ka-knowledge-机制说明
+kind: knowledge
+title: 机制说明
+sync_policy: copy_to_project
+status: active
+triggers:
+  - 机制
+  - 门禁
+  - gate
+  - artifact
+  - guidance
+  - 注入
+  - sf_work
+  - sf_knowledge
+  - 工具
+  - 阶段
+extra:
+  name: mechanism-reference
+  scope:
+    - '*'
+  products:
+    - '*'
+  type: knowledge
+  lifecycle_status: active
+  version: 1.0.0
+  last_reviewed: '2026-06-17'
+  verification_layer: L2
+  stage: _global
+  owner_mechanism: mc-engine-runtime
+---
+
+# SoloForge 机制说明
+
+> 供查阅：SoloForge 怎么把知识/门禁/反馈给到 AI。
+> 运行时核心用法已散在各 guidance（[[工程执行总纲]]/[[反馈修复闭环]] 等）。
+> 注意：knowledge 类**不注入运行时 prompt**，只供 sf_knowledge 搜索查阅。
+
+## 四类资产怎么被消费
+
+| kind | 怎么被消费 | 触发条件 |
+|------|-----------|---------|
+| artifact | AI 按模板骨架产出对应文档 | 用户选 target（产物 kind）时必注入 |
+| guidance | 按 triggers 关键词匹配，全文注入 prompt | intent 含 triggers 或 target_artifact 匹配 |
+| enforced | 按 check.gate 聚合成门禁，确定性 executor 执行 | 该域 verify 时执行 |
+| knowledge | sf_knowledge 索引搜索 | **不注入运行时 prompt**，仅搜索查阅 |
+
+## 四阶段流转
+
+`design`（需求+设计）→ `build`（实现）→ `verify`（测试）→ `operate`（运维）
+
+- 跳转受白名单约束（正向 design→build→verify→operate，合法回退 build→design 等）
+- 跨两级非法（如 operate→design 被拒）
+- 同对域来回打转 >3 次 → escalate
+
+## 门禁与反馈闭环
+
+- 每域一个 `*-gate`，由该域 enforced.md 的 checks 聚合
+- verify 失败 → 生成 findings + recovery_summary → 注入回 AI → 修后重验 → 重试 5 次 escalate
+- 修复流程详见 [[反馈修复闭环]]
+
+## 当前限制（线 B 待办）
+
+用户自定义资产目前：
+- sf_knowledge add 的知识 → 可被索引搜索 ✓
+- 用户放的 enforced/guidance → **暂不进门禁/注入** ✗（下一步线 B 打通扫描范围）
+- domain contract 的产物清单 → **不可由用户扩展** ✗（TS 硬编码）

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. 收敛结论 + 无疑问点举证
+
+- **关键决策**：基于研讨的最终选择（承接进实际产物）
+- **无疑问点举证**（不得空泛，复杂决策必须有依据）：
+  - `[点] 已确认无疑问 — 依据：…`