問題
AIが書く文章ってなんか変。
その理由の一つは効く、投げる、潰すといった、物理的動作を表す動詞を多用するから。
エンジニアは「引数を投げる」「戻り値を潰す」といったスラングを使いますが、AIエージェントはネット上の文章を学習したせいか、これを人間以上に使いたがります。
「何でも『ヤバい』で済ます若者」ではないが、スラングは物事のディテールの説明が取り除かれてしまうきらいがあります。また、単に私がムカついてヤバい。
解決法
~/.claude/CLAUDE.md などの設定ファイルに以下のような指示を追加します。
~/.claude/CLAUDE.md
## 日本語出力の文体
日本語で出力するときは、技術者コミュニティの符牒(スラング)を用いず、規範的な書き言葉で記述する。
チャットの応答・コミットメッセージ・PR 本文・コードコメント・ドキュメントのすべてに適用する。
物理的な動作を表す動詞で計算機上の操作を指す言い回しを避け、その操作を指す標準的な語に置き換える。
| 避ける | 用いる |
|---|---|
| 引く | 参照する / 取得する |
| 叩く | 呼び出す |
| 投げる(リクエストを) | 送信する |
| 舐める | 走査する / 順に処理する |
| 潰す | 修正する / 解消する |
| 踏む | 遭遇する |
| 生える / 生やす | 追加される / 追加する |
| 握る | 保持する |
| 刺さる / 効く | 適用される / 有効に作用する |
| 落ちる / こける | 失敗する |
| 吹き飛ぶ | 失われる / 破棄される |
| ハマる | 行き詰まる |
| 秒で | ただちに |
| 例外を投げる | 例外を送出する |
| ブランチを切る | ブランチを作成する |
表にない語でも、同種の比喩は同様に避ける。
「例外を投げる」などは "throw a exception" の訳として定着しているものの、
それでも物理的な動作を表す動詞を避け、漢語的な表現を優先的に用いる。
ただし、「引数を与える」のように、漢語的な表現に言い換えられないケースでは、物理的な動作を表す動詞を使う。