# Torch 知识消费规则（复制到业务项目的 CLAUDE.md 中）

> 将以下内容复制到你的业务项目 CLAUDE.md 中，修改 `<KNOWLEDGE_REPO_PATH>` 为实际路径即可接入团队知识体系。

---

```markdown
## 团队知识库

团队知识库位于 `<KNOWLEDGE_REPO_PATH>`，包含团队沉淀的技术决策、踩坑记录、最佳实践等经验。

### 同步规则

每次开始新任务前，执行：
git -C <KNOWLEDGE_REPO_PATH> pull --rebase --quiet

### 查询时机

在以下场景下，必须先查阅知识库：
1. **开始任何新任务前** → 读 `knowledge-catalog.md`（~50行）了解知识库全貌
2. **做技术决策/选型前** → 查 `tech-wiki/catalog.md` 中 type=decision 和 type=pitfall 的条目
3. **遇到报错排查时** → 查对应领域的 pitfalls/ 目录
4. **设计新模块前** → 查 `biz-wiki/` 相关 type=model 和 type=process 的条目

### 查询流程（三级渐进）

1. 读 `knowledge-catalog.md`（~50行，零成本）→ 了解有什么
2. 读相关 `catalog.md`（~100-300行）→ 按 tags/type 定位条目
3. 按需读完整条目（~50-200行）→ 获取详细内容

**注意**：不要一次性读取所有条目，遵循渐进式查询控制上下文成本。

### 引用追踪

引用知识条目后，执行以下更新：
1. 更新该条目 YAML front matter 中的 `last_referenced` 为当前日期
2. 将 `reference_count` 加 1
3. 检查是否满足成熟度升级条件：
   - draft → verified：reference_count ≥ 1
   - verified → proven：reference_count ≥ 3 且 evidence 来自 ≥ 2 个不同项目
4. 如果满足升级条件，更新 `maturity` 字段，同时更新 catalog.md 中的成熟度标记
5. 在 `log.md` 末尾追加升级记录

### 知识萃取（对话级）

当你完成一个任务且满足以下**任一**条件时，主动询问用户是否沉淀知识：
- 修复了一个花了 ≥3 轮对话才定位的 bug
- 做了"选 A 而非 B"的技术决策并有明确理由
- 发现了文档没写但很重要的行为或陷阱
- 设计了可复用的架构模式

**不触发**的场景：简单问答、格式调整、一行修改、纯阅读代码、与当前项目技术无关的任务（调研、翻译、闲聊等）。

触发时输出：

💡 检测到可沉淀知识：

类型: {type}
标题: {title}
摘要: {summary}
来源: 本次对话

保存到团队知识库？[Y/N]

用户按 Y 后，使用 /torch-save 执行保存流程。
```