# Agent Knowledge Base

这个项目用来系统整理 Agent 相关知识：原理、架构、实践、项目、实验、评估和资料。

它的目标不是把所有内容一次写满，而是建立一个稳定的知识容器：新概念能放得进来，项目经验能沉淀下来，实验结论能被复现，资料阅读能转化为可执行判断。

## Navigation

- [Knowledge Map](docs/00-knowledge-map.md): 知识版图、分类方式、成熟度标签
- [Agent Principles](docs/01-agent-principles.md): 核心定义、循环模型、能力边界、设计原则
- [Architecture Patterns](docs/02-architecture-patterns.md): 常见 Agent 架构与选型判断
- [Practice Playbook](docs/03-practice-playbook.md): 从需求到上线的实践清单
- [Evaluation and Observability](docs/04-evaluation-observability.md): 评估体系、指标、日志和回归
- [Glossary](docs/99-glossary.md): 统一术语表
- [Projects](projects/README.md): 项目目录、项目记录和复盘
- [Experiments](experiments/README.md): 实验台账、假设、结果和决策
- [References](references/README.md): 论文、文章、开源项目和课程资料
- [Templates](templates/): 概念笔记、项目记录、实验记录、论文笔记模板

## Operating Rules

1. 每条知识都要回答一个明确问题。
2. 区分事实、经验判断和待验证假设。
3. 项目记录要保留上下文、架构、失败点、评估结果和复盘。
4. 实验记录要能复现：假设、变量、数据、步骤、指标、结果都要写清楚。
5. 资料阅读要转化为可执行结论：什么时候适用，什么时候不要用。
6. 术语新增或改名时，同步更新 [Glossary](docs/99-glossary.md)。

## Suggested Workflow

1. 看到一个新概念：用 [concept-note](templates/concept-note.md) 写成一页短笔记。
2. 做一个新项目：从 [project-brief](templates/project-brief.md) 开始。
3. 验证一个想法：用 [experiment-note](templates/experiment-note.md) 记录假设和结果。
4. 读一篇论文或文章：用 [paper-note](templates/paper-note.md) 提炼可迁移结论。
5. 有稳定结论后，把它合并到 `docs/` 的对应主题页。

## Status Labels

- `seed`: 初始想法或待整理材料
- `wip`: 正在验证或补充
- `validated`: 有项目、实验或可靠资料支撑
- `deprecated`: 已不推荐使用，但保留原因和替代方案