zrwangems/dsh-zrwang-plugin / ars/skills/sr-screener
sr-screener
Flagged系统综述文献筛选:把方案或 PROSPERO 协议转成资格规则,双盲筛选标题摘要与全文,第三人裁决冲突,输出 PRISMA 2020 计数、EndNote/Zotero RIS 分组与可交付给论文技能的 literature_corpus。Triggers: systematic review screening, screen papers, PRISMA counts, pilot screening, adjudicate conflicts | 文献筛选, 系统综述筛选, PRISMA 计数, 筛选冲突裁决。
scripts/check_cross_model_handoff_contract.py
View on GitHub#!/usr/bin/env python3
"""Defrift lock for the #527 cross-model handoff contract.
#523 moved the blind-checkpoint transport to the dispatching layer, but left
the owner → dispatcher → owner path enforced by prose only. #527 gives it a
canonical envelope (normative grammar: `scripts/cross_model_handoff.py`) and
this lint pins the contract across its five prompt surfaces so a future edit
cannot silently demote the handoff to an ordinary deliverable.
Invariants:
1. The shared doc carries § Cross-model handoff envelope (#527) with both
fence literals, all required header names, the payload-only blindness
rule, the malformed→unavailable fail-safes, the agreement-no-reinvoke /
divergence-minimum-context routing, the DA full-return rule, and the
flag-unset-unchanged sentence — and names the reference module.
2. Each owner agent emits the canonical envelope with its correct
checkpoint_kind / expected_result pair.
3. The Mode-A orchestrator carries the consumer contract: recognition
(never an ordinary deliverable), fail-safe mapping, and the three-way
outcome routing, naming the reference module.
4. The prose enums match the reference module's CHECKPOINT_KINDS (the
module is normative — prose drift from it must fail).
Exit codes: 0 on pass, 1 on any failure.
"""
from __future__ import annotations
import sys
from pathlib import Path
import cross_model_handoff as cmh
REPO_ROOT = Path(__file__).resolve().parent.parent
SHARED = "shared/cross_model_verification.md"
ORCH = "academic-pipeline/agents/pipeline_orchestrator_agent.md"
# Full backticked header declarations — pinning only the value would let a
# `checkpoint_knd:` typo emit malformed envelopes while staying green
# (codex #527 round-1 P1). The enum owners additionally pin their
# owner_decision blindness clause.
OWNER_BLINDNESS_CLAUSE = "never forwarded to the cross-model"
ALL_THREE_FIELDS_CLAUSE = "all three fields, the envelope grammar rejects a bare decision"
# Every operative envelope header the owner instruction must spell exactly
# (codex #527 round-12 P1: a correlation_idd/owner_decison typo, or a wrong
# owner_agent value, would emit envelopes the normative parser rejects).
OWNER_CORRELATION_CLAUSE = "a `correlation_id` you choose"
OWNER_DECISION_HEADER_CLAUSE = "`owner_decision` header"
OWNERS = {
"deep-research/agents/research_architect_agent.md": (
"`checkpoint_kind: design_freeze`",
f"`owner_agent: {cmh.EXPECTED_OWNERS['design_freeze']}`",
OWNER_CORRELATION_CLAUSE,
OWNER_DECISION_HEADER_CLAUSE,
"`expected_result: enum_comparison`",
OWNER_BLINDNESS_CLAUSE,
ALL_THREE_FIELDS_CLAUSE,
# Payload exclusion: the primary's judgment never rides the payload.
"with the Design-Freeze Checkpoint Audit section (and any other self-judgment, scores, or reasoning) stripped out",
# Consent predicate (codex round-5 P1): the check runs only when the
# flag is set AND consent was granted.
"only when `ARS_CROSS_MODEL` is set + consent granted",
),
"academic-paper-reviewer/agents/editorial_synthesizer_agent.md": (
"`checkpoint_kind: editorial_decision`",
f"`owner_agent: {cmh.EXPECTED_OWNERS['editorial_decision']}`",
OWNER_CORRELATION_CLAUSE,
OWNER_DECISION_HEADER_CLAUSE,
"`expected_result: enum_comparison`",
OWNER_BLINDNESS_CLAUSE,
ALL_THREE_FIELDS_CLAUSE,
"**Never include your decision, the scoring matrix outcome, or your rationale**",
"the consent gate in `shared/cross_model_verification.md` has been passed (reviewer cards + paper metadata go to an external provider — the env var alone is not consent)",
),
"academic-paper-reviewer/agents/devils_advocate_reviewer_agent.md": (
"`checkpoint_kind: da_critique`",
f"`owner_agent: {cmh.EXPECTED_OWNERS['da_critique']}`",
"a `correlation_id` you choose",
"`expected_result: full_return`",
"no `owner_decision` header",
"without your own DA findings",
"First ask for explicit user consent and identify the external provider, model, and manuscript content that would be sent",
),
}
SHARED_HEADING = "### Cross-model handoff envelope (#527)"
SHARED_REQUIRED = [
cmh.OPEN_FENCE,
cmh.CLOSE_FENCE,
"scripts/cross_model_handoff.py",
"checkpoint_kind: design_freeze | editorial_decision | da_critique",
"expected_result: enum_comparison | full_return",
"correlation_id:",
"owner_agent:",
"owner_decision:",
"REQUIRED iff enum_comparison",
"Structured decisions carry ALL THREE fields (`decision`, `drivers`, `confidence`)",
"must not contain a fence-shaped line",
"Sanitized also means data-minimized: strip personal names, affiliations, and private URLs not essential to the judgment",
"NEVER forwarded to the cross-model",
"payload only",
# Transport prompt-shape rule (codex round-7 P1): the citation handlers'
# prompt + grounding normalization must never run a checkpoint judgment.
"NEVER the citation-verification prompt, its grounding-status guards",
"[CROSS-MODEL-ERROR: malformed_handoff]",
"[CROSS-MODEL-ERROR: malformed_result]",
"outcome `unavailable`",
"does **not** re-invoke the owner",
"re-invokes the ORIGINAL owner with the minimum return context",
"The dispatcher never authors it",
"EVERY successful response is returned to the owner",
"owners emit no envelope and behavior is byte-equivalent pre-#527",
]
ORCH_HEADING_LINE = "**Cross-model handoff consumption (#527, Mode A dispatcher).**"
ORCH_REQUIRED = [
cmh.OPEN_FENCE,
"ANY version, detection is generous",
"a transport request, never an ordinary deliverable",
"scripts/cross_model_handoff.py",
"[CROSS-MODEL-ERROR: malformed_handoff]",
"[CROSS-MODEL-ERROR: malformed_result]",
"never the citation-verification prompt or its grounding-status normalization",
"the `owner_decision` header is never forwarded — blindness",
"a stray envelope is logged `[CROSS-MODEL-SKIPPED]` and not transported",
"never fabricate a judgment",
"do NOT re-invoke the owner",
"re-invoke the ORIGINAL owner with the minimum return context",
"never the dispatcher's",
"every successful response returns to the owner",
"[CROSS-MODEL-SKIPPED]",
]
def _module_prose_enums() -> list[str]:
"""The enum spellings the prose table must carry, derived from the
normative module so prose can only drift by failing here."""
fragments = []
for kind, (_, enum) in cmh.CHECKPOINT_KINDS.items():
if enum:
fragments.append(" / ".join(f"`{v}`" for v in enum))
return fragments
def _module_prose_triples() -> list[str]:
"""The complete kind (`owner`) attributions plus each kind's result
shape, derived from CHECKPOINT_KINDS + EXPECTED_OWNERS — a shared-prose
edit rewiring owners or result shapes must fail here (codex #527
round-10 P1)."""
return [
f"`{kind}` (`{cmh.EXPECTED_OWNERS[kind]}`) is `{expected}`"
for kind, (expected, _) in cmh.CHECKPOINT_KINDS.items()
]
def check(shared: str, orch: str, owners: dict[str, str]) -> list[str]:
errors: list[str] = []
# Invariant 1 — shared canonical section
if SHARED_HEADING not in shared:
errors.append(f"invariant 1 ({SHARED}): section {SHARED_HEADING!r} missing")
for fragment in SHARED_REQUIRED:
if fragment not in shared:
errors.append(
f"invariant 1 ({SHARED}): canonical contract lost the pinned "
f"fragment {fragment!r}"
)
# Invariant 2 — owner emission pins
for path, fragments in OWNERS.items():
text = owners[path]
if cmh.OPEN_FENCE not in text:
errors.append(
f"invariant 2 ({path}): owner no longer names the canonical "
f"envelope fence {cmh.OPEN_FENCE!r}"
)
for fragment in fragments:
if fragment not in text:
errors.append(
f"invariant 2 ({path}): owner lost its {fragment!r} "
f"declaration"
)
# Invariant 3 — Mode-A dispatcher consumer contract
if ORCH_HEADING_LINE not in orch:
errors.append(f"invariant 3 ({ORCH}): consumer block {ORCH_HEADING_LINE!r} missing")
for fragment in ORCH_REQUIRED:
if fragment not in orch:
errors.append(
f"invariant 3 ({ORCH}): consumer contract lost the pinned "
f"fragment {fragment!r}"
)
# Invariant 4 — prose enums AND kind/owner/result triples match the
# normative module
for fragment in (*_module_prose_enums(), *_module_prose_triples()):
if fragment not in shared:
errors.append(
f"invariant 4 ({SHARED}): checkpoint table drifted from the "
f"normative module: expected {fragment!r} (source: "
f"scripts/cross_model_handoff.py CHECKPOINT_KINDS + "
f"EXPECTED_OWNERS)"
)
return errors
def main() -> int:
paths = [SHARED, ORCH, *OWNERS]
contents: dict[str, str] = {}
for path in paths:
full = REPO_ROOT / path
if not full.is_file():
print(f"FAILED: surface file missing: {path}", file=sys.stderr)
return 1
contents[path] = full.read_text(encoding="utf-8")
errors = check(contents[SHARED], contents[ORCH], {p: contents[p] for p in OWNERS})
if errors:
for e in errors:
print(f"FAILED: {e}", file=sys.stderr)
print(
"\nUpdate procedure: scripts/cross_model_handoff.py is the "
"normative grammar. If the contract must change, change the "
"module, its fixtures, every listed surface, AND this lint's "
"pinned constants in the same commit.",
file=sys.stderr,
)
return 1
print("PASSED: check_cross_model_handoff_contract — 4 invariants hold")
return 0
if __name__ == "__main__":
sys.exit(main())
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 |