# Protocol Writer

> Use when `evidence-review` needs an operational protocol before screening and extraction.

- Skill: `willoscar/protocol-writer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add willoscar/protocol-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/willoscar/protocol-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: WILLOSCAR (https://skillmd.com/u/willoscar)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/willoscar/protocol-writer

---


# Protocol Writer

## Triggers & routing

- **Trigger**: protocol, PRISMA, systematic review, inclusion/exclusion, 检索式, 纳入排除.
- **Use when**: `evidence-review` pipeline 的起点（C1），需要先锁定 protocol 再开始 screening/extraction。
- **Skip if**: 不是做 evidence/systematic review（或 protocol 已经锁定且不允许修改）。
- **Network**: none.
- **Guardrail**: protocol 必须包含可执行的检索与筛选规则；需要 HUMAN 签字后才能进入 screening。


Transforms the review question into an executable `evidence-review` protocol.

## Inputs

Required:
- `STATUS.md`

Optional:
- `GOAL.md`
- `DECISIONS.md`
- `queries.md`

## Output

- `output/PROTOCOL.md`

## Contract

The protocol must contain:
- review questions
- source/search specification
- inclusion and exclusion clauses with stable IDs
- screening plan
- extraction schema
- bias plan
- explicit HUMAN approval note

## Script boundary

`scripts/run.py` should:
- read current review context
- materialize an operational protocol
- write a stable extraction schema and clause IDs

It should not perform retrieval or screening itself.

## Acceptance

- `output/PROTOCOL.md` exists
- includes extraction schema and protocol clause IDs
- is operational enough for downstream screening

## Non-goals

- writing final synthesis prose
- screening candidate papers