---
name: knowledge-maintenance-pipeline
type: pipeline_procedure
when: '知识维护, 知识更新, 知识审计, 新增知识, 知识库维护, SoloForge维护'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-procedure-知识维护流水线
asset_kind: pipeline_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-knowledge-injection-boundary
emits:
  - knowledge_audit_report
  - knowledge_index_update
required_evidence:
  - execution_evidence
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["需求分析", "架构设计", "详细设计", "任务规划", "编码与单元测试", "代码审查", "联调验证"]
---

# 知识维护管线

### 第1步：知识审计
扫描现有知识库，识别过时条目（长期未被匹配/引用）、重复条目、缺失覆盖的领域。检查知识文件格式一致性。对比设计文档与实际实现的偏差。
工具：sf_knowledge_audit

### 第2步：知识新增
根据审计结果和 sf_learn 积累的高频问题，生成新知识条目草稿。草稿保存到 .soloforge/knowledge/drafts/ 目录，人工 review 后移入正式目录。
工具：sf_knowledge_add

### 第3步：知识更新
更新已有条目的决策边界、when 触发词、验收项。同步更新设计文档中对应的描述。标记废弃条目（不删除，标记 deprecated）。
工具：sf_knowledge_update

### 第4步：一致性验证
重新构建知识索引，验证新增/更新条目可被正确匹配。运行全量测试确认无功能影响。更新设计文档中的知识规模统计。
工具：sf_verify, sf_learn

### 第5步：定期审计与质量控制
定期审计知识库（每月），检查过期/重复/不准确的条目。新增知识条目必须经过 review 后才发布（草稿 → 审核 → 正式）。知识条目使用统计数据纳入监控，低使用率条目评估是否保留。知识条目格式必须符合规约（字段顺序、body 标题、when 风格），使用 sf_knowledge_audit 检查。

## 检查点
- [ ] 知识库审计执行完毕
- [ ] 新增/更新条目索引验证通过
- [ ] 新条目经过 review
- [ ] 低使用率条目已评估
- [ ] 格式规约检查通过

## 注意事项
- 废弃条目标记为 deprecated 而非直接删除，保留历史参考
- 知识条目应保持精简（决策规则 ≤ 20 条），过长难以匹配和阅读
- 知识条目变更应记录变更历史（更新原因、时间）
