mcpField
D
document-writing

document-writing

github.com/shino369ドキュメント3240 回インストール2 週間前に更新
リポジトリ

document-writing について

英語、日本語、繁体字中国語での正式な文書やエッセイ向けの執筆ガイドです。学術、ビジネス、技術、編集分野について、言語ごとの構成、文体、書式と例を扱います。

主な機能

  1. 013言語の執筆規範
  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を入力して読み込まれたか確認します。

詳細

Document and Essay Writing

Scope: This skill focuses on monolingual writing conventions for English, Japanese, and Traditional Chinese. For translation workflows, see the translation-expertise skill.

Overview

This skill provides comprehensive guidance on writing conventions, styles, and best practices for formal documents and essays in English, Japanese, and Traditional Chinese. Each language has distinct rhetorical traditions, organizational patterns, and stylistic conventions.

Document Types and Purposes

Academic Writing
  • Research papers
  • Theses and dissertations
  • Literature reviews
  • Conference papers
  • Journal articles
Business Documents
  • Reports and proposals
  • Memos and emails
  • Presentations
  • White papers
  • Case studies
Technical Writing
  • User manuals
  • API documentation
  • Technical specifications
  • Standard Operating Procedures (SOPs)
  • Technical reports
Creative and Editorial
  • Essays and articles
  • Blog posts
  • Opinion pieces
  • Feature stories
  • Book reviews

Language-Specific Writing Conventions

English Writing Style

Rhetorical Structure:

  • Deductive approach: State thesis upfront, then provide supporting evidence
  • Topic sentences: Each paragraph begins with main point
  • Explicit transitions: Use clear connectors (however, therefore, moreover)
  • Active voice preference: Direct and clear subject-verb-object
  • Conclusion restates thesis: Summarize arguments and restate main point

Organization Patterns:

  1. Introduction: Hook, background, thesis statement
  2. Body paragraphs: Topic sentence, evidence, analysis, transition
  3. Conclusion: Summary, restatement, broader implications

Stylistic Features:

  • Vary sentence length and structure
  • Use specific examples and evidence
  • Balance complex and simple sentences
  • Avoid redundancy and wordiness
  • Maintain parallel structure in lists

Common Phrases:

  • "It is worth noting that..."
  • "In this regard..."
  • "As previously mentioned..."
  • "To illustrate this point..."
  • "In conclusion..."
Japanese Writing Style (日本語)

Rhetorical Structure:

  • Inductive approach (起承転結): Build to conclusion gradually
    • 起 (ki): Introduction, set the scene
    • 承 (shou): Development, elaborate on introduction
    • 転 (ten): Twist or turn, present new perspective
    • 結 (ketsu): Conclusion, resolve and conclude
  • Implicit conclusions: Reader expected to infer meaning
  • Emphasis on harmony: Avoid confrontational statements
  • Humble self-reference: Use humble forms when referring to own work

Politeness Levels:

  • Academic: である・だ体 (plain form) for formal academic writing
  • Business: です・ます体 (polite form) for business communication
  • Formal reports: Mix of である体 with occasional です・ます体

Stylistic Features:

  • Use of 漢語 (kango - Sino-Japanese compounds) for formal tone
  • Passive voice (受身形) more common than English
  • Nominalization (〜こと、〜の) to express abstract concepts
  • Four-character compounds (四字熟語) for conciseness
  • Indirect expressions to soften statements

Common Phrases:

  • 本稿では... (In this paper...)
  • ...について述べる (will discuss...)
  • ...と考えられる (it is thought that...)
  • ...ということが分かる (it can be understood that...)
  • 以上のことから... (From the above...)
  • 結論として... (In conclusion...)

Paragraph Structure:

  • Longer paragraphs than English
  • Less explicit topic sentences
  • Gradual development of ideas
  • Implicit logical connections
Traditional Chinese Writing Style (繁體中文)

Rhetorical Structure:

  • Classical influence: Influenced by literary Chinese traditions
  • Balance and parallelism (對仗): Symmetrical sentence structures
  • Four-character idioms (成語): Concise expression of complex ideas
  • Circular reasoning: Return to opening theme in conclusion
  • Emphasis on elegance: Refined language and literary allusions

Formality Levels:

  • Academic: Literary Chinese influence, classical structures
  • Business: Modern vernacular with formal vocabulary
  • Technical: Clear and direct, less literary

Stylistic Features:

  • Use of 成語 (chengyu) for sophisticated expression
  • Parallel structures (對偶句) for emphasis
  • Classical allusions (典故) to demonstrate erudition
  • Rhetorical questions for persuasion
  • Four-six parallel prose (駢文) for formal writing

Common Phrases:

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

Paragraph Structure:

  • Balanced sentence structures
  • Use of parallel constructions
  • Integration of 成語 for conciseness
  • Smooth transitions using classical phrases

Tone and Register

Casual Tone

English:

  • Contractions (don't, won't, it's)
  • Conversational language
  • Personal pronouns (I, you, we)
  • Simple vocabulary
  • Short sentences
  • Informal expressions

Japanese:

  • Plain form verbs (食べる、行く)
  • Casual particles (ね、よ、さ)
  • Informal pronouns (僕、俺、君)
  • Sentence-ending だ
  • Casual expressions (すごい、ちょっと)

Chinese:

  • Colloquial expressions (很酷、超棒)
  • Simplified sentence structures
  • Everyday vocabulary (吃、看、玩)
  • Personal narrative style
  • Conversational phrases (你知道嗎?、對吧?)
Formal Tone

English:

  • No contractions (do not, will not, it is)
  • Academic/professional vocabulary
  • Third-person perspective preferred
  • Complex sentence structures
  • Passive voice when appropriate
  • Objective language

Japanese:

  • である/だ体 (academic plain)
  • です・ます体 (polite business)
  • Formal vocabulary (漢語)
  • Respectful expressions (敬語)
  • Impersonal constructions
  • Passive and potential forms

Chinese:

  • Literary vocabulary
  • Complex sentence structures
  • Use of 成語 and classical phrases
  • Formal connectors (然而、因此、即)
  • Third-person or impersonal constructions
  • Honorific expressions (敬語: 貴、本、敝)

Document Formatting Conventions

English Documents

Structure:

  • Title (centered, title case)
  • Author name(s) and affiliation
  • Abstract (if academic)
  • Introduction with clear thesis
  • Body with section headings
  • Conclusion
  • References (APA, MLA, Chicago, etc.)

Typography:

  • 12pt Times New Roman or similar
  • Double-spaced (academic)
  • 1-inch margins
  • Page numbers
  • Indented paragraphs or block style
Japanese Documents

Structure:

  • Title (中央揃え)
  • Author (著者名)
  • Abstract (要旨/概要)
  • 序論 (Introduction)
  • 本論 (Main body)
  • 結論 (Conclusion)
  • 参考文献 (References)

Typography:

  • Vertical writing (縦書き) for traditional essays
  • Horizontal writing (横書き) for academic/technical
  • Appropriate use of kanji, hiragana, katakana
  • Proper punctuation (。、「」)
  • Line breaks and paragraph spacing
Traditional Chinese Documents

Structure:

  • 標題 (Title, centered)
  • 作者 (Author)
  • 摘要 (Abstract)
  • 前言/緒論 (Introduction)
  • 內容/本文 (Main body)
  • 結論 (Conclusion)
  • 參考文獻 (References)

Typography:

  • Traditional characters (繁體字)
  • Proper punctuation (。、「」《》)
  • Appropriate spacing
  • Section numbering (一、二、三 or 1、2、3)
  • Paragraph indentation (首行縮排)

Concrete Writing Examples

This section demonstrates how rhetorical structures manifest in actual writing.

English: Deductive Approach Example

Topic: The benefits of remote work

Remote work has become increasingly valuable for modern organizations. First, it reduces overhead costs associated with maintaining physical office spaces, including rent, utilities, and equipment. Second, remote work expands the talent pool by removing geographic constraints, allowing companies to hire the best candidates regardless of location. Third, studies show that remote workers often report higher job satisfaction and productivity due to increased flexibility and reduced commute stress. These factors combine to make remote work an attractive option for both employers and employees.

Analysis:

  • Clear topic sentence stating the main point
  • Three supporting points with explicit markers (First, Second, Third)
  • Each point includes evidence or explanation
  • Concluding sentence ties ideas together
  • Direct, explicit communication style
Japanese: 起承転結 Structure Example

Topic: リモートワークの価値 (The value of remote work)

近年、働き方改革の一環として、リモートワークが注目を集めている。(起)

従来のオフィス勤務では、通勤時間や固定的な勤務時間により、社員の生活が制約されていた。また、企業側も大規模なオフィススペースの維持に多額のコストを負担していた。(承)

しかし、リモートワークの導入により、このような状況が一変した。社員は自宅や好きな場所で働くことができ、通勤のストレスから解放された。企業は優秀な人材を地域に関係なく採用できるようになり、組織の競争力が向上した。(転)

このように、リモートワークは単なる働き方の選択肢ではなく、社会全体の価値観を変える可能性を秘めている。(結)

Analysis:

  • 起 (ki): Introduces remote work as part of work reform trend
  • 承 (shou): Develops context by describing traditional office problems
  • 転 (ten): Presents turning point with remote work's transformative impact
  • 結 (ketsu): Concludes with broader implication about societal values
  • Indirect, gradual build to conclusion
  • Uses passive voice (注目を集めている、解放された)
  • Formal academic tone with である体
Chinese: Balanced Structure with 成語 Example

Topic: 遠程辦公的優勢 (Advantages of remote work)

隨著科技日新月異,遠程辦公已成為現代企業不可忽視的趨勢。此種工作模式不僅能為企業節省成本,更能為員工帶來前所未有的便利。一方面,企業無需負擔龐大的辦公場地費用,可謂事半功倍;另一方面,員工得以免除通勤之苦,在家中即可完成工作,可謂兩全其美。由此可見,遠程辦公之於企業與員工,實為互惠互利、相得益彰之舉。綜上所述,遠程辦公不僅是工作方式的革新,更是提升生活品質的重要途徑。

Analysis:

  • Uses 成語 naturally: 日新月異 (rapid change), 事半功倍 (achieve more with less), 兩全其美 (best of both worlds), 相得益彰 (mutually beneficial)
  • Parallel structure: 一方面...另一方面 (on one hand...on the other hand)
  • Classical phrases: 由此可見 (from this we can see), 綜上所述 (in summary)
  • Balanced, elegant expression
  • Formal literary style with refined vocabulary

Common Writing Patterns

Compare and Contrast

English: Clear comparison markers (similarly, in contrast, whereas, while) Japanese: 一方で (on the other hand), それに対して (in contrast to that) Chinese: 相較之下 (in comparison), 與此相反 (on the contrary)

Cause and Effect

English: Because, therefore, as a result, consequently Japanese: ...ので、...から、その結果、したがって Chinese: 因為...所以、因此、由於、導致

Problem-Solution

English: State problem clearly, propose solution, evaluate effectiveness Japanese: Build context, present challenge, suggest approach indirectly Chinese: Describe situation, analyze causes, propose countermeasures

Argumentation

English: Claim + evidence + reasoning + counterargument + rebuttal Japanese: Present multiple viewpoints, subtle persuasion, indirect conclusion Chinese: Cite authorities, use historical examples, logical progression

品質チェックリスト

文書を仕上げる前に、次の点を確認してください。

内容:

  • 目的と主張が明確である
  • 構成に論理性がある
  • 十分な根拠と裏付けがある
  • 深さと範囲が適切である
  • 導入と結論が効果的である

スタイル:

  • トーンと文体に一貫性がある
  • フォーマルさの度合いが適切である
  • 言語固有の慣習に従っている
  • 明確かつ簡潔に表現されている
  • 読みやすく、興味を引く内容である

技術面:

  • 文法と構文が正しい
  • 句読点が適切である
  • スペルが正確である
  • 文字の使い方が正しい(日本語/中国語)
  • 書式に一貫性がある

言語固有の項目:

  • 英語:主張が明確で、トピックセンテンスが力強い
  • 日本語:適切な起承転結、または構成になっている
  • 中国語:成語やフォーマルな表現が効果的に使われている

ベストプラクティス

  1. 読者を知る:読者の期待に合わせて言語とトーンを調整します
  2. 慣習に従う:文化的な文章作法を尊重します
  3. 明確かつ簡潔にする:不必要に複雑な表現を避けます
  4. 例を使う:具体例は議論を強化します
  5. 一貫性を保つ:トーン、スタイル、書式を統一します
  6. 徹底的に推敲する:良い文章は書き直しによって生まれます
  7. フィードバックを得る:可能であれば、ネイティブスピーカーに確認してもらいます
  8. 幅広く読む:対象言語で書かれた優れた文章から学びます
  9. 定期的に練習する:書く力は練習によって向上します
  10. 文化的規範を尊重する:文化によって期待されることは異なります

リソース

英語の文章作成:

  • ストランクとホワイトの『スタイルの要素』
  • パデュー大学OWL(オンライン・ライティング・ラボ)
  • シカゴ・マニュアル・オブ・スタイル

日本語の文章作成:

  • 日本語文章能力検定の教材
  • さまざまな著者による文章読本
  • 日本の大学が提供する学術論文執筆ガイド

中国語の文章作成:

  • 現代中国語修辞法
  • 実用文の書き方
  • 台湾教育部のスタイルガイド

コメント