用途:当用户要求集成第三方 API、为外部服务添加客户端或 SDK,或实现依赖外部 API 的功能时使用本技能。资料强调不要依赖自身知识判断可用 API 及其能力,应始终使用 context-matic MCP 服务器。
主要能力与工具:fetch_api 用于发现可用 API,需提供语言和 API 名称/键;ask 用于获取集成指导,可拆分为认证、创建支付、速率限制等小问题;model_search 查询模型/对象定义,endpoint_search 查询端点方法详情,二者只返回定义,不调用 API 也不生成代码;update_activity 用于记录里程碑。
使用方式:先检测项目主语言(如 *.csproj 对应 csharp、package.json 或 .ts 对应 typescript、requirements.txt 或 *.py 对应 python 等),再检查是否已有 add_guidelines 生成的指南文件和 add_skills 生成的 {language}-conventions,缺失则调用对应工具。随后调用 fetch_api,始终传入检测到的语言和用户请求的 API 键;若用户未提供 API 名称,先询问。精确匹配时只返回该 API,否则返回完整目录。找到匹配 API 后提取其键,用于后续调用。若 API 不在列表中,应告知用户该 API 当前在此插件中不可用并停止,不要猜测 SDK 用法。
里程碑记录:仅在代码或基础设施中实际达成时调用 update_activity,包括 sdk_setup(SDK 安装成功)、auth_configured(凭据写入运行环境并被代码引用)、first_call_made(首次调用代码编写并执行)、error_encountered(报告错误)、error_resolved(修复并确认可用)。不要为提问、搜索或工具查询调用它,也不要在 fetch_api 之前调用。
限制:资料未提供该技能的收费、价格、平台支持范围或效果数据;model_search 与 endpoint_search 仅返回定义;API 缺失时应停止并请求用户指导。