288 lines
14 KiB
Markdown
288 lines
14 KiB
Markdown
# 文档润色 Agent 与 Claude Scholar 学术插件快速索引
|
||
|
||
问题开始时间：2026-06-11-03-26-41
|
||
|
||
资料来源：
|
||
- GitHub 仓库：<https://github.com/Galaxy-Dawn/claude-scholar>
|
||
- 本地下载目录：`文档润色流和知识库构建流/claude-scholar`
|
||
- 本次核对的 GitHub HEAD：`34d0cdb48a03080c7243841e19ff03ef30967d97`
|
||
- 重点阅读文件：`README.zh-CN.md`、`CLAUDE.zh-CN.md`、`MCP_SETUP.zh-CN.md`、`OBSIDIAN_SETUP.zh-CN.md`、`agents/*.md`、`skills/*/SKILL.md`、`commands/*.md`、`rules/*.md`
|
||
|
||
## 1. 总体定位
|
||
|
||
`claude-scholar` 是面向学术研究和软件开发的半自动研究助手插件。它的核心路线是：
|
||
|
||
```text
|
||
问题 -> 证据 -> 实验 -> 分析 -> 论断 -> 写作
|
||
```
|
||
|
||
它不负责替代研究者做最终判断，而是把文献整理、证据台账、项目知识库、论文或标书写作、引用核验、审稿回复、结果分析等重复但高要求的环节结构化。
|
||
|
||
对“文档润色流”的价值主要有五点：
|
||
- 把模糊主题拆成研究问题、证据需求、假设和下一步动作；
|
||
- 用 Zotero 和 Obsidian 把资料沉淀成可追溯知识库；
|
||
- 用 claim-evidence gate 防止无证据论断进入正式文本；
|
||
- 用 paper-miner、writing-anti-ai、nature-polishing 等技能辅助润色；
|
||
- 用 paper-self-review、citation-verification 做提交前自审。
|
||
|
||
## 2. 安装与使用入口
|
||
|
||
### 2.1 完整安装
|
||
|
||
```bash
|
||
git clone https://github.com/Galaxy-Dawn/claude-scholar.git /tmp/claude-scholar
|
||
bash /tmp/claude-scholar/scripts/setup.sh
|
||
```
|
||
|
||
说明：
|
||
- `main` 分支面向 Claude Code；
|
||
- Codex CLI 应参考仓库的 `codex` 分支；
|
||
- Kimi Code CLI 和 OpenCode 也分别有对应分支；
|
||
- 完整安装会安装 skills、commands、agents、rules、hooks 等组件，并尽量保留用户已有配置。
|
||
|
||
### 2.2 插件市场安装
|
||
|
||
```text
|
||
/plugin marketplace add Galaxy-Dawn/claude-scholar
|
||
/plugin install claude-scholar@claude-scholar
|
||
```
|
||
|
||
注意：
|
||
- 插件市场会加载 skills、commands、agents 和 hooks；
|
||
- `rules/` 需要手动复制；
|
||
- 插件不会自动合并已有 `CLAUDE.md` 或自动配置 `settings.json`；
|
||
- Zotero MCP、Obsidian vault 等外部集成仍需手动配置。
|
||
|
||
### 2.3 手动选择性安装
|
||
|
||
适合只需要文档润色与学术写作能力时：
|
||
|
||
```bash
|
||
cp -r /tmp/claude-scholar/skills/research-ideation ~/.claude/skills/
|
||
cp -r /tmp/claude-scholar/skills/ml-paper-writing ~/.claude/skills/
|
||
cp -r /tmp/claude-scholar/skills/citation-verification ~/.claude/skills/
|
||
cp -r /tmp/claude-scholar/skills/writing-anti-ai ~/.claude/skills/
|
||
cp -r /tmp/claude-scholar/skills/paper-self-review ~/.claude/skills/
|
||
cp -r /tmp/claude-scholar/skills/doc-coauthoring ~/.claude/skills/
|
||
cp /tmp/claude-scholar/agents/paper-miner.md ~/.claude/agents/
|
||
cp /tmp/claude-scholar/agents/literature-reviewer.md ~/.claude/agents/
|
||
```
|
||
|
||
## 3. Agent 快速索引
|
||
|
||
Agent 通常由 Claude Code 根据触发描述自动调度。用户侧最稳妥的调用方式是自然语言明确说明任务，或使用相应 slash command 间接触发。
|
||
|
||
| Agent | 主要功能 | 何时使用 | 典型调用 |
|
||
|---|---|---|---|
|
||
| `literature-reviewer` | 检索论文、导入 Zotero、创建主题 collection、读取全文、综合文献、识别 research gap | 新研究主题、文献综述、研究空白分析、proposal 前期 | “请围绕 X 做系统文献综述”；`/research-init "topic" focused both`；`/zotero-review "collection" deep` |
|
||
| `paper-miner` | 从 PDF、DOCX、arXiv 或论文网页中提炼写作模式、段落结构、venue-specific signals、rebuttal 策略 | 学习优秀论文、获批标书、Nature/NeurIPS 写法 | `/mine-writing-patterns path/to/paper.pdf introduction`；“请从这篇论文中提炼可复用写作结构” |
|
||
| `rebuttal-writer` | 解析审稿意见，分类 Major/Minor/typo/misunderstanding，选择 Accept/Defend/Clarify/Experiment 策略，写逐点回复 | 审稿回复、修改说明、专家意见答复 | `/rebuttal review-comments.md`；“请帮我逐条回应评审意见” |
|
||
| `kaggle-miner` | 从 Kaggle 竞赛和优胜方案中抽取工程路线、模型策略、best practices、代码模板 | 需要从竞赛方案学习技术路径 | “Learn from this Kaggle competition: URL” |
|
||
| `code-reviewer` | 审查 git diff 中的安全、质量、性能、测试覆盖、硬编码密钥等问题 | 修改代码后、提交前 | `/code-review`；“请 review 当前改动” |
|
||
| `tdd-guide` | 以 RED -> GREEN -> REFACTOR 推进测试驱动开发 | 明确要求 TDD 或风险较高功能 | `/tdd 实现 X`；“请先写失败测试再实现” |
|
||
|
||
## 4. 学术写作与文档润色 Skill 索引
|
||
|
||
| Skill | 功能 | 文档润色中的用法 |
|
||
|---|---|---|
|
||
| `research-ideation` | 5W1H、研究问题定义、gap analysis、method selection、research planning | 把标题或方向拆成科学问题、研究假设、证据需求、证伪条件和最小下一步 |
|
||
| `doc-coauthoring` | 大型文档协作写作，包含上下文收集、结构搭建、逐节打磨、读者测试 | 用于标书、proposal、技术方案、决策文档的分节共写 |
|
||
| `ml-paper-writing` | 面向顶会论文的写作、相关工作、引用核验和 claim ledger | 借用其 claim-evidence 纪律，避免把计划、动机或猜测写成已证实结论 |
|
||
| `nature-writing` | 根据 claims、figures、results、notes 或中文草稿重建 Nature 风格章节 | 起草 abstract、introduction、results narrative、discussion |
|
||
| `nature-polishing` | 将稿件润色、重组或翻译为更接近 Nature 风格的精炼英文 | 中英文学术段落精炼、hedging、逻辑顺序调整 |
|
||
| `nature-response` | Nature 系修回逐点回复 | 处理 editor letter、reviewer comments、revision notes |
|
||
| `nature-data` | Data Availability、repository plan、FAIR metadata | 写数据可用性、数据仓库方案和受限数据说明 |
|
||
| `citation-verification` | 核验 DOI、arXiv、CrossRef、Semantic Scholar、Zotero 元数据和论断-引用对齐 | 写作时逐条核查参考文献是否真实、是否支撑对应论断 |
|
||
| `writing-anti-ai` | 去除中英文 AI 写作痕迹，减少空泛套话、机械排比和过度连接词 | 标书和论文润色最后一轮使用，使表达自然但不过度口语化 |
|
||
| `paper-self-review` | 投稿或提交前结构、逻辑、引用、图表、合规性、过度声称检查 | 提交标书或论文前做 claim audit 和结构自审 |
|
||
| `review-response` | 审稿意见分析与 rebuttal 工作流 | 对评审意见、专家修改建议做分类和逐条回应 |
|
||
| `publication-chart-skill` | 论文级图表和表格工作流 | 机制图、技术路线图、实验结果图表的质量控制 |
|
||
| `latex-conference-template-organizer` | 整理会议 LaTeX 模板为 Overleaf-ready 结构 | 论文投稿模板整理 |
|
||
| `zotero-obsidian-bridge` | 把 Zotero 作为文献源，向 Obsidian KB 写入 `Sources/Papers`、`Knowledge`、`Writing` | 文献笔记、证据记录、相关工作草稿联动 |
|
||
|
||
## 5. Slash Command 快速索引
|
||
|
||
### 5.1 研究启动与文献
|
||
|
||
| Command | 用途 | 示例 |
|
||
|---|---|---|
|
||
| `/research-init` | 初始化研究主题，创建或审计 Zotero collection，生成 research question card，证据足够时才生成 proposal | `/research-init "static magnetic field exosome macrophage polarization" focused both` |
|
||
| `/zotero-review` | 读取 Zotero collection，生成文献综述、方法分类、研究空白、相关工作草稿 | `/zotero-review "ATC-MagneticField" deep` |
|
||
| `/zotero-notes` | 批量读取 Zotero collection 并写详细论文笔记 | `/zotero-notes "ATC-MagneticField" detailed` |
|
||
| `/mine-writing-patterns` | 从论文或标书中抽取写作模式并更新 paper-miner 全局写作记忆 | `/mine-writing-patterns path/to/grant.pdf proposal` |
|
||
|
||
### 5.2 写作、润色与回复
|
||
|
||
| Command | 用途 | 示例 |
|
||
|---|---|---|
|
||
| `/rebuttal` | 生成带证据锚点的逐点审稿回复 | `/rebuttal review-comments.md` |
|
||
| `/presentation` | 生成会议报告结构和讲解指导 | `/presentation paper.md 20min` |
|
||
| `/poster` | 整理论文内容并生成海报版式与内容指导 | `/poster paper.md` |
|
||
| `/promote` | 起草社交媒体、博客或外部传播摘要 | `/promote paper.md` |
|
||
|
||
### 5.3 Obsidian 项目知识库
|
||
|
||
| Command | 用途 |
|
||
|---|---|
|
||
| `/kb-init` | 初始化 `Research/{project-slug}/` 项目知识库 |
|
||
| `/kb-status` | 汇总当前 KB 绑定、registry 和关键路径 |
|
||
| `/kb-ingest` | 将新资料路由到 `Sources/Papers`、`Sources/Web`、`Sources/Docs` 等 |
|
||
| `/kb-log` | 更新当天 `Daily/`、必要时更新 plan/hub/project memory |
|
||
| `/kb-sync` | 确定性刷新 scaffold、registry、index、daily、绑定状态 |
|
||
| `/kb-links` | 修复或增强 canonical notes 之间的 wikilink |
|
||
| `/kb-promote` | 将稳定内容从 Daily 或 source note 提升到 `Knowledge`、`Writing` 等 |
|
||
| `/kb-index` | 刷新 `02-Index.md` 自动索引块 |
|
||
| `/kb-lint` | 检查断链、registry 覆盖、index 覆盖、canvas 有效性 |
|
||
| `/kb-archive` | archive、detach、purge、rename KB 对象 |
|
||
| `/kb-map` | 生成或修复 literature canvas、可选 Bases 或其他显式图谱 |
|
||
| `/kb-literature-review` | 从 `Sources/Papers` 生成证据门槛下的文献综合和 `Maps/literature.canvas` |
|
||
|
||
### 5.4 代码、验证与项目维护
|
||
|
||
| Command | 用途 |
|
||
|---|---|
|
||
| `/analyze-results` | blocker-first 实验分析，证据足够时生成统计、图表和结果报告 |
|
||
| `/verify` | 类型检查、lint、测试、安全扫描、git 状态 |
|
||
| `/code-review` | 对未提交改动做安全和质量审查 |
|
||
| `/tdd` | 测试驱动开发 |
|
||
| `/commit` | 本地 Conventional Commit，不推送 |
|
||
| `/update-github` | commit 并推送到远程 |
|
||
| `/checkpoint` | 创建或验证工作流 checkpoint |
|
||
|
||
## 6. Zotero MCP 调用方法
|
||
|
||
Zotero MCP 是 `literature-reviewer`、`/research-init`、`/zotero-review`、`/zotero-notes` 的核心外部能力。
|
||
|
||
Codex CLI 配置示例：
|
||
|
||
```toml
|
||
[mcp_servers.zotero]
|
||
command = "zotero-mcp"
|
||
args = ["serve"]
|
||
enabled = true
|
||
|
||
[mcp_servers.zotero.env]
|
||
ZOTERO_API_KEY = "your-api-key"
|
||
ZOTERO_LIBRARY_ID = "your-user-id"
|
||
ZOTERO_LIBRARY_TYPE = "user"
|
||
UNPAYWALL_EMAIL = "your-email@example.com"
|
||
UNSAFE_OPERATIONS = "all"
|
||
NO_PROXY = "localhost,127.0.0.1"
|
||
```
|
||
|
||
常用工具：
|
||
- 导入：`zotero_add_items_by_identifier`、`zotero_add_items_by_doi`、`zotero_add_items_by_arxiv`、`zotero_add_item_by_url`
|
||
- 读取：`zotero_get_collections`、`zotero_get_collection_items`、`zotero_search_items`、`zotero_get_item_metadata`、`zotero_get_item_fulltext`
|
||
- 更新：`zotero_create_collection`、`zotero_move_items_to_collection`、`zotero_reconcile_collection_duplicates`
|
||
- PDF：`zotero_find_and_attach_pdfs`、`zotero_add_linked_url_attachment`
|
||
|
||
默认导入策略：
|
||
1. 优先抽取 DOI、arXiv ID、publisher landing page 或 PDF URL；
|
||
2. 使用 `zotero_add_items_by_identifier` 导入；
|
||
3. 导入时尝试自动附加 PDF；
|
||
4. 导入后运行 collection 去重；
|
||
5. abstract-only 或 webpage-placeholder 不能支撑稳定写作论断。
|
||
|
||
## 7. 推荐的文档润色流程
|
||
|
||
### 7.1 标书或论文初稿前
|
||
|
||
```text
|
||
research-ideation
|
||
-> Research Question Card
|
||
-> Evidence Records
|
||
-> Gap Analysis
|
||
-> Proposal Readiness Gate
|
||
```
|
||
|
||
建议口令：
|
||
|
||
```text
|
||
请使用 research-ideation，把这个题目拆成研究问题、研究假设、证据需求、证伪条件、研究内容和最小下一步。
|
||
```
|
||
|
||
### 7.2 资料与文献入库
|
||
|
||
```text
|
||
Zotero / local PDFs / web sources
|
||
-> Sources/Papers 或 Sources/Docs
|
||
-> Evidence Record
|
||
-> Knowledge synthesis
|
||
-> Writing draft
|
||
```
|
||
|
||
建议口令：
|
||
|
||
```text
|
||
请把这些论文作为 Sources/Papers 入库，逐篇生成 Evidence Record。只有证据足够的论断才能提升到 Knowledge 或 Writing。
|
||
```
|
||
|
||
### 7.3 学习优秀文本
|
||
|
||
```text
|
||
paper-miner
|
||
-> structure signals
|
||
-> reusable phrasing
|
||
-> venue-specific signals
|
||
-> global writing memory
|
||
```
|
||
|
||
建议口令：
|
||
|
||
```text
|
||
请用 paper-miner 分析这份获批标书，提炼可迁移的章节结构、论证节奏和常用表达。不要复制具体疾病背景或未核实数据。
|
||
```
|
||
|
||
### 7.4 段落润色
|
||
|
||
先做证据检查，再做语言润色：
|
||
|
||
```text
|
||
paper-self-review / citation-verification
|
||
-> claim audit
|
||
-> writing-anti-ai / nature-polishing
|
||
-> final wording
|
||
```
|
||
|
||
建议口令：
|
||
|
||
```text
|
||
请先检查这段话中哪些论断需要证据，给出 keep / weaken / revise / remove，再用 writing-anti-ai 风格润色，保留学术严谨性。
|
||
```
|
||
|
||
## 8. 对本项目的使用建议
|
||
|
||
- 不要直接把 `claude-scholar` 当成“医学标书自动生成器”；它原生偏 CS/AI 研究，更适合借用流程纪律。
|
||
- 对标书写作，最重要的是 `research-ideation`、`doc-coauthoring`、`citation-verification`、`paper-self-review`、`writing-anti-ai`、`paper-miner`。
|
||
- 任何疾病背景、材料性能、实验结论、政策数据或文献事实都应进入 Evidence Record，再进入正文。
|
||
- 可以复用优秀标书的结构、论证顺序、段落功能和语气，但不要复用未经核实的事实性论断。
|
||
- 文档最终提交前至少做三轮检查：引用核验、claim audit、AI 痕迹润色。
|
||
|
||
## 9. 最小调用清单
|
||
|
||
```text
|
||
1. 新主题：
|
||
/research-init "topic" focused both
|
||
|
||
2. 文献集合综述：
|
||
/zotero-review "collection-name" deep
|
||
|
||
3. 批量论文笔记：
|
||
/zotero-notes "collection-name" detailed
|
||
|
||
4. 学习优秀写法：
|
||
/mine-writing-patterns path/to/source.pdf proposal
|
||
|
||
5. 知识库入库：
|
||
/kb-ingest path/to/source.pdf
|
||
|
||
6. 文献综合：
|
||
/kb-literature-review
|
||
|
||
7. 标书/论文自审：
|
||
请使用 paper-self-review 做 claim audit。
|
||
|
||
8. 去除 AI 痕迹：
|
||
请使用 writing-anti-ai 润色以下段落。
|
||
```
|