---
name: torch
description: "Use at the start of any new task and after completing a task — enforces team knowledge base query before work and knowledge extraction after work. Also invoke when user says: 查知识库、萃取知识、torch。"
---

<EXTREMELY-IMPORTANT>
以下两条规则不可跳过，不可推迟，不可"先做完再说"。
如果你正在想"这个任务很简单不需要查知识库"——你错了。查一下只需要 10 秒。
</EXTREMELY-IMPORTANT>

## 规则 1: 任务开始前 — 查询知识库

开始任何新任务前，MUST 按顺序执行：

1. 同步知识库: `git -C <KNOWLEDGE_REPO_PATH> pull --rebase --quiet`
2. 读 `<KNOWLEDGE_REPO_PATH>/knowledge-catalog.md`，检查是否有相关的 pitfall、decision、guideline
3. 如有匹配条目，读取完整内容并在回复中引用
4. 如需深入查询，使用 /torch-query

> **知识库路径**：从当前项目 CLAUDE.md / AGENTS.md / .cursor/rules/torch.md 中的 `知识库路径` 或 `团队知识库` 段落获取。

## 规则 2: 任务完成后 — 知识萃取

完成任务后，检查是否满足以下**任一**条件：

- 修复了花 ≥3 轮才定位的 bug
- 做了"选 A 不选 B"的技术决策
- 发现了文档未记录的陷阱或行为
- 设计了可复用的架构模式

满足则 MUST 输出：

```
💡 检测到可沉淀知识：
类型: {type} | 标题: {title} | 摘要: {summary}
保存到团队知识库？[Y/N]
```

用户确认后使用 /torch-save 执行保存。

## Red Flags — 这些想法意味着你在找借口

| 你的想法 | 现实 |
|---------|------|
| "这个任务很简单，不用查知识库" | 简单任务也可能踩已知的坑，查一下 10 秒而已 |
| "我先写完代码再查" | 查知识库在前，写代码在后，顺序不可颠倒 |
| "知识库里应该没有相关的" | 你不查怎么知道？读 catalog 只需几秒 |
| "这次改动太小，不值得萃取" | 小改动背后可能是大坑，判断标准看上面四个条件 |
| "用户没让我查/萃取" | 这是规则，不需要用户提醒 |
| "上下文太长了，不想再加内容" | 知识库查询用三级渐进，成本可控 |