Menu
配置同步元技能 —— 同步 CLAUDE.md ↔ AGENTS.md 的规则一致性，以及 .claude/ ↔ .agents/ 目录的文件一致性。支持 dry-run 预览、冲突检测与解决。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
科研日常追踪技能（总结 + 规划）—— 扫描 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，增补/维护个性化学习路线图与进度可视化。
| 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/ 为权威源"的假设，改为双向比较、内容更丰富的一方胜出