| name | eisland-dev-generate-release-worklog |
| author | JNTMTMTM |
| description | Generate a release announcement markdown for eIsland. Use this skill whenever the user asks to "generate release notes", "create announcement", "写更新日志", "生成发布公告", "draft release notes", or mentions preparing a new version release document.
|
Generate Release Worklog
Generate a versioned release announcement markdown file for eIsland, following the project's established format and tone.
When to use
- The user asks to generate release notes or an announcement for a new version
- The user mentions "更新日志", "发布公告", "release notes", "announcement"
- A release is being prepared and documentation is needed
Process
Step 1: Gather parameters
Confirm these values with the user (use defaults if not specified):
| Parameter | Description | Default |
|---|
version | Version string (e.g., V26.5.14) | Ask user |
date | Release date (YYYY-MM-DD) | Today |
sinceDate | Git log start date | Previous version's date |
Step 2: Collect recent git commits
Run in the eIsland project root:
git log --oneline --since="<sinceDate>"
Also read docs/CHANGE_LOG.md (lines 1-50) for the latest released version context.
Group the commits by type prefix: feat, fix, refactor, test, docs, i18n, style, chore.
Step 3: Read style reference
Read the bundled reference files in references/V26.6.5/ to extract the canonical format:
- The exact template structure (metadata blockquote, summary, sections, closing) — each version is a directory containing
CH_<version>.md and EN_<version>.md
- The tone and phrasing patterns used in bullet items
- The separation convention: Chinese and English are in separate files
Read both references/V26.6.5/CH_V26.6.5.md and references/V26.6.5/EN_V26.6.5.md as the primary style reference.
Step 4: Generate the announcement
Group commits into user-facing sections: 新功能, 体验优化, 问题修复, 文档更新. Only include sections that have items.
Rewrite each commit into a concise user-facing bullet point in Chinese:
- One sentence per item
- No internal implementation details (no class names, file paths, function names)
- Focus on user-visible behavior changes and benefits
- Match the tone of the style reference
Step 5: Format the output
Generate two separate markdown files inside a directory named after the version:
Chinese file: docs/announcement/<version>/CH_<version>.md
> **更新时间:** *`<date>`*
> **代码仓库:** [`https://github.com/JNTMTMTM/eIsland`](https://github.com/JNTMTMTM/eIsland)
**<Chinese summary in bold>**
## 新功能
- <Chinese bullet>
## 体验优化
- <Chinese bullet>
## 问题修复
- <Chinese bullet>
## 文档更新
- <Chinese bullet>
感谢大家持续反馈与支持。若你在升级后发现新问题，欢迎继续反馈，我们会尽快跟进。
English file: docs/announcement/<version>/EN_<version>.md
> **Release Date:** *`<date>`*
> **GitHub Repository:** [`https://github.com/JNTMTMTM/eIsland`](https://github.com/JNTMTMTM/eIsland)
*<English summary in italic>*
## New Features
- <English translation of bullet>
## Improvements
- <English translation of bullet>
## Bug Fixes
- <English translation of bullet>
## Documentation
- <English translation of bullet>
Thank you for your continued feedback and support. If you encounter new issues after upgrading, please continue to report them — we will follow up as soon as possible.
Format rules
- No emoji anywhere
- No
# title at the top of the file
- No
--- divider anywhere
- Sub-items use 2-space indent
- No empty entries, no duplicates
- Keep bullet items concise (one sentence each)
- Chinese and English are in separate files, never mixed
- Each file's metadata blockquote uses its own language (Chinese: 更新时间/代码仓库, English: Release Date/GitHub Repository)
- Metadata fields are on separate lines (not a single line)
- Chinese summary in bold, English summary in italic
- Only include sections that have items
Step 6: Write and commit
Write both files to docs/announcement/<version>/, then commit:
git add docs/announcement/<version>/
git commit -m "docs(announcement): add <version> release notes"
Output format
Return:
- The output directory path
- The git commit hash
- A brief summary of what was included (section counts per file)
