academic-writing

# 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 **下次更新**: 功能改进时 --- *学术写作，从规范开始！*📝✨