| name | multica-artifact-api-sync |
| description | 把 API 接口文档产物对接到接口协作平台(默认 Apifox)。用于 @BackendDev 上传 API 契约,供前端 / 测试下游消费。平台可替换。 |
Artifact · API Contract Sync
Purpose
把 API 接口文档落地到团队统一的接口协作平台,并让下游(前端 / 测试)用稳定方式取回。
本 skill 把「平台对接」与「角色提示词」解耦:角色提示词只说"产出 API 契约",不关心平台。换公司(用 Swagger / Postman / YApi / 内部网关)只改本 skill,不动 @BackendDev 提示词。
默认平台:Apifox
- 产出:API 契约(端点、入参 / 出参、错误码、鉴权、状态机边界)。
- 上传:在 Apifox 维护接口定义,导出 / 同步后把项目 / 接口分组链接作为产物引用。
- 取回:下游 @FrontendDev / @Tester 通过链接读取,链接即稳定引用。
产物内容规范(与角色解耦的部分)
依据阶段约定,API 契约至少包含:端点清单、请求 / 响应 schema、错误码表、鉴权方式、与 BR- 业务规则的对应关系。
用法(角色侧只写这一句)
@BackendDev:「产出 API 契约,用 multica-artifact-api-sync skill 落地到团队接口平台,并回传链接。」
替换平台(不改角色提示词)
把本 skill 的「默认平台」段替换为你们的工具(Swagger / YApi / Postman / 内部网关),保持「上传 + 回传稳定链接」接口不变即可。
为什么有效
接口平台各团队不同,把平台名写进角色提示词会固化它;下沉到 skill 后,角色保持「产出什么内容」的稳定描述,平台随 skill 替换。