chinese-dev-guide_skill

Overview

This skill provides a focused guide for developers working in Chinese-language or bilingual (Chinese/English) environments. It delivers practical local‑setup steps, editor and Git configurations, and workflow recommendations to ensure a smooth development experience. The guidance targets encoding, fonts, tool settings, and common troubleshooting for Chinese text handling.

How this skill works

When the user indicates they are a Chinese developer or asks for Chinese-related configuration, the skill supplies step‑by‑step environment and editor settings, Git tweaks, and localization tips. It inspects the user's platform and tooling context (shell, VS Code, Git) and returns concrete commands and configuration snippets to apply. It also provides troubleshooting advice for encoding, fonts, and input method issues.

When to use it

• Starting a new project that must support Chinese text and comments
• Setting up a developer workstation for Chinese/English bilingual work
• Fixing encoding or font rendering problems in code, tests, or docs
• Configuring editors and Git for consistent Chinese handling
• Preparing localization-ready repositories and test cases

Best practices

• Standardize UTF-8 across OS, editors, and repository files
• Configure Git to use UTF-8 commit encoding and disable quote-path
• Set editor encoding and a Chinese-friendly font for readability
• Keep comments and documentation in the project’s primary language(s)
• Write tests and fixtures with Chinese descriptions to validate localization

Example use cases

• Provide bash exports to enforce zh_CN.UTF-8 locale on a Linux/macOS machine
• Give VS Code settings to ensure file encoding and font family for Chinese
• Share Git commands to avoid commit-message encoding problems
• Outline a checklist for making a TypeScript project localization-ready
• Troubleshoot garbled text showing in terminal, editor, or CI logs