SuperAPI AI 工具集

create-master-skill

智能体与模型

查看项目

更新于 10-15 10:25

技能介绍

create-master-skill 是一个用于创建 master skill(共享资源库)的系统技能,主要面向需要对接第三方集成的开发场景。它的定位是解决技能之间的重复问题:当 3 个及以上技能共享公共内容(安装配置、API 文档、错误处理、数据结构等)时,把这些内容抽取为一个 master skill,供所有子技能引用,避免多处重复维护。

用途与核心思路 该技能引用了 notion-master 的实践经验:3 个 Notion 相关技能曾存在 950 行重复内容,抽取为 master skill 后缩减为 370 行,实现约 60% 的上下文缩减,并为安装配置、API、错误、schema 提供单一事实来源。

使用方式 用户只需说明需求,例如“create master skill for Airtable”。技能会先询问集成名称(如 airtable、slack、github、linear、google-sheets、stripe),校验名称格式(小写、连字符),检查该集成是否已存在 {integration}-master,然后通过 create-project 技能创建规划项目并推进后续阶段。

强制工作流(不得跳过) 技能明确要求“项目第一、调研第二、构建第三”,并规定必须创建 TodoWrite 覆盖所有阶段。

阶段 0 启动:询问并校验集成名称,创建规划项目。 阶段 1 网络调研(关键):执行 8 类检索,包括 API 官方文档(基础 URL、认证、速率限制)、API 端点参考(关键端点、请求/响应格式)、认证模式(OAuth、API key、令牌刷新)、常用操作(CRUD 示例)、错误处理(错误码、信息、恢复模式)、速率限制(限制、退避策略)、SDK/库(官方 SDK、常用库、安装)、最佳实践(模式、反模式、优化建议)。调研结果保存到指定路径的 research.md。 阶段 2 架构设计:识别将使用该 master 的子技能(查询/搜索、导入/导出、管理、自动化/工作流),定义共享资源(通用安装步骤、复用的 API 模式、跨操作错误、需记录的 schema/类型),规划脚本(配置校验、资源发现、通用工具函数、必要时限流),并记录到 plan.md。 阶段 3 构建:基于模板创建目录结构,包括 SKILL.md、references(setup-guide.md、api-reference.md、error-handling.md 及领域特定文档)、scripts(check_{integration}_config.py、discover_resources.py 及操作脚本)、tests(README.md、run_tests.py),并依据调研结果填充集成特定内容。 阶段 4 验证:运行配置检查与资源发现脚本,核对文档完整性,并至少创建一个引用该 master skill 的子技能。

可作为模板参考的资源包括 SKILL.md、setup-guide.md、api-reference.md、error-handling.md、check_config.py 模板,以及 master-skill-patterns.md、research-checklist.md 参考文档。

成功标准 SKILL.md 明确标注“不可直接加载”;setup-guide.md 覆盖完整的首次安装;api-reference.md 记录关键操作;error-handling.md 覆盖常见错误及解决方案;check_config.py 校验所有必需配置;至少一个子技能成功引用;并测量实现上下文缩减。

适用场景与限制 适用于需要为某第三方集成建立可复用技能库的场景,尤其当多个技能存在内容重复时。该技能强调调研前置与模板化构建,避免因集成差异导致的错误假设。资料中未提供其收费、价格、具体平台依赖或运行环境要求等信息。