Codex 在本 Obsidian Vault 中的工作约定

基本原则

  • 将本目录视为 Obsidian 知识库，而不是普通代码仓库。
  • 默认使用简体中文交流和写作；用户明确要求其他语言时除外。
  • 优先做小范围、可复核的修改，不主动进行大规模重命名、移动、删除或目录重构。
  • 修改 3 个以上文件，或涉及移动、重命名、删除时，先说明范围并取得用户确认。

Obsidian 格式

  • 保留并正确使用 Obsidian 语法，包括 [[Wiki Links]]、![[嵌入]]、标签、Callout 和 YAML frontmatter。
  • 创建链接前先搜索现有笔记，优先链接已有页面，避免制造重复笔记。
  • 不随意修改已有链接目标、标题、标签和 frontmatter 字段。
  • 新笔记的 frontmatter 应参考同目录最近的相似笔记；不要把整个知识库强行统一为一种旧/新格式。
  • 日期使用本机时区，格式遵循相邻笔记。仅在目标笔记本来含有 updated 字段时更新它。

目录与命名

  • 延续现有编号式目录和文件名风格；先查看目标目录中的相邻文件再命名。
  • 用户未指定归档位置的新笔记，默认放入 000 - Inbox/，不要擅自猜测长期分类。
  • 优先更新已有笔记；只有在内容主题确实独立时才新建笔记。
  • 创建 MOC/首页时，使用可点击的 Wiki-link，并检查链接目标真实存在。

安全边界

  • 除非用户明确要求，不要修改 .obsidian/、.claudian/、.claude/、.git/、插件数据、同步元数据或工作区状态文件。
  • 不读取、展示或写入凭据、令牌、Cookie、API Key 等秘密。
  • 不运行破坏性命令，不批量覆盖用户笔记。
  • 如发现已有未提交修改，保留它们，不回滚、不覆盖。

完成前检查

  • 检查 Markdown/YAML 是否完整，围栏、列表和缩进是否闭合。
  • 检查新增 Wiki-link 的目标是否存在；若目标有歧义，使用完整路径或别名。
  • 简要说明创建或修改了哪些笔记；不把工具运行日志写进笔记正文。