writing-guide

汎用執筆ガイド — AI臭さを消す文章術

技術ブログ、社内資料、手順書、スライド、書籍など、あらゆる書き物に共通する文章スタイルルール。 各プロジェクト固有ルール（CLAUDE.md等）と併用して使う。

このスキルの使い方

執筆作業時の「品質チェックリスト」として使う。

1. 執筆前: このルールを頭に入れてから書き始める
2. 執筆中: AI臭い表現が出てきたら即座に書き直す
3. 執筆後: 完成した文章を禁止リストと照合してセルフレビュー

**「提案段階のドラフト」も執筆として扱う。**本文候補の1段落・見出し案・キャッチコピー案をユーザーへ提示する時点で、すでに禁止リストの検品対象。承認後・反映時に直せばよいと後回しにすると、初稿の型（逆接タメ・「のです」締め・比喩スローガン締め等）がそのまま指摘対象になる。

**200〜300字の短い対外文こそ検品対象。**登壇のセッション概要、イベントページの掲載文、プロフィール紹介文、書籍の内容紹介など、外部に載る短い紹介文は「原稿ではないから」「短いから」と素通りしやすい。しかし短い文ほど最後の一文が目立つので、キメ台詞構文（「〜のは◯◯です」）が締めに紛れ込む確率はむしろ高い。書く前にこのスキルを開き、書いたあとに最頻出パターン6つと照合してから提示する。

　直し方は言い換えではなく削除。この種の締めは、直前の文で内容が完結しているところへ教訓を足しているだけなので、平明な言い方へ置き換えても蛇足のまま残る。

何度も再発している最頻出パターン（書き終えたら、まずこの9つを見る）

下の禁止リストは長いので、再発指摘を受けた回数が多いものだけをここへ抜き出す。書いた直後にこの9つだけは必ず自分で見返す。全部が下の表にも載っているが、表の中に埋もれると素通りしてしまう。

1. 段落末の回収まとめ文（「これが◯◯の形です」「〜という方針は、こうして形にできます」「〜と考えると整理しやすくなります」「◯◯そのものです」）。**記録上いちばん再発している型で、しかも既存原稿より自分が新しく書く文で出る。**説明が済んだ直後に抽象ラベルへ包み直す一文を足さない。言い終えたらそのまま終える

2. 「効く」の全用法（効く／効きます／効いてきます／効かせる）

3. ダッシュ（—、──、―、- での区切り）

4. 体言止めの列挙を「。」で締める（「〜する会議のメモ。」）→ 「〜など。」で終わらせる

5. こなれ比喩動詞でのキメ（届かない／拾ってくれます／地続き／一撃で／仕込みます）

6. 一段落が長いまま改行しない（とくにMEMO・コラムなど囲みの中）

7. AIの挙動を断定する（「〜されます」と一通りに言い切る。実際は複数のやり方がありうる）

8. 箇条書きの行頭を「太字ラベル＋コロン」で始める（「- 見た目を自分で決められる：HTMLの体裁は〜」）。§1 の「項目名: 説明のセット形式」と「太字の多用」が同時に出る型で、説明文をREADME・報告・資料へ書くときにほぼ毎回出る。直し方は言い換えではなく箇条書きごと地の文の段落へ戻す（ラベルを外して並べ直すだけだと、今度は同じ構文の箇条書きが残る）。2つ3つの項目を立てたくなったら、それは段落1つで書ける内容だと考える

   ⚠️ ただし「箇条書きを使うな」ではない。禁じているのは行頭太字＋コロンという形であって、箇条書きそのものではない。 このルールを丸ごと適用して地の文だけで押し通すと、条件の列挙まで段落へ溶けて逆に読めなくなる。地の文へ戻すのは「1段落で書ける内容を2〜3項目に割ったとき」だけで、並列に並ぶ条件・対象・例外が4つ以上あるなら箇条書きが正しい。判断基準は §6 の「GitHubのREADME」節にある形の選び方の表を使う

9. 成果物への絵文字の散布。見出しの頭（## 🚀 アプリ）、箇条書きやカードのアイコン代わり（📊 パワポ作るマン）が二大パターン。**1個ずつ見ると可愛いが、並ぶと一気にAIが書いた資料になる。**装飾として足したくなった箇所は、何も足さないのが正解。チャットの応対に絵文字を混ぜるのは別ルール（~/.claude/AGENTS.md 冒頭）なので混同しない

※ ただしそのプロジェクトで承認済みの正式概念語は対象外。例：ある書籍で「ガードレール」を節見出しに採用しているなら、その本の中では禁止語ではなく用語として扱う。禁止語の一括 grep を機械実行しないのはこのため（誤検出が多すぎて使われなくなる）。