mcpField
F
french-language

french-language

github.com/rlespinasse文档处理1341 次安装3 天前更新
代码仓库

关于 french-language

french-language 是用于规范项目内容及生成文件中法语表达的技能。它指导开发者检查语言设置、重音符号和排版,先汇报问题,并在获批后应用修改。

主要功能

  1. 01检查项目语言配置
  2. 02扫描多种文件中的法语文本
  3. 03检查重音符号与语法
  4. 04遵循法语排版规范
  5. 05批量修改前汇报问题
  6. 06校验生成的法语内容

适用场景

  1. 01审查法语项目文档
  2. 02检查生成文件中的法语文本
  3. 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 等)

预检

进行更改前,务必:

  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à
ù带抑音符的 uoù
ô带长音符的 ocontrôle、rôle、clôture、binôme
î带长音符的 imaître、connaître
ç软音符ça、français、leçon、reçu
ë、ï、ü分音符Noël、naïf、ambiguïté
常见的重音符号遗漏模式

审核或生成法语文本时,请留意以下经常遗漏重音符号的情况:

错误正确语境
qualitequalité以 -ité 结尾的名词
securitesécurité以 -ité 结尾的名词
perimetrepérimètre以 -ètre 结尾的名词
deploiementdéploiement带 dé- 前缀的名词
developpeurdéveloppeur带 dé- 前缀的名词
strategestratège以 -ège 结尾的名词
modelemodèle以 -èle 结尾的名词
clotureclôture带 ô 的词
equipeéquipe带 é 的词
rolerôle带 ô 的词
etreêtre带 ê 的动词
batisseurbâtisseur带 â 的名词
retrospectiverétrospective带 é 的词
responsabilitesresponsabilité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 步:应用修正

获得用户批准后:

  1. 对每种修正模式,在每个文件中使用 Edit,并设置 replace_all=true
  2. 对每种文件格式,遵循下方对应的指南
  3. 验证修正后没有引入回归问题
第 4 步:验证

应用修正后:

  1. 搜索是否仍有常见的重音符号遗漏模式
  2. 确认所有文件的内容一致
  3. 报告不确定的术语(请用户提供指导)

特定格式指南

SVG 文件
  • 仅修改 <text> 元素中的文本内容——绝不改动坐标、 样式或结构
  • 检查文本是否能完整显示——重音字符可能稍宽;请确认文本 仍能容纳在其容器中
  • 使用 UTF-8 字符——不要使用 XML 实体(使用 é,而非 &#233;)
  • 代码检查工具可能会重新格式化——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 实体(使用 é,而非 &eacute;)
  • 检查 <title>、<meta>、alt 属性、aria-label 和可见文本

生成新文件

生成任何包含法语文本的新文件时:

  1. 从一开始就正确使用重音符号——不要先生成不带重音的内容, 再事后修正
  2. 所有文件类型均使用 UTF-8 编码
  3. 编写时正确使用重音符号——请参考上文的常见模式表
  4. 技术术语保留英文——不要翻译普遍使用的英文术语
  5. 提交前验证——向用户展示前重新阅读生成的内容,检查是否有 重音符号遗漏

重要准则

  • 绝不要删除重音符号——如果不确定某个单词是否需要重音符号,请保留
  • 保留英文技术术语——不要翻译 Sprint、Backlog 等
  • 批量修改前先询问——应用修正前,先列出要修正的内容
  • 一次处理一种模式——使用 replace_all 时,每次编辑只修正一种单词模式 以避免意外替换
  • 语境很重要——有些词是否带重音符号会改变含义 (例如,“ou”意为“或者”,“où”意为“哪里”)。务必结合语境判断
  • 始终使用 UTF-8——始终使用 UTF-8 编码,绝不要使用 Latin-1 或其他旧版编码
  • 从一开始就正确生成——第一次就正确写好重音符号,比事后再修正更省事

评论

支持 Markdown