SuperAPI AI 工具集

rayfin-getting-started

通用与其它

查看项目

更新于 10-16 06:47

技能介绍

用途:该技能只负责“起步”,把工作区从零带入可运行的 Rayfin 项目,然后交接给项目内技能,不处理 schema、认证、存储、查询与部署等后续内容。

主要能力:判断当前目录是否已是 Rayfin 项目(存在 rayfin/rayfin.yml,或 package.json 依赖 @microsoft/rayfin-*;仅工作区环境信号也足够);区分三种情况——已在项目中、已有非 Rayfin 应用、空目录;对空目录执行脚手架,对已有应用就地集成 Rayfin。

使用方式:空目录脚手架命令保持原样:npx -y @microsoft/create-rayfin@latest --project-name <app-name> --template blankapp。向已有目录加入 Rayfin:npx -y -p @microsoft/rayfin-cli@latest rayfin init --project-name <app-name> [directory]。应使用内置 blankapp 模板,不要浏览模板库或选领域专用模板。注意项目根:create-rayfin 会创建以项目名 slug 化的子目录,需 cd 进入;就地 init 则在当前目录。到达项目根后,若模板带能力路由器先读 AGENTS.md,再加载 .agents/skills/rayfin/SKILL.md。

交接与限制:进入项目后立即以项目内 .agents/skills/rayfin/SKILL.md、node_modules 包文档与 rayfin docs CLI 为准,并停止使用本技能。Rayfin 细节按项目版本锁定,禁止凭记忆回答 API 或语法;仅在无法读取项目内技能文件且无法运行 rayfin docs 时才视为被阻塞,此时应说明需要这些来源后停止,不要给出“通用做法”或示例代码。切勿创建嵌套或同级项目。