normes-de-developpement

Normes de Développement / 开发要求与编码规范

Une compétence, un workflow, deux langues de ressources. / 一个技能、一套流程、两种资源语言。

Révision de ressource jumelée / 双语资源配对修订：2026-10-05.9. Ceci identifie le bundle de ressources, pas une approbation de projet ou une vérification réussie. / 仅标识资源包，不代表项目批准或验证通过。

Sélection de la Langue / 语言选择

• Choisissez la langue d'instruction selon la préférence explicite de l'utilisateur ; sinon utilisez zh-CN pour les requêtes en chinois et en pour les requêtes en anglais. Pour les autres langues, utilisez les ressources en anglais et répondez dans la langue de l'utilisateur. Ne déduisez pas la langue à partir des métadonnées de l'interface ou de la langue des fichiers sources. 规则语言优先遵循用户明确偏好，否则中文请求选 zh-CN、英文请求选 en；其他语言使用英文资源并以用户语言沟通。不根据界面配置或源文件语言推断用户偏好。
• En conversation, suivez la langue demandée par l'utilisateur, sinon sa requête actuelle. Pour chaque document, utilisez sa langue demandée explicitement, sinon la convention de documentation existante du projet, sinon la langue de conversation. Utilisez le modèle correspondant ; pour les autres langues, adaptez un modèle anglais. Ne traduisez pas des fichiers non liés et ne renommez pas les identifiants de code comme effet secondaire. 对话优先遵循用户指定语言，否则跟随当前请求；每份文档优先遵循明确指定的语言，再遵循项目已有文档语言约定，最后跟随对话语言。使用相应模板，其他语言可基于英文模板调整；不顺带翻译无关文件或重命名代码标识符。
• Avant le travail sur une tâche, lisez exactement une référence de base correspondante ci-dessous, puis uniquement ses références pertinentes pour la tâche. La langue demandée pour un document peut différer de la langue d'instruction ; ne chargez pas les deux ensembles complets de ressources pour cette seule raison. 开始任务工作前读取下方一种语言的核心规范，再按需加载其中相关参考。文档目标语言可与规则语言不同，不因此加载两套完整资源。

Référence de base / 核心规范	Quand lire / 读取条件
Normes chinoises	Langue d'instruction chinoise / 规则语言为中文
Normes anglaises	Langue d'instruction anglaise ou de repli / 规则语言为英文或使用英文回退

Invariants Partagés / 共同约束

• Pour le développement formel, approuvez d'abord les prérequis, puis la conception complète du module/de l'architecture pour le périmètre d'implémentation actuel ; les nouveaux projets nécessitent également une confirmation explicite de la stack technique. L'approbation partielle couvre uniquement le périmètre identifié ; les dépendances nécessaires doivent également être approuvées, pas implicitement incluses. N'implémentez pas et ne mettez pas en place de structure avant que les portes applicables ne soient franchies. Réutilisez des approbations authentiques et applicables ; n'en inventez jamais. 正式开发先确认需求，再确认本次实施范围的完整模块架构；新项目还须明确确认技术栈。部分确认仅覆盖指定范围，必要依赖也须已确认，不自动扩大批准。适用门槛未通过前不实施或初始化工程；复用真实有效确认，不伪造批准。
• Lors de la conception architecturale, les modules complexes nécessitent des diagrammes d'architecture et les workflows complexes nécessitent des organigrammes, sauvegardés avec la conception et cohérents avec les descriptions des modules/interfaces. L'absence des diagrammes requis rend ce périmètre incomplet ; les diagrammes ne remplacent pas les contrats et n'ajoutent pas d'étape d'approbation. Les conceptions simples et les tâches en lecture seule/légères ne nécessitent pas de rétroplanification de diagrammes pour l'ensemble du projet. 架构设计阶段，复杂模块必须用架构图、复杂流程必须用流程图表示，随设计文档保存并与模块/接口说明一致。缺少必需图示时对应范围设计不完整；图不替代契约、不新增审批。简单设计及只读/轻量任务不要求补画全项目图。
• Lorsque la conception d'interface est nécessaire, fournissez trois prototypes visuels HTML consultables dans un navigateur, réellement distincts, pour les mêmes exigences de périmètre et les écrans représentatifs, en privilégiant l'esthétique, la mise en page, la typographie et la hiérarchie visuelle. Du HTML/CSS statique suffit ; JavaScript et les démonstrations d'interaction sont facultatifs sauf demande explicite. Fournissez les entrées et les résultats réels de vérification du rendu, enregistrez les compromis et la sélection de l'utilisateur avant l'implémentation formelle. Un travail de conception isolé ne contourne pas les portes des prérequis/stack/architecture et n'autorise pas les services en production. Réutilisez les sélections valides et applicables ; les révisions en lecture seule et les réparations qui préservent la conception établie ne forcent pas une nouvelle sélection. 涉及界面设计时，基于相同范围需求和代表性页面交付 3 套有实质差异、浏览器可查看的 HTML 视觉原型，重点关注美观、布局、排版及视觉层级。静态 HTML/CSS 示意页面即可，JS 与轻量交互默认可选；用户明确要求交互演示时按指定范围实现。提供入口及真实渲染检查结果，记录取舍和用户选择后再正式实施。隔离设计不绕过需求/技术栈/架构门槛，也不授权真实服务操作；复用有效且适用的既有选择，只读评审及保持既定设计的修复不强制重选。
• Au début du codage, vérifiez si l'implémentation concernée utilise une base de données. Si c'est le cas, générez et sauvegardez sa conception avant le code lié à la base de données : proposez une nouvelle base de données ou inspectez et réutilisez/mettez à jour la conception existante, par défaut dans docs/database-design.md. Pas de base de données signifie pas de document de base de données. Ceci est un livrable de codage, pas un prérequis pour l'approbation de l'architecture ou une étape d'approbation supplémentaire. Les garanties applicables en matière de changement de périmètre et d'opérations sur les données s'appliquent toujours ; le travail en lecture seule n'autorise pas les modifications. 开始编码时检查本次实现是否使用数据库；涉及时，数据库相关代码前必须输出并保存设计，默认 docs/database-design.md：新库给出方案，已有库先核对并复用/更新现有设计。不使用数据库则不生成该文档。它是编码阶段交付物，不是架构批准的前置附件，不增加审批阶段；仍遵守范围变更和数据操作安全要求，只读工作不授权编辑。
• Chaque changement complet du code du projet, y compris les corrections de bugs et les refactorisations, doit incrémenter la version du produit affecté selon son schéma établi. Mettez à jour la source de version réelle et les entrées synchronisées requises avant la passation, en signalant les anciennes/nouvelles valeurs et leurs emplacements. Comptez un changement complet, pas chaque édition de fichier ou réessai. Le travail purement documentaire/en lecture seule ne déclenche pas de changement de version ; les schémas peu clairs ou les conflits d'autorité nécessitent une clarification. Les changements de version n'autorisent pas la publication et ne dispensent pas des exigences de compatibilité. 每次完整的项目代码变更，包括 Bug 修复和重构，都必须按既有规则递增受影响产品版本；交付前更新真实版本入口及必要同步项，报告旧值、新值和位置。按完整变更计数，不按文件编辑或重试次数；纯文档/只读工作不触发产品升版，规则不明或授权冲突时先澄清。升版不授权发布，也不豁免兼容要求。
• Les réparations localisées à faible risque éligibles restaurent l'intention claire ; les refactorisations préservant le comportement éligibles conservent le comportement observable, les erreurs et les effets secondaires. Les deux restent dans le périmètre autorisé sans nouvelles fonctionnalités, changements de contrat/limites ou effets à haut risque. Énoncez l'objectif, les preuves, le périmètre et le plan de vérification ; ne forcez pas le rétroplanning de la documentation produit historique ou l'approbation redondante. Clarifiez l'ambiguïté et escaladez le travail affecté lorsque le périmètre ou le risque augmente. 合格低风险局部修复恢复明确预期，行为保持重构保留可观察行为、异常和副作用；均限于授权范围，不新增功能、改变契约/边界或涉及高风险。简述目标、依据、范围和验证方式，不追补历史产品文档或重复审批；有歧义先澄清，范围或风险扩大时升级受影响流程。
• Pour les produits client/serveur, les modifications côté serveur doivent préserver les protocoles, interfaces, sémantique des champs et workflows de base des anciennes versions de l'Agent, sans mise à niveau forcée de l'Agent. Le périmètre de compatibilité utilisateur/projet et les preuves réelles de l'ancien Agent sont requis pour les interactions concernées. L'incompatibilité, l'échec ou l'absence de vérification bloquent la fusion/la publication, pas seulement un avertissement. Agent désigne ici un logiciel client, pas un LLM. 对客户端/Server 产品，服务端改动须保持低版本产品 Agent 的协议、接口、字段语义及核心流程，不强制升级 Agent。涉及交互时遵循用户/项目兼容范围并提供实际低版本证据；不兼容、验证失败或缺失阻断合并发布。Agent 指软件客户端，不是大模型。
• Respectez le périmètre utilisateur, les règles du dépôt et les instructions de priorité supérieure. Les demandes en lecture seule n'autorisent pas les modifications. L'approbation n'accorde pas les autorisations de commit, push, PR, déploiement, données de production ou écriture externe non liés. Signalez les preuves réelles et le travail non vérifié ; l'auto-révision n'est pas une révision indépendante. 遵守用户范围、仓库规则及更高优先级指令；只读请求不授权编辑，批准不授予无关提交、推送、PR、部署、生产数据或外部写入权限。按实际证据报告未验证项，自审不冒充独立审查。

Maintenance de la Traduction / 翻译维护

Terme / 术语	Signification / 含义
Requis / 必须	Obligation applicable, pas une suggestion / 适用时须满足，不是建议
Ne doit pas / 不得	Action interdite / 禁止的操作
Recommandé / 建议	Préféré, avec adaptation justifiée autorisée / 优先采用，可按依据调整
Approuvé / 已确认	Approbation authentique du contenu et du périmètre identifiés / 真实确认指定内容与范围
Vérifié / 已验证	Les vérifications pertinentes ont réellement été effectuées, pas une approbation ou un déploiement / 相关检查实际通过，不等于批准或部署

references/zh-CN et assets/zh-CN sont les sources des règles/modèles en chinois ; les fichiers en correspondants sont des traductions, pas des politiques indépendantes. Mettez à jour les fichiers, liens, README et scénarios de comportement concernés en même temps ; avancez la révision jumelée du bundle dans ce point d'entrée, les deux README et les en-têtes de ressources. Une révision correspondante ne prouve pas l'équivalence sémantique. Maintenez l'équivalence des termes ci-dessus, des modes de tâche, des contraintes de sécurité et des normes de preuve. Le simple changement de langue n'invalide pas les approbations et n'autorise pas le travail. Si un écart est découvert, signalez-le et consultez uniquement la source chinoise concernée ; ne sélectionnez pas silencieusement une traduction plus faible. Si la source ne peut pas être vérifiée, divulguez l'incertitude et ne prétendez pas que la porte concernée a été franchie. Les instructions de priorité supérieure restent prédominantes.

references/zh-CN 和 assets/zh-CN 是中文规则/模板源，同名 en 文件是译文，不是独立政策。修改时同步对应文件、链接、README 及受影响行为场景，并更新入口、两份 README 和资源头部的配对修订标识；标识一致不证明语义等价。保持上表术语、任务模式、安全约束和证据标准等价。仅切换语言不使批准失效或授予实施权限。发现差异时报告并仅核对受影响中文源，不静默选择更宽松译文；源文无法核验时说明不确定性，不声称相关门槛已通过。更高优先级指令始终优先。