Skills 文件结构

~/.claude/skills/   # 全局 Skills
project/.claude/skills/  # 项目级 Skills

24 Skills 5 大类

• 阅读与笔记 (6) — latex-notes, skim-jump...
• 研究与引用 (4) — gs-search, paper-refs...
• 图表提取 (4) — pdf-figure, figure...
• 写作与模板 (4) — beamer, homework...
• 开发与AI (6) — slides, git, latex...

Skills 调用方式

/skill-name        # 触发 Skill
/skim-jump        # PDF 双向联动
/gs-search        # Google Scholar
/latex-debug      # LaTeX 调试

核心功能

• 跨会话持久 — 关闭后重启仍保留
• 项目进度 — 记录当前阅读位置
• 经验教训 — 错误记录避免重复
• 符号约定 — 统一文献符号

数据结构

{
  "project": "因果推断",
  "progress": "第3章 / 18章",
  "lessons": ["符号混淆问题"],
  "conventions": {
    "potential_outcome": "Y_i(1)"
  }
}

核心功能

• 提示词引擎 — 每次会话自动加载
• 写作风格 — Stein 风格 motivation
• 符号约定 — 数学符号规范化
• 规范规则 — LaTeX/Git/引用

示例规则

期望：\mathbb{E}X
概率：\mathbb{P}(A)
独立性：A \Perp B

% 用户注解命令
\newcommand{\userannotation}[2]{%
  \begin{trivlist}
    \item[\textbf{用户注解:}] #1
    \textit{#2}
  \end{trivlist}
}

% 定义环境禁止使用 itemize！
\begin{Definition}[完全随机实验]
设有 $n$ 个样本，其中 $n_1$ 个被分配到治疗组...
\end{Definition}

# Skim displayline 跳转命令
/Applications/Skim.app/Contents/SharedSupport/displayline \
  -r -g [行号] "[PDF路径]" "[TeX源文件]"

# 示例：跳转到第 584 行
/Applications/Skim.app/Contents/SharedSupport/displayline \
  -r -g 584 "notes.pdf" "chapters/chapter1.tex"

{
  "book": "A First Course in Causal Inference",
  "current_position": {
    "chapter": 3,
    "section": 2,
    "page": 45
  },
  "questions": [
    {
      "date": "2026-03-22",
      "chapter": 3,
      "question": "为什么需要引入潜在结果？"
    }
  ]
}

# 每次问答后的自动 Git 提交
git add notes/ .claude/skills/reading-progress/progress.json
git commit -m "QA: 第3章 - 潜在结果定义"

# 或使用脚本
./scripts/commit_notes.sh "更新讲义"

# 创建笔记
obsidian create name="新笔记" content="# Hello"

# 搜索笔记
obsidian search query="因果推断" limit=10

# 追加内容
obsidian append file="笔记名" content="新行内容"

# 管理任务
obsidian tasks daily todo

notes/<主题>/
├── <主题>-notes.tex  # 主文件
├── compile.sh        # 编译脚本
├── references.bib    # BibTeX
├── chapters/
│   ├── chapter0.tex  # 文献概述
│   └── chapter1.tex  # 第一章
└── appendix/
    └── qa.tex        # 问答记录

// Google Scholar DOM 抓取
const items = document.querySelectorAll('#gs_res_ccl .gs_r.gs_or');
const results = Array.from(items).map(item => ({
  title: item.querySelector('.gs_rt a')?.textContent,
  authors: item.querySelector('.gs_a')?.textContent,
  citedBy: item.querySelector('.gs_fl a[href*="cites"]')
    ?.textContent.match(/\d+/)?.[0] || '0'
}));

# 使用方法
python paper_references_generator.py 

# CrossRef API 查询
https://api.crossref.org/works?query=<关键词>

# 输出 BibTeX
@article{author2023,
  author = {Author, First},
  title = {Paper Title},
  year = {2023},
  doi = {10.xxx/xxx}
}

# 扫描文献库
/文献引用管理器 bayesian

# 生成引用库
/文献引用管理器 bayesian --generate-bib

# 处理指定文献
/文献引用管理器 PDFs/bayesian/textbook/Book.pdf

from scripts.citation_generator import CitationGenerator

gen = CitationGenerator(style='apa')
citation = gen.cite_book(
    authors=["Smith, John", "Doe, Jane"],
    title="Research Methods",
    year=2020,
    publisher="Academic Press"
)
print(citation)
# Output: Smith, J., & Doe, J. (2020). Research methods. Academic Press.

# 快速提取 Chapter 2 figures
uv run figure_extractor.py --chapter 2

# 强制重刷
uv run figure_extractor.py --chapter 2 --force

# 仅裁剪模式
uv run figure_extractor.py --chapter 2 --crop-only

# Gemini 边界框识别
PROMPT = f"""看这张教材原图，找出以下 figures 的精确位置：
Figure: Figure X-Y
Bounding Box: x1=0.XX, y1=0.XX, x2=0.XX, y2=0.XX

规则：
- 坐标以图片整体宽高为基准，0.00 ~ 1.00
- 必须包含完整的图注文字
- 四周留 0.02 边距"""

# 裁剪保存
crop = img.crop((int(W * x1), int(H * y1), int(W * x2), int(H * y2)))
crop.save(f"fig_{figure_id}.png", quality=95)

# 分析本地图片
echo "请详细描述这张图片的所有内容" | gemini /path/to/image.png

# 分析网络图片
gemini "https://example.com/image.png"

# 命令行分析
python3 ~/.claude/skills/minimax-vision/analyze.py /path/to/image.png

# 自定义问题
python3 ~/.claude/skills/minimax-vision/analyze.py \
  /path/to/image.png "这张图片有什么特别之处？"

\documentclass[]{beamer}
\usetheme{CambridgeUS}
\usepackage{xeCJK}
\setCJKmainfont{Source Han Serif SC}

\begin{document}
\maketitle
\section{Section Name}
\begin{frame}
  \begin{block}{Block Title}content\end{block}
  \begin{alertblock}{Alert}important\end{alertblock}
\end{frame}
\end{document}

> [!exr] Problem 3.1
> **Section 3.2** — *Randomized Block Design*
>
> 完整习题内容...

> [!example] Referenced Background: Section 2.5
> 被引用的背景内容

> [!note] Data Information
> 数据变量说明...

\chapter*{引言：文献概述}\label{chap:introduction}
\addcontentsline{toc}{chapter}{引言：文献概述}

\section{总述}
介绍学习该主题的背景、意义和研究动机。

\section{文献摘要总结}
\subsection{论文标题}
\begin{enumerate}
    \item \textbf{作者:} 作者姓名
    \item \textbf{链接:} \url{https://arxiv.org/abs/xxxx}
    \item \textbf{核心贡献:}
\end{enumerate}

# 检查 label 定义
grep -nE '\\\\label\{[^}]+\}' notes.tex | grep -v '^(eq:|rem:)'

# 检查 cref 引用
grep -nE '\\\\cref\{[^}]+\}' notes.tex

# 对照原论文验证编号
# Theorem 1.1 → label{def:thm:11}

<!-- 单文件 HTML 演示 -->
<section class="slide" data-slide="1">
  <h1>标题</h1>
  <p class="reveal">渐入内容</p>
</section>

<style>
.slide { height: 100vh; overflow: hidden; }
.reveal { animation: fadeIn 1s ease-out; }
</style>

# 自动提交流程
git status --short
git add -A
git commit -m "更新讲义

Co-Authored-By: Claude Opus 4.6 "
git push origin main

# 提取所有 label 定义
grep -nE '\\\\label\{[^}]+\}' <笔记文件>

# 提取所有 cref 引用
grep -nE '\\\\cref\{[^}]+\}' <笔记文件>

# 对照原论文检查编号一致性

# 编译检测
xelatex -interaction=nonstopmode main.tex

# 常见错误处理：
# - Undefined reference → 检查 label
# - Missing $ → 检查公式
# - Extra } → 检查括号配对

# 每次修复后提交
git add -A && git commit -m "fix: 修复 LaTeX 错误"

// Playwright MCP 工作流
browser_navigate("https://gemini.google.com")

// 找到输入框
browser_type(element: "question input",
  ref: "e350",
  text: "Solve: 复杂数学问题",
  submit: true)

// 等待响应
browser_wait_for(text: "Gemini said", time: 15)

library(dplyr)
library(ggplot2)

# 数据处理
df %>%
  filter(age > 28) %>%
  select(name, age, salary) %>%
  mutate(salary_bonus = salary * 1.1) %>%
  ggplot(aes(x = age, y = salary)) +
  geom_point() +
  geom_smooth(method = "lm")

# 统计检验
t.test(salary ~ group, data = df)