hackathon-copilot

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

快速开始

安装依赖：

npm install

跑基础验证：

npm test
npm run check:scaffold

查看飞书 CLI 命令规划：

npm run cli -- feishu:command-plan .\\config\\user-config.example.json

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

npm run cli -- feishu:doctor .\\config\\user-config.example.json

真实飞书 CLI 接入

需要先设置环境变量：

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

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

• tables.hackathonIntel
• tables.personalTodo

写入比赛情报：

npm run cli -- feishu:intel-upsert .\\config\\user-config.example.json .\\examples\\payloads\\intel-payload.example.json

写入待办计划：

npm run cli -- feishu:todo-upsert .\\config\\user-config.example.json .\\examples\\payloads\\todo-payload.example.json

导出 Task bundle：

npm run cli -- feishu:task-bundle .\\config\\user-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:* 命令做真实落地