sync-zh-changelog
GitHub将EcoPaste版本更新日志从英文同步至中文,确保术语一致、结构验证无误。
Trigger Scenarios
Install
npx skills add EcoPasteHub/EcoPaste --skill sync-zh-changelog -g -y
SKILL.md
Frontmatter
{
"name": "sync-zh-changelog",
"description": "Synchronize an EcoPaste release section from CHANGELOG.md into CHANGELOG.zh-CN.md with project terminology and structural validation. Use when the user explicitly invokes $sync-zh-changelog or asks to generate, translate, update, or verify the Chinese changelog for a release."
}
Sync Chinese Changelog
Synchronize one EcoPaste release from CHANGELOG.md to
CHANGELOG.zh-CN.md without changing release metadata or unrelated files.
Trellis routing
- Treat an explicit
$sync-zh-changeloginvocation as the user's standing choice to skip Trellis task creation for this narrow documentation change. Do not ask again, and do not create, activate, or archive a Trellis task. - When this skill is selected implicitly from natural-language intent, follow the normal Trellis task-creation routing.
- Still respect
AGENTS.md, the dirty worktree, and applicable release specs.
Workflow
-
Read both changelog files before editing. Use the version named by the user; otherwise select the first release section in
CHANGELOG.md. -
If that version already exists in
CHANGELOG.zh-CN.md, update it in place. Otherwise insert it immediately after the# 更新日志title. Never create a duplicate section. -
Translate release prose and headings into concise Simplified Chinese. Search
src/locales/zh-CN/,src/locales/en-US/, and existing Chinese changelog entries withrgwhen product terminology is unclear. -
Preserve the source release header's version, compare URL, date, section order, entry order, issue numbers, commit hashes, and all link targets. Translate only human-readable prose. Keep platform and product names such as EcoPaste, macOS, Windows, Token, AWS Key, and JWT consistent with the UI.
-
Edit only
CHANGELOG.zh-CN.md. Do not modifyCHANGELOG.md, version files, release configuration, or unrelated dirty changes. Do not commit or push. -
Validate the result from the repository root:
python3 .agents/skills/sync-zh-changelog/scripts/check_sync.py git diff --check -- CHANGELOG.zh-CN.mdPass
--version <version>to validate a user-selected non-latest release. -
Fix every validation error, rerun both checks, then report the synchronized version and validation result.
Translation headings
Use these established mappings when the source headings occur:
✨ Features→✨ 新功能🐛 Bug Fixes→🐛 问题修复⚡️ Performance→⚡️ 性能优化⏪ Reverts→⏪ 回退⚠️ Upgrade Notice→⚠️ 升级说明
For an unfamiliar heading, translate it faithfully while preserving any emoji and its position.
Version History
- 5139d30 Current 2026-08-20 17:52


