Academic Writing Assistant

# Academic Writing

## Overview

学术写作辅助技能，提供论文段落写作、语言润色、语法检查、学术风格优化、引用格式检查等功能。

## Capabilities

### 1. 段落写作

**功能**:
- 主题句生成
- 论证展开
- 过渡句写作
- 结论句写作

**使用示例**:
```bash
python academic_writing.py --action write_paragraph --topic "AI psychology" --style APA
```

---

### 2. 语言润色

**功能**:
- 语法检查
- 句式优化
- 词汇升级
- 学术风格优化

**使用示例**:
```bash
python academic_writing.py --action polish --input draft.md --output polished.md
```

**润色规则**:
- 避免口语化表达
- 避免第一人称（除非必要）
- 使用学术术语
- 保持句子简洁（15-30 词）
- 段落长度适中（100-250 词）

---

### 3. 格式检查

**功能**:
- 引用格式检查
- 段落格式检查
- 图表格式检查
- 参考文献格式检查

**支持格式**:
| 格式 | 学科 | 版本 |
|------|------|------|
| **APA** | 心理学、教育学 | 7th |
| **AMA** | 医学 | 11th |
| **Vancouver** | 生物医学 | - |
| **IEEE** | 工程、计算机 | - |
| **Chicago** | 人文社科 | 17th |

---

### 4. 引用管理

**功能**:
- 文内引用格式化
- 参考文献列表生成
- 引用完整性检查
- DOI 验证

**使用示例**:
```bash
python academic_writing.py --action format_citations --input paper.md --style APA
```

---

## Writing Styles

### APA 第 7 版（心理学）

**文内引用**:
- 单作者：(Smith, 2025)
- 双作者：(Smith & Jones, 2025)
- 三作者及以上：(Smith et al., 2025)

**参考文献格式**:
```
Author, A. A. (Year). Title of article. Title of Journal, Volume(Issue), Pages. DOI
```

**示例**:
```
Smith, J. (2025). AI in psychology. Journal of Psychology, 10(2), 100-120. https://doi.org/10.1000/jp.2025.001
```

---

### AMA 第 11 版（医学）

**文内引用**:
- 上标数字：研究结果表明¹

**参考文献格式**:
```
Author AA. Title of article. Journal. Year;Volume(Issue):Pages. DOI
```

**示例**:
```
Smith J. AI in psychology. J Psychol. 2025;10(2):100-120. doi:10.1000/jp.2025.001
```

---

### IEEE（工程）

**文内引用**:
- 方括号数字：研究结果表明 [1]

**参考文献格式**:
```
[N] Author AA. Title of article. Journal. Year;Volume(Issue):Pages.
```

**示例**:
```
[1] Smith J. AI in psychology. J Psychol. 2025;10(2):100-120.
```

---

## Usage

### 基本使用

```bash
# 段落写作
python academic_writing.py --action write --topic "主观幸福感" --style APA

# 语言润色
python academic_writing.py --action polish --input draft.md --output polished.md

# 格式检查
python academic_writing.py --action check --input paper.md --style APA

# 引用格式化
python academic_writing.py --action format_citations --input paper.md --style APA
```

---

### 高级使用

```bash
# 批量润色
python academic_writing.py --action polish --input-dir drafts/ --output-dir polished/

# 格式检查报告
python academic_writing.py --action check --input paper.md --style APA --report report.md

# 引用完整性检查
python academic_writing.py --action check_citations --input paper.md
```

---

## Quality Checks

### 语法检查

**检查项目**:
- [ ] 主谓一致
- [ ] 时态一致
- [ ] 冠词使用
- [ ] 介词使用
- [ ] 句子完整性

**常见错误**:
- ❌ The data shows... → ✅ The data show...
- ❌ In this paper, we studied... → ✅ In this paper, we study...

---

### 风格检查

**检查项目**:
- [ ] 学术语气
- [ ] 避免口语化
- [ ] 避免第一人称（除非必要）
- [ ] 被动语态使用
- [ ] 术语准确性

**改进示例**:
- ❌ We think that... → ✅ It is suggested that...
- ❌ This is a big problem → ✅ This is a significant issue

---

### 清晰度检查

**检查项目**:
- [ ] 句子长度（15-30 词）
- [ ] 段落长度（100-250 词）
- [ ] 逻辑连贯性
- [ ] 过渡词使用
- [ ] 重复内容

**改进示例**:
- ❌ 长句（50+ 词）→ ✅ 拆分为 2-3 个短句
- ❌ 缺少过渡 → ✅ 添加 However, Therefore, Moreover 等

---

### 引用检查

**检查项目**:
- [ ] 引用格式正确
- [ ] 所有引用在参考文献列表中
- [ ] 参考文献列表完整
- [ ] DOI 包含
- [ ] 引用时效性（近 5 年为主）

---

## Output Format

### 润色报告

```markdown
# 润色报告

**输入文件**: draft.md
**输出文件**: polished.md
**润色时间**: 2026-03-14 13:15

## 修改统计

| 类型 | 数量 |
|------|------|
| 语法修改 | 5 |
| 句式优化 | 8 |
| 词汇升级 | 12 |
| 格式调整 | 3 |

## 主要修改

### 第 1 段
**原文**: We think that AI is very useful in psychology research.
**修改**: It is suggested that AI demonstrates significant utility in psychological research.
**原因**: 学术风格优化，避免第一人称

### 第 2 段
**原文**: This is a big problem.
**修改**: This represents a significant challenge.
**原因**: 词汇升级

## 格式检查

- [x] 引用格式正确（APA 7th）
- [x] 段落格式正确
- [x] 参考文献列表完整
- [ ] 部分 DOI 缺失（需补充）
```

---

## Best Practices

### 写作建议

1. **段落结构**
   - 主题句开头
   - 3-5 个论证句
   - 结论句结尾

2. **句子长度**
   - 避免过长（>40 词）
   - 避免过短（<10 词）
   - 保持变化

3. **引用规范**
   - 直接引用加页码
   - 间接引用要准确
   - 避免过度引用

4. **学术风格**
   - 客观陈述
   - 避免主观判断
   - 使用谨慎语言（may, might, suggest）

---

### 避免错误

1. **语法错误**
   - ❌ 主谓不一致
   - ❌ 时态混乱
   - ❌ 句子片段

2. **风格问题**
   - ❌ 口语化表达
   - ❌ 过度使用第一人称
   - ❌ 情绪化语言

3. **引用问题**
   - ❌ 格式不一致
   - ❌ 引用缺失
   - ❌ 过度自引

---

## Integration

### 与 scientific-writing 配合

```
scientific-writing: 负责整体结构和内容生成
academic-writing: 负责语言润色和格式检查
```

### 与 citation-management 配合

```
citation-management: 负责文献搜索和引用生成
academic-writing: 负责引用格式化和完整性检查
```

---

## References

- APA Style: https://apastyle.apa.org/
- AMA Style: https://www.amamanualofstyle.com/
- IEEE Style: https://ieeeauthorcenter.ieee.org/

---

## Examples

### 示例 1: 引言段落润色

**输入**:
```
We studied how AI can help psychology research. We found that AI is very useful.
```

**输出**:
```
This study investigated the potential applications of artificial intelligence in psychological research. The findings suggest that AI demonstrates significant utility in enhancing research efficiency and quality.
```

---

### 示例 2: 引用格式化

**输入**:
```
Smith 2025 said AI is useful in psychology.
```

**输出** (APA):
```
Smith (2025) suggested that AI demonstrates utility in psychological research.
```

**参考文献**:
```
Smith, J. (2025). AI in psychology. Journal of Psychology, 10(2), 100-120. https://doi.org/10.1000/jp.2025.001
```

---

**技能版本**: v1.0.0  
**创建时间**: 2026-03-14  
**维护者**: academic-assistant  
**下次更新**: 功能改进时

---

*学术写作，从规范开始！*📝✨