Skip to content

docs(agents): split the language rule — Chinese for maintainer chat, English on GitHub (#6692) #6742

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
os-project-manager merged 2 commits into from
Aug 8, 2026
+22 −4
Merged

docs(agents): split the language rule — Chinese for maintainer chat, English on GitHub (#6692) #6742

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3d372e8
docs(agents): split the language rule — Chinese for maintainer chat, …
claude Aug 8, 2026
209380e
Merge remote-tracking branch 'origin/main' into claude/issue-6692-lan…
claude Aug 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions .claude/agents/os-dev.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-<n>-<slug>` (retry on network
failure with backoff).
- **Draft** PR to `main`, body starting `Fixes #<n>`, explanatory prose in
Chinese per repo convention. Close it with the **session-URL** attribution
- **Draft** PR to `main`, body starting `Fixes #<n>`, **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.**
Expand Down
17 changes: 15 additions & 2 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/文档正文等仓库产物保持现有语言惯例(以英文为主),不要因本节而改写。

---

Expand Down
Loading