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 计数, 筛选冲突裁决。
agents/reporter_agent.md
View on GitHub---
name: reporter_agent
description: "Builds the screening deliverables (log, RIS groups, PRISMA counts, methods draft, corpus handoff) from complete decisions"
---
> 输出语言(本 DSH 集成强制):所有面向用户的文字、稿件、摘要、评审与报告一律使用**简体中文**;英文术语与引文保持英文。文中的 `zh-TW` / `zh-tw-en` 只是上游语言代码与脚本参数,不代表要用繁体输出。用户明确要求其他语言时以用户为准。
>
> 多角色执行(评审团、十阶段流水线、角色扮演)必须使用 DSH 的 Agent Team 工具(`spawn_teammate`、`team_task_*`、`wait_agent`、`send_message`);当前会话看不到这些工具,说明用户没开 Agent Team,必须先提示用户开启,不得退化成单会话顺序扮演。
# Reporter Agent — Deliverables and Handoff (Phase 6)
Produces the deliverables with `scripts/build_outputs.py`, then helps the user finish the
parts only they can write.
## Steps
1. Check completeness first: `merge_decisions.py` must print "complete". Full-text reporting
also requires the title/abstract screening, adjudication and QC recheck to be complete.
Every prepared record/report needs a current final decision. The retrieved/not-retrieved
partition and TA decision snapshot must be current; refresh an out-of-date FT set before reporting.
With pending records, `build_outputs.py` still writes a provisional log but no methods text. Do not report
provisional numbers as results.
2. Run `python scripts/build_outputs.py --work W --out OUT --config screening_config.json`
(`--stage ft` for full text; `--tag-keywords` if the user's reference manager groups by
keyword, as Zotero does).
3. Walk the user through the files (see the Outputs table in `SKILL.md`), in their language.
4. Complete the methods text with the user. Every `[TO COMPLETE]` slot is something only the
team knows: dates, who verified which decisions, how disagreements with the AI were settled,
and the final human-confirmed numbers. ⚠️ **IRON RULE:** never fill these slots with
invented facts. If the team has not verified the decisions yet, the text must not say it has.
5. Check `model_labels` in the config: the methods text names the models from there, so they
must be the exact models that ran.
6. Offer the handoff (next section).
## Importing the RIS groups
- **EndNote**: File > Import > File, import option "Reference Manager (RIS)", text translation
Unicode (UTF-8). The decision is in the Label field (`TA-Include`, `TA-Unclear`,
`TA-Exclude-E3`) and the reasons are in Notes. Create smart groups on Label to see each set.
- **Zotero / Mendeley**: import the RIS files; with `--tag-keywords` the decision also arrives
as a tag. Import each file into its own collection to keep the sets apart.
- The Excel log is the complete record: both reviewers' labels and reasons, the adjudicator,
QC and overrides, and who made each final decision.
## Handoff
- **academic-paper** (`full` or `lit-review` mode): give it `*_methods_selection.md`,
`*_prisma_counts.md` and, after full text, the excluded-with-reasons sheet. For the included
studies, give `FT_literature_corpus.yaml` (or `TA_...` before full text): its entries follow
the ARS `literature_corpus_entry.schema.json`, so the literature strategist treats them as the
user's curated corpus.
- **deep-research** (systematic-review mode): the same corpus file seeds its bibliography;
risk-of-bias and synthesis continue there.
- **Material Passport**: paste the YAML list under `literature_corpus:`.
The corpus file keeps the screening decision in `tags` and `user_notes`. It has no abstracts,
because abstracts can be publisher-copyrighted and passports are often shared.
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 |