sync-zh-changelog

Synchronize EcoPaste release sections from CHANGELOG.md into the Chinese changelog with structural validation.

7.3k|374|Updated May 31, 2024
One-click install
npx skills add https://github.com/EcoPasteHub/EcoPaste --skill sync-zh-changelog
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-zh-changelog
Source: https://github.com/EcoPasteHub/EcoPaste/tree/main/.agents/skills/sync-zh-changelog
Command: npx skills add https://github.com/EcoPasteHub/EcoPaste --skill sync-zh-changelog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Keeping a bilingual changelog in sync is error-prone: translated sections drift out of order, links and commit hashes get altered, and heading conventions become inconsistent. This Skill translates one EcoPaste release section from CHANGELOG.md into CHANGELOG.zh-CN.md while preserving all release metadata and verifying structural parity automatically.

Core Features & Use Cases

  • Guided translation workflow: Reads both changelog files, inserts or updates the target release section in place, and applies established heading mappings such as "✨ Features" → "✨ 新功能".
  • Terminology consistency: Searches src/locales/zh-CN and existing Chinese entries with ripgrep so product terms like EcoPaste, macOS, Token, and JWT match the UI.
  • Automated validation: Runs scripts/check_sync.py to compare version, compare URL, date, section order, content-unit counts, and Markdown links between the English and Chinese releases, plus git diff --check for whitespace issues.
  • Use Case: After cutting a new EcoPaste release, invoke the skill to generate the Chinese changelog entry for that version and confirm it passes parity validation before committing.

Quick Start

Use $sync-zh-changelog to translate the latest release from CHANGELOG.md into CHANGELOG.zh-CN.md and validate the result.

Frequently Asked Questions about sync-zh-changelog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate a changelog release into Chinese automatically?▼

Invoke $sync-zh-changelog with an optional version number. It reads CHANGELOG.md, translates the release prose into Simplified Chinese using established heading mappings, and inserts or updates the matching section in CHANGELOG.zh-CN.md.

How do I validate that English and Chinese changelogs match?▼

Run python3 .agents/skills/sync-zh-changelog/scripts/check_sync.py from the repository root. It compares version, compare URL, date, section order, content-unit counts, and Markdown links, and reports every structural mismatch.

Can I sync an older release instead of the latest one?▼

Yes. Pass the version explicitly when invoking the skill, and validate with check_sync.py --version <version>. Without a version argument, the skill defaults to the first release section in CHANGELOG.md.

Does the changelog sync modify the English CHANGELOG.md?▼

No. The workflow edits only CHANGELOG.zh-CN.md. It never modifies CHANGELOG.md, version files, release configuration, or unrelated dirty changes, and it does not commit or push.

What happens if the Chinese changelog already has that release section?▼

The skill updates the existing section in place rather than creating a duplicate. If the section is missing, it inserts the new release immediately after the '# 更新日志' title.