AgentSkillsCN

gsd-whats-new

了解自您安装 GSD 版本以来的新功能与更新。

SKILL.md
--- frontmatter
name: gsd-whats-new
description: See whats new in GSD since your installed version
allowed-tools: Read, Bash
<objective> Display changes between installed version and latest available version.

Shows version comparison, changelog entries for missed versions, and update instructions. </objective>

<process> <step name="get_installed_version"> Read installed version from manifest file:
bash
cat .codex/get-shit-done/.gsd-install-manifest.json 2>/dev/null | grep -o '"version"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4

If manifest file missing:

code
## GSD What's New

**Installed version:** Unknown

Your installation doesn't include version tracking.

**To fix:** `npx get-shit-done-multi --codex`

This will reinstall with version tracking enabled.

STOP here if no manifest file. </step>

<step name="fetch_remote_changelog"> Fetch latest CHANGELOG.md from GitHub:

Use WebFetch tool with:

  • •URL: https://raw.githubusercontent.com/shoootyou/get-shit-done-multi/main/CHANGELOG.md
  • •Prompt: "Extract all version entries with their dates and changes. Return in Keep-a-Changelog format."

If fetch fails: Fall back to local changelog:

bash
cat .codex/get-shit-done/CHANGELOG.md 2>/dev/null

Note to user: "Couldn't check for updates (offline or GitHub unavailable). Showing local changelog." </step>

<step name="parse_versions"> From the remote (or local) changelog:
  1. •Extract latest version - First ## [X.Y.Z] line after ## [Unreleased]
  2. •Compare with installed - From VERSION file
  3. •Extract entries between - All version sections from latest down to (but not including) installed

Version comparison:

  • •If installed == latest: "You're on the latest version"
  • •If installed < latest: Show changes since installed version
  • •If installed > latest: "You're ahead of latest release (development version?)" </step>
<step name="display_output"> Format output clearly:

If up to date:

code
## GSD What's New

**Installed:** 1.4.26
**Latest:** 1.4.26

You're on the latest version.

[View full changelog](https://github.com/shoootyou/get-shit-done-multi/blob/main/CHANGELOG.md)

If updates available:

code
## GSD What's New

**Installed:** 1.4.23
**Latest:** 1.4.26

---

### Changes since your version:

## [1.4.26] - 2026-01-20

### Added
- Feature X
- Feature Y

### Changed
- **BREAKING:** Changed Z behavior

## [1.4.25] - 2026-01-18

### Fixed
- Bug in feature A

---

[View full changelog](https://github.com/shoootyou/get-shit-done-multi/blob/main/CHANGELOG.md)

**To update:** `npx get-shit-done-multi --global`

Breaking changes: Surface prominently with BREAKING: prefix in the output. </step>

</process>

<success_criteria>

  • • Installed version read from .gsd-install-manifest.json
  • • Remote changelog fetched (or graceful fallback to local)
  • • Version comparison displayed clearly
  • • Changes since installed version shown (if any)
  • • Update instructions provided when behind </success_criteria>