soloforge 1.4.16 → 2.0.0

package/templates/knowledge/patterns/core//351/252/214/350/257/201/345/221/275/344/273/244/347/224/237/346/210/220.md

@@ -1,63 +0,0 @@
----
-name: verify_command_generation
-when: '验证, 编译, 测试命令, 项目类型检测'
-scope:
-  - shared
-products:
-  - '*'
-id: ka-pattern-verify_command_generation
-asset_kind: pattern
-lifecycle_status: active
-authority: supporting
-routes:
-  - '*'
-primary_triggers:
-  - 验证
-  - 编译
-  - 测试命令
-  - 项目类型检测
-priority: P2
-specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
-consumes: []
-emits: []
-secondary_triggers: []
-negative_triggers: []
-type: pattern
-status: active
----
-
-## 决策规则
-
-- generateVerifyCommands 根据项目类型生成编译和测试命令
-- 三个分支: config（有 sf.yaml）、doc-only（无代码项目）、repo（标准项目）
-- repo 分支通过 detectFingerprint 识别技术栈
-- 生成的命令必须可执行，且覆盖编译 + 测试两个阶段
-- 边界项目（无 package.json）必须有 fallback 处理
-
-## 验收项
-
-- [AC-01] config/doc-only/repo 三分支覆盖
-- [AC-02] 生成的命令格式正确
-- [AC-03] 边界项目有 fallback
-- [AC-04] 自定义命令模板覆盖默认命令
-
-## 何时使用
-
-编译和测试命令是质量门禁的基础
-
-## 是否 hard block
-
-是。此能力为 enforced 状态，违规即 hard fail 阻断流程。
-
-## 证据要求
-
-- config/doc-only/repo 三分支测试通过
-- 边界项目（无 package.json）验证通过
--
-
-## 人工确认/降级边界
-
-- enforced 能力不可跳过，违反即阻断
-- 降级需经 sf_capability_update + 人工确认，提供 escape report 证据

package/templates/knowledge/procedures/OOD/350/256/276/350/256/241/345/267/245/344/275/234/346/265/201.md

@@ -1,50 +0,0 @@
----
-name: OOD设计工作流
-type: procedure
-when: '面向对象设计, SOLID, 领域服务, 业务规则实现, 重构'
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-procedure-OOD设计工作流
-asset_kind: procedure
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-ood-solid-contract
-routes:
-  - code_change
-  - artifact_generation
-primary_triggers:
-  - OOD设计工作流
-secondary_triggers:
-  - SOLID
-negative_triggers:
-  - 文案修改
-priority: P1
-specificity: 5
-consumes:
-  - mc-ood-solid-contract
-emits:
-  - ood_design_summary
-  - code_review_findings
-required_evidence:
-  - execution_evidence
-version: 1.0.0
-last_reviewed: '2026-05-26'
-status: active
----
-
-## 步骤
-
-1. 判断任务是否确实存在对象边界或变化点，简单改动记录不适用理由。
-2. 列出对象职责、接口、依赖方向和主要协作流程。
-3. 对五项 SOLID 原则逐项说明适用风险与取舍。
-4. 编码后执行审查和验证，以实际源码 finding 为准。
-5. 存在硬失败则修复并重验，不能仅在报告中解释。
-
-## 输出摘要
-
-| 对象/模块 | 单一职责 | 依赖接口 | 变化点 | SOLID 风险 | 验证证据 |
-|---|---|---|---|---|---|
-| | | | | | |

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

@@ -1,54 +0,0 @@
----
-name: schema-change-pipeline
-type: pipeline_procedure
-when: '数据库结构变更, 加字段, 改字段, 新建表, 加索引, DDL变更, schema变更, 数据库迁移'
-scope:
-  - backend
-products:
-  - '*'
-id: ka-procedure-Schema变更流水线
-asset_kind: procedure
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-knowledge-asset-governance
-routes:
-  - code_change
-primary_triggers:
-  - Schema变更流水线
-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
----
-
-# 数据库变更管线
-
-### 第1步：变更设计
-评估变更类型（加列/改列/删列/加索引/数据迁移/新建表）。确认向前兼容性（新列默认值或允许 NULL）。制定四层兼容策略（数据库→接口契约→前端展示→导出逻辑）。
-模板：数据库变更方案模版.md
-产出保存到：.soloforge/output/01-变更方案.md
-工具：sf_classify
-
-### 第2步：迁移脚本
-编写 migration 脚本（正向 + 回滚），确保幂等。大表加列使用分批更新策略。大表加索引使用 ONLINE DDL。禁止 migration 中写业务逻辑。
-产出保存到：.soloforge/output/02-migration.sql
-工具：sf_expand
-
-### 第3步：代码适配
-更新 Entity/DTO 映射。更新接口契约（请求/响应字段）。更新前端展示和表单。更新导出逻辑（如有）。更新相关测试数据和测试用例。
-工具：sf_expand
-
-### 第4步：验证验收
-开发环境执行 migration 验证表结构。运行全量测试。代码审查重点关注：四层兼容完整性、回滚脚本有效性、大表性能影响评估。
-工具：sf_verify, sf_review, sf_learn

package/templates/knowledge/procedures//344/270/273/351/223/276/350/267/257/346/216/245/345/205/245/351/252/214/350/257/201/346/265/201/347/250/213.md

@@ -1,56 +0,0 @@
----
-name: 主链路接入验证流程
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-procedure-主链路接入验证流程
-asset_kind: procedure
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-main-path-integration
-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
----
-# 主链路接入验证流程
-
-## 步骤
-
-1. 识别新增模块 (changed_files 中 src/ 下的文件)
-2. 扫描谁导入了该模块 (scanModuleImporters)
-3. 从入口点追踪可达性 (traceModuleReachability)
-4. 收集可观测证据 (collectModuleObservability)
-5. 查找集成测试 (findIntegrationTests)
-6. 判断接入状态 (integrated / implemented_not_integrated / ...)
-7. 运行 orphanGate 和 validateMainPathIntegration
-
-## 接入标准
-
-- **integrated**: 有生产调用 + 有入口链路
-- **implemented_not_integrated**: 无生产调用或无入口链路
-- **experimental_isolated**: 明确标注为实验性
-
-## 注意事项
-
-- barrel export 不算生产调用
-- registry 声明不算接入
-- type reference 不算接入

package/templates/knowledge/procedures//344/273/243/347/240/201/351/227/250/347/246/201/346/265/201/347/250/213.md

@@ -1,60 +0,0 @@
----
-name: code-gate
-type: procedure
-when: '代码门禁, 代码审查门禁, gate review, 发布门禁, 上线检查, 代码评审, 发布审查'
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-procedure-代码门禁流程
-asset_kind: procedure
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-guard-evaluation
-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
----
-
-## 适用场景
-代码变更的最终门禁审查，确保每行变更可追溯、有真实运行证据、符合项目约束和架构红线。
-
-## 步骤
-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/knowledge/procedures//344/273/273/345/212/241/346/213/206/350/247/243/346/265/201/347/250/213.md

@@ -1,58 +0,0 @@
----
-name: task-breakdown
-type: procedure
-when: '任务拆解, 工作分解, task breakdown, 任务拆分, 任务规划, 工单, 工作拆分'
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-procedure-任务拆解流程
-asset_kind: procedure
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-intent-expander
-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
----
-
-## 适用场景
-将设计产物转化为可执行的任务卡片，包含明确范围、验收标准和测试映射。适用于编码前的任务规划阶段。
-
-## 步骤
-1. 确定工单模式：skip（跳过）/ mini（简化）/ full（完整），基于变更类型和风险等级
-2. 先产出交付蓝图：目标、冲突、推荐方案、确认状态、验收标准、3 轮重试策略
-3. 生成任务卡片：每张卡有明确成功标准、上游引用、验收映射和测试映射
-4. DDL 独立为前置任务；多服务按服务拆分；单接口/页面可合并为一张可验证卡
-5. 控制实现上下文：必须读/可选读/默认不读列表，引用上游路径而非复制全文
-6. 验证可追溯性：每张任务卡追溯到需求、接口和设计锚点
-
-## 检查点
-- [ ] 工单模式匹配风险等级和变更类型
-- [ ] 每张任务卡有可验证的成功标准（非"让它工作"）
-- [ ] 任务卡追溯到需求和设计锚点，无孤立任务
-- [ ] DDL 独立为前置任务
-- [ ] 外部系统/大表 DDL/数据迁移/权限安全标记为高风险
-
-## 注意事项
-- 禁止复制上游全文到工单中（引用路径）
-- 禁止只拆后端不拆前端和集成
-- 禁止模糊成功标准如"功能正常"
-- 自动修复循环上限 3 轮

package/templates/knowledge/procedures//345/205/250/347/224/237/345/221/275/345/221/250/346/234/237/345/267/245/344/275/234/346/265/201/345/257/274/350/210/252.md

@@ -1,126 +0,0 @@
----
-name: 全生命周期工作流导航
-type: procedure
-when: '下一步, 继续, 现在能写代码吗, 工作流导航, navigation, 阶段判断, 工作包生成'
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-procedure-全生命周期工作流导航
-asset_kind: procedure
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-workflow-navigation-contract
-routes:
-  - operation
-  - multi_stage_plan
-  - artifact_generation
-primary_triggers:
-  - 全生命周期工作流导航
-secondary_triggers:
-  - 下一步
-  - 继续
-  - 现在能写代码吗
-  - 阶段导航
-negative_triggers: []
-priority: P0
-specificity: 5
-consumes:
-  - mc-workflow-navigation-contract
-  - current_task_context
-  - project_configuration
-  - design_artifact_audit
-  - repair_reverify_directive
-emits:
-  - next_action_plan
-  - executable_work_package
-  - prohibited_actions
-required_evidence:
-  - project_stage
-  - task_stage
-version: 1.0.0
-last_reviewed: '2026-05-26'
-status: active
----
-
-# 全生命周期工作流导航
-
-本流程定义了从项目初始化到发布后的完整工作流导航决策树。
-
-## 项目生命周期阶段
-
-| 阶段 | 判断条件 | 下一步 |
-|------|----------|--------|
-| 未初始化 | .soloforge/ 不存在或无 config.yaml | 运行 soloforge init |
-| 配置待确认 | config.yaml 存在但字段未确认 | 先区分自动修复项和业务确认项；机械类型/evidence 问题运行 soloforge config repair，业务口径再运行 soloforge config confirm |
-| 知识就绪 | 配置已确认、知识库已索引 | 提交开发意图开始新任务 |
-| 设计进行中 | 设计产物存在但未通过审计 | 完成设计并通过审计 |
-| 实现就绪 | 设计产物已通过审计 | 制定开发切片计划 |
-| 开发进行中 | 有任务在编码/验证阶段 | 继续编码和验证 |
-| 交付就绪 | 任务已通过验证 | 进行交付验收 |
-| 已发布 | 已交付上线 | 进入观察期 |
-| 发布后观察 | 发布后验证阶段 | 监控、反馈、回滚预案 |
-
-## 任务生命周期阶段
-
-任务从分类到交付的完整流程：
-
-1. 输入材料收集 → 2. 需求明确化 → 3. 决策研讨 → 4. 架构设计 → 5. 详细设计 → 6. 数据库设计 → 7. API 设计 → 8. 切片规划 → 9. 编码实现 → 10. 本地验证 → 11. 测试 → 12. 代码审查 → 13. 修复复验 → 14. 交付验收 → 15. 发布准备 → 16. 发布后观察
-
-## 导航决策流程
-
-1. 调用 `sf_navigation` 或 `soloforge next` 获取当前状态
-2. 检查是否有陈旧任务需要处理
-3. 读取 `confirmation_decisions`
-   - `must_confirm` 非空时，先让用户选择，不得继续执行会被阻断的动作
-   - `should_confirm` 非空时，明确说明建议确认的收益，但允许继续只读或低风险准备
-   - `auto_resolvable` 非空时，按推荐命令修复或复验，不把它伪装成业务确认
-4. 读取返回的 work_package，按描述执行下一步
-5. 遵守 disallowed_actions 中的禁止动作
-6. 执行完成后运行 acceptance_commands 验证
-7. 如需用户确认，必须列出具体确认项、选项和不确认影响，不能笼统说“需要确认”
-
-## 空项目确认口径
-
-从 0 开发的新项目没有既有项目事实可确认。导航只能要求用户确认目标、边界、技术选择和默认口径。
-
-- 可以继续：初始化、模板同步、知识索引、只读规划、设计准备
-- 不可声称：自动推断结果是已有系统事实
-- 不可阻塞：因为没有源码或历史文档而阻止空项目建立基线
-- 必须阻塞：用户需要在多个业务口径或高影响决策中做选择但尚未选择
-
-## 陈旧任务处理
-
-当 current-task.json 指向旧任务时：
-- 选择"恢复"：继续旧任务从上次中断处开始
-- 选择"归档"：将旧任务标记为归档，清理指针
-- 选择"新建"：归档旧任务后开始新任务
-- 不得绕过 SoloForge 直接操作
-- 归档只处理陈旧指针，不是直接写业务代码的许可
-
-## 阻断恢复
-
-当 Edit、Write、Bash 或 MCP 工具被 SoloForge 阻断时：
-
-- 先读取阻断输出中的 `recovery_command`、`template_path` 和 `confirmation_decisions`
-- 自动修复项按命令修复后重试对应工具
-- 业务确认项列出具体必须确认内容后等待用户确认
-- 不得取消任务后直接写代码
-- 不得改用 Bash 绕过受控任务、设计复验或追踪矩阵
-- 不得手动删除 `.soloforge/state`
-- 若确认为陈旧任务，必须通过 `sf_status action=archive_stale confirm=true` 或导航推荐命令归档，再重新 `sf_classify -> sf_expand`
-
-## 常见导航场景
-
-**场景: 用户说"继续"**
-→ 调用 sf_navigation 获取 work_package，按描述执行
-
-**场景: 用户说"现在能写代码吗"**
-→ sf_navigation 检查项目阶段和设计审计状态，返回允许或阻断原因
-
-**场景: 用户说"审查后做什么"**
-→ sf_navigation 检查 code_review 结果，推荐下一步验证或交付
-
-**场景: 用户说"发布后做什么"**
-→ sf_navigation 返回发布后观察工作包：验证、监控、反馈收集

package/templates/knowledge/procedures//345/212/237/350/203/275/345/274/200/345/217/221/346/265/201/347/250/213.md

@@ -1,67 +0,0 @@
----
-name: feature-development
-type: procedure
-when: '新功能开发, 需求实现, feature, 新增功能, 需求开发, 功能实现, 新建功能'
-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
----
-
-## 适用场景
-从需求到上线的完整功能开发流程。适用于需要前后端协作的中等及以上复杂度功能。
-
-## 步骤
-1. 需求澄清：确认功能边界、验收标准、影响范围
-2. 技术方案设计：确定接口契约（API 定义）、数据模型、技术选型
-3. 自主技术选型（若涉及架构级选型）：调用 sf_explore 检索行业基准 → 四维矩阵 → 证伪循环 → A/B 决策诱导 → 等待人类选择
-4. 前后端对齐：API 文档/接口契约评审，确认字段和状态流转
-4. 后端开发：按 crud-operation / api-pagination 等模式实现，先写接口再写逻辑
-5. 前端开发：按 react-component / react-api-integration 等模式实现页面和接口对接
-6. 单元测试：Service 层核心逻辑 + 前端关键组件
-7. 联调测试：前后端联调，验证完整流程
-8. 代码审查：使用 sf_review 检查质量/安全/性能
-9. 提测：部署到测试环境，执行验收标准
-10. 修复反馈问题后准备发布
-
-## 检查点
-- [ ] API 接口契约已对齐并文档化
-- [ ] 后端接口有 Swagger/OpenAPI 文档
-- [ ] 核心逻辑有单元测试覆盖
-- [ ] 前后端联调通过
-- [ ] 涉及技术选型时已通过 sf_explore 完成行业基准对齐
-- [ ] 交付物末尾已签署终局宣言
-
-## 注意事项
-- 接口契约先于实现（避免前端等后端）
-- 复杂功能拆分为多个子任务并行开发
-- 每个子任务完成后及时联调，不要全部完成后才联调
-- 编码前确认交付蓝图状态，敏感领域（金额算法/状态流转/审批规则/跨系统同步）需用户确认
-- 通过交付蓝图的必须读/可选读/默认不读列表控制上下文，禁止默认读取全部上游文档
-- 修复限于同一限界上下文可继续；跨越无关模块必须返回任务拆解
-- 变更映射必须覆盖所有改动，unmapped_changes 不允许非零

package/templates/knowledge/procedures//345/220/216/347/253/257/346/216/245/345/217/243/345/256/236/347/216/260/345/267/245/344/275/234/346/265/201.md

@@ -1,50 +0,0 @@
----
-name: 后端接口实现工作流
-type: procedure
-when: '后端接口, Controller, DTO, API实现, 数据写入'
-scope:
-  - backend
-products:
-  - '*'
-id: ka-procedure-后端接口实现工作流
-asset_kind: procedure
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-backend-implementation-contract
-routes:
-  - code_change
-  - artifact_generation
-primary_triggers:
-  - 后端接口实现工作流
-secondary_triggers:
-  - REST API
-negative_triggers: []
-priority: P1
-specificity: 5
-consumes:
-  - mc-backend-implementation-contract
-emits:
-  - backend_work_package
-  - verification_result
-required_evidence:
-  - execution_evidence
-version: 1.0.0
-last_reviewed: '2026-05-26'
-status: active
----
-
-## 步骤
-
-1. 确认 OpenAPI、数据库 migration、权限与状态流转基线。
-2. 定义请求 DTO、响应 DTO、字段校验、错误码和分页排序边界。
-3. 定义应用服务事务边界、幂等策略、并发控制和审计事件。
-4. 编码并执行单元、集成、权限、重复提交与契约一致性验证。
-5. 审查 finding 清零并提供验收证据后交付。
-
-## 工作包
-
-| 类别 | 需明确内容 | 证据 |
-|---|---|---|
-| 接口边界 | DTO、统一响应、错误码、分页 | OpenAPI/测试 |
-| 一致性 | 事务、幂等、并发、状态流转 | migration/集成测试 |
-| 安全 | 权限、租户、审计、隐私 | 越权测试/审计日志 |

package/templates/knowledge/procedures//345/221/275/344/273/244/346/211/247/350/241/214/346/265/201/347/250/213.md

@@ -1,53 +0,0 @@
----
-name: 命令执行流程
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-procedure-命令执行流程
-asset_kind: procedure
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-command-execution
-routes:
-  - code_change
-primary_triggers:
-  - 命令执行流程
-secondary_triggers: []
-negative_triggers: []
-priority: P1
-specificity: 5
-consumes:
-  - mc-tool-invocation-contract
-emits:
-  - execution_result
-  - evidence
-required_evidence:
-  - command_classification
-  - execution_result
-version: 1.0.0
-last_reviewed: '2026-05-22'
-migration_note: 知识资产标准化迁移
-type: pipeline_procedure
-when: 命令执行流程
-status: active
----
-# 命令执行流程
-
-## 步骤
-
-1. 接收命令 (command string)
-2. 调用 classifyCommand 分级
-3. 检查分级结果:
-   - destructive → 需人工确认
-   - mutating → 可执行，记录证据
-   - read_only → 自由执行
-4. 执行命令
-5. 收集执行结果和证据
-6. 记录到 task_context
-
-## 注意事项
-
-- 命令分级基于模式匹配，不是白名单
-- 未知命令默认为 mutating
-- 命令参数中的敏感信息需脱敏