From 3d372e8465ce1ba1f5eaae69b43f69eb2aa37b67 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 8 Aug 2026 13:50:41 +0000 Subject: [PATCH] =?UTF-8?q?docs(agents):=20split=20the=20language=20rule?= =?UTF-8?q?=20=E2=80=94=20Chinese=20for=20maintainer=20chat,=20English=20o?= =?UTF-8?q?n=20GitHub=20(#6692)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit AGENTS.md §Communication merged two separable rules into one sentence and its parenthetical assigned PR/issue explanatory prose to Chinese, which the maintainer ruling of 2026-08-08 overturns. .claude/agents/os-dev.md's Definition of done still told every dev agent to write PR prose in Chinese. Split the rule at the boundary the ruling draws, cite the ruling verbatim and untranslated at the authoritative site, and restate the one rule that survives unchanged: a quoted Chinese ruling stays verbatim inside an English body. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01F8q5J1MQyocgtNspb15fSn --- .claude/agents/os-dev.md | 9 +++++++-- AGENTS.md | 17 +++++++++++++++-- 2 files changed, 22 insertions(+), 4 deletions(-) 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/文档正文等仓库产物保持现有语言惯例(以英文为主),不要因本节而改写。 ---