--- name: japanese-technical-writing description: | 文章の品質を大幅に向上させるテクニカルライティングルール集。冗長表現の排除、文末繰り返しの回避、漢字/ひらがなの正しい使い分け、能動態の活用、主語述語の近接配置など、プロフェッショナルなライティング品質を実現する。 テキストを出力・生成するすべてのタスクで必ず参照すること。PR説明文の作成、技術ドキュメント・設計書・仕様書・手順書の執筆、README/CLAUDE.md/Confluenceページの追記更新、コミットメッセージの生成、調査結果や仕様のまとめ、マークダウン出力、既存文章の改善・レビューなどが対象。 「書いて」「作って」「作成して」「まとめて」「追記して」「出力して」「改善して」「レビューして」「ドキュメント化して」「PR作って」「マークダウンで出力して」など、テキスト出力を伴うリクエスト全般でトリガーする。短い指示や暗黙的な文章生成タスクでもこのスキルを参照すること。スキル名の明示的な言及は不要。 --- # 日本語テクニカルライティングガイド 日本語で分かりやすいドキュメントを書くためのルール集。 以下のルールに従い、明確・簡潔・正確な日本語文章を生成する。 ## 出力前の必須チェック 文章を出力する前に、以下の3点を必ず確認する。これらは最も頻繁に違反されるルールである。 ### 1. 「〜を行う」を使っていないか 「〜を行う」は冗長表現の代表例であり、ほぼ全ての場合に短縮できる。出力に含まれていたら必ず書き換える。 | 冗長 | 簡潔 | |--------|-------| | 判定を行う | 判定する | | 処理を行う | 処理する | | 検証を行う | 検証する | | ソートを行う | ソートする | | 制御を行う | 制御する | | 付与を行う | 付与する | ### 2. 同じ文末が3回以上連続していないか 特にだである調で「〜する」「〜である」が連続しやすい。以下の代替表現を活用して変化をつける。 **だである調の文末バリエーション:** | パターン | 例 | |---------|-------------| | 〜する | ソート順を決定する | | 〜である | この値は定数である | | 〜となる | 配信対象となる | | 〜になる | 無効になる | | 〜を返す | true を返す | | 〜に該当する | この条件に該当する | | 〜が必要である | 検証が必要である | | 〜に限る | 公開期間中に限る | | 〜を意味する | リスト型号外を意味する | | 体言止め | 以下のとおり | **番号付き手順リストでの注意:** 手順リストは「〜する」で終わりがちだが、3回以上連続させてはならない。以下のように書き換える。 悪い例: 1. 対象のIDを取得する 2. ユーザーの所属を確認する 3. インプレッションを付与する 良い例: 1. 対象のIDを取得する 2. ユーザーの所属を確認する 3. 未付与のContentUserGroupにインプレッションを記録する（「記録する」「返す」「設定する」など別の動詞に変える） 別の良い例（体言止めを混ぜる）: 1. 対象IDの取得 2. ユーザー所属の確認 3. インプレッションの付与 ### 3. 形式名詞が漢字になっていないか - 〜する事 → 〜すること - 〜の為 → 〜のため - 〜する物 → 〜するもの - その時 → そのとき - 〜して下さい → 〜してください --- ## 基本原則 1. **簡潔に書く**: 無駄な表現を省き、短く明確に伝える 2. **能動態を使う**: 原則として能動態で書き、文章に力強さと明確さを持たせる 3. **文体を統一する**: ですます調/である調を混ぜない。文末表現の繰り返しを避ける 4. **主語と述語を近くに置く**: 主語と述語の間に余計な語句を入れすぎない 5. **やさしい言葉を使う**: 難しい漢字、専門用語、カタカナ用語を避ける --- ## 1. 簡潔さ 冗漫な表現を避け、できるだけ短く表現する。 ### 同語反復を避ける 同じ意味の言葉を繰り返さない。 - 20秒の期間 → 20秒 - あらかじめ予測する → 予測する - 未だ未解決 → 未解決 ### 動詞の名詞化を避ける 動詞を無理に名詞に変えない。 - 行動をする → 行う - 可能です → できます - 集客支援を行う → 集客を支援する - 充填する → うめる - 陳述する → のべる ### 不要な語句を省く なくても意味が通じる語句は省く。 - 初回のケースに関しましては → 初回のケースは - 「〜について」「〜という」は多くの場合削除できる ### 曖昧な表現を避ける 文末や文章中の曖昧さを排除し、具体的に書く。 - タイトルの修正が効果的だと思われます → タイトルの修正が効果的です - 少し長い → 5cmほど長い ### 不要な強調語を削除する - 極めてユニークな → ユニークな - 非常に重要な → 重要な ### もったいぶった言い回しを避ける - 「次のことが言えるといえるだろう」→ 削除 - 「どうなのでしょうか。それでは詳しく見てみましょう」→ 削除 --- ## 2. 文体 ### 文末表現を統一する 「ですます調（敬体）」か「だである調（常態）」のいずれかに統一する。同じ文章中で混ぜない。 ### 文末表現の繰り返しを避ける 同じ文末が3回以上続かないようにする。バリエーションを使う。 - 〜です / 〜ます / 〜でした / 〜ました - 〜ません / 〜でしょう - 〜ください / 〜してください - 体言止め（名詞で終える） ### 話し言葉を書き言葉にする | 話し言葉 | 書き言葉 | |------|-------| | いっぱい | 多い | | ちょっと | 少し | | とても | 非常に | | そういう | そのような | | もっと | さらに | | やっぱり | やはり | | けど | が | | ですから | そのため | | たぶん | おそらく | | 一番 | 最も | | いつも | 常に | | ちゃんと | きちんと | ### 文語体を口語体にする | 文語体 | 口語体 | |-------|-------| | のみならず | だけでなく | | においては | では | | すべく | するため | | できぬ | できない | --- ## 3. 文構造 ### 主語と述語を近くに置く 主語と述語の距離が遠いと読みにくくなる。長い場合は文を分割する。 **悪い例:** 弊社は、ユーザー様がご満足される視聴者向けマーケティング施策を、弊社サービス会員や関係者に、弊社の商品の根強いファンになっていただくことを期待し展開しております。 **良い例:** 弊社は、さまざまな視聴者向けマーケティング施策を展開しております。その目的は、弊社サービス会員や関係者にご満足いただき、弊社商品の根強いファンになっていただくことです。 ### 能動態を原則にする 能動態は明確で説得力がある。受動態は以下の場合にだけ使う。 - 動作主が重要でない場合（例: その行為は犯罪と考えられる） - 動作を受ける対象を強調したい場合 - 文体をあえて弱めたい場合 - 能動態が連続して単調になる場合 ### 修飾語を被修飾語の近くに置く - 素早い花の先に止まったテントウ虫 → 花の先に止まった素早いテントウ虫 ### 主語を統一する 連続する文では、文脈上の主語と文法上の主語を一致させる。 --- ## 4. 語の選び方 ### やさしい言葉を使う 難しい漢語や一般化していないカタカナ用語を避ける。 - 措置 → 処置・取扱い - コンセンサス → 合意 - フィジビリ → 実験 - RFP → 提案依頼書（初出時に説明を添える） ### 不要な省略を避ける - MTG → ミーティング - MGR → マネージャー ただし、チーム内で定着した略語はそのまま使ってよい。 ### 独自の複合名詞を避ける - 時間短縮料理術 → 時間が短縮できる料理術 ### 代名詞・指示語の曖昧さを避ける 「それ」「これ」などの指示語が何を指すか曖昧な場合は、名詞を再び記載するか、「そのカード」のように名詞を補足する。 --- ## 5. 漢字・ひらがなの使い分け ### ひらがなで書く語（ひらく） 本来の意味を失った語や補助的な語はひらがなで書く。 **形式名詞:** - 見た所 → 見たところ（場所の意味でなければひらく） - その時 → そのとき（時間の意味でなければひらく） - 〜する事 → 〜すること - 〜する為 → 〜するため - 〜する物 → 〜するもの（物体の意味でなければひらく） **補助動詞:** - 調べて見る → 調べてみる（視覚の意味でなければひらく） - 行って来る → 行ってくる - 行きたく無い → 行きたくない - 〜して欲しい → 〜してほしい - 〜して下さい → 〜してください **接続詞:** - ただし、または、および、かつ、また、さらに **連体詞・代名詞:** - この、その、わが、あらゆる - あなた、われわれ、ここ、そこ ### 漢字で書く語（とじる） 固有名詞、専門用語はそのまま漢字で書く。常用漢字の範囲で使用する。 --- ## 6. 約物（記号）の基本ルール ### 句読点 - 句点（。）は文の終わりに打つ - 読点（、）は誤読を避けるために打つ（打ちすぎない） ### 三点リーダー - ・・・ → ……（三点リーダーを2つ並べる） ### 疑問符・感嘆符 - 疑問符（？）の後に全角スペースを入れる - 感嘆符（！）は公式文章では原則使用しない ### 数値 - 横書きでは半角アラビア数字を使う - 訓読み（一つ、二つ）、順序（一番目）、副詞（第一に）は漢字 ### 丸括弧 - 全角括弧を基本とする - 使いすぎに注意し、本文に入れ込めないか検討する ### 波ダッシュ（〜） - 範囲を表す場合に使う（例: 1〜3日） - 数値と数値、名詞と名詞をつなぐ（「当日〜3日」は不可、「1〜3日」が正しい） --- ## 7. その他の重要ルール ### 並列表現 - 同じ文法構成を繰り返す - 「たり」は2つ目を省略しない - 楽しんだり、没頭するのがよい → 楽しんだり、没頭したりするのがよい - 箇条書きでは文法的に同じ構造のものを並べる ### 助詞の使い方 - 起点の「より」は「から」に言い換える - 東京より参りました → 東京から参りました - 推量の「う」は「だろう」に言い換える - 言えよう → 言えるだろう - 並列の「と」は比較対象が曖昧になる場合に省略しない ### 副詞の係り受け 副詞と文末のペアを正しく使う。 | 副詞 | 文末 | |------|--------------| | なぜなら | 〜からだ | | もし | 〜たら | | 決して | 〜ない | | おそらく | 〜だろう | | たとえ | 〜ても | | ぜひ | 〜ほしい / 〜ください | | まるで | 〜ようだ | ### 比較構文 - 何と何を比較しているか明確にする - 比較の対象を省略しない --- ## 詳細リファレンス より詳しいルールや例文が必要な場合は `docs/` ディレクトリを参照する。 | ファイル | 内容 | |---------------------------------------------------------|--------------------| | [nouns.md](docs/nouns.md) | 名詞の使い方の詳細と例 | | [pronouns.md](docs/pronouns.md) | 代名詞・指示語の曖昧さ回避 | | [adjectives.md](docs/adjectives.md) | 形容詞・形容動詞の修飾語配置 | | [adverbs.md](docs/adverbs.md) | 副詞の係り受け（呼応表現）全パターン | | [particles.md](docs/particles.md) | 助詞・助動詞の使い分け | | [conciseness.md](docs/conciseness.md) | 簡潔に書く方法の詳細 | | [subject-predicate.md](docs/subject-predicate.md) | 主語と述語の関係 | | [active-passive-voice.md](docs/active-passive-voice.md) | 能動態・受動態の使い分け | | [parallel-structure.md](docs/parallel-structure.md) | 並列表現の使い方 | | [comparison.md](docs/comparison.md) | 比較構文の書き方 | | [emphasis-marks.md](docs/emphasis-marks.md) | 強調記号の使い方 | | [writing-style.md](docs/writing-style.md) | 文体のルール | | [punctuation.md](docs/punctuation.md) | 約物の12のルール | | [kanji-hiragana.md](docs/kanji-hiragana.md) | 漢字・ひらがなの使い分け | | [citation.md](docs/citation.md) | 引用の書き方 |