/absorb

外部知识吸收。当用户发送文章链接或文本，希望体系吸收外部最佳实践时使用。

外部知识吸收

将外部知识（文章、教程、changelog、最佳实践）结构化评估后融入体系文档。

完整设计详见 docs/design/20-体系外部进化机制.md。

步骤

Step 1: 获取内容

• 如果用户提供了 URL：使用 WebFetch 获取文章内容
• 如果用户直接粘贴了文本：直接使用
• 如果用户描述了一个发现/经验：引导用户补充细节

Step 2: 结构化提取

从内容中提取：

• 核心要点（3-5 条，每条一句话）
• 技术细节（具体的配置、命令、API 变更）
• 最佳实践（可操作的建议或模式）
• 与本体系的关联点（哪些现有文档涉及相关主题）

Step 3: 五问评估

对提取的内容逐一评估：

维度	问题	评估标准
可靠性	来源可信吗？	官方文档 > 知名博客 > 社区帖子 > 个人观点
时效性	信息新鲜吗？	6 个月内优先，超 1 年需交叉验证
关联性	与体系相关吗？	直接影响体系的技术栈、工作流或原则
增量性	体系里有了吗？	确认是新知识而非重复
实操性	能落地吗？	有具体配置、命令或模式

Step 4: 定位影响范围

确定知识应更新到体系的哪个位置：

• 工具用法 / 配置方法 → docs/design/ 对应文档
• Prompt 模式 / 模板 → docs/prompts/ 对应食谱
• CLAUDE.md 规则 → CLAUDE.md 或全局配置
• Skill 流程优化 → .claude/skills/ 对应 Skill
• 新的可固化流程 → 新建 Skill + 更新 doc-02

Step 5: 输出评估报告

## 外部知识评估报告

### 来源信息
- **标题**: {文章标题}
- **来源**: {URL 或来源描述}
- **日期**: {发布日期}
- **可靠性等级**: 高 / 中 / 低

### 核心要点
1. {要点 1}
2. {要点 2}
3. {要点 3}

### 五问评估
| 维度 | 评估 | 通过 |
|------|------|------|
| 可靠性 | {说明} | ✓/✗ |
| 时效性 | {说明} | ✓/✗ |
| 关联性 | {说明} | ✓/✗ |
| 增量性 | {说明} | ✓/✗ |
| 实操性 | {说明} | ✓/✗ |

### 影响评估
| 受影响文件 | 变更类型 | 变更内容摘要 |
|-----------|---------|------------|
| {文件路径} | 新增/修改 | {简述} |

### 建议操作
- [ ] {操作 1}
- [ ] {操作 2}

### 风险提示
- {与现有内容的冲突，如有}

输出报告后等待用户确认。

Step 6: 执行融合

用户确认后：

1. 按评估报告的建议操作逐项执行修改
2. 更新交叉引用（新增内容引用的其他文档、被引用文档的关联列表）
3. 更新 CHANGELOG.md，标注来源类型：

   来源：[文章吸收] {标题}（{URL}）

Step 7: 验证

1. 运行 /docaudit 检查文档体系完整性
2. 检查修改过的文件行数 ≤ 500 行
3. 运行 cd site && npm run build 验证站点构建

IMPORTANT

• 不自行决定采纳 — 评估报告输出后必须等待用户明确确认，不要自行开始融合
• 必须标注可靠性等级 — 每次评估都要给出高/中/低可靠性判断
• 冲突时明确指出 — 如果新知识与现有文档内容矛盾，在报告中突出标注并说明差异
• 部分采纳是常态 — 一篇文章可能只有部分内容值得吸收，在报告中标明哪些采纳、哪些跳过
• 融合后必须验证 — /docaudit + 行数检查 + site 构建，三项全过才算完成