api-changelog-versioning

仓库创建 2025年11月8日最近提交 29 天前SkillHot 收录 22 天前

▸ 精选理由

帮助团队规范对外变更通知与兼容性迁移，降低用户升级成本。

这个 Skill 做什么

为 API 管理生成详尽的变更日志、破坏性变更与迁移策略文档。

把 API 的每次变更做成可读的 Changelog，清晰标注 Breaking Changes、弃用项和逐步迁移步骤，附版本号与时间线。对外发布新版本或通知客户端升级时用，帮助开发者快速定位需要改动的点。优点是把复杂变化拆成具体迁移步骤，减少沟通摩擦与升级风险。

▸ 展开 SKILL.md 英文原文

Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers. Use when managing API versions, communicating breaking changes, or creating upgrade guides.

开发编程变更日志版本管理迁移指南通用

180

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/secondsky/claude-skills/main/plugins/api-changelog-versioning/skills/api-changelog-versioning/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/secondsky/claude-skills/main/plugins/api-changelog-versioning/skills/api-changelog-versioning/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# API Changelog & Versioning

Document API changes with clear migration paths and deprecation timelines.

## Changelog Structure

```markdown
# API Changelog

## v3.0.0 (2025-01-15) - Breaking Changes

### Breaking Changes
- Response format now follows JSON:API specification
- Authentication switched from API tokens to JWT Bearer

### Migration Steps
1. Update base URL to `/api/v3`
2. Replace `Authorization: Token xxx` with `Authorization: Bearer xxx`
3. Update response parsing for new envelope format

## v2.5.0 (2024-12-01) - Features

### New Features
- Webhook support for order events
- Batch operations endpoint
- Field filtering via `?fields=` parameter

### Improvements
- 56% faster res

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有