AI-Brain/AGENTS.md

AI-Brain Agent Rules

本文件定义 AI Agent 对知识库的默认读取和写入约定。

读取顺序

1. 先读取根目录 README.md，理解知识库用途和目录语义。
2. 再读取 INDEX.md，定位主题入口。
3. 进入目标目录后，优先读取该目录的 README.md。
4. 根据笔记的 related 字段和 [[内部链接]] 扩展上下文。
5. 回答或生成内容时保留来源文件路径，避免失去可追溯性。

写入规则

1. 无法立即归类的信息先写入 00_Inbox。
2. 一篇知识笔记只描述一个核心主题。
3. 文件名采用清晰、稳定、可搜索的概念名称。
4. 知识笔记必须包含统一 YAML Frontmatter。
5. 正文修改后同步更新 updated 日期。
6. 新建、移动或归档笔记后更新对应索引。
7. 使用 [[笔记名称]] 表达知识关系，不只依赖文件夹。
8. 未验证的信息明确标注“待验证”，不得写成确定事实。
9. 不无理由删除既有知识；失效内容优先移动到 99_Archive。
10. 不写入密码、Token、API Key 或其他秘密信息。

Frontmatter 规范

---
title: 笔记标题
type: concept
domain: 所属领域
status: seed
tags: []
created: YYYY-MM-DD
updated: YYYY-MM-DD
aliases: []
related: []
source: []
---

允许的 status：seed、growing、evergreen、archived。

常用的 type：concept、project、case、material、daily、index。

内容质量规则

• 开头提供“一句话定义”或“今日摘要”。
• 标题层级连续，避免跳级。
• 重要结论写在正文中，不能只存在于标签或图片中。
• 外部信息尽量记录标题、作者、日期和链接。
• 内容过长或包含多个独立主题时，拆分为原子笔记并相互链接。