{"id":"0682f29d-2aa5-43bf-8ad7-0ab254ad13e6","shortId":"3DgnrD","kind":"skill","title":"academic-citation","tagline":"Search, verify, and map citations for CS/AI/ML papers. Produces VERIFIED/UNVERIFIED reference lists with Citation-to-Claim maps and Exemplar Sets. Use when: finding references for a paper section, verifying citation accuracy, building exemplar sets for introduction/related work l","description":"# Academic Citation\n\n将此 skill 视为\"文献取证代理\"，而不是搜索结果搬运器。\n\n## Red Lines（绝对禁止）\n\n1. 禁止编造文献、作者、年份、venue、DOI、arXiv 编号\n2. 禁止把 UNVERIFIED 条目当作 VERIFIED 写入正文\n3. 禁止在正文没有任何 inline citation 的情况下输出参考文献列表\n4. 禁止只引用与自己最相似的方法而故意忽略强基线或不利比较\n5. 禁止因为\"搜索结果第一页看完了\"就停止检索\n\n## 非协商规则\n\n1. 只有经过核验的文献才能进入 `Verified References`；未核验条目必须标 `UNVERIFIED`。\n2. 优先使用一级来源（官方 proceedings、期刊官网、OpenReview、PMLR、ACL Anthology、IEEE Xplore、ACM Digital Library、PubMed、arXiv、DBLP）核验元数据。\n3. 检索结束的标准是覆盖充分，而非看了几页搜索结果。整篇完整论文的总引用数（去重后）应达到至少 35 篇（含本地文献库和外部文献）。单节检索不应少于 4 类查询覆盖。\n4. 对 Introduction 或 Related Work，除正文引用外，还必须建立同领域 `Exemplar Set`（3-5 篇 Introduction exemplars + 4-8 篇 Related Work exemplars），用于学习章节组织与论证顺序，而非复制原文措辞。\n5. 每条用于正文的引用必须有对应的 inline citation marker 和 Citation-to-Claim 映射记录。\n6. 参考文献列表只能包含正文中已被引用或以 `[REF_NEEDED: ...]` 声明的条目。\n7. **本地文献库优先**：当提供了 `local_lit_md_dir` 时，必须优先在本地 MD 库中检索和阅读全文，充分搜索后再联网补充。\n8. **Subagent 阅读只提炼不决策**：`literature-reader-agent` 的输出（LiteratureReadingReport）仅作为主 agent 的参考输入，最终是否引用由主 agent 基于论文整体论证结构决定。\n9. **原文 vs 推断隔离**：`literature-reader-agent` 必须严格区分原文提取和自身推断。主 agent 引用时，只能以 `source: 原文` 的内容作为引用依据。\n\n## 任务模式\n\n1. **full-citation-pass** — 为完整论文或核心章节执行全覆盖检索与核验\n2. **targeted-citation-search** — 为特定 claim、section 或主题检索文献\n3. **exemplar-set-only** — 只构建 Exemplar Set 用于学习章节组织，不强制全部进入正文引用\n4. **citation-verification** — 核验已有候选文献列表的元数据准确性\n5. **local-citation-pass** — 优先从本地文献库（`papersToMd/`）检索与核验引用，不足时再联网补充。依赖 `literature-reader-agent` 进行全文阅读。\n6. **citation-verification-with-reading** — 对已下载到本地文献库的引用文献，逐篇阅读全文并验证引用合理性（claim_accuracy 检查）。用于论文撰写完毕后的引用确认流程。\n\n## 工作流\n\n详见 `references/workflow-citation-pass.md` 获取完整步骤。概要如下：\n\n| Step | 动作 | 关键规则 |\n|------|------|---------|\n| 1 | 确认检索目标与范围 | 明确 section、检索词、是否需要 Exemplar Set |\n| 1a | 本地文献库优先检索 | 有 `local_lit_md_dir` 时先搜本地，2+ 篇候选**必须并行** dispatch reader agent |\n| 2 | 执行多轮检索 | 至少覆盖 4 类查询（问题/方法/基线/时间导向），详见 `references/search-strategy.md` |\n| 3 | 核验每篇候选文献 | 详见 `references/verification-protocol.md`，全部确认→VERIFIED，任一失败→UNVERIFIED |\n| 3a | 联网文献全文获取与阅读 | 优先开放来源获取全文，多篇**必须并行**执行 |\n| 3b | Subagent 阅读结果聚合 | 按 relevance + recommendation 排序，主 agent 评估是否引用 |\n| 4 | 构建 Exemplar Set | Introduction 3-5 篇，Related Work 4-8 篇，提炼叙述功能而非复制段落 |\n| 5 | Citation-to-Claim 映射 | **强制步骤**，详见 `references/citation-mapping.md` |\n| 6 | 输出 | 按 `references/schemas/verified-references.md` 格式输出 Verified References + Exemplar Set + Citation-to-Claim Map |\n\n## Agent 资源\n\n本 Skill 目录下的 `agents/` 文件夹包含以下辅助文件：\n\n| 文件 | 用途 |\n|------|------|\n| `agents/citation_agent.md` | 文献检索策略（4 类查询模板、输出 schema） |\n| `agents/literature-reader-agent.md` | 文献阅读与提炼代理（输入 MD 全文，输出 LiteratureReadingReport） |\n\n**使用方式**：由 `academic-paper-writer` 核心编排器在 Step 3 委托时，按 `academic-paper-writer/references/orchestration-workflow.md` 中的 dispatch 模板创建工具型子代理执行。**此 agent 只执行检索与核验，绝对不得修改项目中的任何文件，也不得独立撰写论文正文**。\n\n`literature-reader-agent` 由 `citation_agent` 或 `academic-paper-writer` 在 Step 3a/3b 中并行 dispatch，用于阅读本地 MD 文献或联网获取的全文。\n\n## 独立使用\n\n当本 Skill 被独立加载（不通过 `academic-paper-writer` 编排器）时：\n\n### 典型请求\n- \"帮我找 5 篇关于 Graph Transformer 的引用\"\n- \"核验一下我列的这些引用是否真实存在\"\n- \"为我的 Introduction 找 Exemplar Set 参考结构\"\n- \"查一下这篇论文的引用来源是否可靠\"\n\n### 入口分流\n\n| 用户输入特征 | 匹配模式 | 优先级 | 行为 |\n|------------|---------|--------|------|\n| 提供 `section` + `keywords` | full-citation-pass | 1（用户显式指定） | 执行完整 6 步流程（同工作流节） |\n| 提供引用列表/种子文献 | citation-verification | 1（用户显式指定） | 仅核验元数据，不追加检索 |\n| 提供 `local_lit_md_dir` | local-citation-pass | 2（路径特征触发） | 本地 MD 优先搜索，批量并行 dispatch reader agent |\n| 只提供 `section` | targeted-citation-search | 3（单特征匹配） | 自动生成关键词，执行 4 类查询 |\n| 明确只需 Exemplar Set | exemplar-set-only | 1（用户显式指定） | 仅构建 Exemplar Set，不强制输出引用列表 |\n\n**多条件匹配时**：取优先级数字最小的匹配模式。\n\n### 执行约束\n- 独立使用时，开始前必须确认：目标 section（默认 Introduction）、检索关键词（未提供时自动生成）、是否需要 Exemplar Set\n- 若用户未指定 `local_lit_md_dir`，跳过本地优先搜索，直接联网检索\n- 输出格式与编排器调度时一致：Verified References + Exemplar Set + Citation-to-Claim Map\n- 若用户要求将引用写入正文，提示：\"本 Skill 只负责检索核验。如需整合到论文正文，请使用 academic-paper-writer 编排器。\"\n\n### 组合使用指引\n| 场景 | 推荐方式 |\n|------|---------|\n| 只需检索/核验引用 | 本 Skill（独立） |\n| 需将引用整合到论文正文并起草 | academic-paper-writer 编排器 |\n| 已有草稿，需补引用并审查 | 本 Skill 检索 → academic-reviser 审查 |\n\n## 何时读取 references/\n\n| Reference 文件 | 打开条件 |\n|---------------|---------|\n| `references/search-strategy.md` | 设计检索查询时（Step 2） |\n| `references/verification-protocol.md` | 核验候选文献时（Step 3） |\n| `references/citation-mapping.md` | 建立 Citation-to-Claim 映射时（Step 5） |\n| `references/schemas/verified-references.md` | 理解输出数据格式（Step 6） |\n| `references/schemas/literature-reading-report.md` | subagent 阅读输出格式（Step 1a/3a） |\n| `agents/literature-reader-agent.md` | 文献阅读代理模板（Step 1a/3a 并行 dispatch） |\n\n## 不适用场景\n\n本 Skill 不适用于：\n- 生成 LaTeX/BibTeX 格式化引用书目（仅负责检索核验与映射）\n- 非 CS/AI/ML 领域的文献检索（如临床医学、法律）\n- 用户已有完整引用列表且明确不需要核验的场景\n\n## 失败处理\n\n- **文献搜不到**：如实报告\"未找到足够可靠来源\"，不补假引文。\n- **无法联网**：明确哪些引用无法核验，相关结论降级为占位或待核验表述。\n- **遇本地 PDF 或旧草稿中的引文**：作为 seed source，仍须回到一级来源核验。\n\n## 何时降低检索强度\n\n仅在以下场景降低检索强度：\n- 用户明确只要大纲，不要正文引用\n- 用户明确表示后续自己补引文\n- 当前任务是修一句话或局部改写\n\n即便如此，也不能编造引用；缺失处保留 `[REF_NEEDED: ...]`。\n\n## Anti-Patterns\n\n| 模式 | 问题 | 正确做法 |\n|------|------|---------|\n| 快速扫描型检索 | 只翻了搜索结果第一页就确认引用 | 至少覆盖 4 类查询，完整论文 8-15 篇合格文献 |\n| 单信源核验 | 仅靠 Google Scholar 标题核验 | 优先使用一级来源（官方 proceedings、DOI 解析） |\n| 引用孤立 | 参考文献列表有正文未引用的条目 | 列表只能包含正文中已引用或 [REF_NEEDED] 声明的条目 |\n| 偏误引用 | 只引与自己最相似的方法，忽略强基线 | 对等引用，不利比较也要反映在文中 |","tags":["academic","citation","paper","writer","joshua-zyy","academic-writing","agent-skills","anthropic-skills","paper-writing","skills"],"capabilities":["skill","source-joshua-zyy","skill-academic-citation","topic-academic-writing","topic-agent-skills","topic-anthropic-skills","topic-paper-writing","topic-skills"],"categories":["academic-paper-writer"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/joshua-zyy/academic-paper-writer/academic-citation","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add joshua-zyy/academic-paper-writer","source_repo":"https://github.com/joshua-zyy/academic-paper-writer","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (5,212 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:18.375Z","embedding":null,"createdAt":"2026-05-18T13:21:56.998Z","updatedAt":"2026-05-18T19:14:18.375Z","lastSeenAt":"2026-05-18T19:14:18.375Z","tsv":"'-15':675 '-5':126,326 '-8':131,331 '/references/orchestration-workflow.md':394 '1':53,79,198,263,461,472,513 '1a':271 '1a/3a':615,619 '2':61,85,204,279,285,485,593 '3':67,103,125,213,296,325,387,500,597 '35':109 '3a':304 '3a/3b':417 '3b':310 '4':72,113,115,130,223,288,320,330,368,504,671 '5':74,138,228,334,436,606 '6':149,243,343,464,610 '7':154 '8':166,674 '9':181 'academ':2,43,382,391,412,429,558,572,582 'academic-cit':1 'academic-paper-writ':381,390,411,428,557,571 'academic-revis':581 'accuraci':35,252 'acl':92 'acm':96 'agent':172,176,179,188,191,241,284,318,357,362,399,406,409,493 'agents/citation_agent.md':366 'agents/literature-reader-agent.md':372,616 'antholog':93 'anti':663 'anti-pattern':662 'arxiv':59,100 'build':36 'citat':3,8,18,34,44,70,141,145,201,207,225,231,245,336,353,408,459,470,483,498,546,601 'citation-to-claim':17,144,335,352,545,600 'citation-verif':224,469 'citation-verification-with-read':244 'claim':20,147,210,251,338,355,548,603 'cs/ai/ml':10,631 'dblp':101 'digit':97 'dir':160,277,480,537 'dispatch':282,396,419,491,621 'doi':58,685 'exemplar':23,37,123,129,135,215,219,269,322,350,445,507,510,516,531,543 'exemplar-set-on':214,509 'find':27 'full':200,458 'full-citation-pass':199,457 'googl':679 'graph':438 'ieee':94 'inlin':69,140 'introduct':117,128,324,443,527 'introduction/related':40 'keyword':456 'l':42 'latex/bibtex':627 'librari':98 'line':51 'list':15 'lit':158,275,478,535 'literatur':170,186,239,404 'literature-reader-ag':169,185,238,403 'literaturereadingreport':174,378 'local':157,230,274,477,482,534 'local-citation-pass':229,481 'map':7,21,356,549 'marker':142 'md':159,163,276,375,421,479,488,536 'need':152,661,691 'openreview':90 'paper':11,31,383,392,413,430,559,573 'paperstomd':234 'pass':202,232,460,484 'pattern':664 'pdf':645 'pmlr':91 'proceed':88,684 'produc':12 'pubm':99 'read':248 'reader':171,187,240,283,405,492 'recommend':315 'red':50 'ref':151,660,690 'refer':14,28,82,349,542,586,587 'references/citation-mapping.md':342,598 'references/schemas/literature-reading-report.md':611 'references/schemas/verified-references.md':346,607 'references/search-strategy.md':295,590 'references/verification-protocol.md':299,594 'references/workflow-citation-pass.md':257 'relat':119,133,328 'relev':314 'revis':583 'schema':371 'scholar':680 'search':4,208,499 'section':32,211,266,455,495,525 'seed':648 'set':24,38,124,216,220,270,323,351,446,508,511,517,532,544 'skill':46,360,425,553,568,579,624 'skill-academic-citation' 'sourc':194,649 'source-joshua-zyy' 'step':260,386,416,592,596,605,609,614,618 'subag':167,311,612 'target':206,497 'targeted-citation-search':205,496 'topic-academic-writing' 'topic-agent-skills' 'topic-anthropic-skills' 'topic-paper-writing' 'topic-skills' 'transform':439 'unverifi':63,84,303 'use':25 'venu':57 'verif':226,246,471 'verifi':5,33,65,81,301,348,541 'verified/unverified':13 'vs':183 'work':41,120,134,329 'writer':384,393,414,431,560,574 'xplore':95 '不利比较也要反映在文中':697 '不强制全部进入正文引用':222 '不强制输出引用列表':518 '不补假引文':640 '不要正文引用':654 '不足时再联网补充':236 '不追加检索':475 '不适用于':625 '不适用场景':622 '不通过':427 '中并行':418 '中的':395 '为完整论文或核心章节执行全覆盖检索与核验':203 '为我的':442 '为特定':209 '主':190,317 '也不得独立撰写论文正文':402 '也不能编造引用':658 '仅作为主':175 '仅在以下场景降低检索强度':652 '仅构建':515 '仅核验元数据':474 '仅负责检索核验与映射':629 '仅靠':678 '仍须回到一级来源核验':650 '任一失败':302 '任务模式':197 '优先从本地文献库':233 '优先使用一级来源':86,682 '优先开放来源获取全文':306 '优先搜索':489 '优先级':452 '何时读取':585 '何时降低检索强度':651 '作为':647 '作者':55 '使用方式':379 '依赖':237 '偏误引用':693 '充分搜索后再联网补充':165 '入口分流':449 '全文':376 '全部确认':300 '关键规则':262 '典型请求':434 '写入正文':66 '列表只能包含正文中已引用或':689 '动作':261 '匹配模式':451 '单信源核验':677 '单特征匹配':501 '单节检索不应少于':112 '即便如此':657 '原文':182,195 '去重后':107 '参考文献列表只能包含正文中已被引用或以':150 '参考文献列表有正文未引用的条目':688 '参考结构':447 '取优先级数字最小的匹配模式':520 '只引与自己最相似的方法':694 '只执行检索与核验':400 '只提供':494 '只有经过核验的文献才能进入':80 '只构建':218 '只翻了搜索结果第一页就确认引用':669 '只能以':193 '只负责检索核验':554 '只需检索':565 '同工作流节':466 '含本地文献库和外部文献':111 '和':143 '在':415 '场景':563 '基于论文整体论证结构决定':180 '基线':292 '声明的条目':153,692 '多条件匹配时':519 '多篇':307 '失败处理':636 '如临床医学':633 '如实报告':638 '如需整合到论文正文':555 '委托时':388 '完整论文':673 '官方':87,683 '审查':584 '对':116 '对已下载到本地文献库的引用文献':249 '对等引用':696 '将此':45 '就停止检索':77 '工作流':255 '已有草稿':576 '帮我找':435 '年份':56 '并行':620 '库中检索和阅读全文':164 '应达到至少':108 '建立':599 '开始前必须确认':523 '引用孤立':687 '引用时':192 '强制步骤':340 '当前任务是修一句话或局部改写':656 '当提供了':156 '当本':424 '必须严格区分原文提取和自身推断':189 '必须优先在本地':162 '必须并行':281,308 '快速扫描型检索':668 '忽略强基线':695 '或':118,410 '或主题检索文献':212 '或旧草稿中的引文':646 '打开条件':589 '执行':309,503 '执行多轮检索':286 '执行完整':463 '执行约束':521 '批量并行':490 '找':444 '按':313,345,389 '排序':316 '推断隔离':184 '推荐方式':564 '提供':454,476 '提供引用列表':467 '提炼叙述功能而非复制段落':333 '提示':551 '搜索结果第一页看完了':76 '整篇完整论文的总引用数':106 '文件':364,588 '文件夹包含以下辅助文件':363 '文献取证代理':48 '文献或联网获取的全文':422 '文献搜不到':637 '文献检索策略':367 '文献阅读与提炼代理':373 '文献阅读代理模板':617 '方法':291 '无法联网':641 '时':161,433 '时先搜本地':278 '时间导向':293 '明确':265 '明确只需':506 '明确哪些引用无法核验':642 '映射':339 '映射时':604 '映射记录':148 '是否需要':268,530 '最终是否引用由主':178 '有':273 '期刊官网':89 '未找到足够可靠来源':639 '未提供时自动生成':529 '未核验条目必须标':83 '本':359,552,567,578,623 '本地':487 '本地文献库优先':155 '本地文献库优先检索':272 '条目当作':64 '构建':321 '查一下这篇论文的引用来源是否可靠':448 '标题核验':681 '核心编排器在':385 '核验一下我列的这些引用是否真实存在':441 '核验候选文献时':595 '核验元数据':102 '核验已有候选文献列表的元数据准确性':227 '核验引用':566 '核验每篇候选文献':297 '格式化引用书目':628 '格式输出':347 '检查':253 '检索':580 '检索与核验引用':235 '检索关键词':528 '检索结束的标准是覆盖充分':104 '检索词':267 '概要如下':259 '模式':665 '模板创建工具型子代理执行':397 '正确做法':667 '此':398 '步流程':465 '每条用于正文的引用必须有对应的':139 '法律':634 '独立':569 '独立使用':423 '独立使用时':522 '理解输出数据格式':608 '生成':626 '用于学习章节组织':221 '用于学习章节组织与论证顺序':136 '用于论文撰写完毕后的引用确认流程':254 '用于阅读本地':420 '用户已有完整引用列表且明确不需要核验的场景':635 '用户明确只要大纲':653 '用户明确表示后续自己补引文':655 '用户显式指定':462,473,514 '用户输入特征':450 '用途':365 '由':380,407 '的内容作为引用依据':196 '的参考输入':177 '的引用':440 '的情况下输出参考文献列表':71 '的输出':173 '目录下的':361 '目标':524 '直接联网检索':539 '相关结论降级为占位或待核验表述':643 '确认检索目标与范围':264 '禁止只引用与自己最相似的方法而故意忽略强基线或不利比较':73 '禁止因为':75 '禁止在正文没有任何':68 '禁止把':62 '禁止编造文献':54 '种子文献':468 '篇':110,127,132,327,332 '篇候选':280 '篇关于':437 '篇合格文献':676 '类查询':289,505,672 '类查询模板':369 '类查询覆盖':114 '组合使用指引':562 '绝对不得修改项目中的任何文件':401 '绝对禁止':52 '编号':60 '编排器':432,561,575 '缺失处保留':659 '而不是搜索结果搬运器':49 '而非复制原文措辞':137 '而非看了几页搜索结果':105 '联网文献全文获取与阅读':305 '自动生成关键词':502 '至少覆盖':287,670 '若用户未指定':533 '若用户要求将引用写入正文':550 '获取完整步骤':258 '行为':453 '被独立加载':426 '视为':47 '解析':686 '设计检索查询时':591 '评估是否引用':319 '详见':256,294,298,341 '请使用':556 '资源':358 '路径特征触发':486 '跳过本地优先搜索':538 '输入':374 '输出':344,370,377 '输出格式与编排器调度时一致':540 '还必须建立同领域':122 '进行全文阅读':242 '逐篇阅读全文并验证引用合理性':250 '遇本地':644 '问题':290,666 '阅读只提炼不决策':168 '阅读结果聚合':312 '阅读输出格式':613 '除正文引用外':121 '需将引用整合到论文正文并起草':570 '需补引用并审查':577 '非':630 '非协商规则':78 '领域的文献检索':632 '默认':526","prices":[{"id":"00f0618d-8e28-439e-b1eb-91875c2218ed","listingId":"0682f29d-2aa5-43bf-8ad7-0ab254ad13e6","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"joshua-zyy","category":"academic-paper-writer","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:56.998Z"}],"sources":[{"listingId":"0682f29d-2aa5-43bf-8ad7-0ab254ad13e6","source":"github","sourceId":"joshua-zyy/academic-paper-writer/academic-citation","sourceUrl":"https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citation","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:56.998Z","lastSeenAt":"2026-05-18T19:14:18.375Z"}],"details":{"listingId":"0682f29d-2aa5-43bf-8ad7-0ab254ad13e6","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"joshua-zyy","slug":"academic-citation","github":{"repo":"joshua-zyy/academic-paper-writer","stars":7,"topics":["academic-writing","agent-skills","anthropic-skills","paper-writing","skills"],"license":"mit","html_url":"https://github.com/joshua-zyy/academic-paper-writer","pushed_at":"2026-05-18T03:40:09Z","description":"面向 CS / AI / ML 领域的证据驱动、分节推进的论文写作 Agent Skill。","skill_md_sha":"b3c74abb6e580348321255398a183ad938ed8da8","skill_md_path":"skills/academic-citation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citation"},"layout":"multi","source":"github","category":"academic-paper-writer","frontmatter":{"name":"academic-citation","description":"Search, verify, and map citations for CS/AI/ML papers. Produces VERIFIED/UNVERIFIED reference lists with Citation-to-Claim maps and Exemplar Sets. Use when: finding references for a paper section, verifying citation accuracy, building exemplar sets for introduction/related work learning, checking if existing citations are real and accurate, supplementing local literature library. Triggers on: 找引用, 文献检索, citation pass, find references, reference check, 补文献, citation verification, Exemplar Set, search papers, verify citation, 核验文献, 查引用, literature search, reference verification."},"skills_sh_url":"https://skills.sh/joshua-zyy/academic-paper-writer/academic-citation"},"updatedAt":"2026-05-18T19:14:18.375Z"}}