为 UOS 云函数开发提供专业支持的 AI 技能集合，包含云函数开发指南和自动化测试页面生成工具。

技能名称	描述
usf-cli	提供全面的 UOS Func Stateless 云函数开发、测试和部署指南
generate-test-web	为函数生成功能测试页面 (test.html) 和 API 文档页面 (instructions.html)

---

• 已安装 OpenCode
• Node.js 运行环境

1. 复制 Skills 到配置目录

# macOS / Linux
cp -r skills ~/.config/opencode/

# Windows (PowerShell)
Copy-Item -Recurse skills ~\.config\opencode\

2. 配置插件

# macOS / Linux
cp .opencode/plugins/usf-cli.js ~/.config/opencode/plugins/

# Windows (PowerShell)
Copy-Item .opencode/plugins/usf-cli.js ~\.config\opencode\plugins\

3. 验证安装

启动 OpenCode 后，可以通过以下方式验证：

• 询问 UOS 云函数开发相关问题，确认 usf-cli 技能已激活
• 使用 skill: "generate-test-web" 命令调用网页生成技能

# 从仓库根目录执行
cp -r skills ~/.config/opencode/
cp .opencode/plugins/usf-cli.js ~/.config/opencode/plugins/

---

• 已安装 Gemini CLI
• 支持 SKILL.md 格式的 AI 助手环境

1. 复制 Skills 到配置目录

# macOS / Linux
cp -r skills ~/.gemini/skills/

# Windows (PowerShell)
Copy-Item -Recurse skills ~\.gemini\skills\

2. 验证安装

启动 Gemini CLI 后，可以通过以下命令验证技能是否加载：

/skills

查看输出中是否包含 usf-cli 和 generate-test-web。

# 从仓库根目录执行
cp -r skills ~/.gemini/skills/

---

该技能会自动加载到系统提示中，无需手动调用。当您需要：

• 设置 UOS 云函数开发环境
• 创建或部署云函数
• 调试云函数问题
• 查询 CRUD 操作示例（MongoDB、Redis、MySQL、PostgreSQL）
• 集成 Multiverse API 或验证 JWT

直接提问即可，例如：

• "如何创建一个连接 MongoDB 的云函数？"
• "帮我部署当前的云函数"
• "云函数本地测试的步骤是什么？"

为函数生成测试页面和 API 文档。

基本用法：

./skills/generate-test-web/scripts/generate_webpage.sh --output-dir ./my-test

自定义参数：

./skills/generate-test-web/scripts/generate_webpage.sh \
  --name "calculateTax" \
  --description "Calculates sales tax for a given amount." \
  --params '[{"name":"amount","type":"number"},{"name":"rate","type":"number"}]' \
  --code 'function userFunction(amount, rate) { return amount * rate; }' \
  --output-dir "./tax-test"

可用参数：

参数	描述	默认值
--name	函数名称	"MyFunction"
--description	函数描述	"A function that does amazing things."
--params	参数定义的 JSON 数组	见示例
--code	函数代码（函数名必须为 userFunction）	见示例
--output-dir	输出目录	. (当前目录)
-h, --help	显示帮助信息	-

---

uos-agent-skills/
├── .opencode/
│   └── plugins/
│       └── usf-cli.js          # OpenCode 插件
├── skills/
│   ├── generate-test-web/      # 测试页面生成技能
│   │   ├── SKILL.md
│   │   ├── assets/
│   │   └── scripts/
│   └── usf-cli/                # 云函数开发技能
│       ├── SKILL.md
│       ├── references/
│       └── scripts/
└── README.md

---

1. 确认 skills 目录已正确复制到目标配置目录
2. 检查 SKILL.md 文件是否存在且格式正确
3. 重启 AI 助手应用

1. 确认插件文件位于 ~/.config/opencode/plugins/
2. 检查 OpenCode 是否启用了插件系统
3. 查看 OpenCode 的日志输出以获取错误信息

---

本项目按原样提供，供 UOS 云函数开发使用。