跳到正文
TakoAPI
返回技能列表

jarvis-api-contract-guard-01

由 xammarie 提供

Browser & Automation
387下载量由 clawskills.sh 提供
0浏览量
0 个赞登录后即可为这个技能点赞
—暂无评分
你的评分

简介

Design and verify API contracts for backward compatibility.

描述

该技能的功能

A structured workflow for designing and verifying API contracts with a focus on backward compatibility. Takes code, docs, and constraints as inputs, runs through defined checkpoints with quality gates, and returns prioritized findings with a concrete action plan.

The checkpoint-and-quality-gate structure forces evidence-backed claims and explicit tradeoffs, reducing the chance that risky changes ship without a documented fallback.

何时使用

  • Checking an API change for breaking changes before merging
  • Turning informal notes into a ranked action plan with acceptance criteria
  • Reviewing a public endpoint refactor with rollback options documented
  • Planning a deprecation timeline with owner and ETA per step
  • Auditing a third-party integration contract before a release

示例工作流

输入

User asks: Here's my updated /payments endpoint diff. Check it for backward compatibility issues and give me an action plan.

智能体
  1. 1

    Defines success criteria: no breaking changes to existing consumers

  2. 2

    Identifies the smallest-valid execution path by listing all changed request/response fields

  3. 3

    Executes checkpoints: compares old and new schemas, flags removed fields and changed types

  4. 4

    Applies quality gates: confirms findings are evidence-backed and assumptions are explicit

  5. 5

    Returns ranked findings, a today/this-week action plan, risks with mitigations, and a checklist of exact fixes

输出

A prioritized list of compatibility issues, each with impact rating, a concrete fix or migration step, and a fallback if the primary plan fails

安装

clawhub install xammarie/jarvis-api-contract-guard-01

运行 CLI 命令,或把这段提示词粘贴到 Claude Code、Cursor、Codex 或你在用的任意编程智能体里。

链接