dsh-translate-docs: delegate translation writing to a subagent worktree with a draft PR

2026-07-20 10:48:58 +08:00
parent 023bed1a83
commit 3a20b4c551
4 changed files with 8 additions and 4 deletions
@@ -5,6 +5,10 @@ description: Use when creating or updating the bilingual counterpart of a doc in

 # Translating DeepSeek-Harness docs

+## Delegate to a subagent in a worktree
+
+When this skill fires and translations need to be written, do not translate on your current branch: spawn a subagent to do the translation work, give it a dedicated worktree under `.worktrees/` on a fresh branch, and have it open a **draft PR** so a human reviews the translation before it lands. The subagent reads this skill and follows everything below; the sections from here on address the agent actually writing the translation. Exception: a counterpart update owed to an in-flight PR belongs on that PR's branch ([same-PR rule](../../../docs/i18n/README.md)) — the subagent works in that branch's worktree instead of opening a separate PR.
+
 **This skill is guidance, not a translation memory.** It is the workflow map for keeping `foo.md ↔ foo.zh.md` pairs consistent and natural in both languages. Both languages carry equal authority — a change is authored in either one, and that side is the source for that update. You are the translator: the rules below say what must hold, not how to phrase any particular sentence — phrasing judgment is yours, terminology is not.

 ## Sources of truth (read, don't re-summarize)