天工开物 Skill

概述

Skill 是一个文件夹，其中的 SKILL.md 用文字说明：在什么情况下查询天工开物，调用哪个接口，拿到数据后如何回答。

安装后，助手遇到「最近有什么 AI 比赛」「某个会员每月多少钱」这类问题时，会调用天工开物的开放接口，而不是凭已有知识作答。所有接口只读，无需登录，也无需 Key。

适用范围

与 AI 比赛、模型、工具、会员无关的问题不在范围内。海外比赛也不在范围内，天工开物只收录国内比赛。

安装

先下载天工开物 Skill 压缩包，解压后把 qiyuan-ai 文件夹复制到助手的 Skill 目录。压缩包包含说明和脚本，无需构建。

Claude Code

按生效范围选择目录：

• 仅当前项目：项目根目录下的 .claude/skills/qiyuan-ai/

• 本机所有项目：用户目录下的 .claude/skills/qiyuan-ai/，Windows 上为 C:\Users\用户名\.claude\skills\qiyuan-ai\

项目级安装时，先把压缩包解压到项目根目录，并在该目录打开终端；用户级安装时，在解压后的文件夹旁打开终端：

# 项目级
mkdir -p .claude/skills && cp -r qiyuan-ai .claude/skills/
# 用户级（macOS / Linux）
mkdir -p ~/.claude/skills && cp -r qiyuan-ai ~/.claude/skills/

复制完成后新开一个会话，提问「最近有什么 AI 比赛」。如果助手开始调用接口，说明 Skill 已生效。

其他助手

其他支持 Skill 的助手，请按各自官方文档确认目录。不支持 Skill 的助手，可以把 SKILL.md 的内容直接发给它，让它按说明查询。

基础地址

Skill 通过环境变量 QIYUAN_BASE_URL 确定请求地址：

BASE="${QIYUAN_BASE_URL:-https://tiangongkaiwuai.cn}"

默认使用正式域名；备案期间该入口可能无法访问。本地调试时先启动本机站点，再设置变量：

export QIYUAN_BASE_URL=http://localhost:3000

通用约定

• 所有接口只读，匿名可用。请求头带上 X-API-Key（Key 须在服务端白名单内）可以提高请求额度。

• 只返回公开内容。草稿、待审、已过期和已归档的内容不会出现。

• 列表接口的响应分为 data、meta、source 三部分：

{
  "data": [],
  "meta": { "total": 12, "page": 1, "pageSize": 20, "generatedAt": "2026-10-05T08:00:00Z" },
  "source": { "name": "天工开物", "site": "https://tiangongkaiwuai.cn", "note": "数据经人工审核，请以 sourceUrls 原始公告为准" }
}

• 每条数据都包含 slug、url（站内页面地址）、updatedAt、verifiedAt（最后一次人工核实的时间）和 sourceUrls（官方来源）。赛道没有核实时间和来源，这两项固定为空。

• 分页使用 page 和 pageSize。pageSize 默认 20，最大 100。

• 日期按北京时间（Asia/Shanghai）计算。daysLeft 表示剩余天数，已过期时为负数。

• 金额按接口返回的原币种表述，人民币写人民币，美元写美元。天工开物不做汇率换算，也不把年付总价除以 12。

• 模型、工具、比赛的 slug 须先从对应的列表接口获取，再查询详情，不要自行拼写。

• 参数和字段的权威说明是 /api/v1/openapi.json。本页与它不一致时，以它为准。

典型问题对照

模型和工具的 slug 来自不同的接口。/api/v1/products/opencode 查询的是 opencode 这个工具，/api/v1/models/{slug} 查询的是某个模型，两者不能互换。

回答要求

Skill 要求助手按下面的规则回答：

1. 回答末尾注明「数据来自天工开物，核实于某月某日」，并附上 sourceUrls 中的官方链接。没有核实时间的数据，写「未注明核实时间」，不补写日期。

2. 接口返回空列表时，回答「目前没有符合条件的记录」，不用已有知识补充。

3. 模型的榜单分来自第三方榜单，引用时写明榜单名称和链接。模型的五项能力分目前为空，不用于比较。工具和会员套餐没有分数。

4. 比较套餐价格时，只在同一币种、同一种购买方式之间比较。官方只给出折合每月价格的，使用官方数字。

5. 涉及报名时间、优惠力度和价格时，提示用户回到来源页面确认。

6. 福利的有效期有四种：长期有效、某天截止、自领取起算若干天、官方未标注截止日期。没有截止日期的福利不能描述为「即将结束」。

限流与错误

匿名请求按 IP 限流，每分钟最多 60 次。超出后返回 HTTP 429，响应头带有 Retry-After，单位为秒。助手应等待相应时间后重试一次，不要连续重试。

错误响应的结构如下：

{ "error": { "code": "...", "message": "...", "details": [] } }

常见问题

助手没有调用接口

请求地址里出现占位符

福利没有截止日期