french-language

フランス語の表記規則を徹底する

プロジェクト内のすべてのコンテンツが、アクセント記号、文法、組版規則を正しく用いたフランス語で書かれるよう支援します。

このスキルは、ドキュメントに限らず、人が読めるフランス語のテキストを含む生成または編集されたすべてのファイルに適用されます。

使用するタイミング

• プロジェクトの CLAUDE.md またはドキュメントで、フランス語が主要言語として指定されている
• ユーザーがフランス語の文章の作成、レビュー、修正を依頼している
• ユーザーがアクセント記号、正書法、組版、またはフランス語に言及している
• ファイルにアクセント記号の欠落や誤りがあるフランス語のテキストが含まれている
• フランス語に設定されたプロジェクトで、あらゆるファイル（SVG、Mermaid、PlantUML、Draw.io、HTML、CSV、JSON、YAML など）を生成する

事前確認

変更を加える前に、必ず次のことを行います。

1. プロジェクトの言語設定を確認する — プロジェクトの言語が指定されている CLAUDE.md、README、その他の設定ファイルを確認します
2. フランス語のテキストを含むファイルを特定する — Markdown だけでなく、すべてのファイル形式を調べます
3. 一括変更を行う前にユーザーに確認する — 特に、多数のファイルにわたってアクセント記号を修正する場合は確認します

フランス語の表記規則

アクセント記号と特殊文字

フランス語のアクセント記号は必須であり、省略できません。欠落すると単語の意味が変わり、スペルミスとみなされます。

文字	名称	例
é	アキュートアクセント	réalisateur、qualité、équipe、périmètre
è	グレイヴアクセント	stratège、modèle、problème、critère
ê	サーカムフレックス	être、forêt、fête、tête
à	グレイヴアクセント付きの a	à、déjà、voilà
ù	グレイヴアクセント付きの u	où
ô	サーカムフレックス付きの o	contrôle、rôle、clôture、binôme
î	サーカムフレックス付きの i	maître、connaître
ç	セディーユ	ça、français、leçon、reçu
ë、ï、ü	トレマ	Noël、naïf、ambiguïté

アクセント記号の欠落がよくあるパターン

フランス語のテキストをレビューまたは生成する際は、次のような、アクセント記号が頻繁に抜けるパターンに注意します。

誤り	正しい表記	文脈
qualite	qualité	-ité で終わる名詞
securite	sécurité	-ité で終わる名詞
perimetre	périmètre	-ètre で終わる名詞
deploiement	déploiement	dé- が付く名詞
developpeur	développeur	dé- が付く名詞
stratege	stratège	-ège で終わる名詞
modele	modèle	-èle で終わる名詞
cloture	clôture	ô を含む名詞
equipe	équipe	é を含む名詞
role	rôle	ô を含む名詞
etre	être	ê を含む動詞
batisseur	bâtisseur	â を含む名詞
retrospective	rétrospective	é を含む名詞
responsabilites	responsabilités	é を含む複数形の名詞

技術用語

フランスの技術分野で一般的に使われる英語の技術用語は、英語のままにします。

• Sprint、Backlog、Product Owner、Scope、Deadline
• CI/CD、DevOps、LLMOps、API、SDK
• RACI、SOW、ROI、NPS、KPI
• Pull Request、Code Review、Merge Request
• Framework、Pipeline、Prompt Engineering

ルール： フランスの技術文化で英語のまま広く使われている用語は、そのまま使います。 標準的なフランス語訳があり、一般的に使われている場合は、フランス語の表現を優先します。

英語由来の表現と不自然な直訳表現

上記の想定される技術用語とは異なり、英語の単語や表現が、専門用語であることを示さずに動詞化されたり、フランス語に合わせて変形されたりしており、不自然に聞こえる、または別のフランス語の単語がすでに存在するため誤解を招く場合に注意してください。

誤り（明示されていない直訳表現）	問題点	修正案
adresser un problème	「to address an issue」の直訳です。フランス語の「adresser」は、誰かに送る・宛てるという意味です。	traiter, résoudre un problème
supporter un client	「to support」の直訳です。フランス語の「supporter」は、耐える・我慢するという意味で、誤解を招きます。	accompagner, prendre en charge
une opportunité (à saisir)	「opportunity」の直訳です。ありふれた英語由来の表現で、一般的なフランス語の単語のほうが自然です。	une occasion
challenger une idée	英語の「challenge」を「-er」を付けて動詞化した表現です。	remettre en question, contester
définitivement（「間違いなく」の意味）	「definitely」の直訳です。フランス語の「définitivement」は、永久に・最終的にという意味で、誤解を招きます。	vraiment, effectivement

正当な技術用語との見分け方（上記の「技術用語」を参照）： 著者が借用語として意図的に示している用語（イタリック、太字、コード形式、または引用符で示されたもの。例：panes、dashboard、API）は意図的なものであり、ここでは対象外です。通常のフランス語の単語であるかのように、装飾なしで文中に使われている英語由来の表現が、このチェックの対象です。

ルール： 直訳表現が装飾なしで使われており、（a）自然なフランス語に聞こえない、または（b）既存のフランス語の単語と意味が衝突する場合は、フランス語の代替表現を提案してください。著者が英語由来の表現を残したい場合は、装飾なしで使うのではなく、専門用語として示す（イタリック体または引用符を使う）ことを提案してください。

フランス語の組版

フランス語の組版には、英語とはいくつかの違いがあります。

ルール	例
: ; ! ? の前にはスペースを入れる	Attention : ceci est important
, . の前にはスペースを入れない	Bonjour, comment allez-vous.
引用符にはギユメを使う	« texte »（改行しないスペースを含む）
序数	1er、2e、3e（1ème、2ème ではありません）
大文字の使用	英語より大文字を使う頻度を抑えます — Modèle Opératoire ではなく Modèle opératoire
全角ダッシュ（—）	フランス語の標準的な句読点ではありません。文脈に応じて :、(…)、または . に置き換えます

全角ダッシュと英語の違い： 全角ダッシュは英語では一般的に使われ、正当な表記です。 英語のコンテンツから全角ダッシュを削除しないでください。このルールはフランス語のテキストにのみ適用してください。

生成ファイルについて： スペースの挿入やギユメの使用などの組版ルールは、すべてのファイル形式で実用的とは限りません。いずれの場合もアクセント記号を正しく使用することを優先してください。表示を損なわず、形式が対応している場合は組版ルールを適用してください。

手順

ステップ 1：レビュー対象のコンテンツを特定する

プロジェクトをスキャンし、フランス語のテキストを含むすべてのファイルを確認します。

• ドキュメント： *.md ファイル
• 図表とビジュアル： *.svg、*.drawio、*.puml、*.mmd（Mermaid）
• Web コンテンツ： *.html、*.htm、*.vue、*.jsx、*.tsx
• データファイル： *.csv、*.json、*.yaml、*.yml、*.toml
• プレゼンテーション： *.tex、*.adoc、*.rst
• 設定： CLAUDE.md、README.md、*.properties、*.ini
• コード： ソースファイル内のコメントと文字列リテラル

ステップ 2：分析して報告する

各ファイルについて、以下を特定します。

• アクセント記号の欠落または誤り
• 文法上の問題
• タイポグラフィ上の問題（コロンの前のスペースなど）
• 言語の不統一（技術的な文脈以外でフランス語と英語が混在している）
• 明示されていない英語由来の表現や不自然な直訳（英語の動詞化、誤訳など）— 上記の「英語由来の表現と不自然な直訳」を参照してください。斜体、太字、コード、 引用符で囲まれている、すでに想定された専門用語は対象外とします。

調査結果を次の表にまとめます。

| File | Issue | Wrong | Correct |
|------|-------|-------|---------|
| docs/roles.md | Missing accent | qualite | qualité |
| diagram.svg | Missing accent | deploiement | déploiement |
| data.csv | Missing accent | responsabilite | responsabilité |
| article.md | Unmarked anglicism | adresser un problème | traiter un problème |

ステップ 3：修正を適用する

ユーザーの承認後：

1. 各ファイル内の修正パターンごとに、replace_all=true を指定して Edit を使用します
2. 各ファイル形式について、以下の形式固有のガイドラインに従います
3. 修正後にリグレッションがないことを確認します

ステップ 4：検証する

修正の適用後：

1. よくあるアクセント記号の欠落パターンが残っていないか検索します
2. すべてのファイルで一貫性が保たれていることを確認します
3. 判断に迷う用語を報告し、ユーザーに確認します

形式固有のガイドライン

SVG ファイル

• <text> 要素内のテキストコンテンツのみを変更します。座標、 スタイル、構造には手を加えないでください
• テキストが収まることを確認します。アクセント付き文字は幅がわずかに広くなる場合があります。 テキストがコンテナー内に収まることを確認してください
• UTF-8 文字を使用します。XML エンティティ（é）ではなく、文字（é）を使用してください
• リンターによる再フォーマットに注意します。SVG オプティマイザー（SVGO）は編集後に ファイルを再フォーマットすることがあります。これは想定された動作であり、元に戻す必要はありません

Mermaid 図（.mmd、Markdown に埋め込み）

• ノードラベルではアクセント記号をそのまま使用できます：A[Qualité] --> B[Sécurité]
• 特殊文字を含むラベルは、引用符で囲みます：A["Clôture du projet"]
• アクセント記号を追加した後はレンダリングをテストしてください。一部の Mermaid レンダラーでは、 エッジラベル内の特定の文字に問題が生じる場合があります

PlantUML ファイル（.puml）

• ラベルとノートではアクセント記号を使用できます：:Vérification du périmètre;
• UTF-8 エンコーディングを使用し、BOM なしで @startuml を追加します
• 参加者名にアクセント記号が含まれる場合、引用符で囲む必要があります： participant "Développeur GenAI" as Dev

Draw.io / diagrams.net ファイル（.drawio）

• XML ファイルのため、value 属性ではアクセント記号をそのまま使用できます
• XML を直接編集するか、ビジュアルエディターを使用します
• UTF-8 文字にするべき箇所が HTML エンティティにエンコードされていないか確認します

CSV ファイル

• UTF-8 エンコーディング（Latin-1/ISO-8859-1 ではなく）を使用します
• フィールド値にはアクセント記号を使用します："Qualité","Sécurité","Périmètre"
• 一部の表計算ツールではエンコーディングが変換されることがあります。エクスポート後にエンコーディングを確認してください

JSON / YAML ファイル

• 文字列値ではアクセント記号をそのまま使用できます："rôle": "Développeur"
• JSON の仕様では UTF-8 が必須です
• YAML は UTF-8 を標準でサポートしているため、アクセント付きの値を引用符で囲む必要はありません

HTML ファイル

• UTF-8 エンコーディングを使用します：<meta charset="UTF-8">
• HTML エンティティ（é）ではなく、UTF-8 文字（é）を使用します
• <title>、<meta>、alt 属性、aria-label、表示テキストを確認します

新しいファイルの生成

フランス語のテキストを含む新しいファイルを生成する場合：

1. 最初からアクセント記号を付けて書きます。 アクセント記号なしで生成してから 後で修正しないでください
2. すべてのファイル形式で UTF-8 エンコーディングを使用します
3. 書く際に正しいアクセント記号を付けます。 上記の一般的なパターン表を参照してください
4. 技術用語は英語のままにします。 広く使われている英語の用語は翻訳しないでください
5. 提示する前に検証します。 ユーザーに見せる前に、生成した内容を読み直し、 アクセント記号の欠落がないことを確認してください

重要なガイドライン

• アクセント記号を絶対に削除しないでください — 単語にアクセント記号が必要かどうかわからない場合は、そのまま残してください
• 技術用語は英語のままにしてください — Sprint、Backlog などは翻訳しないでください
• 一括変更の前に確認してください — 修正を適用する前に、修正箇所の一覧を提示してください
• 一度に一つのパターンを変更してください — 意図しない置換を避けるため、replace_all を使う場合は、編集ごとに単語のパターンを一つずつ修正してください ください
• 文脈が重要です — 単語によってはアクセント記号の有無で意味が変わります （例：「ou」＝「または」、「où」＝「どこ」）。必ず文脈を考慮してください
• 常に UTF-8 を使用してください — 必ず UTF-8 エンコーディングを使用し、Latin-1 などの旧式のエンコーディングは使用しないでください
• 最初から正しく生成してください — 後から修正するより、最初にアクセント記号を正しく入力するほうが効率的です