mcpField
P
paper-spine-research

paper-spine-research

github.com/wubing2023生产力6.1k337 次安装2 周前更新
代码仓库

关于 paper-spine-research

paper-spine-research 用于动机确认和针对特定场景写作之前的研究规划。它结合本地参考资料索引与三个专业分析,整理候选动机供用户确认。

主要功能

  1. 01索引本地参考资料
  2. 02协调三个专业分析
  3. 03研究目标场景要求
  4. 04分析范例的写作结构
  5. 05梳理 SOTA 论文与研究空白

适用场景

  1. 01写作前研究目标投稿场景
  2. 02制定有研究依据的动机选项
  3. 03确认论文重点前识别研究空白

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/wubing2023/paperspine --skill paper-spine-research

安装后在 Claude Code 中输入/paper-spine-research确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
deep-reading.md
exemplar-learning-dossier.md
flash-pro-research.md
journal-style-analysis.md
local-reference-ingestion.md
scenario-competition.md
scenario-conference.md
scenario-journal.md
scenario-report-review.md
style-learning-workflow.md
target-journal-research.md
task-genre-research.md
scripts/
_paper_spine_utils.py
humanize_check.py
reference_inventory.py

详细介绍

PaperSpine 研究

在确认研究动机之前,以及撰写任何特定场景内容之前,使用此技能。没有目标场景研究,就不要提供特定投稿渠道的写作建议。

研究分为三个阶段:在本地建立索引、启动三个并行的专业子 Agent,然后将研究结果整合为动机选项。

输入

如果 paper_rewriting_output/paper_spine_config.json 可用,请读取。重要字段包括 scene、tier、target_name、official_urls、materials_dir、draft_path、reference_mode、reference_paths 和 output_language。

分级规则

  • flash:收集 3 个目标场景示例,以及 3 个近期高质量领域/SOTA 示例。
  • pro:收集 6 个目标场景示例,以及 6 个近期高质量领域/SOTA 示例。

用户可以明确指定其他数量,但不要擅自假设用户做了此类指定。

这些学习示例不同于 citation_support_bank.md。学习示例用于学习结构和写作策略。引文支持论文则用于之后支持具体的文献陈述。

阶段 1 — 为本地参考资料建立索引(主线程)

创建参考资料工作区:

paper_rewriting_output/reference_materials/
  source_index.md
  official_requirements/
  target_examples/
  field_sota/
  templates/
  figures_images/
  extracted_notes/

为所有本地可用的参考资料建立索引。使用 scripts/reference_inventory.py,或生成格式相同的 source_index.md:

来源 ID类型标题/名称来源/URL/路径纳入原因本地文件/备注用途

索引完成后不要停止。立即进入阶段 2。

阶段 2 — 并行专业 Agent

同时启动以下三个子 Agent(在一条消息中调用三次 Agent 工具)。每个 Agent 独立工作,不会看到其他 Agent 的输出。每个 Agent 仅接收所需的上下文——不要传递完整的对话历史。

Agent A:场景分析师

**目标:**生成 paper_rewriting_output/research_dossier.md

传递的上下文:

  • 配置中的 scene、target_name、official_urls、output_language
  • 阶段 1 生成的 reference_materials/source_index.md
  • 场景专属参考文件:references/scenario-{journal|conference|report_review|competition}.md

说明:

You are a Scene Analyst. Write research_dossier.md and stop.

LIMITS (must obey):
- Read the scene reference file, search official URLs at most TWICE
- Target output: 300-500 words total across 4 sections
- Do NOT enumerate every possible requirement — list only the top constraints
- Write the file immediately after gathering key facts, do NOT keep searching

Sections:
1. ## Venue Requirements — format rules (page limit, structure, anonymization)
2. ## Review Criteria — what reviewers evaluate
3. ## Accepted Paper Patterns — 1-2 structural patterns from scene reference
4. ## Constraints for This Paper

Output ONLY research_dossier.md. Do NOT produce other files.
Agent B:范例学习者

**目标:**生成 paper_rewriting_output/exemplar_learning_dossier.md

传递的上下文:

  • 配置中的 tier(用于确定要分析的示例数量)
  • 阶段 1 生成的 reference_materials/source_index.md
  • 场景参考文件路径

说明:

You are an Exemplar Learner. Write exemplar_learning_dossier.md and stop.

LIMITS:
- Analyze at most 3 papers (flash) or 6 papers (pro) — do NOT exceed tier count
- For each paper: ONE paragraph summarizing structural patterns, NOT a full review
- Target output: 400-600 words total
- Write the file immediately after the last paper, do NOT keep adding

Sections:
1. ## Exemplar Inventory — table: title, venue, year, why selected
2. ## Structural Patterns — 2-3 reusable moves observed across exemplars
3. ## Rhetorical Patterns — 1-2 opening/closing techniques
4. ## Language Patterns — brief note on register and conventions

Output ONLY exemplar_learning_dossier.md. Do NOT copy claims/results.
Agent C:SOTA 绘图员

**目标:**生成 paper_rewriting_output/sota_gap_map.md

传递的上下文:

  • 配置中的 tier
  • 阶段 1 生成的 reference_materials/source_index.md
  • 用户提供的 user_motivation(如已设置;将其视为假设,而非已确认结论)

说明:

You are a SOTA Mapper. Write sota_gap_map.md and stop.

LIMITS:
- Map at most 6 relevant SOTA papers — pick the most representative ones
- ONE line per paper in the table, do NOT write paragraphs per entry
- Target output: table with 4-6 rows + 2-3 gap summary lines
- If the user provided a motivation hypothesis, add it as ONE additional row

Table format:
| Candidate Contribution | What SOTA Already Does | User Evidence | Real Gap | Claim Strength | Risk |

Add a ## Gap Summary with the 2 most promising gaps. Output ONLY sota_gap_map.md.
Agent 启动检查清单
  • 在一条消息中使用三次 Agent 工具调用,启动全部三个 Agent。
  • 每个 Agent 只能获得上文列出的上下文——仅保留与其任务相关的内容。
  • 不要让 Agent 看到其他 Agent 的说明或输出。
  • 三个 Agent 均将结果写入 paper_rewriting_output/。

阶段 3 — 整合与综合(主线程)

三个 Agent 全部完成后,读取它们的输出并生成:

style_profile.md

将范例语言模式与场景规范合并:

风格维度目标投稿渠道的预期范例模式在本文中的应用
motivation_options_after_research.md

将研究档案、范例分析和 SOTA 差距图合并为候选动机:

选项一句话动机核心创新为何范围不过宽所需证据最适合的论文脉络

规则:

  • 每个选项都必须简洁。优先突出一个主导性贡献。
  • 如果实际创新点较窄,就如实说明。
  • 交叉参考三个 Agent 的结果:好的动机应契合投稿渠道(场景分析师)、遵循范例的结构模式(范例学习者),并占据真实的研究空白(SOTA 绘图员)。
用户确认

暂停并向用户展示动机选项。请用户选择、修改或自行撰写。只有在确认后,才编写 confirmed_motivation.md:

  • 确认后的动机原文
  • 用户确认状态
  • 被否决的选项及原因
  • 范围限制和禁止夸大的内容

必需输出

  • paper_rewriting_output/reference_materials/source_index.md
  • paper_rewriting_output/research_dossier.md
  • paper_rewriting_output/exemplar_learning_dossier.md
  • paper_rewriting_output/style_profile.md
  • paper_rewriting_output/sota_gap_map.md
  • paper_rewriting_output/motivation_options_after_research.md
  • 仅在用户确认后生成 paper_rewriting_output/confirmed_motivation.md

评论

支持 Markdown