claude2master
所有 Skills
Lurus 编辑部代码

Skill

api-contract-keeper

跨服务 API 契约维护 — proto / OpenAPI / REST diff 自动检查破坏性。

触发条件

改 *.proto / openapi.yaml / handler/*_handler.go 时触发。

安装命令

# Lurus 编辑部 demo skill — 复制下文 SKILL.md 到本地
mkdir -p ~/.claude/skills/api-contract-keeper
# 把 README 里的 SKILL.md 内容粘贴到:
#   ~/.claude/skills/api-contract-keeper/SKILL.md

检查

  1. 字段删除 / 改名 / 改类型 = 破坏性
  2. enum 减值 = 破坏性
  3. required → optional = 兼容
  4. 加新字段 = 兼容

破坏性改动会要求：

  • 列出受影响的下游服务（查 doc/coord/contracts.md）
  • 给出 deprecation 计划（v1 → v2 双跑期）
  • 写 changelog 到对应 service-status
在 Forge 里跑这个 skill →
来源：Lurus 编辑部
contractapiproto