@linkl/link-openapi-skills 0.0.0-stage → 0.1.0

package/skills/link-openapi-integration/references/settlement-service.md

@@ -0,0 +1,9 @@
+# 结算服务
+
+链路 ERP 结算 API：运费查询、可用产品查询、账户余额查询。
+
+| operationId | Method | Path |
+|---|---|---|
+| `queryPrice` | POST | `/openapi/queryPrice` |
+| `fetchAvailableProducts` | POST | `/openapi/fetchAvailableProducts` |
+| `balance` | POST | `/openapi/balance` |

package/skills/link-openapi-integration/references/user-service.md

@@ -0,0 +1,9 @@
+# 用户服务
+
+链路 ERP 用户服务 API：OAuth 登录、获取收货仓库、获取海外仓仓库。
+
+| operationId | Method | Path |
+|---|---|---|
+| `oauthLogin` | POST | `/openapi/oauthLogin` |
+| `getReceiveWarehouse` | POST | `/openapi/getReceiveWarehouse` |
+| `getOwmsWarehouse` | POST | `/openapi/getOwmsWarehouse` |

package/skills/link-settlement-service/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: link-settlement-service
+description: >
+  链路 ERP 结算 API：运费查询、可用产品查询、账户余额查询。
+  当用户需要调用该模块接口、生成 Java 接入代码或排查接口问题时使用。
+---
+
+# LINK 结算服务 Skill
+
+## 使用规则
+- 先阅读 `references/api-reference.md`，再选择接口。
+- 真实请求字段、必填项、枚举和响应结构必须以官方 OpenAPI 定义为准，不得猜测。
+- 所有接口使用服务端配置注入的 `linkToken` Header；不要把 Token 作为模型参数。
+- 部分请求体中的 `customerKey` 是业务字段，不等同于 `linkToken`。
+- 检查响应业务码，不要只凭 HTTP 200 判断成功。
+- 创建、取消、删除、上传、打印、推送等有副作用的操作，必须确认用户意图。
+- 非幂等请求失败后不得盲目重试；先检查业务结果。
+
+## Java 代码规范
+- Java 17+、Jackson、Lombok。
+- 密钥从环境变量、密钥管理服务或租户凭证库读取。
+- 金额、重量、尺寸等数值按 OpenAPI 类型处理，避免不必要的浮点精度损失。

package/skills/link-settlement-service/references/api-reference.md

@@ -0,0 +1,22 @@
+# LINK 结算服务 API 参考
+
+- OpenAPI：`3.0.1`
+- Server：`https://www.linkl.com.cn`
+- 接口数：3
+
+> 本文件从对应 Swagger JSON 提取。请求字段和响应结构应以随包 OpenAPI 原文件为准。
+
+## 查价
+
+- operationId：`queryPrice`
+- 请求：`POST /openapi/queryPrice`
+
+## 获取可用服务产品
+
+- operationId：`fetchAvailableProducts`
+- 请求：`POST /openapi/fetchAvailableProducts`
+
+## 查询余额
+
+- operationId：`balance`
+- 请求：`POST /openapi/balance`

package/skills/link-user-service/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: link-user-service
+description: >
+  链路 ERP 用户服务 API：OAuth 登录、获取收货仓库、获取海外仓仓库。
+  当用户需要调用该模块接口、生成 Java 接入代码或排查接口问题时使用。
+---
+
+# LINK 用户服务 Skill
+
+## 使用规则
+- 先阅读 `references/api-reference.md`，再选择接口。
+- 真实请求字段、必填项、枚举和响应结构必须以官方 OpenAPI 定义为准，不得猜测。
+- 所有接口使用服务端配置注入的 `linkToken` Header；不要把 Token 作为模型参数。
+- 部分请求体中的 `customerKey` 是业务字段，不等同于 `linkToken`。
+- 检查响应业务码，不要只凭 HTTP 200 判断成功。
+- 创建、取消、删除、上传、打印、推送等有副作用的操作，必须确认用户意图。
+- 非幂等请求失败后不得盲目重试；先检查业务结果。
+
+## Java 代码规范
+- Java 17+、Jackson、Lombok。
+- 密钥从环境变量、密钥管理服务或租户凭证库读取。
+- 金额、重量、尺寸等数值按 OpenAPI 类型处理，避免不必要的浮点精度损失。

package/skills/link-user-service/references/api-reference.md

@@ -0,0 +1,22 @@
+# LINK 用户服务 API 参考
+
+- OpenAPI：`3.0.1`
+- Server：`https://www.linkl.com.cn`
+- 接口数：3
+
+> 本文件从对应 Swagger JSON 提取。请求字段和响应结构应以随包 OpenAPI 原文件为准。
+
+## oauth登录
+
+- operationId：`oauthLogin`
+- 请求：`POST /openapi/oauthLogin`
+
+## 获取收货仓库
+
+- operationId：`getReceiveWarehouse`
+- 请求：`POST /openapi/getReceiveWarehouse`
+
+## 获取海外仓仓库
+
+- operationId：`getOwmsWarehouse`
+- 请求：`POST /openapi/getOwmsWarehouse`