soloforge 1.4.16 → 1.5.0

package/templates/artifacts/existing-system//346/225/260/346/215/256/350/241/200/347/274/230/345/233/276/346/250/241/347/211/210.md

@@ -0,0 +1,36 @@
+---
+name: 数据血缘图模版
+type: pipeline_artifact
+asset_kind: pipeline_artifact
+routes:
+  - analysis
+primary_triggers:
+  - 数据血缘
+  - 血缘图
+  - 数据流
+scope: [existing-system]
+---
+
+# 全链路数据血缘图
+
+## 1. 概述
+<!-- 数据血缘图的整体说明 -->
+
+## 2. 接口入口
+<!-- 从外部调用的接口入口列表 -->
+
+## 3. 服务调用链
+
+### 3.1 <!-- 接口名称 -->
+<!-- 接口 → 服务A → 服务B → 数据库的完整映射 -->
+
+**调用链：**
+接口入口 → <!-- 服务 --> → <!-- 服务 --> → <!-- 数据库表 -->
+
+## 4. 数据库读写映射
+
+### 4.1 <!-- 表名 -->
+
+| 字段 | 读/写 | 来源接口 | 来源服务 |
+|---|---|---|---|
+| <!-- 字段名 --> | R/W | <!-- 接口 --> | <!-- 服务 --> |

package/templates/artifacts/existing-system//346/226/260/350/200/201/351/200/273/350/276/221/346/257/224/345/257/271/346/227/245/345/277/227/346/250/241/347/211/210.md

@@ -0,0 +1,29 @@
+---
+name: 新老逻辑比对日志模版
+type: pipeline_artifact
+asset_kind: pipeline_artifact
+routes:
+  - analysis
+primary_triggers:
+  - 比对日志
+  - 新老比对
+  - 逻辑对比
+scope: [existing-system]
+---
+
+# 新老逻辑比对日志
+
+## 1. 比对说明
+<!-- 记录关键节点的数据一致性校验结果 -->
+
+## 2. 比对记录
+
+| 时间 | 接口 | 输入 | 老逻辑输出 | 新逻辑输出 | 一致 | 差异说明 |
+|---|---|---|---|---|---|---|
+| <!-- 时间 --> | <!-- 接口 --> | <!-- 输入 --> | <!-- 输出 --> | <!-- 输出 --> | 是/否 | <!-- 差异 --> |
+
+## 3. 一致性统计
+- 总比对次数：<!-- 数量 -->
+- 一致次数：<!-- 数量 -->
+- 不一致次数：<!-- 数量 -->
+- 一致率：<!-- 百分比 -->

package/templates/artifacts/existing-system//347/264/247/346/200/245/345/233/236/346/273/232/346/211/213/345/206/214/346/250/241/347/211/210.md

@@ -0,0 +1,38 @@
+---
+name: 紧急回滚手册模版
+type: pipeline_artifact
+asset_kind: pipeline_artifact
+routes:
+  - analysis
+primary_triggers:
+  - 回滚手册
+  - 紧急回滚
+  - rollback
+scope: [existing-system]
+---
+
+# 紧急回滚手册
+
+## 1. 回滚触发条件
+- 小流量试运行监控指标超过阈值
+- 核心功能不可用
+- 数据一致性问题
+
+## 2. 回滚步骤
+
+### 2.1 触发一键开关
+<!-- 读取一键开关配置，切换到回退目标 -->
+
+### 2.2 数据回滚
+<!-- 如果有数据变更，如何回滚数据 -->
+
+### 2.3 服务回滚
+<!-- 服务版本回退步骤 -->
+
+## 3. 回滚验证
+- [ ] 老逻辑功能正常
+- [ ] 数据一致性校验通过
+- [ ] 监控指标恢复正常
+
+## 4. 回滚后处理
+<!-- 回滚后的数据清理、日志记录、团队通知 -->

package/templates/artifacts/existing-system//351/232/224/347/246/273/351/200/202/351/205/215/345/231/250/346/226/271/346/241/210/346/250/241/347/211/210.md

@@ -0,0 +1,34 @@
+---
+name: 隔离适配器方案模版
+type: pipeline_artifact
+asset_kind: pipeline_artifact
+routes:
+  - analysis
+primary_triggers:
+  - 隔离适配器
+  - 适配器
+  - 绞杀者模式
+scope: [existing-system]
+---
+
+# 隔离适配器方案
+
+## 1. 隔离策略概述
+<!-- 新老接口共存的隔离策略说明 -->
+
+## 2. 接口适配层
+
+### 2.1 新老接口共存适配
+<!-- 新接口如何与老接口共存，路由规则 -->
+
+### 2.2 数据同步中间层
+<!-- 新老数据库表之间的数据同步方案 -->
+
+### 2.3 Feature Toggle 隔离
+<!-- 功能维度的开关隔离方案 -->
+
+## 3. 隔离架构图
+<!-- 新老系统的隔离边界示意 -->
+
+## 4. 回退策略
+<!-- 如果隔离层出现问题，如何快速切回老逻辑 -->

package/templates/artifacts/shared/ADR/346/250/241/347/211/210.md

@@ -0,0 +1,41 @@
+---
+name: ADR模版
+type: artifact_template
+asset_kind: acceptance_template
+routes:
+  - artifact_generation
+primary_triggers:
+  - ADR
+  - 架构决策
+  - 决策记录
+---
+
+# ADR（架构决策记录）
+
+## 决策标题
+<!-- 简短描述本次架构决策 -->
+
+## 背景
+<!-- 为什么需要做这个决策？当前的架构约束、业务需求、技术债务是什么？ -->
+
+## 选项
+
+### 选项 A: <!-- 选项名称 -->
+- **描述：** <!-- 简述方案 -->
+- **优点：**
+  -
+- **缺点：**
+  -
+
+### 选项 B: <!-- 选项名称 -->
+- **描述：** <!-- 简述方案 -->
+- **优点：**
+  -
+- **缺点：**
+  -
+
+## 结论
+<!-- 最终选择哪个选项 -->
+
+## 原因
+<!-- 为什么选择这个选项？权衡了哪些因素？ -->

package/templates/{knowledge/acceptance_templates → artifacts/shared}/API/346/216/245/345/217/243/350/247/204/346/240/274/346/226/207/346/241/243/346/250/241/347/211/210.md

@@ -13,6 +13,12 @@ routes:
   - artifact_generation
 primary_triggers:
   - API接口规格文档
+  - 接口规格
+  - API文档
+  - 接口设计
+  - API设计
+  - 接口文档
+  - 接口定义
 priority: P1
 specificity: 4
 version: 1.0.0
@@ -72,3 +78,22 @@ OpenAPI 权威路径: `docs/api/openapi.yaml`
 
 | 场景 | 输入 | 预期响应 | 数据/状态变化 | 验证证据 |
 |------|------|----------|---------------|----------|
+
+### 枚举值定义
+
+| 枚举名 | 值 | 含义 |
+|--------|------|------|
+
+### 页面交互映射
+
+| 页面操作 | 触发接口 | 加载状态 | 成功行为 | 失败行为 |
+|---------|---------|---------|---------|---------|
+
+### 接口规范检查
+
+- [ ] 是否定义了接口版本号和演进策略（如 /api/v1/）
+- [ ] 是否有幂等设计（写接口需标注幂等键或唯一约束）
+- [ ] 错误码体系是否完整（业务码 + HTTP 状态码双映射）
+- [ ] 是否有分页参数上限限制（防止恶意大翻页）
+- [ ] 是否有接口限流策略（QPS/并发上限）
+- [ ] 批量操作是否有数量上限（≤ 500 条）

package/templates/artifacts/shared//344/273/243/347/240/201/345/256/241/346/237/245/346/212/245/345/221/212/346/250/241/347/211/210.md

@@ -0,0 +1,33 @@
+---
+name: 代码审查报告模版
+type: artifact_template
+asset_kind: acceptance_template
+routes:
+  - code_change
+primary_triggers:
+  - 代码审查
+  - 审查报告
+---
+
+# 代码审查报告
+
+## 1. 审查信息
+- 审查范围：<!-- 切片级/整体 -->
+- 切片 ID：<!-- 切片ID，切片级审查时填写 -->
+- 审查时间：<!-- 日期 -->
+
+## 2. 审查结果
+- **结论：** 通过/不通过
+- **审查清单版本：** <!-- 模板版本 -->
+
+## 3. 发现项
+
+| # | 维度 | 严重程度 | 文件 | 描述 | 建议 |
+|---|---|---|---|---|---|
+| 1 | <!-- 质量/安全/性能/架构 --> | info/warning/critical | <!-- 文件:行号 --> | <!-- 描述 --> | <!-- 建议 --> |
+
+## 4. 审查清单校验
+
+| 检查项 | 通过 |
+|---|---|
+| <!-- 检查项 --> | 是/否 |

package/templates/artifacts/shared//345/210/207/347/211/207/350/256/241/345/210/222/346/250/241/347/211/210.md

@@ -0,0 +1,45 @@
+---
+name: 切片计划模版
+type: artifact_template
+asset_kind: acceptance_template
+routes:
+  - artifact_generation
+  - code_change
+primary_triggers:
+  - 切片计划
+  - 开发切片
+  - 排查缓冲
+  - 老系统切片
+---
+
+# 开发任务切片计划
+
+## 1. 项目信息
+- 项目名称：<!-- 名称 -->
+- 系统类型：新系统/老系统
+- 创建时间：<!-- 日期 -->
+
+## 2. 切片列表
+
+### 切片 1: <!-- 切片名称 -->
+- **优先级：** 1
+- **描述：** <!-- 功能描述 -->
+- **涉及文件：**
+  - <!-- 文件路径 -->
+- **依赖：** 无 / 依赖切片 <!-- ID -->
+- **排查缓冲：** <!-- 预留的校验/回退时间窗口（老系统切片适用） -->
+- **验收标准：**
+  - [ ] <!-- 验收条件 -->
+
+<!-- 按优先级列出所有切片 -->
+
+## 3. 执行顺序与缓冲安排
+<!-- 切片的推荐执行顺序、并行分组、每个切片的排查缓冲时间（老系统适用） -->
+
+## 4. 风险标注
+<!-- 是否有高风险切片、是否需要额外排查缓冲 -->
+
+## 5. 历史数据清洗脚本（老系统适用）
+<!-- 联调/试运行前统一执行的数据准备步骤 -->
+- 脚本路径：<!-- 路径 -->
+- 执行时机：联调前

package/templates/{knowledge/acceptance_templates → artifacts/shared}//345/216/237/345/236/213/350/257/264/346/230/216/346/250/241/347/211/210.md

@@ -13,6 +13,8 @@ routes:
   - '*'
 primary_triggers:
   - 原型
+  - 原型说明
+  - prototype
   - 设计稿
   - UI规范
   - 前端实现

package/templates/{knowledge/acceptance_templates → artifacts/shared}//346/236/266/346/236/204/350/256/276/350/256/241/346/250/241/347/211/210.md

@@ -14,6 +14,7 @@ routes:
   - '*'
 primary_triggers:
   - 架构设计
+  - 架构文档
   - 模块设计
   - 系统设计
   - 技术方案
@@ -59,6 +60,12 @@ status: active
 
 ## 6. 前端、后端、安全与基础设施架构
 
+### 6.1 系统上下文
+<!-- 系统与外部系统/用户的关系，可使用上下文图 -->
+
+### 6.2 部署方案
+<!-- 部署架构、环境规划、CI/CD 策略 -->
+
 ## 7. 技术选型与依据
 | 技术决策 | 候选方案 | 最终选择 | 选择理由 | 放弃方案原因 |
 |---------|---------|---------|---------|------------|

package/templates/gates/existing-system/gate-/347/216/260/346/234/211/347/263/273/347/273/237/345/210/206/346/236/220.yaml

@@ -0,0 +1,13 @@
+# 现有系统分析门禁配置
+
+stage: "现有系统分析"
+description: "现有系统分析完成后的崩溃风险评估"
+
+checks:
+  - name: "数据血缘完整性"
+    required_artifact: "全链路数据血缘图"
+    rule: "受影响模块的所有接口入口必须覆盖"
+
+  - name: "雷区清单完整性"
+    required_artifact: "历史遗留雷区清单"
+    rule: "至少覆盖数据库、代码、架构三个维度"

package/templates/gates/existing-system/gate-/347/274/226/347/240/201/344/270/216/345/215/225/345/205/203/346/265/213/350/257/225.yaml

@@ -0,0 +1,18 @@
+# 编码门禁配置（老系统）
+# 每个切片完成后即时校验
+
+stage: "编码与单元测试"
+description: "每切片即时覆盖率校验 + 新老逻辑比对"
+
+checks:
+  - name: "单元测试覆盖率"
+    required_artifact: "覆盖率报告"
+    rule: "增量行覆盖率≥80%"
+
+  - name: "新老逻辑比对"
+    required_artifact: "新老逻辑比对日志"
+    rule: "关键节点数据一致性校验全部通过"
+
+  - name: "切片隔离"
+    required_artifact: "已通过切片列表"
+    rule: "当前切片不得修改已通过切片涉及的文件"

package/templates/gates/existing-system/gate-/350/257/225/350/277/220/350/241/214.yaml

@@ -0,0 +1,21 @@
+# 试运行门禁配置
+
+stage: "联调验证"
+description: "小流量试运行熔断门禁"
+
+checks:
+  - name: "错误率"
+    required_artifact: "监控指标"
+    rule: "接口错误率≤5%"
+
+  - name: "延迟"
+    required_artifact: "监控指标"
+    rule: "P99延迟不超过老逻辑3倍"
+
+  - name: "业务成功率"
+    required_artifact: "监控指标"
+    rule: "核心业务流程成功率≥95%"
+
+  - name: "数据一致性"
+    required_artifact: "监控指标"
+    rule: "数据一致性校验0失败"

package/templates/gates/shared/gate-/344/273/273/345/212/241/350/247/204/345/210/222.yaml

@@ -0,0 +1,18 @@
+# 任务规划门禁配置
+# 切片计划必须与设计产物通过一致性校验
+
+stage: "任务规划"
+description: "切片计划与设计产物一致性校验"
+
+checks:
+  - name: "切片与接口一致性"
+    required_artifact: "接口规格文档"
+    rule: "每个切片必须关联到接口规格中定义的接口"
+
+  - name: "切片与数据库一致性"
+    required_artifact: "数据库设计文档"
+    rule: "切片涉及的表操作必须在数据库设计中有定义"
+
+  - name: "切片完整性"
+    required_artifact: "切片计划"
+    rule: "所有设计文档中定义的功能点必须被切片覆盖"

package/templates/gates/shared/gate-/347/274/226/347/240/201/344/270/216/345/215/225/345/205/203/346/265/213/350/257/225.yaml

@@ -0,0 +1,14 @@
+# 编码门禁配置
+# 每个切片完成后即时校验
+
+stage: "编码与单元测试"
+description: "每切片即时覆盖率校验"
+
+checks:
+  - name: "单元测试覆盖率"
+    required_artifact: "覆盖率报告"
+    rule: "新系统行覆盖率≥70%，老系统增量覆盖率≥80%"
+
+  - name: "切片隔离"
+    required_artifact: "已通过切片列表"
+    rule: "当前切片不得修改已通过切片涉及的文件"

package/templates/{knowledge/rules//346/225/217/346/204/237/344/277/241/346/201/257/346/227/245/345/277/227 → internal/rules//346/225/217/346/204/237/344/277/241/346/201/257/345/244/204/347/220/206}/350/247/204/345/210/231.md

@@ -1,46 +1,69 @@
 ---
-name: 敏感信息日志规则
+name: 敏感信息处理规则
 scope:
   - '*'
 products:
   - '*'
-id: ka-hard-rule-敏感信息日志规则
+id: ka-hard-rule-敏感信息处理规则
 asset_kind: hard_rule
 lifecycle_status: active
 authority: canonical
-owner_mechanism_id: mc-code-maintainability-observability-contract
+owner_mechanism_id: mc-privacy-boundary
 routes:
-  - code_change
-  - artifact_generation
+  - 敏感信息处理规则
 primary_triggers:
+  - 敏感信息处理规则
+secondary_triggers:
+  - 敏感信息
+  - 脱敏
+  - 隐私
   - 日志
   - 输出
   - console
   - print
   - log
-secondary_triggers:
-  - 敏感信息
-  - 脱敏
-  - 隐私
-negative_triggers:
-  - 文案
-  - 样式
+negative_triggers: []
 priority: P0
 specificity: 5
 consumes:
-  - mc-code-maintainability-observability-contract
+  - mc-intent-router
 hard_blocks:
-  - sensitive_log_leak
-  - plaintext_credential_in_output
+  - secret泄露
+  - PII未脱敏
 fallback: manual_required
 required_evidence:
-  - sensitive_log_scan_result
-  - review_findings
+  - redaction_records
+  - privacy_findings
 version: 1.0.0
-last_reviewed: '2026-05-26'
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 敏感信息处理规则
+status: active
 ---
 
-## 敏感信息绝对禁止进入日志
+# 敏感信息处理规则
+
+## 核心原则
+
+敏感信息 (密钥、token、PII) 不可泄露到外部材料、prompt 或日志中。
+
+## 规则
+
+1. .env 文件中的值不可作为知识注入 prompt
+2. token/secret 必须在写入前被 detectSecrets 扫描
+3. severity=blocked 的发现必须阻断写入
+4. 外部材料摄取必须经过脱敏处理
+5. DataAccessGrant 必须明确声明数据访问权限
+
+## 验收标准
+
+- [ ] detectSecrets 扫描所有写入内容
+- [ ] severity=blocked 的发现阻断写入流程
+- [ ] RedactionRecord 记录所有脱敏操作
+- [ ] DataAccessGrant 覆盖所有数据访问
+
+## 日志脱敏规则
 
 以下字段必须脱敏或禁止输出到任何日志通道：
 

package/templates/{knowledge → internal}/rules//346/274/224/350/277/233/345/233/236/345/275/222/351/227/250/346/216/247/350/247/204/345/210/231.md

@@ -21,6 +21,8 @@ primary_triggers:
 secondary_triggers:
   - 演进回归
   - evolution regression
+  - regression
+  - duplicate
   - 新增问题
   - 新增 Batch
   - 模板补齐

package/templates/{knowledge/procedures → procedures}//346/236/266/346/236/204/350/256/276/350/256/241/345/267/245/344/275/234/346/265/201.md

@@ -1,7 +1,7 @@
 ---
 name: architecture-design-workflow
 type: procedure
-when: '架构设计, 架构, architecture, 设计系统, 多端设计, 系统设计, 技术方案设计'
+when: '架构设计, 架构, architecture, 设计系统, 多端设计, 系统设计, 技术方案设计, 模块划分, 技术方案, 方案设计, 架构评审'
 scope:
   - backend
   - frontend

package/templates/{knowledge/procedures → procedures}//347/264/247/346/200/245/344/277/256/345/244/215/346/265/201/346/260/264/347/272/277.md

@@ -1,7 +1,7 @@
 ---
 name: hotfix-pipeline
 type: pipeline_procedure
-when: '紧急修复管线, 生产事故处理管线, P0管线, 热修复管线, hotfix pipeline, 线上故障管线'
+when: '紧急修复管线, 紧急修复, 生产事故处理管线, P0管线, 热修复管线, hotfix pipeline, hotfix, 线上故障管线, 线上问题修复, 线上报错, 紧急上线, P0, P1, 事故修复, 止血'
 scope:
   - backend
   - frontend

package/templates/{knowledge/procedures → procedures}//350/260/203/350/257/225/346/216/222/346/237/245/346/265/201/347/250/213.md

@@ -1,7 +1,7 @@
 ---
 name: debug-investigation
 type: procedure
-when: '调试, 排障, 排查问题, bug定位, 问题排查, 线上排查, 异常排查, 错误定位, 日志排查'
+when: '调试, 排障, 排查问题, bug定位, 问题排查, 线上排查, 异常排查, 错误定位, 日志排查, 缺陷修复, Bug修复, 问题修复, 异常修复, 错误修复, bug fix, 缺陷处理'
 scope:
   - backend
   - frontend

package/templates/{knowledge/procedures → procedures}//351/252/214/346/224/266/346/265/213/350/257/225/350/247/204/345/210/222.md

@@ -1,7 +1,7 @@
 ---
 name: acceptance-test-planning
 type: procedure
-when: '验收测试, 验收规划, 验收标准, acceptance test, 验收计划, 测试用例设计'
+when: '验收测试, 验收规划, 验收标准, acceptance test, 验收计划, 测试用例设计, 验证计划, 测试计划, 验证策略, verification plan, 测试规划, 集成测试计划'
 scope:
   - backend
   - frontend

package/templates/rules/existing-system//345/205/274/345/256/271/346/200/247/346/243/200/346/237/245/350/247/204/345/210/231.md

@@ -0,0 +1,33 @@
+---
+name: 兼容性检查规则
+type: review_rule
+asset_kind: pipeline_rule
+routes:
+  - code_change
+  - analysis
+primary_triggers:
+  - 兼容性
+  - 向后兼容
+  - 接口兼容
+scope: [existing-system]
+---
+
+# 向后兼容性检查规则
+
+## 接口兼容性
+- 老接口参数不得被删除
+- 老接口参数类型不得变更（窄化转换）
+- 老接口返回结构不得删除已有字段
+- 新增字段必须有默认值
+- 废弃接口必须标记 @Deprecated 并提供替代方案
+
+## 数据库兼容性
+- 老表不得删除列
+- 老列类型变更必须兼容（拓宽可以，窄化不可以）
+- 新增列必须有默认值或允许 NULL
+- 数据迁移必须可回滚
+
+## 行为兼容性
+- 老逻辑的输出不能被新逻辑改变
+- 新老逻辑可以共存时，通过开关切换
+- 开关关闭时行为必须与老版本一致

package/templates/rules/existing-system//350/200/246/345/220/210/346/243/200/346/265/213/350/247/204/345/210/231.md

@@ -0,0 +1,35 @@
+---
+name: 耦合检测规则
+type: review_rule
+asset_kind: pipeline_rule
+routes:
+  - code_change
+  - analysis
+primary_triggers:
+  - 耦合
+  - 耦合检测
+  - 依赖
+scope: [existing-system]
+---
+
+# 老代码耦合检测规则
+
+## 检测时机
+- 编码阶段尝试写单元测试时
+- 编码阶段尝试修改老代码时
+
+## 触发回退到架构设计的条件
+
+### 无法单独测试
+- 老代码使用静态方法/单例导致无法 mock
+- 老代码直接 new 依赖对象，未使用依赖注入
+- 老代码与框架深度绑定（如直接依赖 Request/Response 对象）
+
+### 无法单独修改
+- 修改一个函数需要同步修改 5 个以上关联文件
+- 老代码存在循环依赖无法单独抽取
+- 老代码的数据结构被多处硬编码引用
+
+### 检测规则
+- 尝试写单测 3 次仍无法 mock 隔离 → 触发回退
+- 修改影响范围超过预期的 3 倍 → 触发回退

package/templates/rules/existing-system//350/257/225/350/277/220/350/241/214/347/206/224/346/226/255/350/247/204/345/210/231.md

@@ -0,0 +1,39 @@
+---
+name: 试运行熔断规则
+type: review_rule
+asset_kind: pipeline_rule
+routes:
+  - code_change
+primary_triggers:
+  - 试运行
+  - 熔断
+  - canary
+scope: [existing-system]
+---
+
+# 试运行熔断判定规则
+
+## 熔断触发条件（满足任一即触发）
+
+### 错误率
+- 接口错误率超过 5%（5 分钟窗口）
+- 错误率相比老逻辑增加超过 2 倍
+
+### 延迟
+- P99 延迟超过老逻辑的 3 倍
+- P99 延迟超过 5 秒
+
+### 业务指标
+- 核心业务流程成功率低于 95%
+- 数据一致性校验失败次数 > 0
+
+### 系统
+- 内存使用超过 90%
+- CPU 使用超过 80%（持续 5 分钟）
+- 数据库连接池耗尽
+
+## 熔断动作
+1. 读取一键开关配置
+2. 切换到回退目标（老逻辑）
+3. 记录熔断时间和触发指标
+4. 回退到编码阶段修复