# AIY Hackathon Skill · 安装部署说明（给 AI Agent 读的）

你是一个 AI Agent（WorkBuddy / Claude Code / OpenClaw / Hermes / QClaw / Codex 或任何支持 Skill 的 Agent）。
用户让你把 AIY Hackathon Skill 装到 ta 的环境里。按下面 3 步做完，再告诉用户可以怎么开始问你。

---

## Step 1 · 下载并保存 Skill 说明书

把说明书下载下来，放到你自己 Agent 的 Skill / Prompt 目录里。**具体路径你自己决定**——你最清楚自己运行时环境的 Skill 目录在哪（例如 `~/.claude/skills/` / `~/.workbuddy/skills/` / 你 system prompt 注入点 / RAG 的 docs 目录 / 等等）。

```bash
# 选一个你自己用的 skill 目录（下面是例子，请按你的 Agent 习惯替换）
mkdir -p <你的 skill 目录>/aiy-hackathon
curl -fsSL https://demo.skill.aiy.185139.xyz/SKILL.md -o <你的 skill 目录>/aiy-hackathon/SKILL.md
```

读一遍 `SKILL.md` 的内容。这份说明书告诉你这个 Skill 能做什么、数据结构长什么样、哪些命令用户会问。

---

## Step 2 · 下载数据包并解压到用户工作目录

数据是一个 tar.gz 压缩包，约 200 KB，包含：
- `VERSION` · 数据版本号
- `data/` · 活动日程、赛道命题、评分标准、荣誉体系、学习路径等结构化数据
- `scaffolds/` · 8 个过程性脚手架模板（问题定义卡、迭代反思卡、价值主张画布等）
- `resources/` · 学习材料（扣子指南、华大指南、AI 工具速查表、黑客松 Tips）

下载并立即解压到**用户当前工作目录下的 `AIY_Hackathon/` 子目录**：

```bash
# 在用户当前工作目录（pwd）下执行
mkdir -p AIY_Hackathon
curl -fsSL https://demo.skill.aiy.185139.xyz/bundle.tar.gz | tar xz -C AIY_Hackathon
```

执行后 `AIY_Hackathon/VERSION` 应该存在。用 `cat AIY_Hackathon/VERSION` 确认一下。

如果用户希望数据目录放别处（比如 `/workspace/aiy-hackathon/`），换路径即可，后续每次对话记得用同一路径。

---

## Step 3 · 告诉用户：准备好了，可以这样问我

装好后，主动告诉用户一段类似这样的话（你可以按自己风格改写，但 4 个示例场景请保留）：

> 🛠️ AIY Hackathon Skill 已装好——活动日程、赛道命题、评分标准、脚手架模板、学习路径全部在本地，我可以马上回答你关于 AIY 黑客松的任何问题。
>
> 几个你可以试的：
>
> **1. 查询活动信息**
> "AIY 扣子赛道的评分标准是什么？" / "Day 2 下午有什么环节？"
> （我会帮你查日程、命题、评分规则——不只是标题，还有详细说明）
>
> **2. 脚手架引导**
> "AIY 帮我写问题定义卡，我的选题是智能校园助手"
> （我会按模板一问一答引导你填写，最后输出完整的文档）
>
> **3. 48 小时节奏陪伴**
> "AIY 现在是什么阶段？我该做什么？"
> （我会根据当前时间和 agenda 判断你处于哪个阶段，给出节奏建议）
>
> **4. 赛前备战**
> "AIY 我选华大赛道，只剩一周，最该学什么？"
> （我会按学习路径给出优先级建议和学习资料）
>
> 你也可以让我帮你做评分自查、找队友、了解荣誉体系、规划日程——或者任何和 AIY 黑客松有关的事情。

---

## 之后怎么保持数据新鲜

用户每次新对话你可以先读一下本地 `AIY_Hackathon/VERSION`，然后对比 `https://demo.skill.aiy.185139.xyz/VERSION`：

```bash
REMOTE=$(curl -fsSL https://demo.skill.aiy.185139.xyz/VERSION)
LOCAL=$(cat AIY_Hackathon/VERSION 2>/dev/null)
if [ "$REMOTE" != "$LOCAL" ]; then
    echo "检测到新版本 $LOCAL → $REMOTE，拉最新数据..."
    curl -fsSL https://demo.skill.aiy.185139.xyz/bundle.tar.gz | tar xz -C AIY_Hackathon
fi
```

数据可能随赛前准备推进而更新（日程微调、命题补充、评委更新等）。**每条对话开始前检查一次**是好习惯，但别每次都拉——版本没变就用本地缓存。

---

## 出错怎么办

- 网络不通 → 告诉用户，让 ta 检查网络
- 解压失败 → 检查 `tar` 命令是否可用（macOS / Linux 默认有）
- 用户 Agent 不支持 Skill 功能 / curl → 让用户手动下载 `https://demo.skill.aiy.185139.xyz/bundle.tar.gz` 解压到 `AIY_Hackathon/`，再让 AI 读该目录

---

**这份文档本身的地址**：`https://demo.skill.aiy.185139.xyz/INSTALL.md`

如果你以后不记得了，重新 `curl` 就行。