soloforge 1.2.20 → 1.3.1

package/templates/knowledge/procedures//347/216/260/346/234/211/347/263/273/347/273/237/345/267/256/350/267/235/345/210/206/346/236/220/345/267/245/344/275/234/346/265/201.md

@@ -0,0 +1,97 @@
+---
+name: existing-system-gap-analysis-workflow
+type: procedure
+when: '现有项目, 新需求, 已有系统, 现有系统, 差距分析, gap analysis, existing system, 现有源码'
+scope:
+  - backend
+  - frontend
+  - infrastructure
+products:
+  - '*'
+owner_mechanism_id: mc-existing-system-analysis
+consumed_contracts:
+  - existing_system_analysis_contract_entry
+  - architecture_design_contract_entry
+  - technology_decision_contract
+  - brainstorm_contract
+  - detail_discipline_contract
+  - first_principles_contract
+required_sections:
+  - 项目上下文检测
+  - 现有系统分析
+  - 需求差距分析
+  - 主线集成计划
+  - 验证计划
+hard_rules:
+  - >-
+    existing_system + new_requirement 必须先生成 ExistingSystemAnalysisContract 和
+    RequirementGapAnalysis
+  - new_system / empty_project 不得强制执行 ExistingSystemAnalysis
+  - unknown 必须 manual_required，不能猜测继续
+  - 现有系统分析必须读取真实代码和相关文档，不能只读需求文档
+  - >-
+    分析结论必须区分 fact / inference / assumption / unknown，并带 confidence 和
+    evidence_refs
+  - 差距分析必须列出现有能力、缺失能力、复用模块、required_changes、兼容/数据/权限/集成风险
+  - 实现前必须有 MainlineIntegrationPlan
+  - VerificationPlan 必须从 RequirementGapAnalysis 生成
+acceptance_checks:
+  - project_context_type 已检测且非 unknown
+  - ExistingSystemAnalysisContract 已创建
+  - RequirementGapAnalysis 已创建
+  - 现有项目已有技术栈和项目约定优先于 SoloForge 默认
+  - 分析结论包含 fact/inference/assumption/unknown 分类
+id: ka-procedure-现有系统差距分析工作流
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+routes:
+  - code_change
+primary_triggers:
+  - 现有系统差距分析工作流
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - workflow_id
+  - required_mechanisms
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
+---
+
+## 适用场景
+已有源码、路由、API、前端页面、权限模型和测试脚本的项目中开发新需求。必须先分析现有系统、再做差距分析、最后才进入设计或编码。
+
+## 步骤
+1. **项目上下文检测**: detectProjectContext 判断 project_context_type
+2. **现有系统分析**:
+   - 读取真实代码和相关文档
+   - 识别技术栈、路由、API、前端页面、权限模型、测试脚本
+   - 区分 fact / inference / assumption / unknown
+3. **需求差距分析**:
+   - 列出现有能力、缺失能力、复用模块
+   - 列出 required_changes、optional_changes、out_of_scope
+   - 列出兼容/数据/权限/集成风险、前后端影响、测试回归范围
+4. **主线集成计划**: 新增文件、组件、API、service、DTO/model、配置必须被真实消费
+5. **验证计划**: VerificationPlan 从 RequirementGapAnalysis 生成
+
+## 检查点
+- [ ] project_context_type 已检测
+- [ ] 现有系统分析读取了真实代码
+- [ ] 差距分析包含完整风险列表
+- [ ] MainlineIntegrationPlan 已创建
+- [ ] VerificationPlan 已从差距分析生成
+
+## 禁止退化
+- existing_system 未分析不得进入设计或编码
+- unknown 类型不得猜测继续，必须 manual_required
+- 不能只读需求文档，必须读代码
+- 缺差距分析不得 coding

package/templates/knowledge/procedures//347/237/245/350/257/206/347/273/264/346/212/244/346/265/201/346/260/264/347/272/277.md

@@ -1,9 +1,36 @@
 ---
 name: knowledge-maintenance-pipeline
 type: pipeline_procedure
-when: "知识维护, 知识更新, 知识审计, 新增知识, 知识库维护, SoloForge维护"
-scope: [backend, frontend]
-products: ["*"]
+when: '知识维护, 知识更新, 知识审计, 新增知识, 知识库维护, SoloForge维护'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-知识维护流水线
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-knowledge-injection-boundary
+routes:
+  - code_change
+primary_triggers:
+  - 知识维护流水线
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 # 知识维护管线

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

@@ -1,9 +1,36 @@
 ---
 name: hotfix-pipeline
 type: pipeline_procedure
-when: "紧急修复管线, 生产事故处理管线, P0管线, 热修复管线, hotfix pipeline, 线上故障管线"
-scope: [backend, frontend]
-products: ["*"]
+when: '紧急修复管线, 生产事故处理管线, P0管线, 热修复管线, hotfix pipeline, 线上故障管线'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-紧急修复流水线
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-delivery-gate
+routes:
+  - code_change
+primary_triggers:
+  - 紧急修复流水线
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 # 紧急修复管线

package/templates/knowledge/procedures//347/264/247/346/200/245/344/277/256/345/244/215/346/265/201/347/250/213.md

@@ -1,9 +1,36 @@
 ---
 name: hotfix-procedure
 type: procedure
-when: 紧急修复, hotfix, 线上问题修复, 线上报错, 紧急上线, P0, P1, 事故修复, 止血
-scope: [backend, frontend]
-products: ["*"]
+when: '紧急修复, hotfix, 线上问题修复, 线上报错, 紧急上线, P0, P1, 事故修复, 止血'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-紧急修复流程
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-delivery-gate
+routes:
+  - code_change
+primary_triggers:
+  - 紧急修复流程
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 ## 适用场景

package/templates/knowledge/procedures//347/274/226/347/240/201/345/211/215/346/276/204/346/270/205/346/265/201/347/250/213.md

@@ -1,3 +1,36 @@
+---
+name: 编码前澄清流程
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-procedure-编码前澄清流程
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-coding-readiness
+routes:
+  - code_change
+primary_triggers:
+  - 编码前澄清流程
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: pipeline_procedure
+when: 编码前澄清流程
+status: active
+---
 # 编码前澄清流程
 
 ## 适用场景

package/templates/knowledge/procedures//347/274/272/351/231/267/344/277/256/345/244/215/346/265/201/346/260/264/347/272/277.md

@@ -1,9 +1,36 @@
 ---
 name: bug-fix-pipeline
 type: pipeline_procedure
-when: "缺陷修复, Bug修复, 问题修复, 异常修复, 错误修复, bug fix, 缺陷处理"
-scope: [backend, frontend]
-products: ["*"]
+when: '缺陷修复, Bug修复, 问题修复, 异常修复, 错误修复, bug fix, 缺陷处理'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-缺陷修复流水线
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-verifier
+routes:
+  - code_change
+primary_triggers:
+  - 缺陷修复流水线
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 # 缺陷修复管线

package/templates/knowledge/procedures//350/207/252/344/270/273/351/200/211/345/236/213/346/265/201/347/250/213.md

@@ -1,9 +1,36 @@
 ---
 name: autonomous-tech-selection
 type: procedure
-when: 技术选型, 不知道用什么, 选型, 方案对比, 架构选型, 方案选择, 技术方案
-scope: [backend, frontend]
-products: ["*"]
+when: '技术选型, 不知道用什么, 选型, 方案对比, 架构选型, 方案选择, 技术方案'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-自主选型流程
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-decision-sovereignty
+routes:
+  - code_change
+primary_triggers:
+  - 自主选型流程
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 ## 适用场景

package/templates/knowledge/procedures//350/256/276/350/256/241/344/272/247/347/211/251/347/224/237/346/210/220/344/270/216/345/244/215/351/252/214/345/267/245/344/275/234/346/265/201.md

@@ -0,0 +1,45 @@
+---
+name: design-artifact-pack-workflow
+type: procedure
+when: '架构设计文档, 数据库设计文档, API接口规格文档, 设计文档升级'
+scope:
+  - backend
+  - frontend
+  - infrastructure
+products:
+  - '*'
+owner_mechanism_id: mc-design-artifact-pack
+id: ka-procedure-design-artifact-pack
+asset_kind: procedure
+lifecycle_status: active
+authority: canonical
+routes:
+  - artifact_generation
+primary_triggers:
+  - 设计产物包
+priority: P0
+specificity: 5
+version: 1.0.0
+last_reviewed: '2026-05-25'
+required_evidence:
+  - design_artifact_pack
+  - consistency_verification
+consumes:
+  - architecture_decision_workshop
+  - docs/architecture/00-架构决策记录.md
+  - existing_design_artifacts
+emits:
+  - design_artifact_pack
+  - docs/architecture/99-设计一致性验收报告.md
+  - implementation_ready
+status: active
+---
+
+# 设计产物生成与复验工作流
+
+1. 消费已经用户确认的架构决策记录。
+2. 新项目生成架构、数据库、API、OpenAPI、SQL/migration 及一致性报告。
+3. 现有文档先标记为需要复验，输出差距和待确认变化，不静默覆盖。
+4. 用户确认后归档旧版本并写入修订产物。
+5. 读取真实文件验证 API 字段、SQL 可执行性和跨文档追踪一致性。
+6. 全部通过后才标记为 `implementation_ready`，供后续编码和交付消费。

package/templates/knowledge/procedures//350/257/246/347/273/206/350/256/276/350/256/241/346/265/201/347/250/213.md

@@ -1,9 +1,36 @@
 ---
 name: detailed-design
 type: procedure
-when: 详细设计, 接口设计, 数据库设计, DDL设计, 类设计, 详细方案, detailed design
-scope: [backend, frontend]
-products: ["*"]
+when: '详细设计, 接口设计, 数据库设计, DDL设计, 类设计, 详细方案, detailed design'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-详细设计流程
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-architecture-design
+routes:
+  - code_change
+primary_triggers:
+  - 详细设计流程
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 ## 适用场景

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

@@ -1,9 +1,36 @@
 ---
 name: debug-investigation
 type: procedure
-when: 调试, 排障, 排查问题, bug定位, 问题排查, 线上排查, 异常排查, 错误定位, 日志排查
-scope: [backend, frontend]
-products: ["*"]
+when: '调试, 排障, 排查问题, bug定位, 问题排查, 线上排查, 异常排查, 错误定位, 日志排查'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-调试排查流程
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-verifier
+routes:
+  - code_change
+primary_triggers:
+  - 调试排查流程
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 ## 适用场景

package/templates/knowledge/procedures//350/277/201/347/247/273/346/265/201/346/260/264/347/272/277.md

@@ -1,9 +1,36 @@
 ---
 name: migration-pipeline
 type: pipeline_procedure
-when: "技术迁移, 框架升级, 技术栈迁移, 版本升级, 迁移, migration, 系统迁移, 组件替换"
-scope: [backend, frontend]
-products: ["*"]
+when: '技术迁移, 框架升级, 技术栈迁移, 版本升级, 迁移, migration, 系统迁移, 组件替换'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-迁移流水线
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-knowledge-asset-governance
+routes:
+  - code_change
+primary_triggers:
+  - 迁移流水线
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 # 技术迁移管线

package/templates/knowledge/procedures//351/203/250/347/275/262/345/217/221/345/270/203/346/265/201/347/250/213.md

@@ -1,9 +1,36 @@
 ---
 name: deploy-release
 type: procedure
-when: 发布, 上线, 部署, release, 发版, 版本发布, 灰度, 发布上线, 生产部署
-scope: [backend, frontend]
-products: ["*"]
+when: '发布, 上线, 部署, release, 发版, 版本发布, 灰度, 发布上线, 生产部署'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-部署发布流程
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-delivery-gate
+routes:
+  - code_change
+primary_triggers:
+  - 部署发布流程
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 ## 适用场景

package/templates/knowledge/procedures//351/207/215/346/236/204/346/265/201/346/260/264/347/272/277.md

@@ -1,9 +1,36 @@
 ---
 name: refactor-pipeline
 type: pipeline_procedure
-when: "代码重构, 模块拆分, 模式优化, 提取公共方法, 重构, refactor, 代码改善, 结构优化"
-scope: [backend, frontend]
-products: ["*"]
+when: '代码重构, 模块拆分, 模式优化, 提取公共方法, 重构, refactor, 代码改善, 结构优化'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-重构流水线
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-task-context-lifecycle
+routes:
+  - code_change
+primary_triggers:
+  - 重构流水线
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 # 重构管线

package/templates/knowledge/procedures//351/233/206/346/210/220/351/252/214/350/257/201/346/265/201/347/250/213.md

@@ -1,9 +1,36 @@
 ---
 name: integration-verification
 type: procedure
-when: 集成测试, 集成验证, E2E测试, 端到端验证, 联调测试, integration test, E2E
-scope: [backend, frontend]
-products: ["*"]
+when: '集成测试, 集成验证, E2E测试, 端到端验证, 联调测试, integration test, E2E'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-集成验证流程
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-verifier
+routes:
+  - code_change
+primary_triggers:
+  - 集成验证流程
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 ## 适用场景

package/templates/knowledge/procedures//351/234/200/346/261/202/346/276/204/346/270/205/346/265/201/347/250/213.md

@@ -1,9 +1,36 @@
 ---
 name: requirement-clarify
 type: procedure
-when: 需求澄清, 需求分析, 需求梳理, 理解需求, 需求确认, requirement, 需求评审
-scope: [backend, frontend]
-products: ["*"]
+when: '需求澄清, 需求分析, 需求梳理, 理解需求, 需求确认, requirement, 需求评审'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-procedure-需求澄清流程
+asset_kind: procedure
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-intent-router
+routes:
+  - code_change
+primary_triggers:
+  - 需求澄清流程
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-intent-router
+emits:
+  - execution_result
+  - evidence
+required_evidence:
+  - execution_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
 ---
 
 ## 适用场景