메뉴
配置同步元技能 —— 同步 CLAUDE.md ↔ AGENTS.md 的规则一致性，以及 .claude/ ↔ .agents/ 目录的文件一致性。支持 dry-run 预览、冲突检测与解决。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | sync-config |
| description | 配置同步元技能 —— 同步 CLAUDE.md ↔ AGENTS.md 的规则一致性，以及 .claude/ ↔ .agents/ 目录的文件一致性。支持 dry-run 预览、冲突检测与解决。 |
你是一名 vault 配置同步专家。你的职责是确保本 Obsidian research vault 的两套并行配置系统保持一致：
CLAUDE.md（英文简明风格）与 AGENTS.md（中文详述风格）之间的规则一致性——不是逐行复制，而是确保两份文件表达的规则、约定和禁令完全一致。.claude/ 与 .agents/ 之间的文件一致性——双向比较，内容更丰富、更完整的一方胜出。核心原则：
CLAUDE.md 和 AGENTS.md 在风格上有意不同（英文简明 vs 中文详述），但表达的规则必须一致。当用户说以下任意一种话时，激活本技能：
/sync-configCLAUDE.md 全文。AGENTS.md 全文。.claude/ 目录树（ls -laR .claude/skills/ .claude/memory/），列出所有文件及其大小和修改时间。.agents/ 目录树（ls -laR .agents/skills/ .agents/memory/），列出所有文件及其大小和修改时间。将 CLAUDE.md 和 AGENTS.md 按语义段落拆分，逐段比较规则是否一致。
对每个语义段落（共 25 条，见 §3.3），提取两个文件中的规则声明（即含"必须"/"禁止"/"推荐"/"铁律"/"must"/"never"/"required"/"prohibited"等约束性语句），忽略风格差异和措辞差异，只检查：
按 §3.1 文件映射表，逐对比较 .claude/ 与 .agents/ 的对应文件。
对每对文件，分类为：
| 状态 | 判定条件 |
|---|---|
| IDENTICAL | 文件内容完全相同（字节级） |
| DRIFTED | 文件存在但内容不同 |
| MISSING_IN_AGENTS | 存在于 .claude/ 但不存在于 .agents/ |
| MISSING_IN_CLAUDE | 存在于 .agents/ 但不存在于 .claude/ |
| NAMING_MISMATCH | 同一逻辑文件在两侧使用不同文件名 |
用 diff 或文件大小 + 修改时间比较。对于大小不同的文件，用 diff 确认实际差异。
将 Step 1 和 Step 2 的结果汇总为结构化报告，不做任何修改，展示给用户确认。
报告格式：
═══════════════════════════════════════════
SYNC-CONFIG DRY-RUN REPORT
日期：YYYY-MM-DD HH:MM
═══════════════════════════════════════════
📋 一、根文件规则一致性 (CLAUDE.md ↔ AGENTS.md)
✅ 一致的规则：N 条
[列出规则主题]
⚠️ 存在漂移的规则：N 条
[对每条漂移规则，列出两个文件中的差异摘要]
🆕 仅存在于 CLAUDE.md 的规则：N 条
[列出]
🆕 仅存在于 AGENTS.md 的规则：N 条
[列出]
📁 二、目录同步（双向比较）
✅ 已同步（IDENTICAL）：N 个文件
[列出路径]
⚠️ 内容漂移（DRIFTED）：N 个文件
[列出路径，附大小差异，标注哪方更丰富]
📝 文件名不一致（NAMING_MISMATCH）：N 个
[列出两侧路径及建议统一名称]
🆕 仅在 .claude/ 中（MISSING_IN_AGENTS）：N 个
[列出路径]
🆕 仅在 .agents/ 中（MISSING_IN_CLAUDE）：N 个
[列出路径]
🔧 三、建议操作
[对每个需要同步的项目，列出具体操作建议]
═══════════════════════════════════════════
请确认是否执行上述操作（全部 / 部分 / 取消）
═══════════════════════════════════════════
用户确认后，按以下策略执行。必须等待用户明确回复"执行"/"全部同步"/"确认"后才能写入任何文件。
规则：内容更丰富的一方胜出。
对每个映射文件对，双向比较：
| 情况 | 操作 |
|---|---|
| 两边都存在且内容相同 | 跳过 |
| 一边不存在，另一边存在 | 从存在的一方复制到缺失的一方 |
| 两边都存在但内容不同 | 比较内容丰富度：行数、规则声明数量、示例数量、边界条件覆盖。更丰富的一方胜出，覆盖另一方。难以判定时暂停让用户选择。 |
文件名不一致（如 SKILL.md vs skill.md） | 统一为 SKILL.md（全大写），内容以更丰富的一方为准 |
独有文件处理：
| 情况 | 操作 |
|---|---|
仅存在于 .agents/ | 报告，不自动删除，提示用户决定 |
仅存在于 .claude/ | 报告，不自动删除，提示用户决定 |
.claude/ 中的空目录（agents/, commands/） | 不同步到 .agents/，这些是 Claude Code 特有的 |
规则：不是逐行复制，而是语义同步。
对每个检测到的规则漂移：
| 漂移类型 | 操作 |
|---|---|
| CLAUDE.md 有但 AGENTS.md 没有的规则 | 将规则以中文风格追加到 AGENTS.md 对应段落 |
| AGENTS.md 有但 CLAUDE.md 没有的规则 | 将规则以英文简明风格追加到 CLAUDE.md 对应段落 |
| 两文件同一规则内容矛盾 | 暂停，向用户展示两个版本，请用户选择，然后更新另一个 |
| Skills 表中的路径/触发词不一致 | 统一为最新实际存在的文件路径和触发词（取两边并集） |
写入风格约定：
CLAUDE.md：英文标题、简明条目、快速参考风格AGENTS.md：中文标题、详述说明、含示例风格同步完成后：
CLAUDE.md 和 AGENTS.md，检查此前漂移的规则是否现在一致。.agents/ 中是否有残留的旧文件名（如 skill.md 已被重命名为 SKILL.md 后，原文件应不存在）。✅ 同步完成
📁 目录同步结果：
· 已复制：N 个文件
· 已覆盖：N 个文件
· 已重命名：N 个文件
· 跳过（已相同）：N 个文件
📋 根文件同步结果：
· 已更新 AGENTS.md：N 处规则
· 已更新 CLAUDE.md：N 处规则
· 需要用户手动处理的矛盾：N 处
⚠️ 待用户决定：
· [列出 .agents/ 中独有的文件]
.claude/ 路径 | .agents/ 路径 | 备注 |
|---|---|---|
memory/user_profile.json | memory/user_profile.json | 同名 |
skills/sync-config/SKILL.md | skills/sync-config/SKILL.md | 同名（本技能自身） |
skills/daily-research/SKILL.md | skills/daily-research/SKILL.md | ⚠️ .agents/ 中旧名为 skill.md |
skills/learning-path/SKILL.md | skills/learning-path/SKILL.md | 同名 |
skills/literature_handout/SKILL.md | skills/literature_handout/SKILL.md | 同名 |
skills/literature_handout/references/vault-inventory.md | skills/literature_handout/references/vault-inventory.md | 同名 |
skills/zotero-notes/SKILL.md | skills/zotero-notes/SKILL.md | 同名 |
标准文件名约定：所有技能定义文件统一使用 SKILL.md（全大写）。历史遗留的 skill.md（小写）应重命名为 SKILL.md。
.claude/ .agents/
├── memory/ ├── memory/
│ └── user_profile.json ↔ │ └── user_profile.json
├── skills/ ├── skills/
│ ├── sync-config/ │ ├── sync-config/
│ │ └── SKILL.md ↔ │ │ └── SKILL.md
│ ├── daily-research/ │ ├── daily-research/
│ │ └── SKILL.md ↔ │ │ └── SKILL.md (原 skill.md)
│ ├── learning-path/ │ ├── learning-path/
│ │ └── SKILL.md ↔ │ │ └── SKILL.md
│ ├── literature_handout/ │ ├── literature_handout/
│ │ ├── SKILL.md ↔ │ │ ├── SKILL.md
│ │ └── references/ │ │ └── references/
│ │ └── vault-inventory.md ↔ │ └── vault-inventory.md
│ └── zotero-notes/ │ └── zotero-notes/
│ └── SKILL.md ↔ │ └── SKILL.md
├── agents/ (Claude Code 特有) │
├── commands/ (Claude Code 特有) │
根文件同步不是结构对齐，而是语义对齐。以下列出需要保持一致的规则主题，不要求段落顺序或标题文字相同：
| ID | 规则主题 | CLAUDE.md 参考位置 | AGENTS.md 参考位置 |
|---|---|---|---|
| R01 | Vault 结构表 | ### Vault Structure | ## Vault 结构 |
| R02 | 文件命名规则 | ### Naming & Syntax Rules | ## 文件命名规则 |
| R03 | Wiki-link 基本语法 | ### Naming & Syntax Rules | ## Obsidian 双链 |
| R04 | Wiki-link 表格转义 | ### Naming & Syntax Rules | ### Markdown 表格中的双链转义 |
| R05 | Block Reference 语法 | ### Naming & Syntax Rules | ### 嵌入块（Block Reference） |
| R06 | Block Reference 区间语义 | ### Naming & Syntax Rules | ### 学习进度 Block Reference 的区间语义 |
| R07 | 章节链接语法 | ### Naming & Syntax Rules | ### 链接到具体章节 |
| R08 | Embed/Transclusion 语法 | ### Embed 语法 | ### 嵌入笔记（Transclusion） |
| R09 | 双链策略（双向链接要求） | ### Bidirectional Linking | ## 双链策略 |
| R10 | LaTeX 规范 | ### Naming & Syntax Rules | ## 知识点笔记内容规范 |
| R11 | LaTeX 表格铁律（\vert 替代） | ### Naming & Syntax Rules | （检查是否缺失） |
| R12 | YAML Frontmatter 字段规范 | ### YAML Frontmatter (Required) | ## YAML Frontmatter / Obsidian Properties |
| R13 | 知识笔记内容结构 | ### Knowledge Note Structure | ## 知识点笔记内容规范 |
| R14 | 可读性标准 | ### 可读性标准 | ### 可读性标准 |
| R15 | 语言与编码规则 | ### 语言与编码规则 | ### 语言与编码铁律 |
| R16 | Callout 类型表 | ### Obsidian Callouts | ## Obsidian Callouts |
| R17 | 知识点成熟度状态表 | ### 知识点成熟度 | ## 知识点成熟度 |
| R18 | 理解程度状态表 | ### 理解程度 | ## 理解程度 |
| R19 | Comprehension AI 禁令 | ### 理解程度 中 | ## 理解程度 中 |
| R20 | Python 图表规则 | ### Python Plotting Rules | ## Python 图表 |
| R21 | Interactive HTML / iframe | ### Interactive HTML / iframe | ## Interactive HTML / iframe |
| R22 | 更新记录格式 | ### 更新记录 | ## 更新记录 |
| R23 | Skills 表（含路径和触发词） | ### Available Skills | ## Custom Skills |
| R24 | Literature Note 段落结构 | ### Literature Note Sections | ## Literature Note Workflow |
| R25 | Agent Memory 与 User Profile | ## Agent Memory & User Profile | ## 🧠 智能体长期记忆与用户画像 |
| 冲突类型 | 策略 |
|---|---|
| 同一文件两边内容不同 | 内容更丰富的一方胜出（比较行数、规则详尽度、示例覆盖）。难以判定时暂停让用户选择 |
| 文件名大小写不一致 | 统一为 SKILL.md（全大写，vault 标准约定） |
| 仅存在于某一边的文件 | 报告，不自动删除，让用户决定 |
| 冲突类型 | 策略 |
|---|---|
| 同一规则在两个文件中表达矛盾 | 暂停，向用户展示两个版本，请用户选择 |
| 一个文件有新规则，另一个没有 | 自动补充到缺失的文件（按各自风格） |
| Skills 表中的路径不一致 | 以两边实际存在的文件路径为准（检查磁盘上的真实文件） |
| Skills 表中的触发词不一致 | 合并两边的触发词（取并集） |
以下文件/目录绝不同步：
Rydberg atom/*.md）Literature/*.md）Daily Notes/*.md）Handout by AI/*.md）tools/*）Learning-Roadmap.md（由 learning-path 技能管理）.claude/agents/ 和 .claude/commands/（Claude Code 特有空目录）同步完成后，逐项验证：
.agents/memory/user_profile.json 与 .claude/memory/user_profile.json 内容完全一致.agents/skills/*/SKILL.md 与 .claude/skills/*/SKILL.md 一一对应且内容一致.agents/skills/daily-research/ 中不存在旧的 skill.md（已重命名为 SKILL.md）CLAUDE.md 和 AGENTS.md 中的 Skills 表路径和触发词一致CLAUDE.md 和 AGENTS.md 中的 Vault 结构表一致CLAUDE.md 和 AGENTS.md 中的 YAML Frontmatter 字段列表一致CLAUDE.md 和 AGENTS.md 中的 Comprehension AI 禁令措辞一致| 关联技能 | 协作方式 |
|---|---|
| 所有技能 | 本技能同步所有其它技能的 SKILL.md 定义文件 |
| update-config | 本技能同步配置文件内容；update-config 负责 hooks / permissions / settings.json 级别的配置 |
| learning-path | learning-path 读取 .agents/memory/user_profile.json；本技能确保该文件在两侧一致 |
/sync-config 或类似触发词。CLAUDE.md 或 AGENTS.md 中的任何规则后，应运行本技能。.agents/ 和 .claude/ 同步。如果 vault 中新增了需要同步的文件或规则：
.claude/ 为权威源"的假设，改为双向比较、内容更丰富的一方胜出科研日常追踪技能（总结 + 规划）—— 扫描 Literature/ 与 Rydberg atom/，总结学习进展并规划当日学习任务，写入 Daily Notes/。
知识笔记/讲义文档质量审查与增强技能 —— 对 Rydberg atom/ 知识笔记或 Handout by AI/ 讲义文档进行系统性审查，补全 wiki-link、生成/修复 Python 图表、检查 YAML/LaTeX/Callout/命名等格式合规性，严格遵循 CLAUDE.md 规范。 Also audits Interactive HTML/iframe encoding/rendering issues such as `? pulse` and `?1`.
从学术论文生成结构化中文讲义（markdown），存放在 Obsidian vault 中，纯 Obsidian 原生导航（[[#Heading]]）。触发条件：用户提供论文（arXiv URL / PDF / 标题），要求生成讲义 / 写讲义 / 读论文写讲义 / 生成 handout。
Zotero 文献笔记处理技能 —— 从 Zotero 导入的论文笔记中提取批注、生成知识笔记、建立双向链接。
学习路径追踪与规划技能 —— 扫描 Rydberg atom/ 知识笔记的 comprehension 字段和 canonical dependency graph，增补/维护个性化学习路线图与进度可视化。