HackerTrip CLI + Skills

终端里的黑客松入口

一套开源命令行工具 + Claude Code skills:选手扫描本地项目找比赛、一条命令把作品发到个人主页;主办方丢一张海报就能提交赛事,审核后在网站与微信小程序双端触达选手。

npx hackertrip --help

🎒 选手:三步发布你的作品

全程不需要账号密码——靠小程序生成的一次性配对码(30 分钟失效)鉴权,repo 扫描 100% 在本地完成。

1

安装 CLI

npm i -g hackertrip

需要 Node.js ≥ 18。想先找比赛?在项目目录里跑 hackertrip match,AI 会按你的技术栈匹配最适合的黑客松。

2

小程序生成配对码

打开 HackerTrip 微信小程序 → 我的 → Skills 同步 → 生成配对码,得到 6 位配对码和同步凭证,按页面提示设置环境变量。

3

一条命令发布作品

hackertrip publish-work \ --pair-code 你的配对码 \ --demo "https://your.demo.app" \ --awards "2026 AdventureX 最佳人气奖"

项目名、技术栈、描述、仓库地址会自动从 repo 扫出来,你只补机器抓不到的。发布后回小程序 我的 → 作品 预览确认,点『发布』即公开到个人主页。

⚡ 让 AI 帮你跑全程

装好选手 skill 后,在 Claude Code 里直接说「帮我把作品发到 HackerTrip」,AI 会自动扫描、追问补全、自检格式、执行发布。

npx hackertrip install-skills --player

📣 主办方:三步提交你的赛事

提交进入绑定账号的草稿箱,平台人工审核后上架——审核通过即在 hackertrip.space 与微信小程序双端展示。

1

安装 CLI

npm i -g hackertrip
2

小程序生成提交码

打开 HackerTrip 微信小程序 → 主办方后台 → 生成提交码(需先通过组织者认证),提交会绑定到你的主办方账号。

3

提交赛事

hackertrip submit-event \ --pair-code 你的提交码 \ --name "AdventureX 2026 黑客松" \ --city "杭州" \ --start 2026-07-25 --end 2026-07-27 \ --website "https://adventure-x.org"

必填四件套:名称 + 起止时间 + 城市 + 官网。奖金、日期不确定就留空,不要编造——提交经过准入门槛与格式双层校验。

⚡ 丢一张海报给 AI

装好主办方 skill 后,把活动海报图丢给 Claude 说「帮我把这个黑客松发到 HackerTrip」,AI 自动 OCR 整理字段并提交。

npx hackertrip install-skills --organizer

📡 跟踪审核状态

提交后随时在终端查询审核进度、待补充项和审核备注。

hackertrip event-status --pair-code 你的提交码

🔐 配对码与安全

  • · 全程不需要账号密码,靠小程序生成的一次性配对码 + 凭证鉴权
  • · 配对码 30 分钟一次性失效,泄露风险极低
  • · 选手 repo 扫描在本地完成,只上传你确认要发布的字段
  • · 作品同步后处于「待审核」,必须本人在小程序预览确认才公开