academic-research-skills 使用指南：从安装到首篇论文的完整实操手册

> 一句话：这篇指南把 academic-research-skills 从"我知道它很厉害"变成"我知道怎么用"——30秒安装、首小时校准流程、29个反模式避雷清单、＄4-6 成本结构，全都有数。

---

🔥 为什么这篇指南值得单独读？

GitHub 上的 README 告诉你"有什么功能"，但这篇 tosea.ai 的指南告诉你"怎么不出错地用上这些功能"。它填补了开源项目最常见的文档缺口：官方文档写功能，社区指南写 workflow，但很少有人写 "第一小时该怎么做"。

---

⚡ 30秒安装：Plugin vs Symlink 两条路

推荐路径：Plugin 市场（30秒）

/plugin marketplace add Imbad0202/academic-research-skills
/plugin install academic-research-skills

支持 Claude Code CLI、VS Code（Claude Code 扩展）、JetBrains（Claude Code 插件）。需要 v3.7.0+。

传统路径：Git Clone + Symlink

git clone https://github.com/Imbad0202/academic-research-skills.git ~/academic-research-skills
cd /path/to/your/project
mkdir -p .claude/skills
ln -s ~/academic-research-skills/deep-research .claude/skills/deep-research
ln -s ~/academic-research-skills/academic-paper .claude/skills/academic-paper
ln -s ~/academic-research-skills/academic-paper-reviewer .claude/skills/academic-paper-reviewer
ln -s ~/academic-research-skills/academic-pipeline .claude/skills/academic-pipeline

关键约束：每个 Skill 必须位于 .claude/skills//SKILL.md 路径下，Claude Code 才能自动发现。

Codex 用户

有专门的 sibling distribution：academic-research-skills-codex，单 Skill $academic-research-suite 包含所有 ars-* 别名。

---

📋 推荐的"第一个小时"：不要上来就跑 Pipeline

这是很多新手会犯的错——安装完立刻 /pipeline "写篇论文"，然后发现输出质量不可控。正确的校准顺序：

步骤	命令	目的
1	`/ars-plan`	在你已经熟悉的主题上跑 Socratic 模式，验证系统的提问质量是否可信
2	运行 Deep Research 在一个窄子问题上	观察 Semantic Scholar 验证步骤——如果它标记某篇论文"未验证"，这就是系统在抓 LLM 会编造的东西
3	用 Reviewer Skill 审一篇你已经被人类审过的草稿	对比 AI 评审员和人类评审员的发现，这是最佳校准练习
4	理解每个独立 Skill 后，再尝试完整 Pipeline	防止把 Suite 当黑盒用

> 这个顺序的本质：先用已知检验未知，建立信任边界，再扩大使用范围。

---

🛡️ 29 个反模式 + 22 个铁律：为什么这比你想象的更重要

部分反模式示例

反模式	表现	为什么失败
从模型记忆生成文献综述	输出看似合理的引用	引入无法验证的引用，Stanford HAI 研究证实 LLM 在学术引用上幻觉率极高
总结源论文而非分析其论点	输出浅层摘要	审稿人会立刻识别出"浅层参与"
评审时修改手稿而非提建议	直接改文本	混淆作者和审稿人角色，破坏评审独立性
缺乏系统综述结构	按主题罗列而非 PRISMA	医学/健康/社会科学领域投稿直接被拒