# hackathon-copilot

Adopt this skill: https://proskills.md/skills/other/sealofyou-hackathon-copilot-skills-hackathon-copilot

Page: https://proskills.md/skills/other/sealofyou-hackathon-copilot-skills-hackathon-copilot
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/hackathon-copilot/SKILL.md
size: 2193
upstream: https://github.com/sealofyou/hackathon-copilot/blob/main/skills/hackathon-copilot/SKILL.md

```text
---
name: hackathon-copilot
description: Use when the user wants to intake hackathon materials, assess whether to participate, or turn a competition opportunity into todos and tasks inside an OpenClaw workflow.
---

# Hackathon Copilot

## 概览

这是整个项目的主 Skill，对外只暴露这一层入口。

它负责两件事：

1. 判断当前该走 A 链路还是 B 链路
2. 调度各子 Skill，把结果统一收束到“情报 -> 待办 -> Task”

## 何时使用

- 用户发来比赛链接、网页、海报、图片、截图、文档
- 用户问“这个比赛值不值得参加”
- 用户想把某个比赛继续推进成待办和任务
- 用户说“主动帮我找适合的比赛并推进”

## 路由规则

### A 链路：资料驱动

当用户已经提供资料时，按这个顺序走：

1. `hackathon-init`
2. `hackathon-intake`
3. `hackathon-web-fetch` 或 `hackathon-image-read`
4. 读图不稳时再走 `hackathon-ocr-fallback`
5. `hackathon-intel-write`
6. `hackathon-recommend`
7. 用户确认继续后走 `hackathon-todo-plan`
8. 进入执行时走 `hackathon-taskify`

### B 链路：主动发现

当用户明确要求主动找比赛时，按这个顺序走：

1. `hackathon-init`
2. `hackathon-discovery`
3. `hackathon-intel-write`
4. `hackathon-recommend`
5. 后续仍复用 `hackathon-todo-plan` 和 `hackathon-taskify`

## 飞书 CLI 落地规则

如果进入飞书落地层，优先使用这些命令：

- 初始化检查：`npm run cli -- feishu:doctor <config-path>`
- 情报写表：`npm run cli -- feishu:intel-upsert <config-path> <payload-path>`
- 待办写表：`npm run cli -- feishu:todo-upsert <config-path> <payload-path>`
- Task 导出：`npm run cli -- feishu:task-bundle <config-path> <payload-path> [output-path]`

## 硬规则

- 不允许绕过情报层直接生成待办
- 没有空闲时间信息时，不要伪造细时间表
- OCR 是兜底，不是默认全量执行
- 不能把别人的数据默认写进你的个人表

## 输出格式

每次输出至少包含：

- 当前走的是 A 还是 B
- 情报是否已经结构化
- 推荐结论
- 是否已经进入待办层
- 是否已经进入 Task 层
- 下一步缺什么
```

## File: README.md
upstream: https://github.com/sealofyou/hackathon-copilot/blob/main/README.md

````text
# Hackathon Copilot

`hackathon-copilot` 的主交付物是一套面向 OpenClaw 的 Skill Suite，不是一套独立业务应用。

这套仓库围绕三层链路展开：

1. 情报层：把比赛链接、网页、图片、海报、文档整理成结构化比赛情报
2. 待办层：结合用户意向和空闲时间，生成个人待办与时间窗口
3. Task 层：把待办继续拆成可执行任务，并输出给后续执行系统

这版仓库已经补上“真实 CLI 接入版”的第一层落地：

- `feishu:doctor`：检查飞书环境变量、表配置、命令面是否齐全
- `feishu:intel-upsert`：把结构化比赛情报写入飞书多维表格
- `feishu:todo-upsert`：把待办计划与任务摘要写入飞书待办表
- `feishu:task-bundle`：导出 Task bundle，交给后续 Task CLI 或执行系统消费

## 仓库结构

- `skills/`
  - 1 个主 Skill + 10 个子 Skill
  - 这是仓库最核心的交付物
- `docs/`
  - 架构、数据流、表结构、飞书 CLI 接入说明
- `templates/`
  - 黑客松情报表与个人待办表模板说明
- `config/`
  - 配置样例与 schema
- `examples/payloads/`
  - 可以直接喂给 CLI 的示例 payload
- `src/`
  - 本地验证、示例管线、飞书 CLI bridge

## 快速开始

安装依赖：

```bash
npm install
```

跑基础验证：

```bash
npm test
npm run check:scaffold
```

查看飞书 CLI 命令规划：

```bash
npm run cli -- feishu:command-plan .\\config\�ser-config.example.json
```

检查当前环境是否具备飞书写入条件：

```bash
npm run cli -- feishu:doctor .\\config\�ser-config.example.json
```

## 真实飞书 CLI 接入

需要先设置环境变量：

```powershell
$env:FEISHU_APP_ID="<your_app_id>"
$env:FEISHU_APP_SECRET="<your_app_secret>"
```

然后在配置里填好两张表的 `appToken` 和 `tableId`：

- `tables.hackathonIntel`
- `tables.personalTodo`

写入比赛情报：

```bash
npm run cli -- feishu:intel-upsert .\\config\�ser-config.example.json .\\examples\\payloads\\intel-payload.example.json
```

写入待办计划：

```bash
npm run cli -- feishu:todo-upsert .\\config\�ser-config.example.json .\\examples\\payloads\\todo-payload.example.json
```

导出 Task bundle：

```bash
npm run cli -- feishu:task-bundle .\\config\�ser-config.example.json .\\examples\\payloads\\todo-payload.example.json .\\examples\\payloads\\task-bundle.example.json
```

## 对 OpenClaw 的定位

如果你要把这套作品交给另一个 OpenClaw 使用，优先复制 `skills/` 目录，而不是把 `src/` 当作主程序。

推荐顺序：

1. 先装 `skills/` 下的 11 个 Skill
2. 再参考 `docs/feishu-cli-integration.md`
3. 最后按需使用 `src/cli.mjs` 的 `feishu:*` 命令做真实落地
````
