科研 Skill
学术论文写作打磨
research-paper-writing
Improves ML, CV, or NLP paper sections for structure, flow, and reviewer clarity, checking claim-evidence alignment. Use when drafting or revising a paper before submission.
SKILL.md
Research Paper Writing
Overview
Use this skill to rewrite a research paper into a reviewer-friendly, high-clarity draft. Prioritize first-impression quality (figures/tables/layout), logical flow, and evidence-backed claims.
Core Workflow
- Clarify the paper story before sentence-level edits.
- Use section-specific guidance in
references/. - Rewrite paragraph-by-paragraph with one message per paragraph.
- Run reverse outlining after writing each section.
- Check every major claim in Abstract/Introduction against experimental evidence.
- Run final-paper adversarial review with
references/paper-review.md.
Global Principles
- Keep one paragraph for one message only.
- State the paragraph message in the first sentence.
- Make nouns self-contained; define new terms before reusing them.
- Maintain sentence-to-sentence flow (cause, contrast, consequence, or refinement).
- Iterate with adversarial self-review: read as a skeptical reviewer.
- Treat visual quality as core content, not decoration.
- Use a clean teaser and pipeline figure.
- Use readable, minimal-ink tables.
- Keep formatting consistent and tidy.
Paragraph Clarity Check (Important)
Use this quick test whenever the user asks whether a paragraph "flows" or is clear.
- Read as an external reader:
- Does this paragraph have one explicit message?
- Does the first sentence state what this paragraph will do?
- Are all key nouns/terms readable without hidden context?
- Does each sentence connect to the previous one with a clear relation (cause, contrast, consequence, refinement, example)?
- Run reverse outlining for the current section:
- Write down thesis/main claim.
- Write down each paragraph topic sentence.
- Write down the evidence/explanation points under each paragraph.
- Check mapping: topic sentence -> thesis, and evidence -> topic sentence.
- Revise or remove any paragraph that cannot be mapped cleanly.
- If flow is still weak, add temporary section headers and explicit transition phrases during revision, then remove unnecessary headers before finalizing.
Source reference for this check:
references/does-my-writing-flow-source.md
Section Guides
Load only the needed section file:
- Introduction:
references/introduction.md - Abstract:
references/abstract.md - Related Work:
references/related-work.md - Method:
references/method.md - Experiments:
references/experiments.md - Conclusion:
references/conclusion.md - Paper review (Paper Review):
references/paper-review.md - Paragraph clarity source:
references/does-my-writing-flow-source.md - Example bank index:
references/examples/index.md
Paper Review Core Points
Use references/paper-review.md for the full checklist and workflow.
- Add an end-of-draft self-review question list in five dimensions:
- contribution,
- writing clarity,
- experimental strength,
- evaluation completeness,
- method design soundness.
- Treat claim-evidence alignment as a hard constraint, especially for Abstract and Introduction.
- Perform adversarial writing: review as a skeptical reviewer and resolve every high-risk question.
- Revise until major rejection risks are explicitly addressed.
Execution Rules
- Build a mini-outline before drafting prose.
- For each subsection, explicitly include motivation, design, and technical advantage when applicable.
- Avoid writing style that looks like incremental patching of a naive baseline.
- Keep terminology stable across the full paper.
- If a claim cannot be supported by results, weaken or remove the claim.
- Before finalizing, append and answer a five-dimension self-review question list, then revise the paper based on unresolved items.
- Do not load all section references (Introduction/Abstract/Related Work/Method/Experiments/Conclusion) at once; load only the specific section guide needed for the current edit target.
Output Contract
When asked to rewrite or draft sections, return:
- A compact section outline (3-7 bullets).
- Revised paragraphs with explicit paragraph roles (opening/challenge/method/advantage/evidence/limitation).
- A short self-review checklist covering clarity, flow, terminology consistency, unsupported claims, and missing evidence.
- A claim-evidence map for each major claim in the revised text using
Claim: ... | Evidence: ... | Status: supported/needs evidence.
Adjacent human-facing documents
This skill governs the published paper draft itself (Abstract, Introduction, Related Work, Method, Experiments, Conclusion). When the work also requires producing or revising meta-documents that support the paper -- for example:
- updates to the project's
PLAN.md, - per-section research notes (
notes/section_<N>.md), - per-component implementation plans (
notes/impl_<component>.md), - the project's
README.md, - a reviewer-response draft,
those documents have a different audience (the user, co-authors,
reviewers) and a different style budget than the paper itself. Load
the human-facing-doc-authoring skill (if installed in this agent's
skill set) for the conventions and per-doc-type structural skeletons.
Use BOTH skills together: paper-writing for the paper draft,
human-facing for any meta-doc.
Resource discipline for paper-writing sessions
A paper-writing session typically iterates across multiple sections,
re-reads many survey notes, may re-grep the paper draft repeatedly,
and often spans multiple sessions before a section is finalised.
Whenever the session is going to be heavy (more than ~5 file reads,
multiple section drafts, or a span across multiple sittings), load
the agent-resource-discipline skill (if installed) at session
start. In particular:
agent-resource-discipline/references/persistent-memory.md-- the first-/last-action protocol that updatesnotes/section_<N>.mdandPLAN.mdstatus fields so the next session resumes cheaply.agent-resource-discipline/references/context-window-budget.md-- the rule that this skill's Execution Rule #7 ("do not load all section references at once") generalises to: do not load all survey notes at once, do not load the full.txtextraction of every cited paper -- target-grep instead.
Both skills compose: paper-writing for what to write; agent-resource- discipline for what to load while writing.
Note on this skill's references/ files
The references files under references/ (abstract.md, conclusion.md,
experiments.md, introduction.md, method.md, paper-review.md,
related-work.md, examples/) are vendored from the upstream
Master-cai/Research-Paper-Writing-Skills
repository at commit 9ee5edd (see ATTRIBUTION.md). They are
deliberately preserved without per-file date-stamp footers -- our
universal "every plan-of-record-style document ends with a date-stamp
footer" convention (root AGENTS.md Section 6) does not apply to
upstream-imported reference content; modifying the upstream files to
add footers would create false revision history.
When upstream evolves the references files, we may selectively
cherry-pick changes (per ATTRIBUTION.md "Pulling updates from
upstream"). When we substantially modify a reference file, we will
add a *Revised YYYY-MM-DD by A. Attia: <note>.* footer to that
specific file at that point. Until then the upstream provenance is
authoritative.
Revised 2026-05-13: added "Adjacent human-facing documents" section pointing at the human-facing-doc-authoring skill for meta-docs (PLAN.md, section/impl notes, README, rebuttal) that this skill does not directly govern. Revised 2026-05-13: added "Resource discipline for paper-writing sessions" section pointing at the agent-resource-discipline skill for the cross-cutting context-window / persistent-memory protocol that complements this skill's Execution Rule #7. Revised 2026-05-14 (post-fresh-audit): documented the deliberate exception from the universal date-stamp-footer convention for upstream-vendored references files (the eight files under references/ that were imported from Master-cai upstream and have not been substantially modified).
Limitations
- This skill names sibling skills (
human-facing-doc-authoring,agent-resource-discipline) by name rather than by a fixed filesystem path; they help only if your agent also has those skills installed from this same marketplace. - Section guidance is tuned for ML/CV/NLP-style empirical papers; humanities, qualitative, or pure-theory papers may need a different structure than Abstract/Intro/Related Work/Method/ Experiments/Conclusion.
示例提示词
帮我润色这篇机器学习论文的Method和Experiments章节表述。
所属插件
安装该插件会一并获得同领域的 54 个 Skill / MCP。
同插件的其他科研 Skill
- 智能体资源节约守则Applies token- and context-saving habits for tool choice, PDF handling, persistent memory, and privacy checks. Use at the start of sessions with many files or PDFs, or multi-session work.
- 英文论文双语精读器把英文论文转成中英对照精读档并生成离线双语阅读器,标注要点并输出读书笔记。精读单篇英文论文、要中英对照阅读时使用。
- 研究方法比较论证Compares quantitative, qualitative, and mixed research methods against what each can and cannot answer to build a methods table. Use when justifying a method choice in a thesis.
- 复杂系统分析方法Analyzes complex systems with power-law fitting, Hurst exponent, fractal dimension, agent-based modeling, and entropy measures. Use for nonlinear or complex-system data.
- 研究环境容器化部署Builds Docker and Singularity containers for reproducible computation and HPC deployment of research environments. Use when packaging an analysis pipeline for reuse or HPC.
- DVC数据版本管理Sets up DVC for dataset and pipeline versioning, remote storage, and experiment comparison in reproducible ML research workflows. Use when tracking large datasets or ML experiment runs.
- 期刊级统计图表绘制Creates publication-quality multi-panel figures with matplotlib, seaborn, or ggplot2 using colorblind-safe palettes and journal export settings. Use when preparing figures for a paper.
- 综述模块拆解规划Breaks a refined literature-review question into 3-5 non-overlapping modules to build a reading map, outline, or search plan. Use when structuring a literature review.
- 学位论文答辩教练模拟学位口试委员提问并提供承认回应证据三段式答辩框架与模拟问答。准备论文口试或研讨会问答环节时使用。
- 实验设计与样本量规划Designs rigorous experiments covering sample-size calculation, randomization strategy, pre-registration, and A/B test duration estimation. Use when planning an experiment or A/B test.
- 管理实验设计架构为管理与商学情境实验规划组间组内设计、对抗平衡与操弄检核,并产出设计书与情境材料模板。做商学实验设计时使用。
- 科研经费申请撰写Structures research grant proposals including NSF/NIH Specific Aims, budget justification, ERC narrative sections, and biosketch formatting. Use when drafting a funding application.
- 人类可读文档撰写规范Guides writing human-facing docs like README, PLAN, survey notes, and reviewer-response drafts with a clear two-tier structure. Use for text a human collaborator will read.
- 知识图谱与SPARQL检索Builds knowledge graphs and runs SPARQL queries over RDF and Wikidata for entity linking in research and library data. Use when modeling research entities as a linked graph.
- LaTeX论文写作与排版Writes, compiles, and submits LaTeX papers covering IMRaD structure, key packages, bibliography management, and arXiv preparation. Use when authoring or debugging a LaTeX manuscript.
- 文献比较矩阵构建器把一批PDF整理成含撤稿查核与APA7书目的文献资料库,并生成横向比较矩阵表。整理综述前要比较文献时使用。
- 跨库学术文献检索Searches OpenAlex, Semantic Scholar, and arXiv for academic literature with deduplication, citation snowballing, and BibTeX export. Use when collecting papers for a review or topic.
- 文献调研语料库维护Finds, verifies, and maintains a literature corpus from arXiv, OpenAlex, Crossref, and related databases with BibTeX entries and per-paper notes. Use when sourcing references for a paper.
- 文献综述研究缺口定位Converts a literature-review synthesis into a concrete, defensible research gap and future-research direction. Use when writing a conclusion or thesis contribution section.
- 文献矛盾结论梳理Analyzes conflicting findings across papers and explains disagreement by sample, method, or context differences for a stronger synthesis. Use when review sources disagree.
- 效应量汇总元分析Pools effect sizes across studies with fixed and random-effects models, heterogeneity tests, forest and funnel plots, and subgroup analysis. Use to synthesize quantitative study results.
- 缺失数据处理Diagnoses missing-data mechanisms such as MCAR, MAR, or MNAR and applies multiple imputation or deletion with sensitivity analysis. Use when a dataset has missing values.
- 混合方法研究设计Designs mixed-methods studies integrating qualitative coding, triangulation, content analysis, and QCA with inter-rater reliability checks. Use when combining qual and quant data.
- 科研机器学习流程Applies machine learning to research questions with scikit-learn pipelines, AutoML, SHAP explainability, and nested cross-validation. Use when building a predictive model for a study.
常见问题
学术论文写作打磨能做什么?
Improves ML, CV, or NLP paper sections for structure, flow, and reviewer clarity, checking claim-evidence alignment. Use when drafting or revising a paper before submission。
如何安装学术论文写作打磨?
在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「学术论文写作打磨」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
学术论文写作打磨需要哪些权限?
该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。
学术论文写作打磨经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。