mcpField
D
document-writing

document-writing

github.com/shino369文档处理3240 次安装2 周前更新
代码仓库

关于 document-writing

面向正式文档与文章写作的指导技能,涵盖英语、日语和繁体中文。内容包括语言特有的结构、语气、格式,以及学术、商务、技术和编辑写作示例。

主要功能

  1. 01三种语言的写作规范
  2. 02学术、商务与技术文档类型
  3. 03修辞结构与语气指导
  4. 04文档排版规范
  5. 05示例与修订清单

适用场景

  1. 01规划研究论文或学位论文
  2. 02起草商务报告和提案
  3. 03编写手册或技术规格
  4. 04按语言规范调整文章

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/shino369/claude-code-personal-workspace --skill document-writing

安装后在 Claude Code 中输入/document-writing确认已加载。

详细介绍

文档与论文写作

范围:本技能侧重于英语、日语和繁体中文的单语写作规范。 关于翻译工作流,请参阅 translation-expertise 技能。

概述

本技能全面介绍英语、日语和繁体中文正式文档与论文的写作规范、风格和最佳实践。每种语言都有各自独特的修辞传统、组织模式和风格惯例。

文档类型与用途

学术写作
  • 研究论文
  • 学位论文与博士论文
  • 文献综述
  • 会议论文
  • 期刊文章
商务文档
  • 报告与提案
  • 备忘录与电子邮件
  • 演示文稿
  • 白皮书
  • 案例研究
技术写作
  • 用户手册
  • API 文档
  • 技术规范
  • 标准操作规程(SOP)
  • 技术报告
创意与编辑写作
  • 论文与文章
  • 博客文章
  • 评论文章
  • 专题报道
  • 书评

各语言的写作规范

英语写作风格

修辞结构:

  • 演绎法:开篇提出论点,再提供支持证据
  • 主题句:每个段落都以要点开头
  • 明确的过渡:使用清晰的连接词(however、therefore、moreover)
  • 倾向使用主动语态:采用直接、清晰的主谓宾结构
  • 结论重申论点:总结论据并重申要点

组织模式:

  1. 引言:引入点、背景、论点陈述
  2. 主体段落:主题句、证据、分析、过渡
  3. 结论:总结、重申、更广泛的意义

风格特点:

  • 变换句子长度与结构
  • 使用具体示例和证据
  • 平衡复杂句与简单句
  • 避免冗余和冗长
  • 在列表中保持平行结构

常用表达:

  • “值得注意的是……”
  • “在这方面……”
  • “如前所述……”
  • “为说明这一点……”
  • “总之……”
日语写作风格(日本語)

修辞结构:

  • 归纳法(起承転結):逐步铺陈,最终得出结论
    • 起(ki):引言,交代背景
    • 承(shou):展开,阐述引言内容
    • 转(ten):转折或转换,提出新视角
    • 结(ketsu):结论,收束并总结
  • 含蓄的结论:预期读者自行推断含义
  • 强调和谐:避免对抗性表述
  • 谦逊的自我指称:提及自己的作品时使用谦逊表达

礼貌等级:

  • 学术写作:正式学术写作使用 である・だ体(简体)
  • 商务写作:商务沟通使用 です・ます体(礼貌体)
  • 正式报告:以 である体为主,偶尔使用 です・ます体

风格特点:

  • 使用漢語(kango,即日语中的汉字词)营造正式语气
  • 被动语态(受身形)比英语更常见
  • 使用名词化形式(〜こと、〜の)表达抽象概念
  • 使用四字熟語提升简洁性
  • 使用间接表达缓和语气

常用表达:

  • 本稿では...(本文将……)
  • ...について述べる(将讨论……)
  • ...と考えられる(可以认为……)
  • ...ということが分かる(可以得知……)
  • 以上のことから...(综上所述……)
  • 結論として...(总之……)

段落结构:

  • 段落比英语更长
  • 主题句不那么明确
  • 逐步展开观点
  • 逻辑联系含蓄呈现
繁體中文寫作風格

修辭結構:

  • 古典影響:受文言傳統影響
  • 平衡與對仗(對仗):採用對稱的句式結構
  • 四字成語(成語):簡潔表達複雜概念
  • 首尾呼應:在結論中回到開篇主題
  • 強調典雅:語言精煉,融入文學典故

正式程度:

  • 學術:受文言影響,採用古典句式
  • 商務:使用現代白話文與正式詞彙
  • 技術:清晰直接,較少使用文學修辭

風格特點:

  • 運用成語(chengyu),使表達更為精煉
  • 採用平行結構(對偶句)以加強語氣
  • 運用典故(典故)彰顯學識
  • 運用設問以增強說服力
  • 正式寫作中採用四、六字句式的駢文

常用語句:

  • 本文將探討...(This article will explore...)
  • 由此可見...(From this we can see...)
  • 綜上所述...(In summary...)
  • 值得注意的是...(It is worth noting that...)
  • 基於以上分析...(Based on the above analysis...)
  • 總而言之...(In conclusion...)

段落結構:

  • 句式結構均衡
  • 運用平行句式
  • 融入成語以精簡表達
  • 透過古典語句自然銜接

語氣與語體

隨意語氣

英語:

  • 使用縮寫(don't、won't、it's)
  • 使用對話式語言
  • 使用人稱代詞(I、you、we)
  • 使用簡單詞彙
  • 使用短句
  • 使用非正式表達

日語:

  • 使用普通體動詞(食べる、行く)
  • 使用隨意助詞(ね、よ、さ)
  • 使用非正式代詞(僕、俺、君)
  • 使用句尾だ
  • 使用隨意表達(すごい、ちょっと)

中文:

  • 使用口語表達(很酷、超棒)
  • 採用簡單句式
  • 使用日常詞彙(吃、看、玩)
  • 採用個人敘事風格
  • 使用對話式語句(你知道嗎?、對吧?)
正式語氣

英語:

  • 不使用縮寫(do not、will not、it is)
  • 使用學術/專業詞彙
  • 優先採用第三人稱視角
  • 採用複雜句式
  • 適當使用被動語態
  • 使用客觀語言

日語:

  • 使用である/だ體(學術普通體)
  • 使用です・ます體(商務禮貌體)
  • 使用正式詞彙(漢語)
  • 使用敬語(敬語)
  • 採用非人稱句式
  • 使用被動式與可能式

中文:

  • 使用文學詞彙
  • 採用複雜句式
  • 使用成語與古典語句
  • 使用正式連接詞(然而、因此、即)
  • 採用第三人稱或非人稱句式
  • 使用敬稱(敬語:貴、本、敝)

文件格式慣例

英文文件

結構:

  • 標題(置中,採用標題式大小寫)
  • 作者姓名與所屬機構
  • 摘要(學術文件適用)
  • 引言,明確提出論點
  • 正文,含章節標題
  • 結論
  • 參考文獻(APA、MLA、Chicago 等格式)

排版:

  • 使用 12pt Times New Roman 或類似字型
  • 採用雙倍行距(學術文件)
  • 頁邊距為 1 英吋
  • 加上頁碼
  • 段落縮排或區塊式排版
日文文件

結構:

  • 標題(中央揃え)
  • 作者(著者名)
  • 摘要(要旨/概要)
  • 序論(Introduction)
  • 本論(Main body)
  • 結論(Conclusion)
  • 參考文獻(References)

排版:

  • 傳統文章採用直排(縦書き)
  • 學術/技術文件採用橫排(横書き)
  • 適當使用漢字、平假名、片假名
  • 使用正確標點(。、「」)
  • 適當換行與段落間距
繁體中文文件

結構:

  • 標題(置中)
  • 作者
  • 摘要
  • 前言/緒論
  • 內容/本文
  • 結論
  • 參考文獻

排版:

  • 使用繁體字
  • 使用正確標點(。、「」《》)
  • 適當留白
  • 使用章節編號(一、二、三或 1、2、3)
  • 段落縮排(首行縮排)

具體寫作範例

本節展示修辭結構如何體現在實際寫作中。

英语:演绎式写作示例

主题:远程办公的好处

远程办公对现代组织的价值日益凸显。首先,它能降低维护实体办公场所的相关开支,包括租金、水电费和设备费用。其次,远程办公消除了地域限制,扩大了人才库,让公司无论候选人身在何处,都能聘用最优秀的人才。第三,研究表明,由于灵活性提高、通勤压力减轻,远程工作者通常会报告更高的工作满意度和生产力。这些因素共同使远程办公成为雇主和员工都青睐的选择。

分析:

  • 主题句清晰,陈述主要观点
  • 用明确的标记(首先、其次、第三)列出三个支撑论点
  • 每个论点都包含证据或解释
  • 结尾句将各个观点联系起来
  • 表达直接、明确
日语:起承転結结构示例

主题:リモートワークの価値(远程办公的价值)

近年来,作为工作方式改革的一环,远程办公备受关注。(起)

在传统的办公室工作模式下,通勤时间和固定的工作时间限制了员工的生活。此外,企业也要承担维持大型办公空间的高昂成本。(承)

然而,随着远程办公的引入,这种情况发生了彻底改变。员工可以在家中或自己喜欢的地方工作,摆脱通勤压力。企业也能不受地域限制地招聘优秀人才,从而提升组织的竞争力。(转)

由此可见,远程办公不仅是一种工作方式的选择,也蕴含着改变整个社会价值观的可能性。(结)

分析:

  • 起(ki):将远程办公作为工作方式改革趋势的一部分引入
  • 承(shou):通过描述传统办公室工作的弊端来铺陈背景
  • 转(ten):呈现转折点,说明远程办公带来的变革性影响
  • 结(ketsu):以对社会价值观的更广泛影响作结
  • 间接、循序渐进地铺陈,最终得出结论
  • 使用被动语态(受到关注、得到解放)
  • 采用「である体」的正式学术语气
中文:均衡结构与成语示例

主题:远程办公的优势

随着科技日新月异,远程办公已成为现代企业不可忽视的趋势。这种工作模式不仅能为企业节省成本,更能为员工带来前所未有的便利。一方面,企业无需承担庞大的办公场地费用,可谓事半功倍;另一方面,员工得以免除通勤之苦,在家中即可完成工作,可谓两全其美。由此可见,远程办公对于企业与员工而言,实为互惠互利、相得益彰之举。综上所述,远程办公不仅是工作方式的革新,更是提升生活品质的重要途径。

分析:

  • 自然运用成语:日新月异(快速变化)、事半功倍(用较少的付出取得更大的成效)、两全其美(双方都得到好处)、相得益彰(互惠互利)
  • 使用对仗结构:一方面……另一方面……
  • 使用经典表达:由此可见、综上所述
  • 表达均衡、优雅
  • 采用词汇精炼的正式书面风格

常见写作模式

比较与对比

英语:使用清晰的比较标记(同样地、相反地、而、虽然) 日语:一方で(另一方面)、それに対して(与之相反) 中文:相较之下、与此相反

因果关系

英语:因为、因此、结果是、于是 日语:……ので、……から、その結果、したがって 中文:因为……所以、因此、由于、导致

问题与解决方案

英语:清楚说明问题,提出解决方案,评估其有效性 日语:铺陈背景,提出挑战,间接地建议解决方法 中文:描述情况,分析原因,提出对策

论证

英语:论点 + 证据 + 推理 + 反方观点 + 反驳 日语:呈现多种观点,委婉劝说,间接得出结论 中文:引用权威观点,运用历史实例,进行逻辑推演

质量检查清单

完成任何文档前:

内容:

  • 目的和论点明确
  • 组织结构合理
  • 证据和论据充分
  • 深度和范围恰当
  • 引言和结论有效

风格:

  • 语气和语域一致
  • 正式程度恰当
  • 遵循语言特定规范
  • 表达清晰简洁
  • 引人入胜且易于阅读

技术:

  • 语法和句法正确
  • 标点使用恰当
  • 拼写准确
  • 字符使用正确(JA/ZH)
  • 格式一致

语言特定要求:

  • 英语:论点明确,主题句有力
  • 日语:采用恰当的起承转结或结构
  • 中文:有效运用成语和正式表达

最佳实践

  1. 了解读者:根据读者的预期调整语言和语气
  2. 遵循惯例:尊重文化写作传统
  3. 清晰简洁:避免不必要的复杂表达
  4. 使用示例:具体示例能增强论证
  5. 保持一致:确保语气、风格和格式统一
  6. 严格编辑:好文章是反复修改出来的
  7. 征求反馈:条件允许时,请母语人士审阅
  8. 广泛阅读:从目标语言的优秀范例中学习
  9. 定期练习:写作能力会随着练习而提高
  10. 尊重文化规范:不同文化有不同的预期

资源

英语写作:

  • Strunk & White 的《风格的要素》
  • Purdue OWL(在线写作实验室)
  • 《芝加哥格式手册》

日语写作:

  • 日本語文章能力検定(Japanese Writing Proficiency Test)资料
  • 多位作者编写的文章読本(Bunshō dokuhon)
  • 日本大学的学术写作指南

中文写作:

  • 現代漢語修辭(现代汉语修辞)
  • 應用文寫作(实用写作)
  • 台湾教育部的风格指南

评论

支持 Markdown