Token导航 LogoToken导航TokenDH.com
中转站排行榜
开发需要联网github未标认证来源可访问许可证需确认审计通过

branch-api-diff-design（branch API diff 设计）

Agent Skill

用于辅助 API 设计、接口文档、请求响应结构和服务集成说明。它适合让 Agent 梳理 endpoint、生成 OpenAPI 草稿、检查字段命名、整理错误码或辅助前后端联调。使用时需要确认真实业务语义、鉴权方式、分页和错误处理规则；涉及生成接口文档时，应避免凭空补字段，最好从现有代码、schema 或接口样例中提取事实。

总安装

212

周安装

9

GitHub Stars

公开资料未说明

下载量

74
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息，不托管安装包，也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：branch-api-diff-design（branch API diff 设计）
来源仓库：https://github.com/elliothughes/mix_skills
仓库路径：skills/branch-api-diff-design
安装命令：
npx skills add https://github.com/elliothughes/mix_skills --skill branch-api-diff-design
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

skills.shnpx skills
npx skills add https://github.com/elliothughes/mix_skills --skill branch-api-diff-design

简介

branch-api-diff-design 辅助 API 接口设计与变更风险评估，提供 OpenAPI 草稿生成与字段命名一致性检查。

  • 适用于分支合并至主干前的接口审查、参数变更分析及前后端联调支持，聚焦控制器与服务层改动。
  • 自动识别 modules/*/controllers、validator 等关键目录，输出标准化变更说明与错误码映射表。
  • 依赖 git diff 获取变更上下文，需确认目标分支与远程仓库可达性，禁止在无 issue 关联时创建 PR。
  • 适用宿主包括 Codex、Claude、Cursor、Gemini CLI，接入前应确认版本、权限和运行环境要求。

SKILL.md

Branch API Diff Design Skill

语言规范

  • 默认输出语言：zh-CN
  • 所有技术分析、风险评估、工时评估使用中文
  • 所有错误 message 必须为 en-US
  • 严禁输出中文错误 message
  • 输出必须结构化、可直接用于技术评审

使用场景

当出现以下情况必须使用本 Skill：

  • 分支准备合并至 master
  • 涉及接口变更
  • 涉及参数变更
  • 需要做风险与工时评估

执行步骤

Step 1

git fetch origin

Step 2

git diff --name-status origin/master...HEAD

分析优先级

必须按顺序分析：

  1. controllers
  2. validator
  3. services
  4. models
  5. response/ErrorCode.php
  6. config
  7. 其他文件

重点目录

  • modules/*/controllers/
  • modules/*/validator/
  • modules/*/services/
  • modules/common/models/
  • response/ErrorCode.php
  • config/

输出结构（强制）

接口变更分析文档

仅允许输出以下三部分，禁止追加背景、数据库、错误码、部署方案、合并建议等无关章节。

一、接口改动变更说明

必须逐个接口输出，且每个接口必须包含以下信息：

  1. 模块 / 控制器 / 方法
  2. 准确 URL（含路由路径）
  3. HTTP Method（若代码中可判定）
  4. 变更类型：新增 / 修改 / 删除
  5. 参数变化：新增 / 删除 / 必填改动 / 类型改动 / 默认值改动 / 校验规则改动
  6. 响应变化：顶层结构、data 字段、字段类型、字段语义、错误码变化
  7. 兼容性结论：兼容 / 不兼容

先输出汇总表：

| 模块 | 控制器 | 方法 | URL | Method | 变更类型 | 参数变化 | 响应变化 | 兼容性 |

再按接口输出详细对比：

1. <controller>/<action>

  • URL: /api/xxx/xxx
  • Method: GET/POST
  • 变更类型：修改
  • 参数变化：

旧版本参数

{}

新版本参数

{}
  • 响应变化：

旧版本响应

{ "code": 0, "msg": "", "data": {} }

新版本响应

{ "code": 0, "msg": "", "data": {} }
  • 兼容性结论：明确说明是否影响现有调用方

如果无法从 diff 中直接推导 URL / Method，必须基于 Yii2 控制器路由规则做出最合理推断，并明确标注“推断”。

二、工时评估（资深后端模型）

必须对每个接口单独评估，按资深后端开发 7.5h = 1 人日计算。

Complexity Points 计算

基础类型

  • 新增接口：3
  • 修改接口：2
  • 小范围 bug 修复：1
  • 删除或不兼容修改：4

参数复杂度

  • 1-3 个字段：+1
  • 4-10 个字段：+2
  • 10 或复杂校验：+3

输出变更

  • data 扩展字段：+1
  • 结构变化：+2
  • 错误码体系变化：+2

权限复杂度

  • 普通鉴权：+1
  • 权限模型变化：+2

数据库复杂度

  • 查询：+1
  • 写入/事务：+2
  • 表结构变更：+4
  • 多表复杂关系：+3

外部依赖

  • 跨模块：+1
  • 支付/RPA/客户端协议：+3

不确定性

  • 需求模糊：+2
  • 灰度或兼容复杂：+2

工时映射

CP 1-2：2h CP 3-4：4h CP 5-6：8h CP 7-8：12h CP 9-10：16h CP 11+：24h+

输出表格

| 模块 | 控制器 | 方法 | URL | 变更摘要 | CP | 估时(h) | 人日(7.5h) | 说明 |

最后输出：

  • 总工时（h）
  • 折算人日
  • 是否建议拆分任务（仅从开发工作量角度）

三、风险评估（仅影响范围）

只允许评估“影响范围”，不要展开性能、权限、部署、数据一致性等维度。

输出表格：

| 模块 | 控制器 | 方法 | URL | 风险等级 | 影响范围 | 受影响对象 | 说明 |

评估口径：

  • 风险等级仅允许：低 / 中 / 高
  • 影响范围仅描述波及面，例如：仅后台前端、特定客户端、全部调用方、下游服务
  • 受影响对象必须尽量具体，例如：运营后台、H5、APP、第三方回调、定时任务
  • 若为不兼容修改，必须明确指出需要联动改造的调用方

强制校验清单

  • 只输出三部分内容
  • 每个接口都要给出准确 URL 或显式标注“推断 URL”
  • 每个接口都要给出参数变化与响应变化
  • 工时统一按资深后端 7.5h = 1 人日
  • 风险评估仅讨论影响范围

End

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明，方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

Codex

32.93%
按下载量换算24

Claude

31.69%
按下载量换算23

Cursor

17.07%
按下载量换算13

Gemini CLI

8.45%
按下载量换算6

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API；具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源，正式发布前建议补源仓库或其他目录站核验。

来源信息

GitHub 仓库

github.com

/elliothughes/mix_skills

SKILL.md 来源

github.com

/elliothughes/mix_skills/tree/main/skills/branch-api-diff-design

skills-sh

skills.sh

/elliothughes/mix_skills/branch-api-diff-design

继续浏览同类 Skills

更多开发 Skills（21,746）返回 Skills 目录

上一个 Skill

bramblebear（bramblebear 开发）

bramblebear 用于补充开发相关能力，适合在 OpenClaw 中需要让 Agent 承接开发相关任务时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

branch-name（分行名称）

branch-name 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。