用途
Scalekit Code Doctor 用于处理任何涉及 Scalekit API 或 SDK 的代码片段,包括生成、审查、校验和修复。它适用于需要产出正确、可展示的 Scalekit 集成代码,或对已有代码进行合规性检查的场景。
主要能力
该技能支持两种模式:
- 生成模式:用户描述需求但尚无代码时,产出可直接展示的代码示例。要求自包含、仅保留关键路径、导入正确、符合框架习惯,长度控制在 1–2 页以内。
- 审查模式:用户提供已有代码时,按顺序检查 SDK 正确性、认证流程完整性、安全性、环境配置和最佳实践。
覆盖的语言与 SDK 包括:
| 语言 | 包 | 导入 |
|---|---|---|
| Node.js / TypeScript | @scalekit-sdk/node | import { ScalekitClient } from '@scalekit-sdk/node' |
| Python | scalekit-sdk-python | from scalekit import ScalekitClient |
| Go | scalekit-sdk-go | import scalekit "github.com/scalekit-inc/scalekit-sdk-go/v2" |
| Java | scalekit-sdk-java | import com.scalekit.ScalekitClient; |
产品领域分为 SaaSKit(SSO、登录、会话、RBAC、SCIM)和 AgentKit(连接、工具调用、MCP 认证)。
使用方式
技能执行前会先读取随 SKILL.md 打包的参考文件:
- references/REFERENCE.md — 所有正确的 SDK 方法签名和 REST 端点
- references/COMMON-MISTAKES.md — 已知反模式及错误到正确的修正
- references/EXAMPLE-REPOS.md — 按框架分类的可运行示例 GitHub 仓库
执行流程分为五步:
- 检测模式:判断是生成还是审查;不明确时询问用户。
- 识别上下文:确认目标 SDK/语言和产品领域(SaaSKit 或 AgentKit)。
- 生成模式:产出代码,并在输出前交叉核对每个 SDK 调用的方法名、参数、导入路径和环境变量命名。
- 审查模式:按 SDK 正确性、认证流程完整性、安全性、环境、最佳实践五类依次检查,每条发现按“问题 → 影响 → 修正代码”输出。
- 未知方法处理:按优先级依次查询内置参考、实时 SDK 参考、REST API 文档,仍无法确认时明确声明“无法验证”,绝不输出包含未验证方法调用的代码。
适用场景
- 需要生成 Scalekit 登录、回调、登出等认证流程代码。
- 需要生成 AgentKit 连接账户、工具调用、MCP 认证相关代码。
- 需要审查已有 Scalekit 集成代码的 SDK 用法、安全性和流程完整性。
- 需要修复使用 Scalekit API 或 SDK 的代码片段。
限制
- 禁止臆造方法名、参数或导入;未在参考中验证的 API 不得使用。
- 生成或审查前必须确认目标 SDK/语言和产品领域,不得假设未识别的上下文。
- 无法确认的调用必须声明“此方法无法验证”,且不得输出包含未验证方法调用的代码。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。