t1yOS/t1y-skills

t1yOS Skills

中文
English

为 AI 编程助手提供的 t1yOS Serverless 平台专业技能包。

简介

t1yOS Skills 是一个专为 AI 编程助手（如 Claude Code、Cursor、Windsurf 等）设计的技能包，为 AI 注入 t1yOS 云操作系统的完整知识，帮助开发者更高效地使用 AI 进行云函数开发、数据库操作、SDK 集成和平台资源管理。

为什么需要这个技能？

t1yOS 是一个独特的 Serverless 平台，它与传统的 Node.js 或主流云平台有显著差异：

- 云函数使用 .jsc 扩展名，而非 .js
- 入口是自由函数 onRequest(ctx)，而非 module.exports
- 模块系统是 require()，不支持 import/export
- 没有 npm 生态，只能使用平台内置模块
- 模板使用 Go 语法，而非 EJS/Pug
- 有专属的安全签名和加密机制

没有 Skills 时，AI 会基于通用的 Node.js/Serverless 经验给出不符合平台规范的建议。使用 Skills 后，AI 能生成直接可用的、符合平台规范的代码。

获取

| 区域 | 仓库地址                                                           |
| ---- | ------------------------------------------------------------------ |
| 国际 | github.com/t1yOS/t1y-skills |
| 国内 | gitee.com/t1yOS/t1y-skills   |

安装

1. 从 GitHub（国内从 Gitee）下载 ZIP 包并解压
2. 将解压后的 t1y-skills 目录放置到对应位置：

| AI 工具               | 安装路径                                          |
| --------------------- | ------------------------------------------------- |
| Claude Code       | ~/.claude/skills/t1yOS/                         |
| Cursor            | 项目根目录 .claude/skills/ 或 .cursor/skills/ |
| Windsurf          | 项目根目录 .claude/skills/                      |
| VS Code (Copilot) | 项目根目录 .claude/skills/                      |

放置后 AI 将自动识别并加载技能，无需额外配置。

技能覆盖

| 领域           | 内容                                                                |
| -------------- | ------------------------------------------------------------------- |
| 云函数开发 | .jsc 文件规范、onRequest 入口、内置模块使用、路由规则、模板渲染 |
| 云数据库   | NoSQL CRUD、SQL-to-BSON、聚合管道、分页、查询操作符                 |
| 安全机制   | HMAC-SHA256 签名、AES-256-GCM 加密、JWT、密码哈希                   |
| MCP Server | 配置方法、工具目录、多 AI 工具适配                                  |
| 客户端 SDK | JS/TS、Android、Swift、Flutter、C#、Go 六平台集成指南               |
| HTTP 常量  | 完整的状态码、方法、MIME 类型参考                                   |

基准测试

使用技能前后的代码生成通过率对比：

| 指标       | 使用技能      | 不使用技能    |
| ---------- | ------------- | ------------- |
| 通过率 | 100% ± 0% | 93% ± 6%      |
| 耗时   | 40.5s ± 10.7s | 43.8s ± 43.8s |
| 稳定性 | 零波动        | 高波动        |

使用技能后通过率从 93% 提升到 100%，且消除了全部执行波动。

项目结构

t1y-os-skills/
├── SKILL.md                    # 主技能文件（触发时加载）
├── README.md                   # 本文件（中文）
├── README.en.md                # 英文 README
├── evals/
│   └── evals.json              # 评估用例
└── references/                 # 参考文档（按需加载）
├── cloud-function.md       # 云函数 API 完整参考
├── database.md             # 数据库 API 完整参考
├── crypto.md               # 加密模块 API 完整参考
├── mcp.md                  # MCP Server 工具参考
├── sdks.md                 # 多平台 SDK 集成指南
├── security.md             # 安全机制详解
└── constants.md            # HTTP 常量完整列表

配合 MCP Server 使用

t1yOS 同时提供 Skills 和 MCP Server 两种 AI 辅助能力：

- Skills（本仓库）：教 AI 怎么写对代码
- MCP Server：让 AI 能直接操作平台

两者配合使用效果最佳——Skills 确保代码正确，MCP 实现一键部署和管理。

MCP Server 配置地址：https://ai.t1y.net/mcp

许可

本项目为 t1yOS 平台官方技能包，随平台文档同步更新。