给AI智能体定规矩Agent Client for Obsidian如何用Context Files定制专属上下文【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-clientAgent Client for Obsidian 是一款把 Claude Code、Codex、Gemini CLI 等 AI 智能体直接接入 Obsidian 的插件基于 ACPAgent Client Protocol协议与智能体通信。而Context Files上下文文件就是给这些智能体定规矩的方式一个放在库根目录的 Markdown 文件智能体每次开启新会话时都会自动读取它从而始终遵循你的写作偏好、目录约定和库结构。下面带你用 3 步定制出专属的 AI 上下文 什么是 Context Files一分钟理解原理Context Files 是存放指令、偏好或背景信息的特殊 Markdown 文件。它的作用相当于给 AI 智能体发一份入职手册✅自动生效智能体在每次会话开始时自动读取无需你手动粘贴✅持久生效写一次之后所有会话都遵循其中的规则⚠️注意这是智能体自身的功能Agent 功能而非插件功能具体行为请参照所用智能体的官方文档换句话说插件负责把智能体请进ObsidianContext Files 负责告诉它在这个库里该怎么做事。官方文档详见 docs/usage/context-files.md。哪个智能体读哪个文件对照表一次看全不同智能体使用各自专属的上下文文件这是新手最容易踩坑的地方。把文件放对位置库根目录智能体才会自动读取智能体读取的 Context FileClaude CodeCLAUDE.mdCodexAGENTS.mdGemini CLIGEMINI.mdMistral VibeAGENTS.mdOpenCodeAGENTS.md找不到时回退CLAUDE.mdKiroAGENTS.md也支持.kiro/steering/*.mdHermes AgentAGENTS.md找不到时回退CLAUDE.md 小技巧多智能体用户可以在聊天头部菜单中随时切换而每个智能体只会认自己那份文件——所以混用时建议各写一份或按主用智能体配置。本项目仓库本身就用到了这套机制根目录下的 CLAUDE.md、AGENTS.md 和 GEMINI.md 就是写给不同智能体看的开发者指南可以直接打开看看真实例子。3步写出你的第一份 Context File第 1 步在库根目录创建文件按上表为所用智能体建一个文件比如 Claude Code 用户就新建CLAUDE.md。第 2 步写入你的规矩官方推荐的经典结构是总览 → 偏好 → 重点目录 → 约定四段式# Vault Context ## Overview 本库用于存放我的个人笔记和研究资料。 ## Preferences - 使用简洁、清晰的风格写作 - 列表使用无序列表 - 优先使用 Markdown 格式 ## Important Notes - Templates/ - 笔记模板目录 - Daily/ - 每日笔记目录 ## Conventions - 日期统一使用 YYYY-MM-DD 格式 - 笔记使用相关主题标签第 3 步开启新会话验证Context Files 在会话开始时加载——修改文件后打开一个新的聊天视图即可让新规则生效。进阶玩法Context Files 与插件功能如何配合Context Files 解决长期背景插件的其它功能则补齐即时上下文两者组合威力最大 提及Note Mentions会话级补充。用引用具体笔记选中文字甚至可以精确到某几行如My Note:5-10。全局规则交给 Context File临时任务交给 提及。提示注入Prompt Injection插件可在每条会话的首条消息自动追加 Obsidian 格式化指令Wiki 链接、LaTeX 数学公式、表格空行让智能体输出Obsidian 原生味道的 Markdown。在Settings → Agent Client → Prompt injection中可按项开关任意目录对话用New chat in directory把聊天指向任意文件夹时智能体会自动加载该文件夹的上下文文件和项目配置——Context Files 的思路同样适用于代码库实现一个项目一份规矩。相关文档Mentions · Prompt Injection4个最佳实践让 AI 真正听话官方文档给出的经验法则建议直接照做保持聚焦Keep it focused—— 只写与你的库相关的内容别把 Context File 写成说明书定期更新Update regularly—— 目录结构变了就同步修改规则过时比没有更糟具体明确Be specific—— 给出真实示例和明确偏好简洁点不如回答控制在 3 行内避开这些雷区 敏感信息API 密钥、密码——上下文会随消息发给 AI 服务商 超长文件——智能体有上下文窗口限制太长会被截断 过时信息——会直接误导智能体的判断写在最后Context Files 是成本最低、见效最快的一步驯化一份几十行的 Markdown就能让 Claude Code、Codex 或 Gemini CLI 在你的 Obsidian 库里按你的规矩工作。先按对照表放对文件再套用四段式模板五分钟就能拥有一个真正懂你笔记库的 AI 智能体 完整说明请阅读 Context Files 官方文档更多功能可浏览 Usage 文档目录。【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考