init

README.md

-# custom-skills
+# Eazybot 智能体技能开发模板
+
+这是一个基于 Python `FastAPI` 的演示项目，提供“智能体技能开发模板”的最小服务能力：
+
+1. 用 `GET /` 返回开发引导文案（包含可下载地址）
+2. 用 `GET /download` 下载打包好的 `.skill` 压缩包
+
+## 目录结构
+
+- `skills/`
+  - 你需要在该目录下自行创建子目录（例如：`weather-query/`）
+  - 每个子目录对应一个技能的开发产物
+
+## 开发与打包
+
+1. 在 `skills/` 下创建技能子目录，并完成你的技能开发
+2. 运行打包命令：
+   - 默认打包第一个子目录：`make skill`
+   - 指定打包某个子目录：`make skill SKILL_DIR=weather-query`
+
+打包结果会生成到 `skills/` 下，并重命名为：
+
+- `skills/<技能目录名>.skill`
+
+（本质上是 zip 压缩包，文件后缀为 `.skill`。）
+
+## 下载技能
+
+1. 默认下载第一个 `.skill` 文件：
+   - `GET /download`
+2. 指定下载某个技能文件（传参）：
+   - `GET /download?skill=weather-query`
+   - 或 `GET /download?skill=weather-query.skill`
+
+## 说明
+
+- 如果 `skills/` 目录不存在，或目录下没有任何技能子目录/`.skill` 文件，接口会返回对应错误提示。