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 | 完整论文流程, 从研究到论文, 端到端写论文, 论文流水线。
_shared/sprint_contract.schema.json
View on GitHub{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://github.com/Imbad0202/academic-research-skills/shared/sprint_contract.schema.json",
"title": "ARS Sprint Contract (Schema 13.2)",
"type": "object",
"additionalProperties": false,
"required": [
"contract_id",
"mode",
"stage",
"baseline_version",
"acceptance_dimensions",
"failure_conditions"
],
"$comment": "Schema 13.2 retains Schema 13.1's mode-conditional measurement_procedure and panel_size gates, and adds reviewer role-scoping in branch 13. Writer / evaluator contracts remain byte-unchanged and do not carry reviewer role fields.",
"properties": {
"contract_id": {
"type": "string",
"pattern": "^[a-z_]+/[a-z_]+/v\\d+$"
},
"mode": {
"enum": [
"reviewer_full",
"reviewer_methodology_focus",
"reviewer_calibration",
"reviewer_guided",
"writer_full",
"evaluator_full"
]
},
"stage": { "type": "string", "minLength": 1 },
"baseline_version": {
"type": "string",
"pattern": "^v\\d+\\.\\d+\\.\\d+$"
},
"panel_size": { "type": "integer", "minimum": 1 },
"acceptance_dimensions": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": ["id", "name", "description", "priority"],
"properties": {
"id": { "type": "string", "pattern": "^D[1-9][0-9]?$" },
"name": { "type": "string", "pattern": "^[a-z][a-z0-9_]*$" },
"description": { "type": "string", "minLength": 1 },
"priority": { "$ref": "#/$defs/priority" },
"eligible_roles": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": { "$ref": "#/$defs/reviewer_role" }
},
"owner_role": { "$ref": "#/$defs/reviewer_role" }
}
}
},
"measurement_procedure": {
"type": "object",
"additionalProperties": false,
"required": [
"reviewer_must_output_before_paper",
"scoring_plan_schema",
"paraphrase_minimum_dimensions"
],
"properties": {
"reviewer_must_output_before_paper": {
"type": "array",
"minItems": 2,
"items": { "type": "string", "minLength": 1 }
},
"scoring_plan_schema": {
"type": "object",
"additionalProperties": false,
"required": ["required"],
"properties": {
"required": {
"type": "array",
"minItems": 5,
"uniqueItems": true,
"items": {
"enum": [
"dimension_id",
"what_to_look_for",
"what_triggers_block",
"what_triggers_warn",
"what_triggers_fatal"
]
},
"$comment": "The five canonical Phase-1 fields are fixed by sprint_contract_protocol.md §4. minItems:5 + uniqueItems:true + enum-constrained items rejects empty lists, partial lists, and typoed entries at CI time instead of letting them fail at runtime as Phase-1 lint."
}
}
},
"paraphrase_minimum_dimensions": {
"anyOf": [
{ "const": "all" },
{ "type": "integer", "minimum": 1 }
]
}
}
},
"pre_commitment_artifacts": {
"type": "object",
"additionalProperties": false,
"required": ["acceptance_criteria_paraphrase"],
"$comment": "Schema 13.1 v3.6.6 §3.4.1 (writer-only). Carries only invariant, paper-agnostic policy: how many acceptance_dimensions the writer must paraphrase in Phase 4a paper-blind output. Everything paper-specific lives in upstream runtime artefacts and is read at Phase 4a / 4b runtime, not committed in the frozen contract baseline. Per-section word counts come from the Paper Configuration Record (intake_agent); section outline comes from the Structure Architect's approved outline (structure_architect_agent); CER chains come from the Argument Blueprint (argument_builder_agent). Writer dimensions D1 (section_completeness), D3 (argument_blueprint_fidelity), D4 (total_word_count), D5 (per_section_word_count) phrase their gates against those upstream artefacts rather than against contract-embedded values. Required for writer_full only (allOf branch 11).",
"properties": {
"acceptance_criteria_paraphrase": {
"type": "object",
"additionalProperties": false,
"required": ["minimum_dimensions"],
"$comment": "CONFIGURATION declaration, not the paraphrase content itself. Declares how many of the contract's acceptance_dimensions the writer must paraphrase in Phase 4a. The actual paraphrase text is a runtime artifact emitted by draft_writer_agent in its Phase 4a output (analogous to how reviewer paraphrase content lives in <phase1_output>, not in the contract). Mirrors reviewer measurement_procedure.paraphrase_minimum_dimensions semantics.",
"properties": {
"minimum_dimensions": {
"anyOf": [
{ "const": "all" },
{ "type": "integer", "minimum": 1 }
],
"$comment": "Default in shipped writer template: 'all'."
}
}
}
}
},
"disagreement_handling": {
"type": "object",
"additionalProperties": false,
"required": ["paraphrase_minimum_dimensions", "scoring_plan", "pre_commitment_check_protocol", "disagreement_resolution"],
"$comment": "Schema 13.1 v3.6.6 §3.4.2 (evaluator-only). Required for evaluator_full only (allOf branch 12).",
"properties": {
"paraphrase_minimum_dimensions": {
"anyOf": [
{ "const": "all" },
{ "type": "integer", "minimum": 1 }
],
"$comment": "How many of the contract's acceptance_dimensions the evaluator must paraphrase in Phase 6a paper-blind output (the contract_paraphrase artifact named in §1 design goal 2 / §4.3). Mirrors reviewer measurement_procedure.paraphrase_minimum_dimensions and writer pre_commitment_artifacts.acceptance_criteria_paraphrase.minimum_dimensions to keep the Phase-6a anti-drift gate hard-required at the schema layer rather than relying on prose-level commitments. Default in shipped evaluator template: 'all'."
},
"scoring_plan": {
"type": "object",
"additionalProperties": false,
"required": ["per_dimension_criteria"],
"properties": {
"per_dimension_criteria": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": ["dimension_id", "what_to_look_for", "what_triggers_block", "what_triggers_warn"],
"properties": {
"dimension_id": { "type": "string", "pattern": "^D[1-9][0-9]?$" },
"what_to_look_for": { "type": "string", "minLength": 1 },
"what_triggers_block": { "type": "string", "minLength": 1 },
"what_triggers_warn": { "type": "string", "minLength": 1 }
},
"$comment": "Mirrors reviewer measurement_procedure.scoring_plan_schema four-field structure. Evaluator commits these in Phase 6a paper-blind."
}
}
}
},
"pre_commitment_check_protocol": {
"type": "object",
"additionalProperties": false,
"required": ["check_writer_artifact"],
"properties": {
"check_writer_artifact": {
"const": "pre_commitment_artifacts",
"$comment": "Pinned to the single writer source for v3.6.6. Field shape exists (rather than inlining the const) for forward compatibility — when v3.6.7+ may add additional writer artifacts, this can relax to an enum without a breaking schema change."
}
}
},
"disagreement_resolution": {
"type": "object",
"additionalProperties": false,
"required": ["on_dimension_disagreement", "on_structural_drift"],
"$comment": "Both subfield enums use the fully-qualified evaluator_decision=* vocabulary so values can be passed directly into failure_conditions[].action without runtime transformation. Keeping a single canonical action vocabulary across §3.3.3 and §3.4.2 prevents drift between the two surfaces.",
"properties": {
"on_dimension_disagreement": {
"enum": [
"evaluator_decision=request_revision",
"evaluator_decision=accept_with_dissent_note",
"evaluator_decision=flag_for_reviewer_stage"
],
"$comment": "What the evaluator does when its own paper-blind scoring plan flags a dimension during paper-visible evaluation (the dimension hits its pre-committed what_triggers_block or what_triggers_warn anchors). Default in shipped templates: 'evaluator_decision=request_revision' for mandatory dimensions; runtime evaluator may downgrade non-mandatory dimensions to 'accept_with_dissent_note' (see F4 in evaluator/full.json)."
},
"on_structural_drift": {
"enum": [
"evaluator_decision=request_revision",
"evaluator_decision=accept_with_dissent_note",
"evaluator_decision=flag_for_reviewer_stage"
],
"$comment": "What the evaluator does when the actual draft structure deviates from the Structure Architect's approved outline (the upstream runtime artefact from structure_architect_agent that the writer follows in Phase 4b). Drift threshold lives in the evaluator's runtime judgement, not the schema; the contract carries only the default verdict to apply when drift is observed."
}
}
}
}
},
"failure_conditions": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": ["condition_id", "severity", "expression", "action"],
"properties": {
"condition_id": {
"type": "string",
"pattern": "^F(0|[1-9][0-9]?)$",
"$comment": "F0 reserved for accept-grade conditions per shipped templates §6.1+§6.2; spec §3.2 line 174 mistakenly writes ^F[1-9][0-9]?$ — DO NOT 'align' the schema back. Leading-zero forms (F00, F01) rejected to keep ordinal-position tie-break (§3.2 severity precedence) unambiguous."
},
"severity": { "type": "integer", "minimum": 0, "maximum": 100 },
"cross_reviewer_quantifier": { "enum": ["any", "majority", "all"] },
"expression": { "type": "string", "minLength": 1 },
"action": {
"type": "string",
"$comment": "Schema 13.1 v3.6.6 §3.3.3: base enum lifted; mode-conditional action enums enforced in allOf branches 4 (reviewer) / 5 (writer_full) / 6 (evaluator_full). The base property keeps only type:string as a structural placeholder so JSON Schema's intersection semantics do not block writer / evaluator action values."
}
}
}
},
"override_ladder": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": ["round", "trigger", "required"],
"properties": {
"round": { "type": "integer", "enum": [1, 2, 3] },
"trigger": { "type": "string", "minLength": 1 },
"required": {
"type": "array",
"items": { "type": "string", "minLength": 1 }
}
}
}
},
"agent_amendments": {
"type": "object",
"additionalProperties": false,
"properties": {
"stage_specific_notes": { "type": "string", "maxLength": 500 },
"additional_measurement_hints": {
"type": "array",
"items": { "type": "string", "minLength": 1 }
}
}
},
"generated_at": { "type": "string", "format": "date-time" }
},
"allOf": [
{
"$comment": "Branch 1 (existing Schema 13 §3.3): reviewer mode requires cross_reviewer_quantifier on every failure_conditions entry.",
"if": {
"properties": { "mode": { "pattern": "^reviewer_" } },
"required": ["mode"]
},
"then": {
"properties": {
"failure_conditions": {
"items": { "required": ["cross_reviewer_quantifier"] }
}
}
}
},
{
"$comment": "Branch 2 (existing Schema 13 §3.3): override_ladder three-round shape if present.",
"if": { "required": ["override_ladder"] },
"then": {
"properties": {
"override_ladder": {
"minItems": 3,
"maxItems": 3,
"prefixItems": [
{ "properties": { "round": { "const": 1 } } },
{ "properties": { "round": { "const": 2 } } },
{ "properties": { "round": { "const": 3 } } }
]
}
}
}
},
{
"$comment": "Branch 3 (new v3.6.6 §3.3.1): reviewer mode requires measurement_procedure (lifted from base required).",
"if": {
"properties": { "mode": { "pattern": "^reviewer_" } },
"required": ["mode"]
},
"then": {
"required": ["measurement_procedure"]
}
},
{
"$comment": "Branch 4 (new v3.6.6 §3.3.3): reviewer mode pins failure_conditions[].action to editorial_decision=* enum (re-pins the Schema 13 base enum; structurally identical for reviewer contracts).",
"if": {
"properties": { "mode": { "pattern": "^reviewer_" } },
"required": ["mode"]
},
"then": {
"properties": {
"failure_conditions": {
"items": {
"properties": {
"action": {
"enum": [
"editorial_decision=accept",
"editorial_decision=minor_revision",
"editorial_decision=major_revision",
"editorial_decision=reject"
]
}
}
}
}
}
}
},
{
"$comment": "Branch 5 (new v3.6.6 §3.3.3): writer_full pins failure_conditions[].action to writer_decision=* enum.",
"if": {
"properties": { "mode": { "const": "writer_full" } },
"required": ["mode"]
},
"then": {
"properties": {
"failure_conditions": {
"items": {
"properties": {
"action": {
"enum": [
"writer_decision=accept",
"writer_decision=revise_in_phase_4b",
"writer_decision=escalate_to_evaluator"
]
}
}
}
}
}
}
},
{
"$comment": "Branch 6 (new v3.6.6 §3.3.3): evaluator_full pins failure_conditions[].action to evaluator_decision=* enum.",
"if": {
"properties": { "mode": { "const": "evaluator_full" } },
"required": ["mode"]
},
"then": {
"properties": {
"failure_conditions": {
"items": {
"properties": {
"action": {
"enum": [
"evaluator_decision=accept",
"evaluator_decision=accept_with_dissent_note",
"evaluator_decision=request_revision",
"evaluator_decision=flag_for_reviewer_stage"
]
}
}
}
}
}
}
},
{
"$comment": "Branch 7 (new v3.6.6 §3.3.4): reviewer mode F0 contains action=editorial_decision=accept (re-pins the Schema 13 inline contains; structurally identical for reviewer contracts).",
"if": {
"properties": { "mode": { "pattern": "^reviewer_" } },
"required": ["mode"]
},
"then": {
"properties": {
"failure_conditions": {
"contains": {
"type": "object",
"properties": {
"condition_id": { "const": "F0" },
"action": { "const": "editorial_decision=accept" }
},
"required": ["condition_id", "action"]
}
}
}
}
},
{
"$comment": "Branch 8 (new v3.6.6 §3.3.4): writer_full F0 contains action=writer_decision=accept.",
"if": {
"properties": { "mode": { "const": "writer_full" } },
"required": ["mode"]
},
"then": {
"properties": {
"failure_conditions": {
"contains": {
"type": "object",
"properties": {
"condition_id": { "const": "F0" },
"action": { "const": "writer_decision=accept" }
},
"required": ["condition_id", "action"]
}
}
}
}
},
{
"$comment": "Branch 9 (new v3.6.6 §3.3.4): evaluator_full F0 contains action=evaluator_decision=accept.",
"if": {
"properties": { "mode": { "const": "evaluator_full" } },
"required": ["mode"]
},
"then": {
"properties": {
"failure_conditions": {
"contains": {
"type": "object",
"properties": {
"condition_id": { "const": "F0" },
"action": { "const": "evaluator_decision=accept" }
},
"required": ["condition_id", "action"]
}
}
}
}
},
{
"$comment": "Branch 10 (new v3.6.6 §3.3.5): reviewer mode requires panel_size (lifted from base required).",
"if": {
"properties": { "mode": { "pattern": "^reviewer_" } },
"required": ["mode"]
},
"then": {
"required": ["panel_size"]
}
},
{
"$comment": "Branch 11 (new v3.6.6 §3.5): writer_full requires pre_commitment_artifacts.",
"if": {
"properties": { "mode": { "const": "writer_full" } },
"required": ["mode"]
},
"then": {
"required": ["pre_commitment_artifacts"]
}
},
{
"$comment": "Branch 12 (new v3.6.6 §3.5): evaluator_full requires disagreement_handling.",
"if": {
"properties": { "mode": { "const": "evaluator_full" } },
"required": ["mode"]
},
"then": {
"required": ["disagreement_handling"]
}
},
{
"$comment": "Branch 13 (Schema 13.2): reviewer dimensions require role-scoping metadata.",
"if": {
"properties": { "mode": { "pattern": "^reviewer_" } },
"required": ["mode"]
},
"then": {
"properties": {
"acceptance_dimensions": {
"items": { "required": ["eligible_roles", "owner_role"] }
}
}
}
}
],
"$defs": {
"reviewer_role": {
"enum": ["eic", "methodology", "domain", "perspective", "da"]
},
"score": { "enum": ["block", "warn", "pass"] },
"priority": { "enum": ["mandatory", "high", "normal"] }
}
}
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 |