pdf-citation-verifier

/pdf-citation-verifier — PDF Citation Verifier

User invoked the PDF Citation Verifier skill with:

$ARGUMENTS

Language Routing / 语言路由

• If $ARGUMENTS or the conversation is mainly Chinese, follow 中文命令流程 and read ${CLAUDE_PLUGIN_ROOT}/SKILL.zh.md.
• Otherwise follow English Command Flow and read ${CLAUDE_PLUGIN_ROOT}/SKILL.md.
• Parameter names stay English: pdf, job-id, max-refs, strict, no-wait, output.
• JSON keys, status labels (REAL / LIKELY_REAL / NEEDS_REVIEW / LIKELY_FAKE / FAKE), and reason codes stay English.
• 如果 $ARGUMENTS 或对话主要是中文，使用 中文命令流程。
• 否则使用 English Command Flow。

English Command Flow

1. Pre-flight

Run the checks below in order. Any failed check stops the flow — do not run the script.

1. Check AMINER_API_KEY is set:

   [ -z "${AMINER_API_KEY+x}" ] && echo "AMINER_API_KEY missing" || echo "AMINER_API_KEY exists"
   

   If missing, tell the user to get a token from https://open.aminer.cn and export AMINER_API_KEY=<token>. Never echo the token value.

2. Check Python dependency:

   python3 - <<'PY'
   import importlib.util
   missing = [name for name in ("requests",) if importlib.util.find_spec(name) is None]
   print("Missing: " + ", ".join(missing) if missing else "Python dependencies exist")
   PY
   

   If missing, instruct: pip install -r "${CLAUDE_PLUGIN_ROOT}/requirements.txt".

3. Confirm the user supplied a local .pdf file path, or alternatively a job-id to fetch results for a previously submitted job. If neither, ask for one. Never fabricate or download a PDF.

2. Parse $ARGUMENTS

Accept structured fields and natural language together:

Field	Values	Default	Meaning
pdf	absolute PDF path	required unless job-id is given	Local file to verify
job-id	verify_YYYYMMDDTHHMMSSZ_<8hex>	–	Fetch result for an existing job instead of uploading
max-refs	1-100	50	Max references to verify (upload only)
strict	yes / no	no	Stricter FAKE judgement (upload only)
no-wait	yes / no	no	With pdf: submit and return job_id without polling. With job-id: single fetch, no polling loop.
timeout	seconds	600	Overall polling timeout
output	path	–	Optional JSON output path