---
id: ka-knowledge-机制说明
kind: knowledge
title: 机制说明
sync_policy: engine_only
status: active
triggers:
  - 机制
  - 验证
  - evidence
  - artifact
  - skill
  - hook
  - sf_verify
  - sf_task
extra:
  name: mechanism-reference
  scope:
    - '*'
  products:
    - '*'
  category: knowledge
  version: 2.0.0
  last_reviewed: '2026-07-15'
  verification_layer: L2
  stage: _global
  owner_mechanism: mc-engine-runtime
---

# SoloForge 机制说明

## 生成与验证

- Skill 指导 AI 研讨和生成具体产物。
- 宿主直接编辑真实项目文件。
- `soloforge hook-check` 只做 quick，不写权威状态。
- `sf_verify action="full"` 执行完整验证并写任务绑定记录。
- `sf_review` 管理语义审查和 finding 闭环。
- `sf_task` 只根据证据要求推进和交付。

## 四类资产

| kind | 消费方式 |
|---|---|
| artifact | 用户自定义时扩展项目产物合同；正式产物骨架由对应 skill 提供 |
| guidance | 通过 `sf_knowledge action="query"` 按任务信号提供方法指导 |
| enforced | 由完整验证规则消费 |
| knowledge | 通过 `sf_knowledge action="query"` 检索；部分结构化规则还用于适配器生成 |

## 恢复

Full 失败时按 findings 修复同一产物并重新 full。内容、规则集或引擎修订变化后旧记录会失效。达到 retry 上限时停止重复尝试，分析根因并让用户决定下一步。
