Agent Operating Contract

本文件是所有 Agent 读取知识库的第一入口。每次写入前必读，写入后必遵守。

🧭 核心原则

Vault 是唯一真相源：所有 Agent 经验、决策记录、项目知识都在这里，不依赖记忆
写入前先搜索：用 search_files 查重，发现相关内容则更新/追加，不创建重复文件
渐进式组织：先丢 00-Inbox/，定期整理到正确位置，不要求一步到位
链接优先：每条知识至少链接到一个现有笔记，形成知识图谱
状态可追踪：用 frontmatter 标记 status，让知识可演进、可过期

📁 目录结构

目录	用途	示例
`00-Inbox/`	快速捕获区，未分类内容	Agent 临时输出、待处理信息
`10-Projects/`	有明确目标和截止日期的活跃项目	`水翼智能艇/`、`CRM部署/`
`20-Areas/`	持续关注的责任领域	`fleet-management/`、`feishu-ops/`
`30-Resources/`	参考资料、技术文档、最佳实践	`API参考/`、`工具评测/`
`40-Archive/`	已完成/搁置的项目和资料	永不删除，只归档

📝 命名规范

文件名：使用英文或中文均可，但同一项目内保持一致
项目笔记：YYYY-MM-DD_标题.md 或直接用 标题.md
决策记录：ADR-NNN_决策标题.md（如 ADR-001_选择SQLite作为CRM存储.md）
经验教训：YYYY-MM-DD_经验关键词.md

🏷️ Frontmatter 模板

每条 processed note 必须包含：

---
title: "笔记标题"
date: 2026-04-30
type: experience | decision | reference | project-note | daily-log
status: draft | confirmed | deprecated
tags: [tag1, tag2]
source: "URL或来源说明"
---

🔄 知识流转规则

捕获 → 丢入 00-Inbox/（快速，不纠结分类）
处理 → 从 Inbox 移到正确目录，添加 frontmatter 和 wikilinks
链接 → 更新 index.md，确保新笔记被索引
演进 → 状态从 draft → confirmed，过时则标记 deprecated
归档 → 项目完成后移入 40-Archive/

⛔ 禁止事项

❌ 不创建无 frontmatter 的笔记（Inbox 除外）
❌ 不修改 AGENTS.md、index.md 以外的 System 文件
❌ 不删除任何文件，只标记 deprecated 或移入 Archive
❌ 不在一个笔记中混合多个主题（保持单一职责）
❌ 不写入测试数据到生产知识库

🔗 Wikilink 使用

用 [[笔记名]] 语法关联笔记，例如：

提到某个项目时：[[水翼智能艇]]
引用某个决策时：[[ADR-001_选择SQLite作为CRM存储]]
关联某个经验时：[[2026-04-30_Feishu API限频处理]]

🤖 多 Agent 协作规则

详细协议见：03-multi-agent-protocol、04-knowledge-evolution、05-conflict-resolution

写入前检查

查重 → search_files 搜索关键词
检查意图 → 00-Inbox/intents/ 是否有其他 Agent 正在修改
确认领域 → 这是你的专业领域吗？跨领域需标记 #cross-domain
评估置信度 → 你对这个知识的 confidence 是多少？(0.0-1.0)

Frontmatter 扩展（多 Agent）

---
title: "笔记标题"
date: 2026-04-30
type: experience | decision | reference | project-note
status: draft | confirmed | deprecated
confidence: 0.8  # 置信度 (0.0-1.0)
agent: "your-agent-id"
domain: "your-domain"  # 是否匹配你的专业领域
tags: [tag1, tag2]
created_by: "agent-id"
created_at: "2026-04-30T09:00:00Z"
---

冲突处理

发现矛盾 → 创建 冲突_主题 笔记，链接矛盾方
不直接删除/覆盖他人笔记
通过证据竞争，高分方案胜出

专业领域

supply: 规划、调度、资源配置
research: 情报分析、技术调研
data: 数据分析、代码、技术设计
跨领域写入 → 置信度衰减，需标记

📊 质量检查清单

写入前自检：

文件放在正确目录了吗？
Frontmatter 完整吗？（含 confidence, agent, domain）
至少有一个 wikilink 指向现有笔记吗？
内容是否单一主题？
是否已搜索查重？
是否检查了其他 Agent 的意图？
置信度评估合理吗？

Last updated: 2026-05-01 14:27:39