关于 french-language
french-language 是用于规范项目内容及生成文件中法语表达的技能。它指导开发者检查语言设置、重音符号和排版,先汇报问题,并在获批后应用修改。
主要功能
- 01检查项目语言配置
- 02扫描多种文件中的法语文本
- 03检查重音符号与语法
- 04遵循法语排版规范
- 05批量修改前汇报问题
- 06校验生成的法语内容
适用场景
- 01审查法语项目文档
- 02检查生成文件中的法语文本
- 03查找项目文件中遗漏的重音符号
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ rlespinasse/ agent-skills --skill french-language安装后在 Claude Code 中输入/french-language确认已加载。
附带文件evals/evals.json
详细介绍
遵循法语语言规范
你正在帮助用户确保项目中的所有内容都使用规范的法语书写,正确使用重音符号、语法和排版规范。
这项技能适用于所有包含法语可读文本的生成或编辑文件,而不只是文档。
何时使用
- 项目的 CLAUDE.md 或文档指定法语为主要语言
- 用户要求撰写、审核或修正法语内容
- 用户提到重音符号、拼写、排版或法语语言
- 文件中的法语文本缺少或错误使用重音符号
- 在配置为法语的项目中生成任何文件(SVG、Mermaid、PlantUML、Draw.io、HTML、CSV、JSON、YAML 等)
预检
进行更改前,务必:
- 检查项目的语言配置——查找 CLAUDE.md、README 或其他指定项目语言的配置文件
- 确认哪些文件包含法语文本——扫描所有文件类型,而不只是 Markdown
- 批量更改前先询问用户——尤其是在需要修正多个文件中的重音符号时
法语书写规则
重音符号和特殊字符
法语重音符号必须正确使用,不可省略。缺少重音符号会改变词义,也属于拼写错误。
| 字符 | 名称 | 示例 |
|---|---|---|
| é | 尖音符 | 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) - 网页内容:
*.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 步:应用修正
获得用户批准后:
- 对每种修正模式,在每个文件中使用
Edit,并设置replace_all=true - 对每种文件格式,遵循下方对应的指南
- 验证修正后没有引入回归问题
第 4 步:验证
应用修正后:
- 搜索是否仍有常见的重音符号遗漏模式
- 确认所有文件的内容一致
- 报告不确定的术语(请用户提供指导)
特定格式指南
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 编码——添加
@startuml时不要带 BOM - 参与者名称中的重音可能需要加引号:
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"> - 使用实际的 UTF-8 字符,而非 HTML 实体(使用
é,而非é) - 检查
<title>、<meta>、alt属性、aria-label和可见文本
生成新文件
生成任何包含法语文本的新文件时:
- 从一开始就正确使用重音符号——不要先生成不带重音的内容, 再事后修正
- 所有文件类型均使用 UTF-8 编码
- 编写时正确使用重音符号——请参考上文的常见模式表
- 技术术语保留英文——不要翻译普遍使用的英文术语
- 提交前验证——向用户展示前重新阅读生成的内容,检查是否有 重音符号遗漏
重要准则
- 绝不要删除重音符号——如果不确定某个单词是否需要重音符号,请保留
- 保留英文技术术语——不要翻译 Sprint、Backlog 等
- 批量修改前先询问——应用修正前,先列出要修正的内容
- 一次处理一种模式——使用
replace_all时,每次编辑只修正一种单词模式 以避免意外替换 - 语境很重要——有些词是否带重音符号会改变含义 (例如,“ou”意为“或者”,“où”意为“哪里”)。务必结合语境判断
- 始终使用 UTF-8——始终使用 UTF-8 编码,绝不要使用 Latin-1 或其他旧版编码
- 从一开始就正确生成——第一次就正确写好重音符号,比事后再修正更省事