Chinese Reference Formatter
Overview
Convert one or more Chinese or English reference titles into通用中文论文参考文献条目 and BibTeX. Always verify bibliographic metadata from public sources before formatting; do not invent missing references.
Workflow
- Read
references/chinese-reference-rules.md before formatting.
- For each input title, search public metadata sources and compare title, authors, year, venue, DOI/ISBN/URL.
- Prefer DOI, publisher, university repository, official journal, official conference, official standards, or patent pages over aggregators.
- If no DOI or official page exists, require a strong title match plus matching author/year/venue from at least one credible source.
- If sources conflict and no source is clearly authoritative, return an ambiguity note instead of choosing.
- If no clear match exists, output
未找到与“<title>”明确对应的公开文献。
- Normalize confirmed metadata to JSON and run
scripts/format_reference.py to produce the reference entry plus BibTeX.
Search Sources
Use sources appropriate to the document type:
- DOI and publisher metadata: Crossref, DataCite, official publisher pages.
- Broad scholarly metadata: OpenAlex, Semantic Scholar.
- Computer science papers: DBLP, arXiv, conference/open-review pages.
- Biomedical papers: PubMed/NCBI and official journal pages.
- Chinese references: DOI/publisher pages, university repositories, official journal pages; use CNKI/Wanfang metadata when reachable from web search.
- Standards, patents, books, theses: official standards bodies, patent offices, publishers, library catalogs, university repositories.
Formatting
The formatter accepts a JSON object, a JSON list, or { "items": [...] } through stdin or --input.
python scripts/format_reference.py --start 1 < metadata.json
Common normalized fields:
{
"type": "article",
"title": "Paper title",
"authors": ["Family, Given", "中文作者"],
"journal": "Journal name",
"booktitle": "Proceedings name",
"year": 2026,
"volume": "12",
"issue": "3",
"pages": "1-10",
"doi": "10.xxxx/example",
"url": "https://example.org",
"access_date": "2026-05-07",
"sources": ["https://source.example"]
}
Supported type values include article, inproceedings, book, chapter, thesis, report, standard, patent, newspaper, and online.
Default output for each resolved item:
标准参考文献:[1] ...
BibTeX:
```bibtex
...
```
核验来源:...
Preserve the user's input order. Start numbering at [1] unless the user gives a different starting number. Do not append to a project .bib file unless the user explicitly asks.
Conflict Rules
- DOI or official source metadata wins over aggregator metadata.
- Publisher version wins over preprint metadata when formatting the published version.
- Preprint metadata is valid only when the user asks for the preprint or no published version exists.
- If author order, year, venue, or page range conflicts, state the conflict and cite the competing sources.
- Use the actual current date for online access dates unless the source provides a citation access date or the user specifies one.
Common Mistakes
- Do not format from title guesses alone.
- Do not silently translate titles or author names.
- Do not list more than three authors before
等 or et al.
- Do not force a school-specific thesis requirement unless the user explicitly provides that institution's rules.
- Do not count online resources or standards as ordinary journal/conference papers unless the user's style guide explicitly says to.
1---2name: chinese-reference-formatter-skill3description: Use when a user needs通用中文参考文献、GB/T 7714-style bibliography entries, Chinese academic reference formatting, or BibTeX completion from Chinese or English literature titles, including 根据文献名补全参考文献、生成中文论文参考文献格式、format Chinese academic references.4license: MIT5---67# Chinese Reference Formatter89## Overview1011Convert one or more Chinese or English reference titles into通用中文论文参考文献条目 and BibTeX. Always verify bibliographic metadata from public sources before formatting; do not invent missing references.1213## Workflow14151. Read `references/chinese-reference-rules.md` before formatting.162. For each input title, search public metadata sources and compare title, authors, year, venue, DOI/ISBN/URL.173. Prefer DOI, publisher, university repository, official journal, official conference, official standards, or patent pages over aggregators.184. If no DOI or official page exists, require a strong title match plus matching author/year/venue from at least one credible source.195. If sources conflict and no source is clearly authoritative, return an ambiguity note instead of choosing.206. If no clear match exists, output `未找到与“<title>”明确对应的公开文献。`217. Normalize confirmed metadata to JSON and run `scripts/format_reference.py` to produce the reference entry plus BibTeX.2223## Search Sources2425Use sources appropriate to the document type:2627- DOI and publisher metadata: Crossref, DataCite, official publisher pages.28- Broad scholarly metadata: OpenAlex, Semantic Scholar.29- Computer science papers: DBLP, arXiv, conference/open-review pages.30- Biomedical papers: PubMed/NCBI and official journal pages.31- Chinese references: DOI/publisher pages, university repositories, official journal pages; use CNKI/Wanfang metadata when reachable from web search.32- Standards, patents, books, theses: official standards bodies, patent offices, publishers, library catalogs, university repositories.3334## Formatting3536The formatter accepts a JSON object, a JSON list, or `{ "items": [...] }` through stdin or `--input`.3738```bash39python scripts/format_reference.py --start 1 < metadata.json40```4142Common normalized fields:4344```json45{46 "type": "article",47 "title": "Paper title",48 "authors": ["Family, Given", "中文作者"],49 "journal": "Journal name",50 "booktitle": "Proceedings name",51 "year": 2026,52 "volume": "12",53 "issue": "3",54 "pages": "1-10",55 "doi": "10.xxxx/example",56 "url": "https://example.org",57 "access_date": "2026-05-07",58 "sources": ["https://source.example"]59}60```6162Supported `type` values include `article`, `inproceedings`, `book`, `chapter`, `thesis`, `report`, `standard`, `patent`, `newspaper`, and `online`.6364Default output for each resolved item:6566````text67标准参考文献:[1] ...68BibTeX:69```bibtex70...71```72核验来源:...73````7475Preserve the user's input order. Start numbering at `[1]` unless the user gives a different starting number. Do not append to a project `.bib` file unless the user explicitly asks.7677## Conflict Rules7879- DOI or official source metadata wins over aggregator metadata.80- Publisher version wins over preprint metadata when formatting the published version.81- Preprint metadata is valid only when the user asks for the preprint or no published version exists.82- If author order, year, venue, or page range conflicts, state the conflict and cite the competing sources.83- Use the actual current date for online access dates unless the source provides a citation access date or the user specifies one.8485## Common Mistakes8687- Do not format from title guesses alone.88- Do not silently translate titles or author names.89- Do not list more than three authors before `等` or `et al`.90- Do not force a school-specific thesis requirement unless the user explicitly provides that institution's rules.91- Do not count online resources or standards as ordinary journal/conference papers unless the user's style guide explicitly says to.