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.