[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80673":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":9,"rankLanguage":9,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":33,"readmeContent":34,"aiSummary":35,"trendingCount":14,"starSnapshotCount":14,"syncStatus":16,"lastSyncTime":36,"discoverSource":37},80673,"chinese-reference-formatter-skill","Zechang-Xiong\u002Fchinese-reference-formatter-skill","Zechang-Xiong","Codex skill for formatting Chinese academic references and BibTeX",null,"Python",54,5,48,0,1,2,6,3,2.33,"MIT License",false,"main",true,[25,26,27,28,29,30,31,32],"academic-writing","agent-skills","bibliography","bibtex","chinese","codex-skill","gbt-7714","reference-formatting","2026-06-12 02:04:05","\u003Cdiv align=\"center\">\n\n# 中文参考文献.skill\n\n### Chinese Reference Formatter Skill\n\n把“只有题名”的文献，整理成可核验的中文论文参考文献和 BibTeX。\n\n\u003Cp>\n  \u003Cimg alt=\"Codex Skill\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCodex-Skill-111827\">\n  \u003Cimg alt=\"GB\u002FT 7714 style\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGB%2FT%207714-style-2f6f4e\">\n  \u003Cimg alt=\"BibTeX output\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Foutput-BibTeX-8b5e34\">\n  \u003Cimg alt=\"Python stdlib\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-stdlib-3776ab\">\n\u003C\u002Fp>\n\n\u003Cp>\n  \u003Ca href=\"#效果示例\">效果示例\u003C\u002Fa>\n  ·\n  \u003Ca href=\"#安装\">安装\u003C\u002Fa>\n  ·\n  \u003Ca href=\"#它解决什么\">它解决什么\u003C\u002Fa>\n  ·\n  \u003Ca href=\"#工作原理\">工作原理\u003C\u002Fa>\n  ·\n  \u003Ca href=\"#开发\">开发\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003C\u002Fdiv>\n\n---\n\n## 一句话\n\n人工整理参考文献时，最烦的是格式；让 AI 代劳时，最怕的是信息不可靠。\n\n这个 skill 同时解决这两个问题：先核验公开元数据，再输出通用中文论文参考文献条目和 BibTeX。找不到明确文献时，它会直接说找不到；来源冲突时，它会给出歧义说明。\n\n> 少调格式，不编参考文献。\n\n---\n\n## 效果示例\n\n### 你输入\n\n```text\n帮我把下面这些文献补全成中文论文参考文献格式，并输出 BibTeX：\n\n1. Semi-supervised classification with graph convolutional networks\n2. Focal loss for dense object detection\n3. 理想的图书馆员和信息专家的素质与形象\n```\n\n### 它输出\n\n````text\n标准参考文献：[1] Kipf T N, Welling M. Semi-supervised Classification with Graph Convolutional Networks[J]. International Conference on Learning Representations, 2017. DOI:10.48550\u002FarXiv.1609.02907.\n\nBibTeX：\n```bibtex\n@article{kipf-2017-semi-supervised-classification-graph,\n  author = {Kipf, Thomas N and Welling, Max},\n  title = {Semi-supervised classification with graph convolutional networks},\n  journal = {International Conference on Learning Representations},\n  year = {2017},\n  doi = {10.48550\u002FarXiv.1609.02907}\n}\n```\n\n核验来源：https:\u002F\u002Fopenreview.net\u002Fforum?id=SJU4ayYgl\n\n标准参考文献：[2] Lin T Y, Goyal P, Girshick R, et al. Focal Loss for Dense Object Detection[C]. Proceedings of the IEEE International Conference on Computer Vision, 2017:2980-2988.\n\nBibTeX：\n```bibtex\n@inproceedings{lin-2017-focal-loss-dense,\n  author = {Lin, Tsung-Yi and Goyal, Priya and Girshick, Ross and He, Kaiming and Dollár, Piotr},\n  title = {Focal loss for dense object detection},\n  booktitle = {Proceedings of the IEEE International Conference on Computer Vision},\n  year = {2017},\n  pages = {2980-2988}\n}\n```\n\n核验来源：https:\u002F\u002Fopenaccess.thecvf.com\u002Fcontent_ICCV_2017\u002Fhtml\u002FLin_Focal_Loss_for_ICCV_2017_paper.html\n\n标准参考文献：[3] 李炳穆. 理想的图书馆员和信息专家的素质与形象[J]. 图书情报工作, 2000, 44(2):5-8,95.\n\nBibTeX：\n```bibtex\n@article{ref-2000-b65e7d86,\n  author = {李炳穆},\n  title = {理想的图书馆员和信息专家的素质与形象},\n  journal = {图书情报工作},\n  year = {2000},\n  volume = {44},\n  number = {2},\n  pages = {5-8,95}\n}\n```\n\n核验来源：https:\u002F\u002Fwww.lis.ac.cn\u002FCN\u002FY2000\u002FV44\u002FI2\n````\n\n如果没有可靠匹配：\n\n```text\n未找到与“definitely not a real paper title”明确对应的公开文献。\n```\n\n如果多个来源冲突：\n\n```text\n无法确定“...”的唯一对应文献：多个来源信息冲突，无法确定唯一对应文献。\n```\n\n---\n\n## 安装\n\n### Codex skills 目录\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FZechang-Xiong\u002Fchinese-reference-formatter-skill.git ~\u002F.codex\u002Fskills\u002Fchinese-reference-formatter-skill\n```\n\n如果你设置了 `CODEX_HOME`：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FZechang-Xiong\u002Fchinese-reference-formatter-skill.git \"$CODEX_HOME\u002Fskills\u002Fchinese-reference-formatter-skill\"\n```\n\n### skills CLI\n\n如果你使用 open agent skills 生态的 CLI：\n\n```bash\nnpx skills add Zechang-Xiong\u002Fchinese-reference-formatter-skill\n```\n\n### 调用\n\n```text\nUse $chinese-reference-formatter-skill to format these literature titles as Chinese academic references with BibTeX.\n```\n\n中文也可以：\n\n```text\n帮我把这些文献题名补全为中文参考文献格式，并给 BibTeX。\n```\n\n---\n\n## 它解决什么\n\n| 痛点 | 处理方式 |\n| --- | --- |\n| 只有论文题名，没有完整引用 | 搜索并比对公开元数据 |\n| 中英文文献格式混在一起 | 统一输出中文论文参考文献格式 |\n| BibTeX 和中文参考文献不一致 | 同一份标准化 JSON 同时渲染两种结果 |\n| 聚合站、预印本、正式发表版本冲突 | 权威来源优先，无法判断就标记歧义 |\n| 文献根本不存在或无法确认 | 明确返回未找到，不猜测 |\n\n---\n\n## 支持类型\n\n| 类型 | 标识 | 典型字段 |\n| --- | --- | --- |\n| 期刊论文 | `J` | 作者、题名、期刊、年、卷、期、页码、DOI |\n| 会议论文 | `C` | 作者、题名、会议\u002F论文集、年、页码 |\n| 图书\u002F专著 | `M` | 作者、书名、版次、出版地、出版社、年份 |\n| 析出章节 | `M` | 章节作者、章节题名、图书题名、出版社、页码 |\n| 学位论文 | `D` | 作者、题名、保存地、保存单位、年份 |\n| 报告 | `R` | 作者、题名、机构、年份 |\n| 标准 | `S` | 标准编号、标准名称、发布机构、年份 |\n| 专利 | `P` | 申请者、专利名、国别、专利号、发布日期 |\n| 报纸 | `N` | 作者、题名、报纸名、日期、版次 |\n| 在线资源 | `EB\u002FOL` | 作者、题名、发布日期、引用日期、URL |\n\n作者和语言规则：\n\n- 3 名及以内作者全部列出。\n- 超过 3 名作者，中文文献使用 `等`，英文文献使用 `et al`。\n- 中文作者名按来源保留。\n- 西文作者使用姓在前、名缩写在后，例如 `Einstein A`。\n- 题名和作者名默认不翻译。\n\n---\n\n## 工作原理\n\n输入题名后，skill 做四步：\n\n| 步骤 | 做什么 | 目的 |\n| --- | --- | --- |\n| 1. 读取规则 | 读取 `references\u002Fchinese-reference-rules.md` | 确认通用中文参考文献格式 |\n| 2. 核验来源 | 比对题名、作者、年份、载体、DOI\u002FISBN\u002FURL | 避免把错文献格式化得很漂亮 |\n| 3. 解决冲突 | DOI、出版社、官方页面、标准\u002F专利机构优先 | 在正式版、预印本、聚合信息之间做取舍 |\n| 4. 渲染输出 | 调用 `scripts\u002Fformat_reference.py` | 同时生成中文参考文献和 BibTeX |\n\n核心设计是把“核验”和“排版”拆开：\n\n- 核验阶段负责判断文献是否可信。\n- formatter 阶段只负责把可信元数据稳定渲染。\n\n---\n\n## 直接运行 formatter\n\n`scripts\u002Fformat_reference.py` 不联网检索，只格式化已经核验过的元数据。\n\n```bash\npython scripts\u002Fformat_reference.py --start 1 \u003C metadata.json\n```\n\n输入可以是单个对象、对象数组，或 `{ \"items\": [...] }`：\n\n```json\n{\n  \"type\": \"article\",\n  \"title\": \"Semi-supervised classification with graph convolutional networks\",\n  \"authors\": [\"Kipf, Thomas N\", \"Welling, Max\"],\n  \"journal\": \"International Conference on Learning Representations\",\n  \"year\": 2017,\n  \"doi\": \"10.48550\u002FarXiv.1609.02907\",\n  \"sources\": [\"https:\u002F\u002Fopenreview.net\u002Fforum?id=SJU4ayYgl\"]\n}\n```\n\n常用字段：\n\n| 字段 | 说明 |\n| --- | --- |\n| `type` | 文献类型，如 `article`、`inproceedings`、`book`、`thesis`、`standard`、`online` |\n| `title` | 文献题名 |\n| `authors` | 作者列表，支持字符串或 `{ \"family\": \"...\", \"given\": \"...\" }` |\n| `journal` \u002F `booktitle` | 期刊名或会议\u002F论文集名 |\n| `year` | 出版年份 |\n| `volume` \u002F `issue` \u002F `pages` | 卷、期、页码 |\n| `doi` \u002F `url` | DOI 或 URL |\n| `access_date` | 在线资源引用日期 |\n| `sources` | 核验来源 URL 列表 |\n| `status` | `not_found` 或 `ambiguous` 时输出对应提示 |\n\n---\n\n## 诚实边界\n\n这个 skill 明确不做这些事：\n\n- 不凭题名猜测文献信息。\n- 不把聚合站结果自动当成权威来源。\n- 不默认翻译题名或作者名。\n- 不把学校、期刊或会议的特殊细则强加到所有用户身上。\n- 不自动追加到项目 `.bib` 文件，除非你明确要求。\n\n一个参考文献工具最重要的能力不是“看起来格式对”，而是知道什么时候不能确定。\n\n---\n\n## 仓库结构\n\n```text\nchinese-reference-formatter-skill\u002F\n├── README.md\n├── SKILL.md                              # skill 入口\n├── agents\u002F\n│   └── openai.yaml                       # Codex 展示信息\n├── references\u002F\n│   └── chinese-reference-rules.md        # 中文参考文献规则\n└── scripts\u002F\n    ├── format_reference.py               # JSON -> 参考文献 + BibTeX\n    ├── test_format_reference.py          # formatter 行为测试\n    └── test_skill_content.py             # skill 内容回归测试\n```\n\n---\n\n## 开发\n\nformatter 仅依赖 Python 标准库。测试使用 `pytest`：\n\n```bash\npython -m pytest scripts\n```\n\n当前测试覆盖：\n\n- 英文期刊\u002F会议条目。\n- 三名以上作者规则。\n- 中文期刊条目。\n- 在线资源访问日期。\n- 未匹配文献提示。\n- skill 身份和通用性检查。\n\n---\n\n## English\n\nChinese Reference Formatter Skill turns verified bibliographic metadata into Chinese academic references and BibTeX.\n\nIt is built for common GB\u002FT 7714-style Chinese bibliography workflows. It verifies public metadata first, formats confirmed records, and reports uncertainty instead of inventing missing references.\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FZechang-Xiong\u002Fchinese-reference-formatter-skill.git ~\u002F.codex\u002Fskills\u002Fchinese-reference-formatter-skill\n```\n\n```text\nUse $chinese-reference-formatter-skill to format these literature titles as Chinese academic references with BibTeX.\n```\n\n---\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=Zechang-Xiong\u002Fchinese-reference-formatter-skill&type=Date)](https:\u002F\u002Fwww.star-history.com\u002F#Zechang-Xiong\u002Fchinese-reference-formatter-skill&Date)\n","这个项目是一个用于格式化中文学术参考文献和生成BibTeX的Codex技能。其核心功能在于通过核验公开元数据来确保信息的准确性，并将仅有题名的文献条目转换成符合GB\u002FT 7714标准的中文论文参考文献格式以及BibTeX格式。当找不到明确文献或来源信息存在冲突时，该工具会给出相应的提示。采用Python标准库开发，易于安装与使用。适用于需要频繁处理中文文献引用的学术写作场景，帮助用户减少手动调整格式的工作量并提高引用信息的可靠性。","2026-06-11 04:01:35","CREATED_QUERY"]