HackerTrip CLI + Skills
终端里的黑客松入口
一套开源命令行工具 + Claude Code skills：选手扫描本地项目找比赛、一条命令把作品发到个人主页；主办方丢一张海报就能提交赛事，审核后在网站与微信小程序双端触达选手。
npx hackertrip --help🎒 选手：三步发布你的作品
全程不需要账号密码——靠小程序生成的一次性配对码（30 分钟失效）鉴权，repo 扫描 100% 在本地完成。
免安装运行 CLI
npx hackertrip --help需要 Node.js ≥ 18，npx 每次自动拉取最新版，不用全局安装。想先找比赛？在项目目录里跑 npx hackertrip match，AI 会按你的技术栈匹配最适合的黑客松。
小程序生成配对码
打开 HackerTrip 微信小程序 → 我的 → Skills 同步 → 生成配对码，得到 6 位配对码和同步凭证，按页面提示设置环境变量。
一条命令发布作品
npx 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 与微信小程序双端展示。
免安装运行 CLI
npx hackertrip --help需要 Node.js ≥ 18，npx 每次自动拉取最新版，不用全局安装。
小程序复制凭证
打开 HackerTrip 微信小程序 → 发布赛事 → 让 AI 帮我提交（需先通过组织者认证），拿到主办方编号和提交密钥。密钥长期有效、可随时重置，提交会绑定到你的主办方账号。
提交赛事
npx hackertrip submit-event \
--organizer-no HT-XXXXXX --submit-key 你的密钥 \
--from event.jsonevent.json 用云端字段名（name、city、startDate、endDate、website、registrationUrl、contactEmail、cover…）， 与小程序指令模板一致，也可以用 --name / --city / --start / --end / --website 逐项传。必填四件套：名称 + 起止时间 + 城市 + 官网。奖金、日期不确定就留空，不要编造——提交经过准入门槛与格式双层校验。
⚡ 丢一张海报给 AI
装好主办方 skill 后，把活动海报图丢给 Claude 说「帮我把这个黑客松发到 HackerTrip」，AI 自动 OCR 整理字段并提交。
npx hackertrip install-skills --organizer📡 跟踪审核状态
提交后随时在终端查询审核进度、待补充项和审核备注。
npx hackertrip event-status --organizer-no HT-XXXXXX --submit-key 你的密钥🔐 配对码与安全
- · 全程不需要账号密码，靠小程序生成的一次性配对码 + 凭证鉴权
- · 配对码 30 分钟一次性失效，泄露风险极低
- · 选手 repo 扫描在本地完成，只上传你确认要发布的字段
- · 作品同步后处于「待审核」，必须本人在小程序预览确认才公开