bibliography-builder

Bibliography Builder 是一个用于学术写作的参考文献（书目）构建技能，帮助研究者从手稿中的文内引注自动生成格式化的参考文献列表。其核心流程是：提取文内引注、与本地 references.bib 文件匹配、检查问题、生成参考文献。\n\n主要能力\n\n1. 引注提取：支持 Pandoc [@citationKey] 格式与传统 (Author Year) 格式。可识别单作者、两位作者、et al.、多引注、带页码、叙述式引注等变体，并去重、按字母排序、统计出现频次，还会用 grep 命令辅助验证提取是否遗漏边界情况（如带连字符、带重音符号的姓名）。\n2. BibTeX 匹配：Pandoc 格式通过 citationKey 直接查找 .bib 条目键，传统格式则按作者姓氏与年份匹配 author 和 year 字段，记录结果为 Found、Ambiguous、Not Found。\n3. 问题审查：标记缺失条目、歧义匹配（同一作者同年多篇）、年份不匹配、姓名写法差异等问题，由用户给出解决方案。\n4. 参考文献生成：构建一个仅含匹配引注键的临时 markdown 文件，通过 nocite 字段让 pandoc 将其全部纳入书目，运行 pandoc --citeproc 生成 bibliography.md，并将未匹配引注作为单独小节附在末尾供手动查找。\n\n使用方式\n\n该技能通过对话分阶段执行：Phase 0 读取手稿并确认引注样式；Phase 1 提取引注并由用户核对；Phase 2 进行 BibTeX 匹配并由用户复核；Phase 3 审查问题并由用户解决；Phase 4 生成参考文献。各阶段之间设有暂停点等待用户确认。技能可读取 project.yaml 中的 drafts 路径配置，完成后更新 progress.yaml 的状态与产物记录。在进入新阶段修改输出文件前，需先用 git add 与 git commit 提交当前状态，不创建带版本后缀的副本，以 git 历史作为版本记录。\n\n依赖要求\n\n需要 references.bib（通常位于项目根目录或 references/ 子目录，由本地 BibTeX 流程通过 ingest.py 填充）；需要支持 citeproc 的 pandoc（pandoc 2.11+ 默认包含）；需要目标样式的 CSL 文件，如 ASA 用 american-sociological-association.csl、APA 7th 用 apa.csl、Chicago Author-Date 用 chicago-author-date.csl，可从 https://github.com/citation-style-language/styles 下载。\n\n适用场景\n\n适用于所有项目类型的学术手稿，尤其适合已有文内引注和 BibTeX 文献库、需要生成 APA、ASA、Chicago 等格式参考文献的研究者。Pandoc 格式手稿匹配快速且确定性强，传统格式手稿则通过作者加年份的字符串匹配处理。\n\n限制\n\nreferences.bib 必须存在且可读；缺失条目需用户先补充到 .bib 文件；同名同年多篇文献可能产生歧义，需用户裁决；传统格式对姓名变体的匹配需灵活处理；CSL 文件需提前准备。