screening-manager
根据批准的方案管理标题/摘要筛选并将决策记录到`papers/screening_log.csv`中。**触发**:筛选、标题/摘要筛选、包含/排除、screening_log.csv、文献筛选、文献排除。**使用时机**:系统评价的筛选阶段(C2),方案锁定并通过 HUMAN 图层。**如果**:已还没有`output/PROTOCOL.md`(或方案)则跳过。 **网络**:无。**护栏**:每条记录决策包含理由;保持可审计(不要把“未读/缺失”立即纳入)。
📖 中文导读:根据批准的方案管理标题/摘要筛选并将决策记录到`papers/screening_log.csv`中。**触发**:筛选、标题/摘要筛选、包含/排除、screening_log.csv、文献筛选、文献排除。**使用时机**:系统评价的筛选阶段(C2),方案锁定并通过 HUMAN 图层。**如果**:已还没有`output/PROTOCOL.md`(或方案)则跳过。 **网络**:无。**护栏**:每条记录决策包含理由;保持可审计(不要把“未读/缺失”立即纳入)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: screening-manager
description: |
Manage title/abstract screening and record decisions into papers/screening_log.csv according to an approved protocol.
Trigger: screening, title/abstract screening, inclusion/exclusion, screening_log.csv, 文献筛选, 纳入排除.
Use when: systematic review 的 screening 阶段(C2),protocol 已锁定并通过 HUMAN 审批。
Skip if: 还没有 output/PROTOCOL.md(或 protocol 未通过签字)。
Network: none.
Guardrail: 每条记录包含决策与理由;保持可审计(不要把“未读/不确定”当作纳入)。
Screening Manager (title/abstract screening)
Goal: produce an auditable screening log that can be traced back to the protocol.
Inputs
Required:
output/PROTOCOL.md
Optional candidate pools (choose one if available):
papers/papers_raw.jsonlpapers/papers_dedup.jsonlpapers/core_set.csv
Outputs
papers/screening_log.csv
Output schema (recommended)
Columns (minimum viable):
paper_idtitleyearurldecision(include|exclude)reason(short, protocol-grounded)reviewer(HUMAN|CODEX)decided_at(ISO date/time)notes(optional)
Workflow
Read
output/PROTOCOL.mdand extract:- inclusion criteria
- exclusion criteria
- time window
- any mandatory outcomes/metrics
Choose a candidate list
- If a
papers/*.jsonlorpapers/core_set.csvexists, use it as the row source. - Otherwise, ask the user for the candidate list format and load it into the workspace first.
- If a
Screen each candidate deterministically
- Decide
includeonly when the title/abstract clearly satisfies inclusion and does not trigger exclusion. - If information is insufficient, decide
excludeand state the missing requirement explicitly inreason.
- Decide
Write
papers/screening_log.csv- One row per candidate.
- Reasons must map to protocol clauses (avoid generic “not relevant”).
Quick QA
- Check every row has
decision+reason. - Spot-check that
includerows satisfy the protocol.
- Check every row has
Definition of Done
-
papers/screening_log.csvexists and covers all candidates. - Every row has a decision + protocol-grounded reason.
Troubleshooting
Issue: you do not have a candidate pool file
Fix:
- Import/export the candidate list into one of:
papers/papers_raw.jsonl,papers/papers_dedup.jsonl, orpapers/core_set.csv, then rerun screening.
Issue: too many borderline cases
Fix:
- Tighten
output/PROTOCOL.mdwith more operational inclusion/exclusion rules (then re-screen for consistency).