Personal API Obsidian 身份层

要解决什么问题

在 Obsidian 里让 Claude、Codex 等代理「读懂你是谁、该怎么做事、知识往哪放」，往往缺少统一契约：根目录没有稳定的身份与行为文件，知识目录各写各的，代理容易越权改你的个人叙述，或把未经审阅的内容当成永久结论。

Personal API 是一套轻量路由技能：按场景读 scripts/setup.sh、模板与 references/，在指定库路径落地脚手架，而不是替你编造真实身份内容。

技能如何工作

技能约定三类核心契约：

• ME.md — 身份契约（你是谁、边界与偏好，由人填写）
• AGENT.md — 行为契约（代理在库内应如何读、写、协作）
• 30.knowledge/00.system/methodology.md — Knowledge Palace v2 知识生产轨道的操作手册

典型工作流包括：

1. 安装：在用户提供库路径时运行安装逻辑；默认创建完整 Knowledge Palace v2（含 30.knowledge/），仅当用户明确要求身份层时才用 --minimal（不创建 30.knowledge/）。
2. 填写契约：逐项解释 templates/ME.md、templates/AGENT.md 占位符，向用户索取真实信息，可参考 references/operation-boundaries.md。
3. 启动知识生产：原材料进 30.knowledge/10.capture/，整理笔记进 30.knowledge/40.notes/literature/；永久笔记与框架需人工审阅。
4. 校验与打包：发布前对照 scripts/validate_skill.py、CHANGELOG.md 等，保证版本与产物一致。

安装还会生成薄适配层 CLAUDE.md、AGENTS.md，以及 Track A 目录桩，便于不同代理入口对齐同一套规则。

适用边界

• 适用：新建 AI 可读库结构、刷新 ME/AGENT、初始化 Knowledge Palace v2、说明代理如何在库内操作、技能发布前自检。
• 不适用：代写你的真实履历、价值观或偏好；未经你明确授权，不应修改 Track A 核心身份文件。
• AI 可以讲解字段含义并给示例，个人事实必须由你本人提供。