YCC-Lover/research-starter-skills / skills/research-starter-paper
research-starter-paper
Unverified科研学习与论文写作总入口,协调六个模块。帮助不知道提供什么材料的新手逐步产出、自动保存和恢复项目进度,也用于跨阶段研究任务;区分学习、执行和只读检查。
resources/research-engine/academic-pipeline/references/reproducibility_audit.md
View on GitHub# Auditability and Re-execution Documentation
The pipeline standardizes stage contracts and records artifacts so a run can be inspected. This does not ensure identical model behaviour, judgements, or manuscript quality across executions.
## Standardized Workflow
| Contract surface | Mechanism and boundary |
|---------------|-----------|
| Integrity check every time | Stage 2.5 + Stage 4.5 are **mandatory** stages, cannot be skipped |
| Declared review angles | Journal-Fit Reviewer + R1/R2/R3 + Devil's Advocate — five role-separated perspectives; this is not evidence of independent errors or consistent findings |
| Declared verification procedure | integrity_verification_agent uses standardized templates and records coverage; semantic decisions and retrieval availability can vary |
| Explicit gate rules | Integrity PASS/FAIL criteria are inspectable; passing applies only to the registered/checked population and named verdict classes |
| Traceable workflow | Every stage's deliverables are recorded, enabling retrospective audit |
## Audit Trail
When the pipeline ends, state_tracker_agent produces a complete audit trail:
```
Pipeline Audit Trail
====================
Topic: [topic]
Started: [time]
Completed: [time]
Total Stages: [X/9]
Stage 1 RESEARCH: [mode] -> [output count]
Stage 2 WRITE: [mode] -> [word count]
Stage 2.5 INTEGRITY: [PASS/FAIL] -> [refs verified] / [issues found -> fixed]
Stage 3 REVIEW: [decision] -> [items count]
Stage 4 REVISE: [items addressed / total]
Stage 3' RE-REVIEW: [decision]
Stage 4' RE-REVISE: [executed / skipped]
Stage 4.5 FINAL INTEGRITY: [PASS/FAIL] -> [refs verified]
Stage 5 FINALIZE: Ask format style -> MD -> DOCX via Pandoc when available (otherwise instructions) -> LaTeX (apa7/ieee/etc.) -> tectonic -> PDF
Stage 6 PROCESS SUMMARY: Ask language -> MD -> LaTeX -> PDF (zh/en)
Integrity Summary:
Pre-review: [X] refs checked, [Y] issues found, [Y] fixed
Final: [X] refs checked, [Y] issues found, [Y] fixed
Overall: [CLEAN / ISSUES NOTED]
```
## Re-execution boundary (v3.3.5+)
This document defines a PROCESS CONTRACT — declared stages, reviewer roles,
gate rules, and retained artifacts. It does not promise consistent outputs.
For computational re-execution documentation, see
[`../../shared/artifact_reproducibility_pattern.md`](../../shared/artifact_reproducibility_pattern.md).
The pipeline enforces process routing and deterministic validators where specified.
The Material Passport's optional `repro_lock` records configuration for inspection;
it is not a byte-replay guarantee for LLM output. The audit trail supports comparison,
not proof of equivalent outcomes or quality.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |