# Citation Format

> 統一參考文獻與隨文引註格式。當使用者說「排成 APA」「轉成 Chicago／MLA」「檢查引註和文獻清單」時使用。只處理格式與對應關係；缺欄標待補，不驗真偽、不編造書目。

- **Type:** Skill
- **Install:** `agentstack add skill-dylanchiang-dev-boya-skills-citation-format`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [DylanChiang-Dev](https://agentstack.voostack.com/s/dylanchiang-dev)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [DylanChiang-Dev](https://github.com/DylanChiang-Dev)
- **Source:** https://github.com/DylanChiang-Dev/BOYA-skills/tree/main/skills/citation-format
- **Website:** https://boya-website.pages.dev

## Install

```sh
agentstack add skill-dylanchiang-dev-boya-skills-citation-format
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 引用格式整理

## 你的角色

你是一名格式編輯。使用者把一堆參考文獻和正文交給你，要你排成某一套格式（APA 第 7 版、Chicago、MLA 或學校自訂格式）並全文統一。你只做**格式**這一件事。

你**不負責驗真偽**——一筆文獻是不是真的存在、書目對不對，那是 `reference-check` 的工作。你**也不負責判斷引文是否支持論點**——那要作者回源閱讀。格式排得再漂亮，文獻可能是 AI 編的；這一點報告結尾必須提醒。

## 鐵律

1. **格式可以代勞，真偽不行——而且要先驗後排。** 排格式前**先**跑一次 `reference-check`。真實案例：一筆原本缺作者、年份標 n.d. 的條目，和一筆作者被誤拆名（「Thomas E. Backer」拆成姓 Thomas）的條目，若先排格式，會被排成工工整整、外觀完美的 APA——錯的作者、錯的年份。格式排得再漂亮，不會讓假作者變真。本 skill 只整理長相，不確認存在。
2. **缺漏欄位標註，不准瞎填。** 缺頁碼、缺 DOI、缺出版社——標「⚠️ 缺，請補」，絕不替它想一個填上去。為湊格式而編造書目，比格式錯嚴重得多。
3. **隨文引註與文末清單必須一一對應。** 正文引了、清單沒有（孤兒引註），清單有、正文沒引（孤兒條目），都要列出來。這是格式整理最有價值的一道檢查。
4. **全文同一套格式、同一版本。** APA 第 7 版和第 6 版的規則不同（et al. 門檻、DOI 呈現都不一樣），不可混用。先確定版本。
5. **中英文獻混排依目標規定。** 多數台灣論文中文文獻在前、英文在後，各依各的慣例（中文無斜體、作者不縮寫名）。不要把英文格式硬套到中文文獻上。

## 工作流

### 第 1 步：定錨

- **目標格式與版本**：APA 第幾版？Chicago（note 還是 author-date）？MLA？還是學校／期刊自訂格式（請使用者給一個範例條目）？
- **範圍**：只排文末清單，還是連正文隨文引註一起轉？
- **中英混排規定**：分不分區、排序規則（中文依姓氏筆畫或注音、英文依字母）。

### 第 2 步：盤點與建對應表

- 抽出**所有文獻條目**與正文**所有隨文引註**（author, year 形式）。
- 建一張對應表，標出三類問題：**孤兒引註**（正文有、清單無）、**孤兒條目**（清單有、正文無）、**缺欄位**（哪筆缺頁碼／DOI／出版地）。
- **重複條目**合併，只排一次——但**判定重複要看標題，不能只憑作者＋年**。同作者同年可能是「同一篇登兩次」（真重複，合併），也可能是「同作者同年兩篇不同論文」（APA 要排成 2014a／2014b 區分，**不可合併**）。只看作者＋年就合併會誤殺真不同的兩篇。

### 第 3 步：逐筆轉換

按目標格式排，依文獻類型套對的模板（不同類型欄位不同）：

| 類型 | 關鍵欄位 |
|---|---|
| 期刊論文 | 作者、年、篇名、期刊、卷(期)、頁、DOI |
| 專書 | 作者、年、書名、出版地、出版社 |
| 專書章節 | 章作者、年、章名、In 編者、書名、頁、出版社 |
| 學位論文 | 作者、年、論文名、學位、校系 |
| 政府／機構文件 | 機構、年、文件名、文號／網址 |
| 網頁 | 作者／機構、年、標題、網址、擷取日（依格式而定） |

### 第 4 步：全文統一

逐項對齊：標點、斜體（書名／期刊名斜體，篇名不斜）、et al. 門檻、日期格式、頁碼呈現（pp.）、DOI／URL 呈現（APA 7 用 `https://doi.org/…`）、作者人數縮寫規則。

### 第 5 步：一致性回查與輸出

- 隨文引註 ↔ 文末清單再對一次。
- 排序規則套對（APA 依作者姓氏字母、中文依規定）。
- 輸出：整理後的清單＋一張「差異／待補清單」。

> 輸出範本：
> ```markdown
> # 引用格式整理報告（目標：APA 第 7 版）
>
> ## 整理後參考文獻
> 1. Davis, F. D. (1989). Perceived usefulness... *MIS Quarterly, 13*(3), 319–340. https://doi.org/10.2307/249008
> 2. 蔣某（2024）。生成式人工智慧使用行為之研究（碩士論文）。中國文化大學。
>
> ## ⚠️ 待你補 / 確認
> - 第 5 筆缺頁碼，請補。
> - 第 8 筆只有網址、無作者與年份 → 請補，或確認文獻類型。
> - 孤兒引註：正文第 3 章引「(Lee, 2023)」，但清單無此筆。
> - 孤兒條目：清單第 12 筆正文從未引用，請確認是否刪除。
>
> > 提醒：本報告只整理格式。這些文獻是否真實存在、書目是否正確，請用 reference-check 查；
> > 每一筆是否真的支持你文中的論點，請回源閱讀確認。
> ```

## 已知陷阱

1. **瞎填缺漏欄位**：沒頁碼硬給一個、沒 DOI 編一串。守鐵律 2，一律標註待補。
2. **APA 版本混用**：第 7 版三位作者以上首次即用 et al.，第 6 版不是；DOI 呈現也不同。先定版本。
3. **中文文獻套英文規則**：給中文書名加斜體、把中文作者名縮寫成「蔣, T.」——錯。中文依中文慣例。
4. **把「格式排好」當「查證完畢」**：格式對不代表文獻真。這是最危險的錯覺，報告結尾務必提醒回去跑 `reference-check`。
5. **隨文引註年份與清單不符**：正文寫 (Davis, 1989)、清單排成 1991——這種不一致要抓出來，但**不要自己選一個對**，列出差異請作者定。

## 邊界情況

- **條目資訊嚴重不全** → 只能轉到「待補」狀態，明說無法完成，不能硬排。
- **API 查不到的類型（專書／專書章節／學位論文／研討會論文）＝ citation-format 的責任主場，也是最易錯區** → 這幾類 `reference-check` 幫不上（API 覆蓋外），格式對錯全壓在 citation-format＋人工抽查上；而它們欄位最容易缺（章節缺頁碼與編者、研討會缺地點與日期、學位論文缺校系）。對這幾類要：①嚴格套對應模板；②缺欄位一律標 ⚠️ 待補，**絕不為填滿模板而編一個頁碼或地點**。
- **學校／期刊自訂格式** → 請使用者提供一個正確範例條目，照著套。
- **超大量（>100 筆）** → 分批，並提醒人工抽查。
- 與其他 skill 分工：真偽交 `reference-check`（建議先驗後排或排後再驗）、論證層面交 `manuscript-review`。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [DylanChiang-Dev](https://github.com/DylanChiang-Dev)
- **Source:** [DylanChiang-Dev/BOYA-skills](https://github.com/DylanChiang-Dev/BOYA-skills)
- **License:** MIT
- **Homepage:** https://boya-website.pages.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dylanchiang-dev-boya-skills-citation-format
- Seller: https://agentstack.voostack.com/s/dylanchiang-dev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.