Skip to content

YCC-Lover/research-starter-skills / skills/research-starter-paper

research-starter-paper

Unverified

科研学习与论文写作总入口,协调六个模块。帮助不知道提供什么材料的新手逐步产出、自动保存和恢复项目进度,也用于跨阶段研究任务;区分学习、执行和只读检查。

FileKindSize
SKILL.mdskill md8.8 KB
agents/openai.yamlconfig366 B
assets/evidence-ledger.tsvother106 B
assets/manuscript-plan.mdmarkdown423 B
assets/project-state.mdmarkdown928 B
assets/requirements-research.txtmarkdown263 B
assets/task-brief.mdmarkdown429 B
references/advanced-capabilities.jsonconfig8.5 KB
references/advanced-research.mdmarkdown8.5 KB
references/discipline-fit.mdmarkdown2.3 KB
references/evidence-and-figures.mdmarkdown2.8 KB
references/guided-start.mdmarkdown7.2 KB
references/handoff.mdmarkdown1.9 KB
references/learning.mdmarkdown3.2 KB
references/paper-sections.mdmarkdown5.6 KB
references/research-engine-notice.mdmarkdown1.6 KB
references/research-engine-patches.jsonconfig3.4 KB
references/research-practice.mdmarkdown3.2 KB
references/research.mdmarkdown3.2 KB
references/revision.mdmarkdown2.1 KB
references/runtime-helpers.mdmarkdown6.0 KB
references/source-manifest.jsonconfig34.8 KB
references/sources.mdmarkdown7.4 KB
references/task-brief.mdmarkdown1.6 KB
resources/research-engine/LICENSEother19.1 KB
resources/research-engine/MODE_REGISTRY.mdmarkdown6.7 KB
resources/research-engine/NOTICE.mdmarkdown1.0 KB
resources/research-engine/THIRD_PARTY.mdmarkdown5.0 KB
resources/research-engine/academic-paper-reviewer/WORKFLOW.mdmarkdown43.9 KB
resources/research-engine/academic-paper-reviewer/agents/devils_advocate_reviewer_agent.mdmarkdown42.0 KB
resources/research-engine/academic-paper-reviewer/agents/domain_reviewer_agent.mdmarkdown32.4 KB
resources/research-engine/academic-paper-reviewer/agents/editorial_synthesizer_agent.mdmarkdown41.8 KB
resources/research-engine/academic-paper-reviewer/agents/eic_agent.mdmarkdown28.1 KB
resources/research-engine/academic-paper-reviewer/agents/field_analyst_agent.mdmarkdown11.2 KB
resources/research-engine/academic-paper-reviewer/agents/methodology_reviewer_agent.mdmarkdown44.0 KB
resources/research-engine/academic-paper-reviewer/agents/perspective_reviewer_agent.mdmarkdown32.7 KB
resources/research-engine/academic-paper-reviewer/examples/hei_paper_review_example.mdmarkdown33.8 KB
resources/research-engine/academic-paper-reviewer/examples/interdisciplinary_review_example.mdmarkdown27.6 KB
resources/research-engine/academic-paper-reviewer/examples/subclaim_decomposition_example.mdmarkdown8.3 KB
resources/research-engine/academic-paper-reviewer/references/calibration_mode_protocol.mdmarkdown15.5 KB
resources/research-engine/academic-paper-reviewer/references/changelog.mdmarkdown1.4 KB
resources/research-engine/academic-paper-reviewer/references/editorial_decision_standards.mdmarkdown12.8 KB
resources/research-engine/academic-paper-reviewer/references/guided_mode_protocol.mdmarkdown2.0 KB
resources/research-engine/academic-paper-reviewer/references/integration_guide.mdmarkdown680 B
resources/research-engine/academic-paper-reviewer/references/quality_rubrics.mdmarkdown6.3 KB
resources/research-engine/academic-paper-reviewer/references/re_review_mode_protocol.mdmarkdown51.9 KB
resources/research-engine/academic-paper-reviewer/references/review_criteria_framework.mdmarkdown6.2 KB
resources/research-engine/academic-paper-reviewer/references/review_panel_provenance_protocol.mdmarkdown9.4 KB
resources/research-engine/academic-paper-reviewer/references/review_quality_thinking.mdmarkdown3.3 KB
resources/research-engine/academic-paper-reviewer/references/reviewer_sprint_prompt_source.mdmarkdown47.9 KB
resources/research-engine/academic-paper-reviewer/references/sprint_contract_protocol.mdmarkdown32.1 KB
resources/research-engine/academic-paper-reviewer/references/statistical_reporting_standards.mdmarkdown29.8 KB
resources/research-engine/academic-paper-reviewer/references/top_journals_by_field.mdmarkdown12.6 KB
resources/research-engine/academic-paper-reviewer/templates/editorial_decision_template.mdmarkdown11.0 KB
resources/research-engine/academic-paper-reviewer/templates/peer_review_report_template.mdmarkdown14.8 KB
resources/research-engine/academic-paper-reviewer/templates/revision_response_template.mdmarkdown7.4 KB
resources/research-engine/academic-paper/WORKFLOW.mdmarkdown63.8 KB
resources/research-engine/academic-paper/agents/abstract_bilingual_agent.mdmarkdown12.0 KB
resources/research-engine/academic-paper/agents/argument_builder_agent.mdmarkdown10.9 KB
resources/research-engine/academic-paper/agents/citation_compliance_agent.mdmarkdown23.5 KB
resources/research-engine/academic-paper/agents/draft_writer_agent.mdmarkdown56.1 KB
resources/research-engine/academic-paper/agents/formatter_agent.mdmarkdown63.8 KB
resources/research-engine/academic-paper/agents/intake_agent.mdmarkdown25.5 KB
resources/research-engine/academic-paper/agents/literature_strategist_agent.mdmarkdown46.5 KB
resources/research-engine/academic-paper/agents/peer_reviewer_agent.mdmarkdown29.5 KB
resources/research-engine/academic-paper/agents/revision_coach_agent.mdmarkdown20.0 KB
resources/research-engine/academic-paper/agents/socratic_mentor_agent.mdmarkdown27.9 KB
resources/research-engine/academic-paper/agents/structure_architect_agent.mdmarkdown18.9 KB
resources/research-engine/academic-paper/agents/visualization_agent.mdmarkdown17.2 KB
resources/research-engine/academic-paper/examples/chinese_paper_example.mdmarkdown21.1 KB
resources/research-engine/academic-paper/examples/clinical_citation_verification_checklist.mdmarkdown4.4 KB
resources/research-engine/academic-paper/examples/clinical_epistemic_status_example.mdmarkdown6.6 KB
resources/research-engine/academic-paper/examples/commitment_ledger_example.mdmarkdown8.1 KB
resources/research-engine/academic-paper/examples/imrad_hei_example.mdmarkdown23.3 KB
resources/research-engine/academic-paper/examples/literature_review_example.mdmarkdown30.8 KB
resources/research-engine/academic-paper/examples/plan_mode_guided_writing.mdmarkdown34.3 KB
resources/research-engine/academic-paper/examples/revision_mode_example.mdmarkdown20.1 KB
resources/research-engine/academic-paper/examples/revision_recovery_example.mdmarkdown41.2 KB
resources/research-engine/academic-paper/examples/version_family_reconciliation_example.mdmarkdown3.8 KB
resources/research-engine/academic-paper/references/abstract_writing_guide.mdmarkdown12.5 KB
resources/research-engine/academic-paper/references/academic_writing_style.mdmarkdown7.6 KB
resources/research-engine/academic-paper/references/anti_leakage_protocol.mdmarkdown4.4 KB
resources/research-engine/academic-paper/references/apa7_chinese_citation_guide.mdmarkdown14.0 KB
resources/research-engine/academic-paper/references/apa7_extended_guide.mdmarkdown6.6 KB
resources/research-engine/academic-paper/references/changelog.mdmarkdown2.8 KB
resources/research-engine/academic-paper/references/citation_format_switcher.mdmarkdown7.4 KB
resources/research-engine/academic-paper/references/committee_correspondence_protocol.mdmarkdown6.3 KB
resources/research-engine/academic-paper/references/credit_authorship_guide.mdmarkdown13.7 KB
resources/research-engine/academic-paper/references/disclosure_mode_protocol.mdmarkdown53.9 KB
resources/research-engine/academic-paper/references/domain_evidence_profiles.mdmarkdown4.2 KB
resources/research-engine/academic-paper/references/failure_paths.mdmarkdown14.2 KB
resources/research-engine/academic-paper/references/funding_statement_guide.mdmarkdown11.9 KB
resources/research-engine/academic-paper/references/hei_domain_glossary.mdmarkdown6.8 KB
resources/research-engine/academic-paper/references/intro_title_rhetoric_guide.mdmarkdown8.7 KB
resources/research-engine/academic-paper/references/journal_submission_guide.mdmarkdown8.7 KB
resources/research-engine/academic-paper/references/latex_template_reference.mdmarkdown9.6 KB
resources/research-engine/academic-paper/references/mode_selection_guide.mdmarkdown17.5 KB
resources/research-engine/academic-paper/references/paper_structure_patterns.mdmarkdown8.4 KB
resources/research-engine/academic-paper/references/plan_mode_protocol.mdmarkdown6.7 KB
resources/research-engine/academic-paper/references/policy_anchor_disclosure_protocol.mdmarkdown21.0 KB
resources/research-engine/academic-paper/references/policy_anchor_table.mdmarkdown21.2 KB
resources/research-engine/academic-paper/references/revision_patch_protocol.mdmarkdown12.9 KB
resources/research-engine/academic-paper/references/statistical_visualization_standards.mdmarkdown23.7 KB
resources/research-engine/academic-paper/references/venue_disclosure_policies.mdmarkdown38.4 KB
resources/research-engine/academic-paper/references/vlm_figure_verification.mdmarkdown9.1 KB
resources/research-engine/academic-paper/references/workflow_phase_details.mdmarkdown4.7 KB
resources/research-engine/academic-paper/references/writing_judgment_framework.mdmarkdown3.3 KB
resources/research-engine/academic-paper/references/writing_quality_check.mdmarkdown13.0 KB
resources/research-engine/academic-paper/templates/bilingual_abstract_template.mdmarkdown4.7 KB
resources/research-engine/academic-paper/templates/case_study_template.mdmarkdown2.8 KB
resources/research-engine/academic-paper/templates/conference_paper_template.mdmarkdown2.3 KB
resources/research-engine/academic-paper/templates/credit_statement_template.mdmarkdown4.4 KB
resources/research-engine/academic-paper/templates/funding_statement_template.mdmarkdown8.9 KB
resources/research-engine/academic-paper/templates/imrad_template.mdmarkdown4.4 KB
resources/research-engine/academic-paper/templates/latex_article_template.texother4.7 KB
resources/research-engine/academic-paper/templates/literature_review_template.mdmarkdown2.8 KB
resources/research-engine/academic-paper/templates/policy_brief_template.mdmarkdown3.6 KB
resources/research-engine/academic-paper/templates/revision_tracking_template.mdmarkdown10.2 KB
resources/research-engine/academic-paper/templates/theoretical_paper_template.mdmarkdown2.8 KB
resources/research-engine/academic-pipeline/WORKFLOW.mdmarkdown58.0 KB
resources/research-engine/academic-pipeline/agents/claim_ref_alignment_audit_agent.mdmarkdown44.3 KB
resources/research-engine/academic-pipeline/agents/collaboration_depth_agent.mdmarkdown9.8 KB
resources/research-engine/academic-pipeline/agents/integrity_verification_agent.mdmarkdown70.7 KB
resources/research-engine/academic-pipeline/agents/pipeline_orchestrator_agent.mdmarkdown173.8 KB
resources/research-engine/academic-pipeline/agents/state_tracker_agent.mdmarkdown26.8 KB
resources/research-engine/academic-pipeline/examples/full_pipeline_example.mdmarkdown17.7 KB
resources/research-engine/academic-pipeline/examples/integrity_failure_recovery.mdmarkdown26.8 KB
resources/research-engine/academic-pipeline/examples/mid_entry_example.mdmarkdown13.4 KB
resources/research-engine/academic-pipeline/references/adapters/.gitkeepother0 B
resources/research-engine/academic-pipeline/references/adapters/overview.mdmarkdown10.0 KB
resources/research-engine/academic-pipeline/references/ai_research_failure_modes.mdmarkdown15.6 KB
resources/research-engine/academic-pipeline/references/changelog.mdmarkdown5.8 KB
resources/research-engine/academic-pipeline/references/claim_audit_calibration_protocol.mdmarkdown14.2 KB
resources/research-engine/academic-pipeline/references/claim_verification_protocol.mdmarkdown27.2 KB
resources/research-engine/academic-pipeline/references/external_review_protocol.mdmarkdown6.2 KB
resources/research-engine/academic-pipeline/references/integrity_review_protocol.mdmarkdown7.1 KB
resources/research-engine/academic-pipeline/references/literature_corpus_consumers.mdmarkdown11.7 KB
resources/research-engine/academic-pipeline/references/mode_advisor.mdmarkdown7.8 KB
resources/research-engine/academic-pipeline/references/passport_as_reset_boundary.mdmarkdown18.6 KB
resources/research-engine/academic-pipeline/references/pipeline_state_machine.mdmarkdown28.3 KB
resources/research-engine/academic-pipeline/references/plagiarism_detection_protocol.mdmarkdown13.5 KB
resources/research-engine/academic-pipeline/references/process_summary_protocol.mdmarkdown15.8 KB
resources/research-engine/academic-pipeline/references/progress_dashboard_template.mdmarkdown1.5 KB
resources/research-engine/academic-pipeline/references/reinforcement_content.mdmarkdown1.4 KB
resources/research-engine/academic-pipeline/references/reproducibility_audit.mdmarkdown2.6 KB
resources/research-engine/academic-pipeline/references/score_trajectory_protocol.mdmarkdown3.8 KB
resources/research-engine/academic-pipeline/references/team_collaboration_protocol.mdmarkdown10.1 KB
resources/research-engine/academic-pipeline/references/two_stage_review_protocol.mdmarkdown3.0 KB
resources/research-engine/academic-pipeline/templates/pipeline_status_template.mdmarkdown3.7 KB
resources/research-engine/agents/report_compiler_agent.mdmarkdown26.0 KB
resources/research-engine/agents/research_architect_agent.mdmarkdown25.3 KB
resources/research-engine/agents/screening_reviewer_agent.mdmarkdown4.8 KB
resources/research-engine/agents/synthesis_agent.mdmarkdown28.2 KB
resources/research-engine/commands/ars-3w.mdmarkdown1.1 KB
resources/research-engine/commands/ars-abstract.mdmarkdown1.2 KB
resources/research-engine/commands/ars-cache-invalidate.mdmarkdown1.8 KB
resources/research-engine/commands/ars-citation-check.mdmarkdown971 B
resources/research-engine/commands/ars-disclosure.mdmarkdown1.5 KB
resources/research-engine/commands/ars-format-convert.mdmarkdown1.0 KB
resources/research-engine/commands/ars-full.mdmarkdown1.1 KB
resources/research-engine/commands/ars-lit-review.mdmarkdown1.3 KB
resources/research-engine/commands/ars-mark-read.mdmarkdown2.4 KB
resources/research-engine/commands/ars-outline.mdmarkdown953 B
resources/research-engine/commands/ars-plan.mdmarkdown965 B
resources/research-engine/commands/ars-rebuttal-audit.mdmarkdown1.3 KB
resources/research-engine/commands/ars-reviewer.mdmarkdown1.1 KB
resources/research-engine/commands/ars-revision-coach.mdmarkdown1.5 KB
resources/research-engine/commands/ars-revision.mdmarkdown944 B
resources/research-engine/commands/ars-unmark-read.mdmarkdown1.3 KB
resources/research-engine/deep-research/WORKFLOW.mdmarkdown51.3 KB
resources/research-engine/deep-research/agents/bibliography_agent.mdmarkdown34.4 KB
resources/research-engine/deep-research/agents/devils_advocate_agent.mdmarkdown10.9 KB
resources/research-engine/deep-research/agents/editor_in_chief_agent.mdmarkdown7.9 KB
resources/research-engine/deep-research/agents/ethics_review_agent.mdmarkdown21.7 KB
resources/research-engine/deep-research/agents/meta_analysis_agent.mdmarkdown16.3 KB
resources/research-engine/deep-research/agents/monitoring_agent.mdmarkdown9.2 KB
resources/research-engine/deep-research/agents/report_compiler_agent.mdmarkdown26.0 KB
resources/research-engine/deep-research/agents/research_architect_agent.mdmarkdown25.3 KB
resources/research-engine/deep-research/agents/research_question_agent.mdmarkdown10.1 KB
resources/research-engine/deep-research/agents/risk_of_bias_agent.mdmarkdown12.2 KB
resources/research-engine/deep-research/agents/socratic_mentor_agent.mdmarkdown52.3 KB
resources/research-engine/deep-research/agents/source_verification_agent.mdmarkdown10.3 KB
resources/research-engine/deep-research/agents/synthesis_agent.mdmarkdown28.2 KB
resources/research-engine/deep-research/agents/timeline_extraction_agent.mdmarkdown9.1 KB
resources/research-engine/deep-research/examples/exploratory_research.mdmarkdown6.9 KB
resources/research-engine/deep-research/examples/fact_check_mode.mdmarkdown12.9 KB
resources/research-engine/deep-research/examples/handoff_to_paper.mdmarkdown12.5 KB
resources/research-engine/deep-research/examples/idea_diversity_coverage_gap_advisory.mdmarkdown3.2 KB
resources/research-engine/deep-research/examples/policy_analysis.mdmarkdown9.4 KB
resources/research-engine/deep-research/examples/review_mode.mdmarkdown17.3 KB
resources/research-engine/deep-research/examples/socratic_guided_research.mdmarkdown22.9 KB
resources/research-engine/deep-research/examples/systematic_review.mdmarkdown7.7 KB
resources/research-engine/deep-research/references/apa7_style_guide.mdmarkdown4.6 KB
resources/research-engine/deep-research/references/argumentation_reasoning_framework.mdmarkdown3.9 KB
resources/research-engine/deep-research/references/arxiv_api_protocol.mdmarkdown6.5 KB
resources/research-engine/deep-research/references/changelog.mdmarkdown2.3 KB
resources/research-engine/deep-research/references/chinese_literature_api_protocol.mdmarkdown34.4 KB
resources/research-engine/deep-research/references/cross_agent_quality_definitions.mdmarkdown1.4 KB
resources/research-engine/deep-research/references/crossref_api_protocol.mdmarkdown5.0 KB
resources/research-engine/deep-research/references/equator_reporting_guidelines.mdmarkdown41.8 KB

resources/research-engine/academic-paper/references/mode_selection_guide.md

View on GitHub
# Mode Selection Guide

This guide helps users and the `intake_agent` select the most appropriate operational mode.

---

## Mode Selection Flowchart

```
User Input →
│
├── Already have complete research?
│   ├── Yes → Want a full paper?
│   │   ├── Yes ─────────────────────────→ full mode
│   │   └── No → Just need an outline?
│   │       ├── Yes ─────────────────────→ outline-only mode
│   │       └── No → Just need an abstract?
│   │           ├── Yes ──────────────────→ abstract-only mode
│   │           └── No → Just need a literature review?
│   │               ├── Yes ─────────────→ lit-review mode
│   │               └── No ──────────────→ full mode
│   │
│   └── No → Want guided thinking?
│       ├── Yes ─────────────────────────→ plan mode ★ NEW
│       └── No ──────────────────────────→ full mode (Phase 0 will conduct an interview)
│
├── Have an existing paper to revise? ──────────────────────→ revision mode
├── Have comments explicitly identified as coming from a real committee or institutional review office?
│   └── Need tracking / response preparation ───────────────→ revision-coach committee-correspondence variant
├── Have reviewer comments to handle?
│   ├── Comments only, no response written yet ──────────→ revision-coach mode
│   └── Comments + an existing rebuttal/response draft ──→ rebuttal-audit mode
├── Need an AI-usage disclosure statement? ─────────────────→ disclosure mode
├── Just need format conversion? ────────────────────────→ format-convert mode
└── Just need a citation check? ────────────────────────→ citation-check mode
```

---

## Detailed Description of Each Mode

### full mode — Complete Paper Writing

**Applicable Scenarios**:
- User has a clear research question and (partial) materials
- Needs to produce a complete paper from start to finish
- Includes all phases: Interview → Literature → Structure → Argumentation → Writing → Citation → Review → Formatting

**Not Applicable When**:
- User has no idea about research direction (→ use `deep-research` first)
- Only need a specific section (→ use another specialized mode)

**Expected Output**: Complete paper draft + references + bilingual abstract + review report
**Expected Duration**: Long (all 8 Phases fully executed)
**Agents Used**: All 9 + socratic_mentor (if needed)

---

### outline-only mode — Outline Generation

**Applicable Scenarios**:
- Only need the paper structure and outline
- A proposal to submit to an advisor for review
- Need to quickly plan the paper structure

**Not Applicable When**:
- Need complete paper content (→ full mode)
- Need guided thinking (→ plan mode)

**Expected Output**: Detailed outline + evidence allocation + word count distribution
**Expected Duration**: Short (Phase 0-2)
**Agents Used**: intake → literature_strategist → structure_architect

---

### plan mode — Chapter-by-Chapter Guided Planning ★ NEW

**Applicable Scenarios**:
- User has ideas but they are not yet clear enough
- Wants guided thinking for each chapter's content
- First-time academic paper writer
- Wants to think through every section before writing
- Just received materials from deep-research and needs to transform them into a paper plan

**Not Applicable When**:
- Already knows exactly what to write (→ full mode is faster)
- Only needs an outline without deep thinking (→ outline-only mode)
- Time-pressured and needs rapid output (→ full mode)

**Expected Output**: Chapter Plan + INSIGHT Collection
**Expected Duration**: Medium (Step 0-3, approximately 20-30 rounds of conversation)
**Agents Used**: intake → socratic_mentor → structure_architect → argument_builder

**Subsequent Connections**:
- Chapter Plan → full mode (produce complete paper)
- Chapter Plan → academic-paper-reviewer (review the plan)

---

### revision mode — Paper Revision

**Applicable Scenarios**:
- Already have a completed paper draft
- Received reviewer comments requiring revision
- Feel certain sections need improvement

**Not Applicable When**:
- No existing paper draft (→ full mode)
- Only need to check citation format (→ citation-check mode)

**Expected Output**: Revised paper + revision notes (tracked changes)
**Expected Duration**: Medium
**Agents Used**: peer_reviewer → draft_writer → citation_compliance

**Prerequisite**: User must provide existing paper content

---

### abstract-only mode — Abstract Writing

**Applicable Scenarios**:
- Paper is already complete, only need an abstract
- Need to submit a conference abstract
- Need a bilingual abstract

**Not Applicable When**:
- No paper content to summarize (→ full mode or plan mode)

**Expected Output**: Bilingual abstract in the run's declared output language pair (`output_language_pair`; default zh-TW + EN) + keywords
**Expected Duration**: Short
**Agents Used**: intake → abstract_bilingual

---

### lit-review mode — Literature Review

**Applicable Scenarios**:
- Need a literature review on a specific topic
- Preparing the Literature Review chapter of a paper
- Need a systematic search strategy and literature matrix

**Not Applicable When**:
- Need a complete paper (→ full mode)
- Need an in-depth research investigation (→ deep-research)

**Expected Output**: Annotated bibliography + literature matrix + synthesis analysis
**Expected Duration**: Medium
**Agents Used**: intake → literature_strategist

---

### format-convert mode — Format Conversion

**Applicable Scenarios**:
- Already have paper content, need format conversion
- Markdown → LaTeX / DOCX / PDF
- Need to comply with a specific journal's formatting requirements

**Not Applicable When**:
- No existing content (→ full mode)
- Need content modifications (→ revision mode)

**Expected Output**: Document in target format
**Expected Duration**: Short
**Agents Used**: formatter used standalone

---

### citation-check mode — Citation Check

**Applicable Scenarios**:
- Already have a paper, only need to check citation format
- Final check before submission
- Switching citation format (e.g., APA → IEEE)

**Not Applicable When**:
- No existing citation list (→ full mode)
- Need to modify paper content (→ revision mode)

**Expected Output**: Citation error report + automatic correction suggestions
**Expected Duration**: Short
**Agents Used**: citation_compliance used standalone

---

### revision-coach mode — Reviewer-Comment Triage

**Applicable Scenarios**:
- Received reviewer comments / a decision letter and need them parsed into a structured plan
- Want a Revision Roadmap that classifies, maps, and prioritizes each comment
- Need a Response Letter Skeleton to start drafting replies
- Deciding whether to address or push back on a comment (disagreement posture)
- Non-journal scopes: conference rebuttal, grant-panel response, transfer-after-review

**Not Applicable When**:
- Already have a written rebuttal/response draft you want QA'd (→ rebuttal-audit mode)
- The paper itself needs rewriting based on the comments (→ revision mode)

**Expected Output**: Revision Roadmap + optional Tracking Template + Response Letter Skeleton
**Expected Duration**: Short-Medium
**Agents Used**: revision_coach_agent used standalone (no prior pipeline execution required)

**Committee-correspondence variant**: when the user explicitly identifies comments
from a real committee or institutional review office, this same entrypoint loads
`committee_correspondence_protocol.md` and emits the separate #668 byte-accounted
concern tracker plus placeholder response skeleton. It does not emit the reviewer
Roadmap, Schema 11, priority/severity, a determination, or a resolution claim. Formal
tone alone never activates the variant.

---

### disclosure mode — AI-Usage Disclosure Outcome

**Applicable Scenarios**:
- Paper is drafted and you need venue-specific disclosure text or a policy action checklist
- Submitting under a covered policy target (ICLR, NeurIPS, Nature, Science, ACL, EMNLP, or a covered medical-publishing target: ICMJE, NEJM, The Lancet, JAMA, BMJ, PLOS, Frontiers, publisher-wide 中华护理杂志社, journal-level 国际眼科杂志)
- Need placement/action guidance for every required manuscript or submission channel

**Not Applicable When**:
- No paper drafted yet — disclosure is a finishing step (→ full mode first)
- The venue is not in the policy database (confirm the venue's current policy manually)

**Expected Output**: Default venue path — `REQUIRED` / `ACTION_ONLY` / `NOT_REQUIRED` / `UNKNOWN` applicability plus typed halt status; policy-anchor path — anchor-specific render
**Expected Duration**: Short
**Agents Used**: formatter agent's standalone disclosure branch, which loads the disclosure protocol before the venue policy database or policy-anchor lookup; it does not run normal Phase 7 formatting

---

### rebuttal-audit mode — Rebuttal-Draft QA

**Applicable Scenarios**:
- You already wrote a rebuttal/response-to-reviewers draft and want it checked before sending
- Need a per-comment coverage table (which reviewer concerns the draft addresses, partially addresses, or misses)
- Want risk flags for tone (too combative), unsupported claims, or a response that misreads the reviewer's point

**Not Applicable When**:
- You have reviewer comments but have **not** written a response yet (→ revision-coach mode, which *generates* a skeleton)
- The manuscript itself needs revising (→ revision mode)

**Input gate**: requires BOTH (a) the reviewer comments / decision letter AND (b) an existing rebuttal draft. Comments only → route to revision-coach. If intent is ambiguous, clarify rather than guess.

**Expected Output**: Advisory QA report — per-comment coverage + gap list + risk flags. Generates no new response.
**Expected Duration**: Short
**Agents Used**: revision_coach_agent's comment-parsing capability, run standalone (advisory)

**Integrity boundary**: a standalone invocation runs **outside** the pipeline, so rebuttal-audit does **not** emit a Schema 11 ledger, does **not** write the Material Passport, and does **not** mark anything `ready_to_submit` or verified. The output is advisory QA only.

---

## Paths from deep-research

```
deep-research completed
  │
  ├── deep-research (full mode) outputs:
  │   RQ Brief + Methodology Blueprint + Annotated Bibliography + Synthesis Report
  │   │
  │   ├── Want to write the paper directly ──→ academic-paper (full mode)
  │   │   intake_agent auto-detects materials, skips redundant questions
  │   │
  │   └── Want to plan before writing ──→ academic-paper (plan mode)
  │       socratic_mentor leverages existing materials to accelerate guidance
  │
  └── deep-research (socratic mode) outputs:
      INSIGHT Collection + Synthesis Report
      │
      ├── INSIGHTs are sufficiently clear ──→ academic-paper (full mode)
      │
      └── Need more guidance ──→ academic-paper (plan mode)
          socratic_mentor continues deepening from INSIGHTs
```

## Connecting to academic-paper-reviewer

```
academic-paper completed
  │
  ├── full mode produces complete paper ──→ academic-paper-reviewer (full / guided)
  │   Complete peer review + revision suggestions
  │
  ├── plan mode produces Chapter Plan ──→ academic-paper-reviewer (guided)
  │   Review the plan's feasibility and completeness
  │
  └── reviewer feedback ──→ academic-paper (revision mode)
      Revise paper based on review comments
```

---

## Common Misselection Scenarios

| User Says | Easily Misselected | Correct Choice | Reason |
|---------|---------|---------|------|
| "Help me write an outline" / 「幫我寫大綱」 | outline-only | First confirm: Do they want a simple outline or deep planning? | May need plan mode |
| "I want to write a paper but don't know how to start" / 「想寫論文但不知道怎麼開始」 | full | plan mode | Needs guided thinking |
| "Help me revise my paper" / 「幫我修改論文」 | revision | First confirm: Are there reviewer comments? | May need full mode rewrite |
| "Help me search for literature" / 「幫我找文獻」 | lit-review | First confirm: Is it a literature review for a paper or a research investigation? | May need deep-research |
| "I have deep-research results, help me write a paper" / 「我有研究結果,幫我寫成論文」 | full (skip Phase 0 directly) | full (but intake needs to detect handoff) | Materials need to be properly imported |
| "I want to plan my paper step by step" / 「我想逐步規劃論文」 | outline-only | plan mode | Needs interactive guidance |
| "The paper format is wrong" / 「論文格式不對」 | revision | citation-check or format-convert | May only need format correction |
| 「帶我寫論文」/「引導我寫論文」 | full | plan mode | 使用者需要互動式引導,不是直接產出 |
| 「第一次寫論文」/「論文新手」 | full | plan mode | 新手需要蘇格拉底式逐章引導 |

---

## Quick Decision Table

| What Do You Have? | What Do You Want? | Choose This Mode |
|-----------|-----------|------------|
| Nothing | Complete paper | plan mode → full mode |
| Research question + literature | Complete paper | full mode |
| Research question + literature | Outline | outline-only mode |
| Vague idea | Paper plan | plan mode |
| deep-research results | Complete paper | full mode (auto-handoff) |
| deep-research results | Guided planning | plan mode |
| Completed paper | Revision | revision mode |
| Completed paper | Abstract | abstract-only mode |
| Completed paper | Format conversion | format-convert mode |
| Completed paper | Citation check | citation-check mode |
| Reviewer comments (no response yet) | Parse + roadmap + reply skeleton | revision-coach mode |
| Real-committee comments (explicitly identified; no response yet) | Preserve source + concern tracker + placeholder response skeleton | revision-coach committee-correspondence variant |
| Reviewer comments + a written rebuttal draft | QA the draft before sending | rebuttal-audit mode |
| Drafted paper + target venue | AI-usage disclosure bundle or policy action checklist | disclosure mode |

---

### Plan to Full Mode Conversion Protocol

When a user completes `plan` mode and wants to proceed to `full` mode for actual paper writing:

#### Conversion Checklist

| Plan Mode Output | Full Mode Input | Conversion Action |
|-----------------|-----------------|-------------------|
| Chapter Plan (structure outline) | `structure_architect` agent | Map chapters → formal sections with heading levels; validate against `paper_structure_patterns.md` |
| Socratic Responses (Q&A transcripts) | `argument_builder` agent | Extract claims + evidence + warrants from dialogue; discard conversational scaffolding |
| Literature Notes (if any) | `literature_strategist` agent | Independent execution — plan mode notes serve as seed keywords only; full systematic search required |
| Argument Sketches | `argument_builder` agent | Evaluate each sketch against 4-level scoring; only `adequate` or above proceed |

#### Quality Gate

Before conversion, ALL of the following must be true:
- [ ] Every chapter in the Chapter Plan has at least 1 argument sketch rated `adequate` or above
- [ ] The overall paper structure maps to a recognized pattern in `paper_structure_patterns.md`
- [ ] At least 5 potential references have been identified (seeds for `literature_strategist`)
- [ ] The research question is finalized (not still evolving from Socratic dialogue)

#### What Gets Discarded
- Conversational filler from Socratic dialogue (greetings, confirmations, repetitions)
- Tentative ideas explicitly marked as "maybe" or "not sure" by the user
- Plan mode's iterative drafts (only the final version of each chapter plan carries over)

---

## Trigger-to-Mode Mapping Examples

```
"Write a paper on SDGs in HEI"           -> full
"Give me a paper outline for..."         -> outline-only
"Revise this paper based on feedback"    -> revision
"Write an abstract for this paper"       -> abstract-only
"Do a literature review on..."           -> lit-review
"Convert this paper to LaTeX"            -> format-convert
"Convert citations to IEEE"              -> format-convert
"Check the citations in this paper"      -> citation-check
"guide my paper"                         -> plan
"help me plan my paper"                  -> plan
"I got reviewer comments"               -> revision-coach
"parse these reviews"                    -> revision-coach
"help me with my revision"              -> revision-coach
"should we push back on reviewer 2"     -> revision-coach
"conference rebuttal" / "grant response" -> revision-coach
"track these committee comments"          -> revision-coach committee-correspondence variant (only with explicit real-source identity)
"audit my rebuttal draft"               -> rebuttal-audit (needs comments + an existing draft)
"did I miss any reviewer comment"       -> rebuttal-audit
"AI disclosure for Nature"              -> disclosure
"generate an AI usage statement"        -> disclosure
```
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall