soloforge 1.1.46 → 1.1.48

package/templates/build/React/346/216/245/345/217/243/351/233/206/346/210/220.md

@@ -1,42 +0,0 @@
----
-id: ka-pattern-react-api-integration
-kind: knowledge
-title: React接口集成
-sync_policy: copy_to_project
-status: active
-extra:
-  name: react-api-integration
-  scope:
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain: build
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-frontend-pattern
----
-
-## 决策规则
-- 必须通过 service 层封装 API 调用，禁止组件内直接写 axios.get/post
-- 必须基于统一 axios 实例，统一处理 Token 注入和错误拦截
-- 请求必须管理 loading 状态，禁止无反馈的静默请求
-- 401 响应必须自动跳转登录页
-- API URL 禁止硬编码，必须通过环境变量或统一 baseURL
-- API 调用必须封装到独立的 service 层，禁止在组件中直接调用 axios/fetch
-- API 层必须统一处理：Token 注入、错误拦截、响应解包、重试逻辑
-- 请求取消必须使用 AbortController，组件卸载时取消未完成请求
-- API 类型必须定义 Request/Response interface，禁止 any
-- 并发请求必须使用 Promise.all / Promise.allSettled 批量处理
-
-## 验收项
-- [AC-01] API 调用通过 service 层，无组件内直接调用
-- [AC-02] 请求有 loading 状态管理
-- [AC-03] 401 响应自动跳转登录页
-- [AC-04] 接口错误有用户提示
-- [AC-05] API 封装到 service 层
-- [AC-06] 组件卸载取消请求
-- [AC-07] API 有 TypeScript 类型定义

package/templates/build/Schema/345/217/230/346/233/264/346/265/201/346/260/264/347/272/277.md

@@ -1,52 +0,0 @@
----
-id: ka-procedure-Schema变更流水线
-kind: guidance
-title: Schema变更流水线
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 数据库结构变更
-  - 加字段
-  - 改字段
-  - 新建表
-  - 加索引
-  - DDL变更
-  - schema变更
-  - 数据库迁移
-extra:
-  name: schema-change-pipeline
-  type: procedure
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
----
-
-# 数据库变更管线
-
-## 第1步：变更设计
-评估变更类型（加列/改列/删列/加索引/数据迁移/新建表）。确认向前兼容性（新列默认值或允许 NULL）。制定四层兼容策略（数据库→接口契约→前端展示→导出逻辑）。
-模版：数据库变更方案.md
-产出保存到：docs/design/01-数据库设计文档.md
-工具：（本步骤为任务入口，由 sf_task 统一路由）
-
-## 第2步：迁移脚本
-编写 migration 脚本（正向 + 回滚），确保幂等。大表加列使用分批更新策略。大表加索引使用 ONLINE DDL。禁止 migration 中写业务逻辑。
-产出保存到：docs/architecture/02-migration.sql
-工具：sf_work action=act
-
-## 第3步：代码适配
-更新 Entity/DTO 映射。更新接口契约（请求/响应字段）。更新前端展示和表单。更新导出逻辑（如有）。更新相关测试数据和测试用例。
-工具：sf_work action=act
-
-## 第4步：验证验收
-开发环境执行 migration 验证表结构。运行全量测试。代码审查重点关注：四层兼容完整性、回滚脚本有效性、大表性能影响评估。
-工具：sf_work action=verify, sf_gate

package/templates/build/TS/350/264/250/351/207/217/345/256/241/346/237/245.md

@@ -1,78 +0,0 @@
----
-id: ka-review-rule-TS质量审查规则
-kind: guidance
-title: TS质量审查
-triggers:
-  - TypeScript
-  - 类型
-  - any
-sync_policy: copy_to_project
-status: active
-extra:
-  name: ts-quality-rules
-  type: constraint
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.0.0
-  last_reviewed: '2026-06-14'
-  domain: build
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-generic-review
----
-
-# TypeScript 质量审查规则
-
-聚焦 TypeScript/JavaScript 强类型场景的经典坏味道，按 `languages: [ts]` 标注 —— 仅 TS 项目（含 JS，LANG_TAG_MAP 将 javascript 也映射到 ts 标签）执行，Java/Python/Go 项目按技术栈自动跳过（passed=true 不阻断）。
-
-severity 分级：
-- **error**：几乎一定是债（`@ts-ignore` 压制类型检查、`var` 废弃声明）→ 阻断 promote。
-- **warning**：可能是合理取舍或正则引擎对注释/字面量的固有误报 → hold 待人工确认，不阻断。
-
-## TS-Q01: as any 类型断言逃逸
-languages: [ts]
-pattern: /as\s+any\b/
-severity: warning
-check_type: deterministic
-scope: [backend, frontend]
-description: 禁止用 `as any` 绕过类型检查，应补全精确类型或收窄 unknown。惰性加载占位、catch 错误对象等少数场景可标注取舍后保留，故为 warning 级（regex 无法区分合法/滥用，需人工确认）
-evidence_required:
-  - "扫描结果：含 as any 的文件路径+行号"
-  - "取舍说明：保留处为何无法避免 as any"
-
-## TS-Q02: @ts-ignore/@ts-nocheck 压制类型检查
-languages: [ts]
-pattern: /@ts-(?:ignore|nocheck|expect-error)\b/
-severity: error
-check_type: deterministic
-scope: [backend, frontend]
-description: 禁止用 @ts-ignore/@ts-nocheck 压制类型错误，必须修复根因类型问题。@ts-expect-error 须附带错误码且在错误消失后会被编译器提示清理
-evidence_required:
-  - "扫描结果：含类型压制的文件路径+行号"
-  - "修复确认：根因类型修复证据"
-
-## TS-Q03: 宽松相等 ==/!=
-languages: [ts]
-pattern: /[^=!<>]==[^=]|[^=!]!=[^=]/
-severity: warning
-check_type: deterministic
-scope: [backend, frontend]
-description: 禁止用 ==/!= 宽松相等（隐式类型转换坑），必须用 ===/!==。warning 级：正则按行匹配无法区分代码与注释/正则字面量，注释里的 == 会误报，需人工确认
-evidence_required:
-  - "扫描结果：含宽松相等的文件路径+行号"
-  - "修复确认：改用 ===/!== 证据"
-
-## TS-Q04: var 声明
-languages: [ts]
-pattern: /\bvar\s+[A-Za-z_$]/
-severity: error
-check_type: deterministic
-scope: [backend, frontend]
-description: 禁止 var 声明（函数作用域 + 变量提升坑），必须用 let/const。pattern 限定 var 后跟合法标识符开头，避免命中注释里的中文「var 模式」等
-evidence_required:
-  - "扫描结果：含 var 声明的文件路径+行号"
-  - "修复确认：改用 let/const 证据"

package/templates/build//344/270/212/346/270/270/344/272/244/345/217/211/351/252/214/350/257/201.md

@@ -1,68 +0,0 @@
----
-id: 上游交叉验证
-kind: guidance
-title: 上游交叉验证
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 交叉验证
-  - 一致性校验
-  - cross validation
-  - 上游验证
-  - 设计产物一致性
-extra:
-  name: upstream-cross-validation
-  type: constraint
-  domain: build
-  lifecycle_status: active
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-command-router
----
-
-# 上游交叉验证规则
-
-## UCV-01: 实施前变更范围对照设计
-  id: UCV-01
-  name: 实施前变更范围对照设计
-  severity: error
-  check_type: deterministic
-  check_hint: 任务规划阶段，每个切片的变更范围必须对照详细设计文档逐项确认
-  description: 任务规划阶段，每个切片的变更范围（涉及文件列表）必须对照详细设计文档逐项确认。涉及的文件列表必须与设计文档描述的模块一致。
-
-## UCV-02: 未覆盖场景回退补充
-  id: UCV-02
-  name: 未覆盖场景回退补充
-  severity: error
-  check_type: semantic
-  check_hint: 发现设计文档未覆盖的场景必须回退补充设计，不得跳过
-  description: 扫描过程中发现设计文档未覆盖的业务场景，必须回退到详细设计阶段补充，不得跳过设计直接编码。
-
-## UCV-03: 实施中接口签名匹配
-  id: UCV-03
-  name: 实施中接口签名匹配
-  severity: error
-  check_type: deterministic
-  check_hint: 编码阶段实现的接口签名必须与设计规格严格匹配
-  description: 编码阶段，每个切片完成后对照设计文档确认实现与设计一致。接口签名（HTTP 方法、路径、参数类型、响应结构）、数据结构、错误处理必须与设计规格严格匹配。
-
-## UCV-04: 实施中设计偏离须更新
-  id: UCV-04
-  name: 实施中设计偏离须更新
-  severity: warning
-  check_type: semantic
-  check_hint: 编码中发现需要偏离设计时，必须先更新设计文档并获取确认
-  description: 编码过程中发现需要偏离设计（接口签名变更、数据结构调整、错误处理方式变更等），必须先更新设计文档并获取用户确认后才能继续。
-
-## UCV-05: 实施后设计要求全覆盖
-  id: UCV-05
-  name: 实施后设计要求全覆盖
-  severity: error
-  check_type: deterministic
-  check_hint: 所有设计要求必须有对应的实现证据
-  description: 所有切片完成后，最终审查必须以设计文档为基准。每个设计要求必须有对应的实现证据。未覆盖的设计要求必须标注为待实现或已变更。

package/templates/build//344/270/273/351/223/276/350/267/257/346/216/245/345/205/245/351/252/214/350/257/201.md

@@ -1,56 +0,0 @@
----
-id: ka-procedure-主链路接入验证流程
-kind: guidance
-title: 主链路接入验证
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 主链路
-  - 集成验证
-  - 链路接入
-  - 端到端集成
-extra:
-  name: mainline-integration-verification
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  type: procedure
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-main-path-integration
----
-
-# 主链路接入验证流程
-
-## 步骤
-
-1. 识别新增模块 (changed_files 中 src/ 下的文件)
-2. 扫描谁导入了该模块 (scanModuleImporters)
-3. 从入口点追踪可达性 (traceModuleReachability)
-4. 收集可观测证据 (collectModuleObservability)
-   evidence_required:
-     - "模块导入者列表（scanModuleImporters 输出）"
-     - "入口点可达性追踪日志（traceModuleReachability 输出）"
-     - "集成测试文件路径（findIntegrationTests 输出）"
-5. 查找集成测试 (findIntegrationTests)
-6. 判断接入状态 (integrated / implemented_not_integrated / ...)
-7. 运行 orphanGate 和 validateMainPathIntegration
-
-## 接入标准
-
-- **integrated**: 有生产调用 + 有入口链路
-- **implemented_not_integrated**: 无生产调用或无入口链路
-- **experimental_isolated**: 明确标注为实验性
-
-## 注意事项
-
-- barrel export 不算生产调用
-- registry 声明不算接入
-- type reference 不算接入

package/templates/build//344/273/243/347/240/201/351/227/250/347/246/201.md

@@ -1,58 +0,0 @@
----
-id: ka-procedure-代码门禁流程
-kind: guidance
-title: 代码门禁
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 代码门禁
-  - 代码审查门禁
-  - gate review
-  - 发布门禁
-  - 上线检查
-  - 代码评审
-  - 发布审查
-extra:
-  name: code-gate
-  type: procedure
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-guard-evaluation
----
-
-## 适用场景
-代码变更的最终门禁审查，确保每行变更可追溯、有真实运行证据、符合项目约束和架构红线。
-
-## 步骤
-1. 确认存在真实 diff 和真实测试证据，无证据不启动审查
-2. 先运行预检查和快照链验证，识别缺口后再下结论
-3. 逐行审查 diff：每行必须追溯到任务卡、交付蓝图、实现映射或阻塞性缺陷
-4. 无关变更、顺手重构、主动抽象、无任务依据的删除默认为阻断
-5. 验证集成证据：部署结果、服务就绪、API 动态验证、DDL 迁移、运行时证据
-6. 拒绝以下类型作为通过证据：dry-run、skipped、not_run、静态分析、AI 摘要、生成截图
-7. 产出三级结论之一：通过 / 有条件通过（附改进清单）/ 不通过（附返回阶段路由）
-8. 审查方与实现方分歧时记录 DISPUTE，按角色层级仲裁
-
-## 检查点
-- [ ] 每个 diff 行追溯到任务卡或缺陷
-- [ ] 无 dry-run/静态分析/AI 摘要冒充运行时证据
-- [ ] 部署、就绪、API、DDL、运行时、流程覆盖均有证据
-- [ ] 每个发现项有唯一返回路由和修复权限
-- [ ] 无关变更和顺手重构已被阻断
-
-## 注意事项
-- 禁止接受 dry-run/静态分析/AI 摘要/生成截图作为运行时证据
-- 禁止在缺少运行时证据时通过
-- 禁止先下结论再找理由（先查缺口再判断）
-- draft 状态的桥接/快照/边车文件为阻断项

package/templates/build//345/205/250/346/240/210/346/265/201/347/250/213/344/277/256/345/244/215.md

@@ -1,48 +0,0 @@
----
-id: ka-pattern-fullstack-flowheal
-kind: knowledge
-title: 全栈流程修复
-sync_policy: copy_to_project
-status: active
-extra:
-  name: fullstack-flowheal
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-general-pattern
----
-
-## 决策规则
-- 必须严格遵循 5 步顺序：定义用例 → 收集证据 → 诊断 → 补丁计划 → 验证，禁止跳步
-- 证据优先、流程优先、浏览器证据优先、最小补丁、分层验证
-- 禁止将不稳定测试视为业务失败，先稳定复现再判断
-- 禁止删除断言、增加 sleep、降低覆盖率、增加 mock 来制造通过
-- 禁止用 SQL 直接写业务测试数据
-- 禁止自动修改事务/权限/金额/库存/安全策略
-- 一次只修一个问题，禁止跨层大重构同时进行
-- 高风险/低置信度/跨多服务的复杂变更上报人工决策
-- 端到端测试必须从浏览器页面出发，禁止绕过前端
-- 前后端联调必须基于接口文档（OpenAPI），禁止口头约定字段
-- 前后端字段命名不一致时以后端为准，前端通过映射层适配
-- 接口变更必须同步更新文档和前端调用，禁止只改一侧
-- 联调问题必须在缺陷系统记录根因（文档不完整/需求不明确/理解偏差），持续改进
-
-## 验收项
-- [AC-01] 遵循 5 步顺序（用例→证据→诊断→补丁→验证）
-- [AC-02] 证据包含 UI 追踪/API 调用/后端 traceId/数据状态
-- [AC-03] 修复后重新构建再验证
-- [AC-04] 最终状态显式声明（ready_to_commit/escalated/reverted）
-- [AC-05] 联调基于接口文档
-- [AC-06] 接口变更同步更新文档和前端
-- [AC-07] 联调问题记录根因

package/templates/build//345/210/207/347/211/207/346/211/247/350/241/214/347/272/252/345/276/213.md

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