japanese-writing

name	japanese-writing
description	日本語で文章を書く・編集する・レビューする・返信する際に参照する。英語（特にスラング・口語・技術用語）の直訳による不自然な日本語、体言止めの乱用、「〜どうぞ」「〜まで。」などの訳語調を検出し、自然な日本語に直す。コミットメッセージ、PR 説明、ドキュメント、UI 文言、ユーザーへの日本語応答を含む。

日本語ライティング（直訳回避）

英語由来の不自然な日本語を、文脈に合った自然な表現へ置き換える。

発火タイミング

1. ユーザーが日本語での応答・文章作成を求めている
2. 日本語のコミットメッセージ、PR 説明、ドキュメント、UI 文言を書く・直す
3. 既存の日本語テキストをレビュー・校正する
4. 会話が日本語で進行している

基本方針

1. MUST: 英語の形を日本語に当てはめず、意味と意図を取って日本語として自然な言い回しに組み直す
2. MUST: 本文・説明文・会話文では述語のある文を使う; NEVER: 「対応。」「修正。」「確認。」のような体言止め（名詞＋句点）で文を完結させない
3. MUST: 依頼・案内は文脈に応じて「〜してください」「〜をお願いします」「〜できます」などに分ける; NEVER: 「〜どうぞ。」で依頼文を終える
4. MUST: 「〜まで」は副詞句として使い、述語を補う; NEVER: 「リリースまで。」「対応まで。」のように「〜まで。」だけで文を切る
5. MUST: 英語の phrasal verb（〜up, 〜out, 〜down）の直訳になりやすい「〜きる」接尾語を安易に使わない
6. MUST: land / drop / knock down / ship などの技術スラングを直訳しない; 文脈に応じてマージする、削除する、解消する、リリースする等に置き換える

高頻度パターン（即修正）

不自然（直訳調）	自然な日本語の例
変更を寄せる / PR を寄せる	変更を取り込む / PR をマージする
機能を落とす / サポートを落とす	機能を削除する / サポートを終了する
バグを倒す / 課題を倒す	バグを修正する / 課題を解消する
確認どうぞ。 / ご確認どうぞ。	ご確認ください。 / 確認をお願いします。
リリースまで。 / 対応まで。	リリース予定です。 / 対応中です。
対応。 / 修正。 / 確認。	対応しました。 / 修正します。 / 確認してください。
〜しきる / 〜やりきる / 〜書ききる	〜し終える / 〜を完了する / 〜を書き上げる
〜していきます（乱用）	〜します / 順次〜します
〜することができます	〜できます（冗長なら削る）
〜についてお知らせします	〜をお知らせします
問題なく動作します	正常に動作します
〜を実施する（乱用）	〜する / 〜を行う（文脈で選ぶ）
ご不明点がございましたら	不明点があれば（トーンに応じて調整）

体言止め

1. MAY: 見出し・ラベル・極めて短い箇条書き・UI ステータスラベル（「対応中」「未対応」）で体言止めを使う
2. NEVER: 本文・説明文・会話文で体言止めを使う

❌ 認証エラーの修正。
✅ 認証エラーを修正しました。

❌ 次のステップはデプロイまで。
✅ 次はデプロイです。 / 次のステップはデプロイです。

❌ 詳細はドキュメント参照。
✅ 詳細はドキュメントを参照してください。

出力前チェックリスト

日本語を出力する直前に、次を確認する。

1. 体言止め（名詞＋「。」）が本文に残っていないか
2. 「〜どうぞ」「〜まで。」で文が終わっていないか
3. 「寄せる」「落とす」「倒す」が英語スラングの直訳になっていないか
4. 「〜きる」が過剰・不自然でないか
5. 一文が長すぎないか（必要なら分割）
6. 敬体（です・ます）と常体の混在が意図的か

トーンの指針

場面	推奨
ユーザーへの説明・報告	です・ます調。簡潔だが述語のある文
コミットメッセージ	常体可。「〜した」「〜を修正」など動詞で締める
UI ラベル・ボタン	短くてよいが、動詞形または明確な名詞句
技術ドキュメント	です・ます調。体言止めは見出しのみ

詳細リファレンス

パターンが増えた場合や判断に迷う場合は、同梱のリファレンスを読む。

1. references/calque-patterns.md — 英語→直訳調→自然語の対照表
2. references/examples.md — 場面別の before / after 例