Back to Details

api-evolution-manager

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

API Evolution Manager

API Evolution Manager

This skill ensures that your API grows gracefully without breaking downstream consumers.
本技能可确保你的API平稳演进，不会影响下游消费者。

Capabilities

功能

1. Breaking Change Detection

1. 破坏性变更检测

  • Compares current API schemas (OpenAPI, GraphQL) with previous versions.
  • Flags any changes that would break backward compatibility.
  • 对比当前API schema（OpenAPI、GraphQL）与历史版本。
  • 标记任何会破坏向后兼容性的变更。

2. Lifecycle Management

2. 生命周期管理

  • Manages deprecation notices and sunsetting schedules.
  • Automatically generates "Migration Guides" for developers using the API.
  • 管理弃用通知与下线时间表。
  • 自动为使用该API的开发者生成「迁移指南」。

Usage

使用方式

  • "Audit the latest API changes for breaking changes and update the versioning plan."
  • "Generate a migration guide for clients moving from v1.0 to v2.0."
  • "审核最新API变更中的破坏性内容并更新版本规划。"
  • "为从v1.0升级到v2.0的客户端生成迁移指南。"

Knowledge Protocol

知识协议

  • This skill adheres to the 
    knowledge/orchestration/knowledge-protocol.md
    . It automatically integrates Public, Confidential (Company/Client), and Personal knowledge tiers, prioritizing the most specific secrets while ensuring no leaks to public outputs.
  • 本技能遵循
    knowledge/orchestration/knowledge-protocol.md
    。它会自动整合公开、保密（公司/客户）和个人知识层级，优先使用最具体的保密信息，同时确保不会泄露到公开输出中。