zrwangems/dsh-zrwang-plugin / ars/skills/academic-paper
academic-paper
Flagged学术论文写作:按 IMRaD 或领域结构成稿,含大纲、论证地图、双语摘要、图表与题注、引用格式转换、返修与逐条回复、AI 使用声明。Triggers: write a paper, academic paper, paper outline, revise paper, reviewer comments, rebuttal, citation check, abstract | 写论文, 论文大纲, 修改论文, 审稿意见, 返修, 审稿回复, 引文核对, 写摘要。
_shared/contracts/passport/reset_ledger_entry.schema.json
View on GitHub{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://github.com/Imbad0202/academic-research-skills/shared/contracts/passport/reset_ledger_entry.schema.json",
"title": "Passport Reset Ledger Entry",
"description": "One append-only ledger entry in reset_boundary[]. Two kinds: 'boundary' (recorded at a FULL checkpoint when ARS_PASSPORT_RESET=1) and 'resume' (recorded when resume_from_passport consumes a boundary entry). See academic-pipeline/references/passport_as_reset_boundary.md.",
"oneOf": [
{ "$ref": "#/$defs/boundary" },
{ "$ref": "#/$defs/resume" }
],
"$defs": {
"boundary": {
"type": "object",
"additionalProperties": false,
"required": [
"kind",
"hash",
"stage",
"next",
"generated_at",
"session_marker",
"version_label"
],
"properties": {
"kind": {
"const": "boundary",
"description": "Discriminator. 'boundary' = reset emitted at a FULL checkpoint."
},
"hash": {
"type": "string",
"pattern": "^[0-9a-f]{12}$",
"description": "First 12 lowercase hex characters of SHA-256 over the concatenated ledger (prior entries + this entry with hash set to the canonical placeholder '000000000000'). Placeholder rule is normative — see protocol doc §'The reset boundary protocol' step 2."
},
"stage": {
"type": "string",
"minLength": 1,
"description": "Stage number or name that just completed (e.g., '1', '2', '2.5', 'RESEARCH')."
},
"next": {
"type": ["string", "null"],
"minLength": 1,
"description": "Default next stage after resume. When pending_decision is unset, this is the authoritative route. When pending_decision is set, this field is advisory: the matched option's next_stage takes precedence, and next MAY be null (including when all branches terminate). The orchestrator MUST NOT auto-advance using next when pending_decision is present."
},
"generated_at": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp of boundary creation."
},
"session_marker": {
"type": "string",
"minLength": 1,
"description": "Opaque identifier for the source session. Audit-only; not relied on for resume."
},
"version_label": {
"type": "string",
"minLength": 1,
"description": "Monotonic version label for the passport state at this boundary (e.g., 'v1.0', 'v1.1-revised'). Stage re-runs bump this."
},
"mode": {
"type": "string",
"description": "Mode of the just-completed stage (e.g., 'full', 'systematic-review')."
},
"verification_status": {
"type": "string",
"enum": ["VERIFIED", "UNVERIFIED", "STALE"],
"description": "Mirror of Schema 9 verification_status at this boundary. Copied for convenience; authoritative value lives in Schema 9 top-level."
},
"observer_snapshot_ref": {
"type": "string",
"description": "Optional path or ID of the collaboration_depth_agent observer output for this checkpoint. Audit-only."
},
"pending_decision": {
"type": "object",
"additionalProperties": false,
"required": ["question", "options"],
"properties": {
"question": {
"type": "string",
"minLength": 1,
"description": "Human-readable question the user must answer on resume (e.g., 'Stage 3 review outcome: revise, restructure, or abort?')."
},
"options": {
"type": "array",
"minItems": 2,
"uniqueItems": true,
"items": {
"type": "object",
"additionalProperties": false,
"required": ["value", "next_stage"],
"properties": {
"value": {
"type": "string",
"minLength": 1,
"description": "Branch identifier. Must be unique across the options array — chosen_branch on the resume entry matches this field."
},
"next_stage": {
"type": ["string", "null"],
"description": "Stage number or name to route to when this branch is chosen. null means terminate the pipeline."
},
"next_mode": {
"type": "string",
"minLength": 1,
"description": "Optional downstream mode override when this branch is chosen. Omit to use the default mode for next_stage."
}
}
},
"description": "Enumerated decision branches. Each option carries its own routing: on resume, the orchestrator looks up chosen_branch in options[].value, then uses that entry's next_stage and next_mode to determine actual routing. The boundary entry's next field is advisory (best-guess default) and is superseded by the matched option's next_stage at resume time. CLI stage=/mode= overrides from resume_from_passport still win over option routing."
}
},
"description": "Set when the boundary co-occurs with a MANDATORY user decision (Stage 3 rejection, Stage 5 finalization, etc.). When present, resume must re-prompt the user. Each option carries its own next_stage/next_mode routing; the boundary entry's 'next' field is advisory only and is overridden by the matched option's next_stage at resume time."
}
}
},
"resume": {
"type": "object",
"additionalProperties": false,
"required": [
"kind",
"consumes_hash",
"generated_at",
"session_marker"
],
"properties": {
"kind": {
"const": "resume",
"description": "Discriminator. 'resume' = resume_from_passport consumed a prior boundary entry."
},
"consumes_hash": {
"type": "string",
"pattern": "^[0-9a-f]{12}$",
"description": "Hash of the boundary entry this resume consumes. Append-only pointer — lets readers compute awaiting_resume state from the ledger alone."
},
"generated_at": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp of resume event."
},
"session_marker": {
"type": "string",
"minLength": 1,
"description": "Opaque identifier for the resuming session."
},
"chosen_branch": {
"type": "string",
"description": "If the consumed boundary had pending_decision, record which option the user chose. Omit otherwise."
},
"user_override": {
"type": "object",
"additionalProperties": false,
"properties": {
"stage": { "type": "string" },
"mode": { "type": "string" }
},
"description": "Optional stage/mode overrides the user supplied on the resume command."
}
}
}
}
}
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 |