メニュー
日本語で文章を書く・編集する・レビューする・返信する際に参照する。英語（特にスラング・口語・技術用語）の直訳による不自然な日本語、体言止めの乱用、「〜どうぞ」「〜まで。」などの訳語調を検出し、自然な日本語に直す。コミットメッセージ、PR 説明、ドキュメント、UI 文言、ユーザーへの日本語応答を含む。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
ユーザーの暗黙知を対話で引き出すとき（傾聴、インタビュー、曖昧な回答の具体化、過去の意思決定の掘り下げ、前提への挑戦、矛盾の統合、動機の引き出し、思考の精緻化）に参照する。Rogers 傾聴・DICE プロービング・CDM・悪魔の代弁者・弁証法的探究・動機づけ面接 OARS・ナラティブ引き出し・ソクラテス式質問の 8 技法を統合し、場面に応じた選択ガイドと共通ルールを定義する。
パッチバグフィクス以外の実装作業を行うときに必ず参照する。Issue 起票、専用ブランチ作成、実装、PR 作成、同期状態確認、ahead/behind がない場合のみマージする標準フローを定義する。巨大モノレポ、複数会社・複数人で同時実装する状況、機能追加、仕様変更、リファクタリング、設計変更、依存関係変更、DB/API/UI/アーキテクチャ変更で使用する。
既存スキルに従って作業しても期待通り進まないとき、Web 検索などで異なる情報・より新しい情報が得られたとき、スキルの条件分岐を厳守するとスタックや実装の自由度が制限され最良の結果が得られないと判断したときに参照する。`.agents/skills/<name>/SKILL.md` をローカルで改変する手順、および改変内容が有用と判断した場合に `philtzjp/skills` リポジトリへ変更提案 Issue を起票する手順とテンプレートを定義する。
新規パッケージの追加、`turbo.json` / `pnpm-workspace.yaml` / `tsconfig` の編集、`apps/` や `packages/` の構成変更、責務パッケージ（`log` / `error` / `prompt` / `env` / `db`）の配置・参照を行うときに参照する。Turborepo + pnpm のベストプラクティス、`workspace:*` プロトコル、JIT コンパイル方針を定義する。
コミット、プッシュ、ブランチ作成/切り替え/削除、マージ、リベース、`gh pr merge` による PR マージなどあらゆる Git / GitHub 操作を行うときに参照する。コミットメッセージのフォーマット (`type(scope): 説明`)、マージコミット件名 (`merge(scope): 説明`) の `--subject` / `--body ""` 指定、`--author` の扱い、`git fetch --prune` などの安全チェック、マージコミット件名・本文への PR/Issue 番号 (`#N`) 禁止、`Co-Authored-By` 禁止、`git add .` 禁止などを定義する。
API エンドポイントの設計・実装・変更を行うとき（OpenAPI スキーマ、ヘルスチェック、ルーティング、認証方式の追加など）に参照する。OpenAPI 準拠、RFC 9457 エラー、パスバージョニング、認証（ネットワーク公開 API は Bearer、loopback サービスは Origin 検証で代替可）、Spectral リント、単一 HTTP フレームワーク（Hono / Nitro 等から選定）への統一を定義する。
| name | japanese-writing |
| description | 日本語で文章を書く・編集する・レビューする・返信する際に参照する。英語（特にスラング・口語・技術用語）の直訳による不自然な日本語、体言止めの乱用、「〜どうぞ」「〜まで。」などの訳語調を検出し、自然な日本語に直す。コミットメッセージ、PR 説明、ドキュメント、UI 文言、ユーザーへの日本語応答を含む。 |
英語由来の不自然な日本語を、文脈に合った自然な表現へ置き換える。
| 不自然（直訳調） | 自然な日本語の例 |
|---|---|
| 変更を寄せる / PR を寄せる | 変更を取り込む / PR をマージする |
| 機能を落とす / サポートを落とす | 機能を削除する / サポートを終了する |
| バグを倒す / 課題を倒す | バグを修正する / 課題を解消する |
| 確認どうぞ。 / ご確認どうぞ。 | ご確認ください。 / 確認をお願いします。 |
| リリースまで。 / 対応まで。 | リリース予定です。 / 対応中です。 |
| 対応。 / 修正。 / 確認。 | 対応しました。 / 修正します。 / 確認してください。 |
| 〜しきる / 〜やりきる / 〜書ききる | 〜し終える / 〜を完了する / 〜を書き上げる |
| 〜していきます（乱用） | 〜します / 順次〜します |
| 〜することができます | 〜できます（冗長なら削る） |
| 〜についてお知らせします | 〜をお知らせします |
| 問題なく動作します | 正常に動作します |
| 〜を実施する（乱用） | 〜する / 〜を行う（文脈で選ぶ） |
| ご不明点がございましたら | 不明点があれば（トーンに応じて調整） |
❌ 認証エラーの修正。
✅ 認証エラーを修正しました。
❌ 次のステップはデプロイまで。
✅ 次はデプロイです。 / 次のステップはデプロイです。
❌ 詳細はドキュメント参照。
✅ 詳細はドキュメントを参照してください。
日本語を出力する直前に、次を確認する。
| 場面 | 推奨 |
|---|---|
| ユーザーへの説明・報告 | です・ます調。簡潔だが述語のある文 |
| コミットメッセージ | 常体可。「〜した」「〜を修正」など動詞で締める |
| UI ラベル・ボタン | 短くてよいが、動詞形または明確な名詞句 |
| 技術ドキュメント | です・ます調。体言止めは見出しのみ |
パターンが増えた場合や判断に迷う場合は、同梱のリファレンスを読む。
references/calque-patterns.md — 英語→直訳調→自然語の対照表references/examples.md — 場面別の before / after 例