soloforge 1.1.2 → 1.1.30

package/templates/internal/rules//351/252/214/350/257/201/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -0,0 +1,61 @@
+---
+name: 验证契约规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-验证契约规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-verifier
+routes:
+  - 验证契约规则
+primary_triggers:
+  - 验证契约规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-task-context-lifecycle
+hard_blocks:
+  - 验证未通过
+  - 证据缺失
+fallback: manual_required
+required_evidence:
+  - verification_evidence
+  - test_results
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 验证契约规则
+status: active
+---
+
+# 验证契约规则
+
+## 核心原则
+
+验证策略由 execution_shape 决定，不同执行形态使用不同验证强度。
+
+## 验证策略
+
+1. **code_execution**: 完整 build + test
+2. **single_artifact/source_extraction**: 轻量检查
+3. **direct_answer**: 无需验证
+
+## 规则
+
+1. 验证结果必须保存到 task_context 才能标记 done/learning
+2. evidence level 必须达到 E1 以上
+3. 验证命令必须覆盖所有 changed_files
+4. 验证失败时进入 repair_reverify 循环
+
+## 验收标准
+
+- [ ] generateVerifyCommands 根据 execution_shape 选择策略
+- [ ] VerifyResult 包含 evidence 和 coverage
+- [ ] 验证结果保存到 task_context
+- [ ] repair_reverify 循环有 max_attempts 限制

package/templates/patterns/API/350/256/276/350/256/241/350/247/204/350/214/203.md

@@ -1,9 +1,36 @@
 ---
 name: api-design
+when: 'API设计, 接口设计, 新建接口, 接口定义, RESTful, API规范, 接口契约, 请求参数, 响应格式'
+scope:
+  - backend
+products:
+  - '*'
+id: ka-pattern-api-design
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - API设计
+  - 接口设计
+  - 新建接口
+  - 接口定义
+  - RESTful
+  - API规范
+  - 接口契约
+  - 请求参数
+  - 响应格式
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: API设计, 接口设计, 新建接口, 接口定义, RESTful, API规范, 接口契约, 请求参数, 响应格式
-scope: [backend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/Docker/351/203/250/347/275/262/350/247/204/350/214/203.md

@@ -1,9 +1,35 @@
 ---
 name: docker-deployment
+when: 'Docker部署, 容器部署, Dockerfile, docker-compose, 镜像构建, 容器化, 部署发布'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-pattern-docker-deployment
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - Docker部署
+  - 容器部署
+  - Dockerfile
+  - docker-compose
+  - 镜像构建
+  - 容器化
+  - 部署发布
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: Docker部署, 容器部署, Dockerfile, docker-compose, 镜像构建, 容器化, 部署发布
-scope: [backend, frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/Git/346/223/215/344/275/234/350/247/204/350/214/203.md

@@ -1,15 +1,45 @@
 ---
 name: gitops
+when: 'Git操作, 提交, commit, 分支, merge, 回滚, git, 代码提交, 版本控制, 代码合并, 冲突解决'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-pattern-gitops
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - Git操作
+  - 提交
+  - commit
+  - 分支
+  - merge
+  - 回滚
+  - git
+  - 代码提交
+  - 版本控制
+  - 代码合并
+  - 冲突解决
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: Git操作, 提交, commit, 分支, merge, 回滚, git, 代码提交, 版本控制, 代码合并, 冲突解决
-scope: [backend, frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则
 - Commit 消息必须语义化（feat/fix/refactor/test/docs/chore + 描述），禁止"update"、"fix"等笼统消息
 - 每个 commit 对应一个最小变更单元
-- 提交前检查清单：lint/format 通过、测试通过、无调试残留（console.log/print/TODO/FIXME）、无敏感信息、无超范围变更、无未跟踪大文件
+- 提交前检查清单：lint/format 通过、测试通过、无调试残留（console 输出、print、待办/修复占位标记）、无敏感信息、无超范围变更、无未跟踪大文件
 - 功能分支合并必须使用 --no-ff 保留历史
 - 冲突在功能分支解决，禁止在 master 上解决冲突
 - 单 commit 问题用 git revert，整分支问题用 git revert -m 1

package/templates/patterns/N/345/212/2401/346/237/245/350/257/242/350/247/204/350/214/203.md

@@ -1,9 +1,37 @@
 ---
 name: n-plus-one-query
+when: 'N+1查询, 慢查询, 性能问题, 批量查询, 循环查询, SQL优化, 查询优化, JOIN, 延迟加载, eager loading'
+scope:
+  - backend
+products:
+  - '*'
+id: ka-pattern-n-plus-one-query
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - N+1查询
+  - 慢查询
+  - 性能问题
+  - 批量查询
+  - 循环查询
+  - SQL优化
+  - 查询优化
+  - JOIN
+  - 延迟加载
+  - eager loading
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: N+1查询, 慢查询, 性能问题, 批量查询, 循环查询, SQL优化, 查询优化, JOIN, 延迟加载, eager loading
-scope: [backend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/React/345/210/227/350/241/250/350/241/250/346/240/274/350/247/204/350/214/203.md

@@ -1,9 +1,36 @@
 ---
 name: react-list-table
+when: '列表页, 表格, 数据展示, antd Table, 数据列表, 查询列表, 搜索列表, 分页列表, 列表查询'
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-pattern-react-list-table
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - 列表页
+  - 表格
+  - 数据展示
+  - antd Table
+  - 数据列表
+  - 查询列表
+  - 搜索列表
+  - 分页列表
+  - 列表查询
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: 列表页, 表格, 数据展示, antd Table, 数据列表, 查询列表, 搜索列表, 分页列表, 列表查询
-scope: [frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/React/346/216/245/345/217/243/351/233/206/346/210/220/350/247/204/350/214/203.md

@@ -1,9 +1,37 @@
 ---
 name: react-api-integration
+when: '前端API调用, 接口对接, HTTP请求, axios, fetch, 数据请求, 接口联调, 后端对接, API集成, 请求封装'
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-pattern-react-api-integration
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - 前端API调用
+  - 接口对接
+  - HTTP请求
+  - axios
+  - fetch
+  - 数据请求
+  - 接口联调
+  - 后端对接
+  - API集成
+  - 请求封装
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: 前端API调用, 接口对接, HTTP请求, axios, fetch, 数据请求, 接口联调, 后端对接, API集成, 请求封装
-scope: [frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/React/347/212/266/346/200/201/347/256/241/347/220/206/350/247/204/350/214/203.md

@@ -1,9 +1,37 @@
 ---
 name: react-state-management
+when: '状态管理, 全局状态, useState, useContext, 状态共享, 跨组件通信, 全局数据, store, Context, 状态同步'
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-pattern-react-state-management
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - 状态管理
+  - 全局状态
+  - useState
+  - useContext
+  - 状态共享
+  - 跨组件通信
+  - 全局数据
+  - store
+  - Context
+  - 状态同步
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: 状态管理, 全局状态, useState, useContext, 状态共享, 跨组件通信, 全局数据, store, Context, 状态同步
-scope: [frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/React/347/273/204/344/273/266/350/247/204/350/214/203.md

@@ -1,9 +1,36 @@
 ---
 name: react-component
+when: 'React组件, 页面开发, 前端组件, tsx, 新建页面, 新建组件, 组件开发, React开发, 前端开发'
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-pattern-react-component
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - React组件
+  - 页面开发
+  - 前端组件
+  - tsx
+  - 新建页面
+  - 新建组件
+  - 组件开发
+  - React开发
+  - 前端开发
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: React组件, 页面开发, 前端组件, tsx, 新建页面, 新建组件, 组件开发, React开发, 前端开发
-scope: [frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/React/350/241/250/345/215/225/350/247/204/350/214/203.md

@@ -1,9 +1,36 @@
 ---
 name: react-form-handling
+when: '表单处理, 表单校验, 用户输入, 表单提交, Form, 表单开发, 数据采集, 编辑表单, 新增表单'
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-pattern-react-form-handling
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - 表单处理
+  - 表单校验
+  - 用户输入
+  - 表单提交
+  - Form
+  - 表单开发
+  - 数据采集
+  - 编辑表单
+  - 新增表单
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: 表单处理, 表单校验, 用户输入, 表单提交, Form, 表单开发, 数据采集, 编辑表单, 新增表单
-scope: [frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/React/350/267/257/347/224/261/350/247/204/350/214/203.md

@@ -1,9 +1,37 @@
 ---
 name: react-routing
+when: '路由, 页面跳转, 菜单, 权限路由, 导航, 路由配置, react-router, 页面路由, 嵌套路由, 路由守卫'
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-pattern-react-routing
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - 路由
+  - 页面跳转
+  - 菜单
+  - 权限路由
+  - 导航
+  - 路由配置
+  - react-router
+  - 页面路由
+  - 嵌套路由
+  - 路由守卫
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: 路由, 页面跳转, 菜单, 权限路由, 导航, 路由配置, react-router, 页面路由, 嵌套路由, 路由守卫
-scope: [frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/SOLID/350/256/276/350/256/241/350/247/204/350/214/203.md

@@ -0,0 +1,39 @@
+---
+name: solid-design-pattern
+when: 'SOLID, 面向对象设计, 职责划分, 依赖倒置, 接口隔离'
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+id: ka-pattern-solid-design
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+owner_mechanism_id: mc-ood-solid-contract
+routes:
+  - code_change
+primary_triggers:
+  - SOLID
+  - 面向对象设计
+priority: P1
+specificity: 5
+version: 1.0.0
+last_reviewed: '2026-05-26'
+consumes:
+  - mc-ood-solid-contract
+emits: []
+secondary_triggers: []
+negative_triggers: []
+type: pattern
+status: active
+---
+
+## 规则
+
+- 一个类只承担一个清晰可验证的业务原因。
+- 新增行为优先扩展端口或策略，避免修改大量既有条件分支。
+- 子类型必须保持父契约的有效输入、输出和错误语义。
+- 接口按消费者需要拆分，禁止空实现和不支持异常。
+- 业务核心依赖抽象，基础设施实现由装配层注入。
+- 简单修改不建立无用抽象层，避免为原则之名过度设计。

package/templates/patterns/Schema/345/205/274/345/256/271/350/247/204/350/214/203.md

@@ -1,9 +1,36 @@
 ---
 name: schema-compatibility
+when: '数据库变更, 字段修改, 表结构变更, 数据迁移, Schema变更, 加字段, 改字段, 删字段, DDL'
+scope:
+  - backend
+products:
+  - '*'
+id: ka-pattern-schema-compatibility
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - 数据库变更
+  - 字段修改
+  - 表结构变更
+  - 数据迁移
+  - Schema变更
+  - 加字段
+  - 改字段
+  - 删字段
+  - DDL
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: 数据库变更, 字段修改, 表结构变更, 数据迁移, Schema变更, 加字段, 改字段, 删字段, DDL
-scope: [backend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/Vue/347/212/266/346/200/201/347/256/241/347/220/206/350/247/204/350/214/203.md

@@ -1,9 +1,35 @@
 ---
 name: vue-state
+when: 'Vue状态管理, Pinia, Vuex, 全局状态, store, Vue状态, 状态共享, 跨组件通信'
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-pattern-vue-state
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - Vue状态管理
+  - Pinia
+  - Vuex
+  - 全局状态
+  - store
+  - Vue状态
+  - 状态共享
+  - 跨组件通信
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: Vue状态管理, Pinia, Vuex, 全局状态, store, Vue状态, 状态共享, 跨组件通信
-scope: [frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/Vue/347/273/204/344/273/266/350/247/204/350/214/203.md

@@ -1,9 +1,39 @@
 ---
 name: vue-component
+when: >-
+  Vue组件, Vue页面, vue, Vue开发, 组合式API, Composition API, setup, defineComponent,
+  Vue3, 前端开发vue
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-pattern-vue-component
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - Vue组件
+  - Vue页面
+  - vue
+  - Vue开发
+  - 组合式API
+  - Composition API
+  - setup
+  - defineComponent
+  - Vue3
+  - 前端开发vue
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: Vue组件, Vue页面, vue, Vue开发, 组合式API, Composition API, setup, defineComponent, Vue3, 前端开发vue
-scope: [frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则

package/templates/patterns/Vue/350/267/257/347/224/261/350/247/204/350/214/203.md

@@ -1,9 +1,34 @@
 ---
 name: vue-routing
+when: 'Vue路由, Vue Router, 页面跳转, Vue导航, 路由守卫, 路由配置, vue-router'
+scope:
+  - frontend
+products:
+  - '*'
+id: ka-pattern-vue-routing
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - Vue路由
+  - Vue Router
+  - 页面跳转
+  - Vue导航
+  - 路由守卫
+  - 路由配置
+  - vue-router
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
 type: pattern
-when: Vue路由, Vue Router, 页面跳转, Vue导航, 路由守卫, 路由配置, vue-router
-scope: [frontend]
-products: ["*"]
+status: active
 ---
 
 ## 决策规则