Menu
Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when developing in packages/agent-core-v2 (the DI × Scope agent engine) — adding or modifying a domain Service, choosing a LifecycleScope, wiring DI dependencies, splitting a domain across scopes, owning or migrating a config section, gating behavior behind an experimental flag, raising coded errors, working on the permission system, writing DI/Scope tests, porting business logic from agent-core (v1) to v2, triaging a main-branch commit against v2, or exposing a v2 domain over server-v2 while keeping the /api/v1 wire contract compatible with released clients. Self-contained guide organized by development stage (orient → design → implement → test → verify) plus align workflows for v1→v2 migration, main-branch commit triage, and server-v2 wire exposure; each file carries the rules, examples, and red lines for its step.
Use when generating changesets in the kimi-code repository, including package bump selection, internal package and CLI bundle handling, bump levels, major confirmation, and English changelog wording.
Use ONLY for code review and test write/review guidance in `packages/agent-core-v2` (the DI × Scope agent engine). Does NOT apply to the legacy `packages/agent-core` or to any other package — for those, do not load this skill. Groups the review and testing lenses used for agent-core-v2 — `slop` (single-level-of-abstraction / layered error-handling review, invoked only on explicit request) and `test` (contract-driven per-test rules for both authoring and reviewing tests). Apply the sub-skill that matches the task; do not apply `slop` unprompted.
Invoke only when the user explicitly asks to review code through the "single level of abstraction / layered error handling" lens — a function does only its own layer's business logic while errors are handled above or below. The agent reports detections, raw-count measurements, and move directions. Apply only when the user explicitly requests this lens.
Use when writing or reviewing tests, or when asked how to write a good single test. Encodes the per-test rules behind the "test the contract / responsibility, not the implementation" principle — name and structure one behavior per `it`, drive through the public surface, stub only true external boundaries, control time and config via documented knobs, and keep tests clear, isolated, and refactor-resilient. The same rules drive both authoring (write mode) and auditing existing tests (review mode).
Use after a release succeeds, when maintainers need to sync apps/kimi-code/CHANGELOG.md into docs/en/release-notes/changelog.md and docs/zh/release-notes/changelog.md, then open a PR on a dedicated branch.
| name | translate-docs |
| description | Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md. |
This repository keeps bilingual user documentation under docs/zh/ and docs/en/. This skill synchronizes the two locales, page by page, after either side has been updated.
This skill is invoked by both gen-docs (incremental updates) and audit-docs (full pre-release audit) to keep locale mirrors in sync.
If any of the following are missing, stop and report to the user before continuing:
docs/zh/ and docs/en/ mirrored directory structure.docs/AGENTS.md — terminology table, typography rules, and source-of-truth rules.release-notes/changelog.md): English is the source. Translate to Chinese.release-notes/breaking-changes.md): English is the source. Translate to Chinese.docs/en/ and docs/zh/ are mirrored pairs. After either side changes, update the other locale in the same change.When non-changelog pages change in either locale, sync the mirror before release. When the English changelog changes, sync the Chinese changelog.
Detect what needs syncing
git diff main..HEAD --stat docs/ — see which files changeddocs/en/ or docs/zh/, locate its mirror in the other locale (same relative path).Translate page by page, section by section
Apply terminology and typography rules from docs/AGENTS.md
，。；：？！（）), space between Chinese and ASCII (letters / numbers / inline code / links).::: tip / ::: warning / ::: info / ::: danger) use the short Chinese labels from docs/AGENTS.md.Verify
git diff docs/ — scan for terminology drift or punctuation regressions.pnpm --filter docs run build or equivalent) to catch broken links and Markdown errors.docs/AGENTS.md writing-style examples); preserve that tone in Chinese; preserve sentence-case headings and concise English style in English.example.com, example.test, and YOUR_API_KEY in both locales.Wire, MCP, ACP, JSON, OAuth, macOS, uv, etc.).example placeholders.