AgentSkillsCN

write-ios-macos-changelog

可读取用户指定时间范围内的提交记录和变更文件，并为 iOS 和 macOS 分别生成更新日志。

SKILL.md
--- frontmatter
name: write-ios-macos-changelog
description: Reads commits and changed files within a timeframe specified by user and compiles a changelog for both iOS and macOS.
metadata:
  short-description: Write changelog for iOS/macOS release

If not specified a timeframe, ask the user for a time frame to read commits until then. Read all commits until specified point in history, list files for each commit and compile a list of new features and fixes for each app. For changes in shared modules, include it for both apps.

Write in past tense. Use these examples for the tone, tense, and wording. Example:

code
New

- Added video upload support
- New chat visibility setting: Open chat settings to change who can access the chat

Fixes & Improvements

- Fixed emojis appearing as invalid character
- Fixed video upload failing

Example:

code
New

- You can now edit gradients directly on the canvas using gradient handles
- Added text formatting panel to control casing, wrapping, and truncation
- Added support for automatic optical size in variable fonts

Improvements and fixes

- Reworked the snapping system for better performance and improved heuristics
- Improved performance of duplicating elements with -drag
- Fill and Fit sizes now report rounded values
- Removed unnecessary background-repeat styles from the code output
- Improved handling of mismatching font versions
- Editor will no longer attempt to load a font from Google if a local version is available
- Fixed an issue where an empty Selection colors panel was sometimes shown

More guidelines

  • •Prefer 5 to 10 bullets total for most releases.

Filtering rules

  • •Include: new features, UI changes, behavior changes, bug fixes users would notice, performance improvements with visible impact.
  • •Exclude: refactors, dependency bumps, CI changes, developer tooling, internal logging, analytics changes unless they affect user privacy or behavior.
  • •If a change is ambiguous, ask for clarification or describe it as a small improvement only if it is user-visible.

Language Guidelines

  • •Translate technical terms into user-facing descriptions.
  • •Avoid versions of "API", "refactor", "nil", "crash log", or "dependency".
  • •Prefer "Improved", "Added", "Fixed", "Updated" or action verbs like "Search", "Upload", "Sync".
  • •Keep tense present or past: "Added", "Improved", "Fixed".

QA Checklist

  • •Every bullet ties to a real change in the range.
  • •No duplicate bullets that describe the same change.
  • •No internal jargon or file paths.
  • •Final list fits App Store text limits for the target storefront if provided.