skill-citation-format

name	skill-citation-format
description	Citation formatting rules for investment value reports. Standardizes inline citations, generates source_documents arrays, and manages snippet/URL generation.

Citation Format Standard

Purpose

Ensure all investment report content has properly formatted, traceable citations that meet regulatory and institutional investor standards.

Citation Rules

Inline Citations

• Web sources: [来源: 标题](URL) — always include the full URL
• Prospectus (招股书): (招股书 Pxx) — include page number when available
• Prospectus with breadcrumb（铁律）: （招股书 P{page_no}，{breadcrumb}） — mandatory when breadcrumb field is available from RAG results. Example: （招股书 P88，第四节 发行人基本情况 > 一、基本情况）. If breadcrumb is null/empty, fall back to plain （招股书 Pxx）.
• Industry reports: [来源: 报告名称 - 发布机构](URL) — include authoring institution
• Government documents: [来源: 政策文件名称 - 发布部门](URL)
• Images from prospectus (MS1): ![图注](img_url) — use original prospectus charts/figures when img_url is available from RAG. Place below the describing paragraph. Never use AI-generated or web-sourced images as substitutes.

Source Documents Array

The system (GEN3 citation extraction middleware) will automatically extract source_documents from the inline citations you write in the chapter body. Do NOT embed raw JSON or source_documents blocks in your markdown output. Just write the inline citations in standard formats (see above), and the system will build the structured metadata.

For reference, each extracted citation entry looks like:

Field	Source
file_name	Human-readable source name
rag_source_file	Internal document path or URL
snippet	First 300 characters of the cited content
url	Public URL if available, null otherwise

Citation Density

• Every section MUST have at least 1 citation
• Data claims (numbers, percentages, growth rates) MUST be cited
• Industry comparisons MUST cite the source of each competitor's data
• Regulatory or policy statements MUST cite the official document

Anti-Patterns

• Do NOT use [citation needed] as placeholder — mark as 暂无公开数据支撑 instead
• Do NOT cite the same source more than 3 times in one section without providing additional sources
• Do NOT fabricate page numbers or URLs