zrwangems/dsh-zrwang-plugin / ars/skills/academic-pipeline
academic-pipeline
Flagged学术研究总编排:研究→写作→诚信检查→评审→返修→复审→终检→定稿的十阶段流水线,每阶段停在用户确认点,含材料护照与 7 类 AI 研究失败模式检查。Triggers: academic pipeline, research to paper, full paper workflow, end-to-end paper | 完整论文流程, 从研究到论文, 端到端写论文, 论文流水线。
examples/mid_entry_example.md
View on GitHub# Example: Mid-Entry into Pipeline
## Scenario Description
**User type**: University professor, experienced in paper writing
**Scenario**: Already completed an English paper draft, wants a simulated review before submission
**Goal**: Review --> Revision --> Format conversion (LaTeX)
**Language**: English (paper is in English; conversation with orchestrator in English)
---
## User Input
```
I've already written an English paper titled "Machine Learning Approaches for
Predicting University Attrition Risk in Taiwan," approximately 7,000 words.
I'd like a simulated review before submitting.
```
---
## Pipeline Execution Log
### Orchestrator: Mid-Entry Detection
```
Detection results:
- Materials: Complete English paper draft (7,000 words)
- Goal: Simulated review + revision + submission preparation
- Entry point: Stage 3 (REVIEW)
- User type: Experienced researcher
Detected that you have a complete paper — you can proceed directly to Stage 3 (REVIEW).
Before starting, let me confirm a few things:
1. What's the paper structure? (IMRaD / other)
2. What review mode would you like?
- full: Complete 5-person review (Journal-Fit Reviewer + R1/R2/R3 + Devil's Advocate)
- quick: Journal-Fit Reviewer quick assessment (15-minute version)
- guided: Socratic guided review (interactive dialogue)
3. Which journal (or what tier) are you targeting?
4. Will you need revision and format conversion after the review?
If you later want to revise based on review comments, I'll automatically guide you to Stage 4.
```
**User**: IMRaD structure, I'd like a quick review first to see if there are any big-picture issues. Targeting Computers & Education (SSCI Q1). Will decide about revision after the review.
### Orchestrator: Confirm Configuration
```
Got it. Pipeline configuration:
Stage 1 RESEARCH [--] Skipped (you already have a research foundation)
Stage 2 WRITE [--] Skipped (you already have a complete paper)
Stage 3 REVIEW: quick -- Journal-Fit Reviewer quick assessment first, checking the big picture
Stage 4 REVISE: TBD -- based on Stage 3 results
Stage 5 FINALIZE: TBD -- when needed
Start Stage 3 (REVIEW) quick mode?
Progress: [--]Research -> [--]Writing -> [..]Review -> [ ]Revision -> [ ]Finalization
```
**User**: Start.
---
### Stage 3: REVIEW (quick mode)
```
Entering Stage 3 (REVIEW) -- using academic-paper-reviewer quick mode
Loading academic-paper-reviewer SKILL.md...
Receiving user-provided paper draft...
field_analyst_agent analyzing paper domain...
eic_agent executing quick assessment...
```
**Field Analysis (quick version):**
```
Paper domain: Educational Data Mining / Higher Education
Method type: Machine Learning (Supervised Classification)
Target journal: Computers & Education (SSCI Q1, IF: 12.0)
Journal-Fit Reviewer Persona:
Computers & Education Associate Editor
Specialization: Learning Analytics, Educational AI
```
**Journal-Fit Reviewer Quick Assessment:**
```
Overall: Promising but needs work (Minor-to-Major Revision range)
Key Strengths (top 3):
1. Timely topic -- university attrition prediction highly relevant
in Taiwan's demographic context
2. Good feature engineering -- combining MOE open data with
institutional records is novel
3. Clear methodology -- model comparison (RF, XGBoost, LSTM)
is well-structured
Key Concerns (top 3):
C1: [CRITICAL] Ethical considerations section is missing.
C&E requires explicit discussion of algorithmic fairness,
student privacy, and potential discriminatory outcomes.
C2: [MAJOR] Model interpretability not discussed.
C&E reviewers expect SHAP values or similar explainability
analysis, not just accuracy metrics.
C3: [MAJOR] Literature gap -- no mention of Dropout Factory
literature (Balfanz & Legters, 2004) or recent European
attrition studies. Too Taiwan-centric for an international
journal.
Quick Verdict: Major Revision
Before full submission, address C1-C3.
Estimated revision effort: 2-3 weeks.
```
**Stage 3 Deliverables:**
- Journal-Fit Reviewer Quick Assessment Report
- 3 key issues list (priority sorted)
---
### Orchestrator: Transition Recommendation
```
Stage 3 (REVIEW) quick mode Complete!
Review result: Major Revision direction
C1: [CRITICAL] Missing ethics discussion (hard requirement for C&E)
C2: [MAJOR] Missing model interpretability analysis
C3: [MAJOR] Literature review lacks international perspective
This is the quick review result. You have several options:
a) Proceed directly to Stage 4 (REVISE) to address these 3 issues
b) Upgrade to full review (complete five-seat review),
to see if there are other issues
c) Revise on your own first, come back when done
My recommendation: Since you're targeting C&E (Q1 journal),
fix C1-C3 first, then do a full review to ensure quality.
Which do you choose?
```
**User**: Fix C1-C3 first, then do full review.
### Orchestrator: Update Configuration
```
OK, updating pipeline:
Stage 3 REVIEW (quick): [v] Completed
Stage 4 REVISE: [..] Next -- fix C1-C3
Stage 3' RE-REVIEW: full mode -- full review after revision
Stage 5 FINALIZE: TBD
Start Stage 4 (REVISE)?
Progress: [--]Research -> [--]Writing -> [v]Review -> [..]Revision -> [ ]Re-review -> [ ]Finalization
```
**User**: Start revision.
---
### Stage 4: REVISE (revision mode, Round 1)
```
Entering Stage 4 (REVISE) -- using academic-paper revision mode
Loading academic-paper SKILL.md (revision mode)...
Passing Paper Draft + Quick Assessment Report...
```
**Revision Progress Tracking:**
```
C1: [v] Added Ethics & Fairness section (Section 5.3)
- Algorithmic fairness analysis (demographic parity, equalized odds)
- Student privacy framework (FERPA-equivalent for Taiwan)
- Potential discriminatory outcomes discussion
- Added 5 citations on AI ethics in education
C2: [v] Added Model Interpretability analysis (Section 4.3)
- SHAP value analysis for top 20 features
- Feature importance comparison across 3 models
- Case study: 3 individual prediction explanations
- Added SHAP visualization figures
C3: [v] Expanded Literature Review (Section 2)
- Added Dropout Factory framework (Balfanz & Legters)
- Added 6 European attrition studies (2020-2026)
- Added cross-cultural comparison discussion
- Restructured into 3 sub-sections: global -> Asia -> Taiwan
```
**Stage 4 Deliverables:**
- Revised Draft (9,200 words, 2,200 words more than original)
- Response to Reviewers (R-A-C format, 3 items all addressed)
---
### Orchestrator: Stage 4 --> 3' Transition
```
Stage 4 (REVISE) Complete!
Revision results:
- 3/3 issues all addressed
- Paper expanded from 7,000 to 9,200 words
- Added Ethics section, SHAP analysis, international literature
- Added 11 new citations
Next step is Stage 3' (RE-REVIEW) -- this time using a user-requested fresh full review,
not the contract-governed verification re-review. Five role-separated seats will
review the revised version (four configured identities plus the fixed Devil's Advocate).
This is revision cycle 1 (max 2 cycles).
Submit for full review?
Progress: [--]Research -> [--]Writing -> [v]Review -> [v]Revision -> [..]Re-review -> [ ]Finalization
```
**User**: Submit.
---
### Stage 3': RE-REVIEW (full mode, Loop 1)
```
Entering Stage 3' (RE-REVIEW) -- full mode, Loop 1/2
Loading academic-paper-reviewer SKILL.md (full mode)...
Passing Revised Draft + Response to Reviewers + Editorial Decision Letter (#539 Judge Record input)...
field_analyst_agent analyzing (legitimate here: the user requested a NEW full review
of the revised version — a fresh review, not a verification re-review — and full mode
runs field_analyst by definition; Round 1 was an ARS quick assessment. The yardstick
freeze in re_review_mode_protocol.md § Yardstick Continuity governs re-review mode only)...
```
**Reviewer Configuration:**
```
Journal-Fit Reviewer (serialized source ID EIC):
Computers & Education Associate Editor
Educational AI, Learning Analytics
Reviewer 1: Machine Learning expert
Predictive modeling, Model evaluation
Reviewer 2: Higher Education researcher
Student success, Retention strategies
Reviewer 3: Research Ethics / Data Science ethicist
Algorithmic fairness, Educational data mining ethics
Fixed seat: Devil's Advocate
Core-argument stress test, strongest counter-explanations
```
**5 Review Reports Compiled:**
```
Journal-Fit Reviewer: Minor Revision
- C1 response adequate, Ethics section well-structured
- Recommend updating Abstract to reflect new ethics + interpretability contributions
- Recommend adding a Practical Implications section for university administrators
Reviewer 1: Accept
- SHAP analysis thorough and insightful
- Model comparison fair and well-documented
- Minor: Table 3 precision/recall should include confidence intervals
Reviewer 2: Minor Revision
- International literature coverage greatly improved
- Recommend Discussion add dialogue with Tinto's Student Integration Model
- Minor: Section 2.1 citation Chen (2023) should be Chen (2024)
Reviewer 3: Accept
- Ethics section quality is high, exceeding typical C&E standards
- Algorithmic fairness metrics well-chosen
- Recommend adding a "limitations of fairness metrics" reflection paragraph
Devil's Advocate: No unresolved Critical challenge
- Fairness metrics still rely on contested group definitions
- Preserve this limitation explicitly rather than presenting the metrics as complete
```
**Editorial Decision: Minor Revision (Accept direction)**
```
Required Revisions:
R1: Update Abstract (reflect new contributions)
R2: Add Practical Implications section
Suggested Revisions:
S1: Table 3 add confidence intervals
S2: Discussion add Tinto's model dialogue
S3: Fix Chen (2023) -> Chen (2024) citation year
S4: Add fairness metrics limitations paragraph
```
---
### Orchestrator: Quick Revision + FINALIZE
```
Stage 3' (RE-REVIEW) Complete!
Review result: Minor Revision (Accept direction)
- Among the 4 non-DA scoring reviewers: 2 Accept + 2 Minor Revision
- The fixed Devil's Advocate raised no unresolved Critical challenge
- 2 required items (Abstract update + Practical Implications)
- 4 suggested modifications
These are all minor changes that can be handled during Stage 5 (FINALIZE).
Or would you prefer a formal Stage 4 revision before another review?
My recommendation: Since all items are minor, proceed directly to Stage 5 and handle them together.
What format do you need?
a) LaTeX (.tex + .bib) -- suitable for C&E submission
b) Other formats
Progress: [--]Research -> [--]Writing -> [v]Review -> [v]Revision -> [v]Re-review -> [..]Finalization
```
**User**: Go straight to finalize, LaTeX format.
---
### Stage 5: FINALIZE (format-convert mode)
```
Entering Stage 5 (FINALIZE) -- format-convert mode
Simultaneously handling minor revision items:
R1: [v] Abstract updated
R2: [v] Added Practical Implications section (200 words)
S1: [v] Table 3 confidence intervals added
S2: [v] Discussion Tinto's model paragraph added
S3: [v] Chen citation year corrected
S4: [v] Fairness metrics limitations paragraph added
formatter_agent executing LaTeX conversion...
- Using Elsevier article template (C&E format)
- Producing .tex + .bib + figures/
- Producing cover letter draft
```
**Stage 5 Deliverables:**
- `ml_university_attrition_taiwan.tex` (LaTeX main text)
- `references.bib` (BibTeX file)
- `figures/` (all figures and tables)
- `cover_letter.tex` (submission cover letter draft)
---
### Orchestrator: Pipeline Complete
```
+=========================================+
| Academic Pipeline Status |
+=========================================+
| Topic: ML Approaches for Predicting |
| University Attrition Risk |
+-----------------------------------------+
Stage 1 RESEARCH [--] Skipped
Stage 2 WRITE [--] Skipped
Stage 3 REVIEW [v] Completed
Mode: quick
Decision: Major Revision (3 items)
Stage 4 REVISE [v] Completed
Round: 1, Addressed: 3/3
Stage 3' RE-REVIEW [v] Completed
Mode: full, Loop: 1/2
Decision: Minor Revision (Accept)
Stage 5 FINALIZE [v] Completed
Format: LaTeX (Elsevier)
+-----------------------------------------+
| Materials: |
| [--] RQ Brief (skipped) |
| [--] Methodology (skipped) |
| [--] Bibliography (skipped) |
| [--] Synthesis (skipped) |
| [v] Paper Draft (user-provided) |
| [v] Review Reports (quick + full) |
| [v] Revision Roadmap |
| [v] Revised Draft (9,500 words) |
| [v] Response to Reviewers |
| [v] Final Paper (LaTeX) |
+-----------------------------------------+
| Revision History: |
| Round 1: Major -> 3/3 addressed |
| RE-REVIEW: Minor (Accept direction) |
| Final minor fixes in FINALIZE |
+-----------------------------------------+
| Pipeline Complete! |
+=========================================+
Your paper is ready for submission to Computers & Education.
Final deliverables:
1. ml_university_attrition_taiwan.tex (main text)
2. references.bib (citations)
3. figures/ (figures and tables)
4. cover_letter.tex (submission cover letter draft)
Pre-submission recommendations:
- Read through the cover letter one more time, adjust to your tone
- Confirm C&E Author Guidelines for any additional formatting requirements
- Prepare Highlights (3-5 bullet points) and Graphical Abstract
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |