回复与注释语言

回复与注释语言

适用范围

适用于所有项目、所有 AI 编辑器（Claude Code / Codex / Trae / CodeBuddy / VSCode Copilot 等）。

语言要求

• 默认使用中文进行对话回复、解释、提问、错误说明与总结。
• 代码中的注释统一使用中文（包括行注释、方法注释、TODO）。
• 例外：以下内容保持英文，不翻译：
• 标识符（类名、方法名、变量名、包名）
• 日志输出字符串中的关键字（便于检索），但日志的业务说明部分可用中文
• 第三方库的 API、注解名、配置 key
• Git commit message（见 git-commit.md）

风格

• 回复保持简洁、直接，先给结论或代码，再补充必要说明；避免冗长寒暄。
• 涉及取舍（trade-off）时，列出 1-2 个备选并说明选择理由，而非长篇大论。
• 不确定时主动提问澄清，不要基于猜测大面积改动代码。

命名/术语一致性

• 业务术语统一使用 10-backend/his-domain.md 与 20-frontend/* 中的叫法（如「挂号」「号源」「门诊」「医保」），不要自创同义词。