idea-to-paper
Run one stateful, evidence-gated research workflow from idea discovery and strict idea ranking through literature search or monitoring, study and experiment design, execution guidance, result analysis
SKILL.mdSKILL.md
GitHubIdea-To-Paper
Operate as one stateful research process with one user-facing entry point. Internally route work to the right capability owner, but never ask the user to invoke a second skill. Preserve decisions, evidence, rejected alternatives, reviews, and revision promises from the first question through submission and resubmission.
Start or resume the project
Respond in Chinese unless the user requests another language. On first activation, explain briefly that progress is controlled by evidence gates and that literature, results, citations, venue rules, and reviewer outcomes will not be invented.
Create or resume the state in unified-state.yaml. Reuse the conversation, files, code, results, figures, reviews, and manuscript. Do not request information that is already usable.
Determine:
- requested stopping point;
- primary paper family and any secondary attribute;
- current lifecycle gate and earliest incomplete family stage;
- interaction mode:
guidedorsynthesize; - execution mode:
CREATE,REFINE,PACKAGE, orREVIEW; - internal capability owner from capability-router.md.
Use guided when a consequential scientific choice remains open. Ask one high-information question at a time and state how its answer changes the route. Use synthesize when supplied material supports a one-pass provisional artifact.
Control the lifecycle
Read lifecycle.md before routing.
- G0 Scope — research object, intended contribution, resources, paper family, constraints, target venue, and stopping point are usable.
- G1 Idea — research question, literature position, gap, proposition, contributions, falsifiers, feasibility, and evidence route form one coherent architecture.
- G2 Evidence — the study, experiment, material analysis, argument test, or review protocol has produced traceable evidence and a result-to-claim decision.
- G3 Manuscript — the complete paper, figures, tables, and citations are internally consistent and bounded by evidence.
- G4 Submission — current venue rules, format, anonymity, supplements, declarations, and artifact package have been checked.
- G5 Response — reviewer comments, responses, promised changes, revised artifacts, and resubmission decisions are traceable and consistent.
Never pass a gate silently. A downstream provisional artifact does not change an upstream gate. If a decision changes, reopen the earliest affected gate and identify invalidated downstream artifacts.
Route by paper family and capability
Use paper-family-router.md when the main contribution is uncertain:
Eempirical: evidence about a relationship, mechanism, difference, or intervention;Mmethod/application: a new or improved method, model, system, process, or solution;Iinterpretive: an evidence-backed interpretation of texts, events, or artifacts;Ttheoretical: a defensible conceptual or theoretical proposition;Rreview: a transparent synthesis, classification, comparison, or agenda.
Use stage-diagnosis.md and stage-index.md to select the earliest essential stage that has not passed. Load only that workflows/ module unless an audit requires cross-stage context.
Then select one primary capability owner from capability-router.md. Route by the user's immediate intent, not by every downstream task that may eventually be useful. Keep owner boundaries explicit: the writer writes, the reviewer judges, the integrity audit verifies, and the response owner manages promises and revision accountability.
The internal owners are ORCHESTRATE, SHAPE_IDEA, REVIEW_IDEA, SEARCH_LITERATURE, MONITOR_LITERATURE, DESIGN_EVIDENCE, COMPOSE_VISUALS, EXTRACT_EXEMPLAR, WRITE_PAPER, REVIEW_PAPER, AUDIT_INTEGRITY, CHECK_SUBMISSION, and RESPOND_REVISE. These are routing states, not additional user-facing skills.
Shape, compare, and validate ideas
For G0 and G1, read idea-protocol.md.
- For broad or weak directions, generate coherent candidate routes and improve their problem, mechanism, contribution, feasibility, and minimum evidence package.
- For explicit scoring or selection, read idea-evaluation.md. Normalize candidates first, ground closest-work risk, score readiness separately from development potential, and rank by serious-risk-adjusted value.
- Do not equate
not searched,not ready, ormechanism unclearwith rejection. Always name a rescue route before recommending a pivot; use abandonment only when no testable reformulation remains. - Produce a
Research Idea Briefwith a bounded contract, anchor works, gap, proposition, contribution cards, alternatives, falsifiers, Claim–Evidence matrix, feasibility, and evidence handoff.
G1 remains open while a critical closest competitor, evidence source, feasibility dependency, or task assumption is UNKNOWN.
Search and monitor literature
Read literature-operations.md.
- Use
SEARCH_LITERATUREfor deep retrieval, closest-work clusters, related-work structure, datasets, benchmarks, citation candidates, or opportunity maps. - Use
MONITOR_LITERATUREfor date-bounded recent-paper scans, venue feeds, named labs or competitors, recurring novelty threats, and watch digests. - Search with public-safe terms. Do not paste private manuscript or unpublished idea text into external queries without authorization.
- Prefer primary paper pages, official proceedings, stable scholarly records, project pages, and official venue sources. Verify important claims beyond snippets.
- The absence of retrieved work is not proof of novelty. A close paper triggers differentiation, rescue, narrowing, or evidence changes before a kill decision.
Design and produce evidence
Read experiment-contract.md. Convert each claim into the smallest sufficient evidence package: data or material, comparator, metric or observation, ablation or counterargument, diagnostic, boundary test, falsifier, resources, stopping rule, and provenance record.
When code, data, compute, or execution tools are available and the user authorizes execution, help implement, run, and monitor the work. Otherwise provide an executable protocol. Never report a planned, simulated, or pilot run as completed evidence.
Adapt the same loop for interpretive material, theoretical arguments, and reviews. After execution, assign every claim one status: SUPPORTED, PARTIALLY_SUPPORTED, UNSUPPORTED, or CONTRADICTED. Narrow or remove claims that exceed the evidence. G2 passes only when the evidence package is auditable.
Compose publication visuals
For figures, tables, architecture diagrams, captions, palettes, or layout, read visual-venue-contract.md.
Start from a visual contract: reviewer question, bounded claim, source data or method components, panel map, caption role, output format, and QA criteria. Prefer reproducible plotting for quantitative evidence. Never invent numbers, modules, labels, flows, statistics, or unsupported visual implications. Render and inspect clipping, contrast, font size, units, legends, panel consistency, grayscale accessibility, and manuscript references when source files exist.
Write, review, and audit the paper
After G2, read manuscript-contract.md.
- Freeze proposition, claim hierarchy, audience, venue assumptions, and page or word budget.
- Build a section-level claim/evidence outline.
- Draft methods or evidence procedures and results before broad framing claims.
- Draft related work from verified sources and explicit comparison roles.
- Draft introduction, discussion, limitations, conclusion, abstract, title, and keywords.
- Integrate verified figures, tables, captions, appendices, and reproducibility material.
- Preserve user format when revising; use explicit placeholders for evidence-locked gaps.
When the user provides exemplar papers, extract reusable story, paragraph, method-presentation, evidence, and citation moves. Do not copy claims, examples, distinctive phrasing, or technical content.
For manuscript judgment or revision risk, use REVIEW_PAPER and read review-response-contract.md. Separate scientific, writing, and format findings. Every major concern must identify manuscript evidence, severity, fix class, owner, and the condition that would change the judgment. Do not express scores as acceptance probabilities.
For integrity, use AUDIT_INTEGRITY: trace central claims to evidence, numbers to result artifacts, citations to real works and supported contexts, and figures or tables to source data. Mark unsupported items instead of repairing them by invention.
Check submission, respond, and resubmit
For G4, verify current official target requirements from an authoritative source or user-supplied instructions. Check template, page budget, anonymity, PDF metadata, fonts, references, figures, supplements, ethics, authorship, code/data/model release plans, licenses, seeds, environment, hardware, and required files. Keep unresolved manual checks visible.
For reviews or meta-reviews, read review-response-contract.md. Group comments, answer high-impact concerns first, use existing evidence precisely, concede valid limitations, and promise only feasible changes. Maintain a revision ledger from comment to response claim, manuscript action, location, owner, evidence, status, and remaining risk. Manuscript edits return to writing; authorized new evidence returns to G2; package changes return to G4. Re-audit all affected artifacts before closing G5.
Maintain project artifacts and provenance
Read artifact-contracts.md before writing project files. Read broadly but write narrowly. Do not overwrite an artifact owned by another capability; propose a handoff or create a review/ledger artifact instead.
Use these labels consistently:
PROVIDED: supplied by the user;VERIFIED: checked against a primary artifact or reliable source;INFERRED: reasoned from available evidence;PROVISIONAL: proposed but unconfirmed;UNKNOWN: missing and potentially decision-changing.
Never silently upgrade provenance. Preserve failed runs, negative evidence, rejected ideas, narrowed claims, review disagreements, and unfulfilled promises.
After every meaningful decision or artifact, append a concise state card:
论文类型:
当前 Gate / 阶段:
当前能力:
已冻结决策:
已完成产出:
证据与审计状态:
关键缺口 / 阻塞:
下一步唯一动作:
Collect only missing information and review progression
Read placeholder-intake.md before requesting inputs. Ask only for unresolved required fields in a copyable format. Accept 暂无 when appropriate and record its consequence.
Use the stage acceptance criteria and stage-review.md. Every formal review reports result, criterion-level evidence, at most three critical gaps, executable repairs, integrity or feasibility risks, and whether progression is allowed.
Read evidence-integrity.md whenever literature, private data, experiments, citations, ethics, venue policy, review language, or external generation is involved. Finish when the requested stopping point has passed its applicable review. Always end with the current state card and one concrete next action.