---
name: draft-writing
description: |
  論文草稿的撰寫、讀取、引用管理。
  LOAD THIS SKILL WHEN: 寫草稿、draft、撰寫、Introduction、Methods、Results、Discussion、引用、citation、字數
  CAPABILITIES: write_draft, draft_section, read_draft, list_drafts, insert_citation, sync_references, count_words, get_section_template
---

# 草稿撰寫技能

## 適用情境

| 觸發語 | 操作 |
|--------|------|
| 寫草稿、撰寫 section | `draft_section()` 或 `write_draft()` |
| 看草稿、讀取 | `read_draft()` |
| 有哪些草稿 | `list_drafts()` |
| 加引用、插入引用 | `insert_citation()` |
| 整理引用、生成 References | `sync_references()` |
| 字數、word count | `count_words()` |
| 怎麼寫這個 section | `get_section_template()` |

---

## ⚠️ 前置條件

**撰寫任何草稿前必須：**
1. 確認專案已選定：`get_current_project()`
2. 確認 concept.md 存在且包含 🔒 區塊
3. 結構驗證通過（🔒 NOVELTY + 🔒 SELLING POINTS 不為空）

**例外**：寫 `concept.md` 本身不需要驗證

---

## MCP Tools 清單

### 撰寫工具 (mdpaper)

| 工具 | 參數 | 說明 |
|------|------|------|
| `write_draft` | `filename`, `content`, `project` | 建立/覆寫草稿檔案 |
| `draft_section` | `topic`, `notes`, `project` | 根據筆記產出特定 section |
| `read_draft` | `filename`, `project` | 讀取草稿結構與內容 |
| `list_drafts` | `project` | 列出所有草稿 |

### 引用工具 (mdpaper)

| 工具 | 參數 | 說明 |
|------|------|------|
| `insert_citation` | `filename`, `target_text`, `pmid` | 在指定位置插入引用 |
| `sync_references` | `filename`, `project` | 掃描 [[wikilinks]] 生成 References |
| `count_words` | `filename`, `section` | 計算字數 |
| `get_section_template` | `section` | 取得 section 寫作指南 |

---

## 工作流程

### Flow A: 撰寫新 Section

```
Step 1: 確認專案和驗證狀態
  get_current_project()
  validate_for_section(section="Introduction")
  → ✅ CAN WRITE / ❌ CANNOT WRITE

Step 2: 讀取 concept 和受保護內容
  read_draft(filename="concept.md")
  → 提取 🔒 NOVELTY STATEMENT
  → 提取 🔒 KEY SELLING POINTS

Step 3: 取得寫作指南
  get_section_template(section="Introduction")
  → 返回該 section 的結構建議

Step 4: 撰寫內容
  draft_section(
    topic="Introduction",
    notes="Background on remimazolam... Gap in literature..."
  )
  或
  write_draft(
    filename="drafts/introduction.md",
    content="..."
  )

Step 5: 確認字數
  count_words(filename="drafts/introduction.md")
```

---

### Flow B: 插入引用

**方法 1: Wikilink 格式（推薦）**
```markdown
先前研究指出 [[greer2017_27345583]] 使用 propofol 有其限制。
```

然後執行：
```
sync_references(filename="drafts/introduction.md")
→ 轉換為 [1] 格式
→ 生成 References 區塊
```

**方法 2: 定點插入**
```
insert_citation(
  filename="drafts/introduction.md",
  target_text="先前研究指出",
  pmid="27345583"
)
```

---

### Flow C: 整理 References

```
Step 1: 確認草稿有 wikilinks
  read_draft(filename="drafts/full_manuscript.md")
  → 檢查是否有 [[citation_key]] 格式

Step 2: 同步引用
  sync_references(filename="drafts/full_manuscript.md")
  → 輸出：
    | # | Citation Key | Title |
    | 1 | greer2017_27345583 | Review of... |
    | 2 | smith2020_12345678 | Analysis of... |

Step 3: 確認未找到的引用
  → ⚠️ Not found: chen2019_87654321
  → 需要先 save_reference_mcp(pmid="87654321")
```

---

## 🔒 受保護內容規則

| 受保護區塊 | 出現位置 | 規則 |
|------------|----------|------|
| 🔒 NOVELTY STATEMENT | concept.md | Introduction 必須體現 |
| 🔒 KEY SELLING POINTS | concept.md | Discussion 必須強調全部 |

**撰寫時的強制要求：**
```
✅ Introduction 開頭或結尾必須呼應 NOVELTY
✅ Discussion 必須逐條強調 SELLING POINTS
❌ 不可刪除或弱化 🔒 區塊內容
❌ 修改 🔒 區塊前必須詢問用戶
```

---

## Section 寫作指南

### Introduction (400-600 words)
**結構：Evidence Funnel (證據漏斗)**
1. **Clinical Reality** - 具體數據開場（避免 "In recent years..."）
2. **Evidence Base** - 綜合現有文獻（使用 [[wikilinks]]）
3. **Knowledge Gap** - 明確指出不足（對應 🔒 NOVELTY）
4. **Objective** - 本研究目的

**🚫 Anti-AI 寫作規則：**
- 禁止使用模糊開場（如 "With the advancement of..."）
- 禁止每段開頭都用 "Furthermore", "Additionally"
- 必須包含具體數字、百分比、機制描述
- 轉折語必須具備邏輯性（如 "Despite these benefits...", "In contrast to..."）

### Methods (800-1200 words)
```
1. Study Design - 研究設計
2. Participants - 納入排除標準
3. Intervention - 介入措施
4. Outcomes - 結果指標
5. Statistics - 統計方法
```

### Results (600-1000 words)
```
1. Participants - 收案流程、基線特徵
2. Primary Outcome - 主要結果
3. Secondary Outcomes - 次要結果
4. Tables/Figures - 圖表說明
```

### Discussion (1000-1500 words)
```
1. Main Findings - 主要發現（含 🔒 SELLING POINTS）
2. Comparison - 與現有文獻比較
3. Implications - 臨床意義
4. Limitations - 研究限制
5. Conclusion - 結論
```

### Abstract (250-350 words)
```
Structured: Background / Methods / Results / Conclusions
Unstructured: 依期刊要求
```

---

## Wikilink 格式

**正確格式：**
```
[[author2024_12345678]]  ← 作者年份_PMID
[[greer2017_27345583]]
```

**會被自動修復的格式：**
```
[[12345678]] → [[author2024_12345678]]
[[PMID:12345678]] → [[author2024_12345678]]
Author 2024 [[12345678]] → [[author2024_12345678]]
```

---

## 常見問題

| 問題 | 解法 |
|------|------|
| 草稿被阻擋 | 檢查 concept.md 的 🔒 區塊是否填寫 |
| 引用找不到 | 先 `save_reference_mcp()` 儲存文獻 |
| 字數太多 | `count_words()` 逐 section 檢查 |
| 不知道怎麼寫 | `get_section_template()` 取得指南 |
| Wikilink 格式錯誤 | `validate_wikilinks()` 自動修復 |

---

## 相關技能

- `concept-development` - 發展 concept（撰寫前）
- `concept-validation` - 驗證 concept（撰寫前）
- `reference-management` - 管理引用文獻
- `word-export` - 匯出為 Word