Skip to content

Commit 901eb85

Browse files
docs(agents): split the language rule — Chinese for maintainer chat, English on GitHub (#6692) (#6742)
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. Claude-Session: https://claude.ai/code/session_01F8q5J1MQyocgtNspb15fSn Co-authored-by: Claude <noreply@anthropic.com>
1 parent 07eefb0 commit 901eb85

2 files changed

Lines changed: 22 additions & 4 deletions

File tree

.claude/agents/os-dev.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -178,8 +178,13 @@ Definition of done, in order:
178178
- Changeset added when the change is user-visible.
179179
- Pushed with `git push -u origin claude/issue-<n>-<slug>` (retry on network
180180
failure with backoff).
181-
- **Draft** PR to `main`, body starting `Fixes #<n>`, explanatory prose in
182-
Chinese per repo convention. Close it with the **session-URL** attribution
181+
- **Draft** PR to `main`, body starting `Fixes #<n>`, **title and explanatory
182+
prose in English** — GitHub artifacts (issue and PR titles, bodies, comments)
183+
are English per the maintainer ruling of 2026-08-08 quoted in AGENTS.md
184+
§Communication; Chinese is for talking to the maintainer in Claude Code, not
185+
for what lands on GitHub. A Chinese ruling you cite stays **verbatim and
186+
untranslated** inside that English body — rewriting a quoted ruling is
187+
rewriting the ruling. Close the body with the **session-URL** attribution
183188
footer — the bare-URL form is stripped from the stored body on every later
184189
edit (see the sanitizer note at the end of this file).
185190
- **`skip-changeset` label — your step, not CI's; the read-back is the proof.**

AGENTS.md

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,21 @@ Primary AI instruction file for this repo. Read natively by Claude Code, GitHub
88

99
## Communication
1010

11-
- **与维护者沟通时一律使用中文**(对话回复、PR/issue 讨论中的解释性文字)。
12-
- 代码、标识符、提交信息(commit messages)、ADR/文档正文等仓库产物保持现有语言惯例(以英文为主),不要因本条而改写。
11+
语言规则分两件事:**和维护者说话用什么语言**,与**留在 GitHub 上的产物用什么语言**
12+
它们可分,并且就在这里分开。
13+
14+
- **在 Claude Code 中与维护者对话一律使用中文**(对话回复、轮次报告等聊天通道里的内容)。
15+
- **GitHub 产物一律使用英文**:issue 与 PR 的标题、正文、评论。维护者裁决
16+
(2026-08-08,#6692),原文引用、未翻译:
17+
18+
> issue 和 PR 必须用英文,在 claude code 中和我讨论可以用中文。
19+
20+
这条裁决推翻的是本节此前的写法——它把上面两件事并成一句,并把「PR/issue 讨论中的
21+
解释性文字」一并划给中文。代价实测过:同一天、同一身份下的 PR 正文一半中文一半英文
22+
(#6556 中文 / #6691 英文),因为 agent 手里同时握着两条相反的指令(#6692)。
23+
- **引用中文裁决时保持原文、不翻译**,即使承载它的 issue/PR 正文通篇是英文——改写引文
24+
就是改写裁决。上面那段引用即是一例:它是维护者的原话,一个字未动。
25+
- 代码、标识符、提交信息(commit messages)、ADR/文档正文等仓库产物保持现有语言惯例(以英文为主),不要因本节而改写。
1326

1427
---
1528

0 commit comments

Comments
 (0)