---
id: EPIC-0003
type: epic
status: closed
stage: done
title: 可控外部知识摄入 (Controlled Knowledge Ingestion)
created_at: '2026-01-12T00:00:00'
updated_at: '2026-01-15T13:38:00'
closed_at: '2026-01-15T13:38:00'
solution: implemented
dependencies: []
related: []
domains: []
tags:
- '#EPIC-0003'
- agent-native
- knowledge
- spike
progress: 1/1
files_count: 0
uid: 462e89
---

## EPIC-0003: 可控外部知识摄入 (Controlled Knowledge Ingestion)

## 目标 (Objective)

为 Agent 提供一种安全、确定性且可引用的方式来摄入外部知识 (Repos)。目前专注于通过 Git 仓库形式摄入确定性参考资料。

## 概念: Spike (探针)

Spike 原意为敏捷开发中的“探针任务”。在 Monoco 中，我们将 Spike 定义为**“对外部知识的切片引用”**。

1. **确定性**: 每个 Spike 都是本地 `.references/` 目录下的一个文件，Agent 读取的是固化的本地副本，而非易变的互联网内容。
2. **可引用**: 通过 `[[SPIKE-001]]` 引用知识，就像引用代码一样。

## 关键交付 (Key Deliverables)

1. **Spike CLI (`monoco spike`)**:
   - `add <url>`: 下载 URL 内容 (Git Repo)。
   - `list`: 列出已有知识。
   - `read <id>`: 读取知识内容。
2. **知识引用一致性**: 确保 Spike ID 在本地可被正确解析。

## 子故事 (Child Features)

- [x] [[FEAT-0004]]: Spike 基础管理 (Add/List/Read) (Done)
- [x] [[FEAT-0069]]: Spike 内容清洗与元数据增强 (Cancelled - 简化为仅支持 Git 仓库)

## Review Comments

- [x] Self-Review
