diff --git a/.claude/agents/os-dev.md b/.claude/agents/os-dev.md index de5febd641..367e98e09c 100644 --- a/.claude/agents/os-dev.md +++ b/.claude/agents/os-dev.md @@ -176,8 +176,13 @@ Definition of done, in order: - Changeset added when the change is user-visible. - Pushed with `git push -u origin claude/issue--` (retry on network failure with backoff). -- **Draft** PR to `main`, body starting `Fixes #`, explanatory prose in - Chinese per repo convention. Close it with the **session-URL** attribution +- **Draft** PR to `main`, body starting `Fixes #`, **title and explanatory + prose in English** — GitHub artifacts (issue and PR titles, bodies, comments) + are English per the maintainer ruling of 2026-08-08 quoted in AGENTS.md + §Communication; Chinese is for talking to the maintainer in Claude Code, not + for what lands on GitHub. A Chinese ruling you cite stays **verbatim and + untranslated** inside that English body — rewriting a quoted ruling is + rewriting the ruling. Close the body with the **session-URL** attribution footer — the bare-URL form is stripped from the stored body on every later edit (see the sanitizer note at the end of this file). - **`skip-changeset` label — your step, not CI's; the read-back is the proof.** diff --git a/AGENTS.md b/AGENTS.md index 3539a7e091..fcf5af81dd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,8 +8,21 @@ Primary AI instruction file for this repo. Read natively by Claude Code, GitHub ## Communication -- **与维护者沟通时一律使用中文**(对话回复、PR/issue 讨论中的解释性文字)。 -- 代码、标识符、提交信息(commit messages)、ADR/文档正文等仓库产物保持现有语言惯例(以英文为主),不要因本条而改写。 +语言规则分两件事:**和维护者说话用什么语言**,与**留在 GitHub 上的产物用什么语言**。 +它们可分,并且就在这里分开。 + +- **在 Claude Code 中与维护者对话一律使用中文**(对话回复、轮次报告等聊天通道里的内容)。 +- **GitHub 产物一律使用英文**:issue 与 PR 的标题、正文、评论。维护者裁决 + (2026-08-08,#6692),原文引用、未翻译: + + > issue 和 PR 必须用英文,在 claude code 中和我讨论可以用中文。 + + 这条裁决推翻的是本节此前的写法——它把上面两件事并成一句,并把「PR/issue 讨论中的 + 解释性文字」一并划给中文。代价实测过:同一天、同一身份下的 PR 正文一半中文一半英文 + (#6556 中文 / #6691 英文),因为 agent 手里同时握着两条相反的指令(#6692)。 +- **引用中文裁决时保持原文、不翻译**,即使承载它的 issue/PR 正文通篇是英文——改写引文 + 就是改写裁决。上面那段引用即是一例:它是维护者的原话,一个字未动。 +- 代码、标识符、提交信息(commit messages)、ADR/文档正文等仓库产物保持现有语言惯例(以英文为主),不要因本节而改写。 ---