SuperAPI AI 工具集

add-resource

编程与开发

查看项目

更新于 10-16 08:06

技能介绍

用途:向 ***plain 规范文件添加“链接资源”。链接资源是用 Markdown 链接语法引用的外部本地文件,其内容会随规范一起传给渲染器,为代码生成提供额外上下文。首次使用前应先调用 load-plain-reference 技能获取 ***plain 语法规则。

主要能力:将 JSON Schema、OpenAPI/Swagger、数据转换规则(如 .jolt)、测试夹具、配置示例等文本文件链接进规范;在定义、实现要求、功能规格等章节中通过 Markdown 链接引用。

用法:确认资源文件位于 resources/ 目录或 .plain 文件同目录/子目录;在合适位置添加 Markdown 链接,如 auth schema;路径须相对 .plain 文件位置;回读文件确认链接语法与路径正确。

限制与规则:仅支持同一文件夹或子文件夹内的单个文本文件;不支持绝对路径、外部 URL(http/https/ftp/git/s3/gs 等)、目录路径、二进制文件(图片、PDF、Office 文档、压缩包、音视频、编译产物等)。链接目标若以 / 结尾、含 ://、指向目录或二进制扩展名均无效。.plain 内容中不得出现任何 URL 或文件夹路径,唯一例外是生成软件运行时使用的配置值(如调用基址、数据库连接路径、CLI 参数值)。目录内容若相关,应选取其中最具代表性的单个文件(如 README.md、清单文件)加以链接;URL 内容若必要,应先抓取并保存为 resources/ 下的文本文件;二进制素材应先转写为文本(如截图转为 Markdown 描述或 YAML 线框,PDF 转为 Markdown 摘录或 JSON Schema/OpenAPI,架构图转为 Mermaid)。何时使用:信息过于详细或结构化难以内联、被多处引用、或属于渲染器可直接解释的行业标准格式。何时不用:信息足够短可直接内联,或文件是生成代码(应放 plain_modules/)。

验证清单包括:资源文件存在;目标是磁盘文件而非目录;是本地路径而非 URL;是文本文件而非二进制;周围 .plain 内容无 URL 或文件夹路径(运行时值除外);路径相对而非绝对;文件在同目录或子目录;Markdown 链接语法正确;内容相关且有增益。