跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

arxiv-paper-writer

Write LaTeX ML/AI review articles for arXiv using the IEEEtran template and verified BibTeX citations. Use when writing, planning, or continuing an arXiv review/survey paper, or when validating and repairing citations in an existing LaTeX project.

appautomaton · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add appautomaton/latex-arxiv-SKILL --skill arxiv-paper-writer

技能说明


name: arxiv-paper-writer description: > Write LaTeX ML/AI review articles for arXiv using the IEEEtran template and verified BibTeX citations. Use when writing, planning, or continuing an arXiv review/survey paper, or when validating and repairing citations in an existing LaTeX project. compatibility: > Python 3.8+ for scripts. Web browsing/search for citation verification. LaTeX is required (pdflatex + bibtex or latexmk). metadata: short-description: ML/AI review papers (IEEEtran template) with verified citations

ML/AI Review Paper Workflow (IEEEtran template)

When to Use

  • ML/AI review papers for arXiv (main text ~6-10 pages; references excluded)
  • LaTeX + BibTeX workflow with verified citations
  • Citation validation/repair on existing LaTeX projects

When NOT to Use

  • Novel experimental research papers (this is a review workflow)
  • Non-academic documents

Inputs

  • Topic description (required)
  • Constraints: venue, page limit, author/affiliations (optional)
  • Existing project path for citation validation (optional)

Outputs

  • main.tex (LaTeX source)
  • ref.bib (verified BibTeX entries)
  • IEEEtran.cls
  • plan/<timestamp>-<slug>.md, issues/<timestamp>-<slug>.csv
  • Figures/tables; main.pdf
  • notes/research-snapshot.md (Gate 0 research snapshot)
  • notes/literature-notes.md (optional per-citation notes)
  • notes/arxiv-registry.sqlite3 (arXiv metadata/BibTeX cache)

Conventions: run python3 scripts/... from this skill folder (where scripts/ lives); <paper_dir> is the paper/project root (contains main.tex, ref.bib, plan/, issues/, notes/). Paths like plan/... are under <paper_dir>. Papers are created under --out <workspace_dir> (your working directory, never inside this skill folder); pass the same --out (and --name, if used) to both bootstrap stages. For arXiv discovery/metadata/BibTeX, use scripts/arxiv_registry.py (no ad-hoc curl/wget).


Gated Workflow

Tip: Run python3 scripts/<script>.py --help before use. Open reference files only when a step calls them out.

Non-Negotiable Rules

  1. No prose in main.tex until plan approved AND issues CSV exists.
  2. First deliverable: research snapshot + outline + clarification questions + draft plan.
  3. Use plan + issues tracking for all new papers; do not opt out.
  4. Issues CSV is the execution contract; update Status and Verified_Citations per issue, and add/split/insert issue rows when scope grows (do not do untracked work).
  5. Template is fixed: use IEEEtran two-column layout (assets/template/IEEEtran.cls). Treat two-column width as a layout constraint (use two-column floats when needed).

Gate 0: Research Snapshot + Draft Plan

  1. Confirm constraints (venue, page limit, author block, date range).
  2. Translate the topic into search keywords and run a light discovery pass: 10-20 key papers (see references/research-workflow.md). After step 4 (once <paper_dir> exists), cache arXiv discovery with arxiv_registry.py search and save the snapshot to notes/research-snapshot.md.
  3. Propose 2-4 candidate titles aligned to the topic.
  4. Scaffold the project folder and draft plan:
    python3 scripts/bootstrap_ieee_review_paper.py --stage kickoff --topic "<topic>" --out <workspace_dir>
    
    This copies LaTeX templates from assets/template/; plan/issues are generated from templates in assets/. Initialize arXiv registry (once): python3 scripts/arxiv_registry.py --project-dir <paper_dir> init.
  5. Create a framework skeleton in main.tex (section headings + 2-4 bullets per section + seed citations; no prose).
  6. Update the plan file to reflect the framework, proposed titles, and section/subsection plan.
  7. Compile early: python3 scripts/compile_paper.py --project-dir <paper_dir> Fix any Overfull \hbox warnings (see Layout Hygiene below).
  8. Return to user:
    • Proposed outline (5-8 sections, 2-4 bullets each)
    • Planned visualizations (5+) mapped to sections (see references/visual-templates.md)
    • Clarification questions
  9. STOP until user approves.

Gate 1: Create Issues CSV (after approval)

  1. Check kickoff gate in plan: - [x] User confirmed scope + outline in chat.
  2. Create issues CSV (script refuses if gate unchecked):
    python3 scripts/bootstrap_ieee_review_paper.py --stage issues --topic "<topic>" --out <workspace_dir> --with-literature-notes
    
  3. Validate:
    python3 scripts/validate_paper_issues.py <paper_dir>/issues/<timestamp>-<slug>.csv
    
  4. If literature notes are enabled, keep short summaries and (optional) abstract snippets to avoid re-search.
  5. The plan may evolve; add/split/insert issues as needed, re‑validate after edits, and keep going until all issues (including inserted ones) are DONE or SKIP (when feasible, in the same run).

Phase 2: Per-Issue Writing Loop

For each writing issue in the CSV:

  • If an issue balloons (new figure, new subsection, new benchmark set, or a large QA fix), split/insert new issue row(s) (e.g., W6a, Q5) before proceeding; re-run python3 scripts/validate_paper_issues.py <issues.csv>; keep going until all issues are DONE/SKIP.
  1. Research: 8-12 section-specific papers.
  2. Write: Never 3 sentences without citations; varied paragraph rhythm (see references/writing-style.md). For section intent and structure, use references/template-usage.md.
  3. Visualize: Match content triggers (see references/visual-templates.md). Prioritize single-column sizing; use double-column spans only when necessary (see Layout Hygiene). Cite externally sourced figure content.
  4. Verify: Web search + open source page (and PDF if available) before adding to ref.bib. For arXiv entries, append BibTeX via python3 scripts/arxiv_registry.py --project-dir <paper_dir> export-bibtex <arxiv_id> --out-bib <paper_dir>/ref.bib.
  5. Update: Mark issue DONE with `Verifie
阅读完整来源 ↗