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 计数, 筛选冲突裁决。
references/failure_paths.md
View on GitHub> 输出语言(本 DSH 集成强制):所有面向用户的文字、稿件、摘要、评审与报告一律使用**简体中文**;英文术语与引文保持英文。文中的 `zh-TW` / `zh-tw-en` 只是上游语言代码与脚本参数,不代表要用繁体输出。用户明确要求其他语言时以用户为准。
>
> 多角色执行(评审团、十阶段流水线、角色扮演)必须使用 DSH 的 Agent Team 工具(`spawn_teammate`、`team_task_*`、`wait_agent`、`send_message`);当前会话看不到这些工具,说明用户没开 Agent Team,必须先提示用户开启,不得退化成单会话顺序扮演。
# Failure paths
| # | Situation | How it shows | Recovery |
|---|-----------|--------------|----------|
| F1 | Protocol vague, contradictory or missing a criterion | Protocol Architect cannot place a criterion; boundary cases get disputed | Ask targeted questions (max five at a time); mark inferred items `[proposed]`; nothing is screened until confirmed |
| F2 | Seed study not in the search results | `prepare_records.py` prints "NOT FOUND" | Search problem: fix the strategy and re-export before screening |
| F3 | Seed study excluded in the pilot | QC pilot report | Read both reasons, amend the definition or code wording, re-pilot the same batches |
| F4 | Export formats misread | A file is "skipped (format not recognised)" or record counts differ from the database's total | Re-export as RIS or MEDLINE; `--db "file=Database"` for labels; reconcile counts before screening |
| F5 | A reviewer returns fewer decisions than records | Workflow log "incomplete"; merge lists pending IDs | Automatic Grep retry inside the run; later `--jobs pending`; lower `max_records` if frequent |
| F6 | Malformed decisions (label/code mismatch, IDs from another batch) | merge prints "dropped ..." counts | Discarded by design, then retried; many in one batch: inspect that batch file |
| F7 | Every agent fails at once | Workflow returns all batches "screen-failed" | Usually a wrong `agent_type` or model alias: fix the config, regenerate, rerun the pilot |
| F8 | Usage limit or closed session mid-run | Workflow stops; journal partial | Merge everything so far, then `--jobs pending`; nothing is defaulted or lost |
| F9 | Many conflicts or a criterion read two ways | Pilot conflicts cluster on one code | Add a definition or example to the protocol (amendment), re-pilot |
| F10 | "unclear" share far above expectations | QC report | Tighten the core-criteria gate; check whether a systematically missing field (for example no abstracts) drives it |
| F11 | QC advances many rechecked exclusions | merge prints "exclusions advanced by QC" | Exclusions are unreliable: find the pattern, amend, re-screen the affected batches |
| F12 | Criteria change after screening started | Team request | Amendment log entry; decide which records the change can flip; re-screen those; never mix old and new rules silently |
| F13 | Prepared work folder would be overwritten | `prepare_records.py` refuses | Use a new `--work` folder; `--force` only when no decisions exist, since IDs would change |
| F14 | PDFs not matched at full text | `prepare_fulltext.py` "not retrieved" count | Rename PDFs with the record ID or give a `--map` CSV; truly unobtainable reports go in the PRISMA "not retrieved" box |
| F15 | No subagents available | Session cannot spawn agents | Offer `quick` mode (single-reviewer triage, disclosed as such) or run the pipeline in Claude Code |
| F16 | Pilot is incomplete or excluded a record the team advanced | `merge_decisions.py --pilot-labels` prints "STOP"; `--jobs all` and pending jobs outside the pilot refuse | Finish every labelled pilot record, or read the missed record's AI reason and amend the protocol, then merge with `--pilot-labels` again; start outside the pilot anyway only if the user decides so, with `--pilot-override "<reason>"` (recorded, reported in the methods text) |
| F17 | Screening done but numbers still provisional | merge prints "PENDING QC" | Run `build_workflow.py ta --jobs recheck` for the required recheck of joint exclusions and near-miss records, then merge again |
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 |