# Gameshot — Agent Skill

不用记接口，也不用写代码。让支持 Agent Skills（`SKILL.md`）的工具直接用中文查询 [Gameshot](https://gameshot.games)：最新精选、关键词动态、当前热点和事件来龙去脉、游戏日报。

**装一次，以后不用再更新。** 查什么、怎么整理都在 Gameshot 服务器上完成；Skill 只负责提问和转述。Gameshot 以后新增的能力，已经装好的 Skill 会自动用上。适合 Claude Code、Codex、Gemini CLI、OpenCode 等支持 Agent Skills 的客户端。

基础能力长期保持匿名、只读、无需 API Key。本 Skill 遵循公开使用规则：个人非商业、公益非商业和组织内部使用免费；任何面向外部的商业产品、收费服务、客户交付、代理接口、数据转售、公开镜像或批量公开再分发，须事先取得书面授权。

## 安装前可审阅

- [SKILL.md](https://gameshot.games/gameshot-skill/SKILL.md)
- [安装包清单](https://gameshot.games/gameshot-skill/manifest.sha256)
- [install.sh](https://gameshot.games/gameshot-skill/install.sh)

安装包只有 3 个文件：

```text
SKILL.md
LICENSE
agents/openai.yaml
```

## 让 Agent 安装

把这段话发给你的 Agent（接入页会自动带上可选的 `--actor`）：

```text
请安装 Gameshot Skill：https://gameshot.games/gameshot-skill/README.md
装完告诉我是否需要开启新会话。
```

安装器会先校验完整包，不覆盖别家 Skill，发现旧副本会先停下来问你。

给 Agent 的做法：

- 能运行 Bash（macOS、Linux、WSL、Windows 上的 Git Bash）：用下面的安装命令，Claude Code 用 `--target claude`，其它支持 Agent Skills 的工具用 `--target agents`。
- 不能运行 Bash（例如 Windows 原生 PowerShell / CMD）：不要把 Bash 命令粘贴到 PowerShell。按 [安装包清单](https://gameshot.games/gameshot-skill/manifest.sha256) 从 `https://gameshot.games/gameshot-skill/<文件名>` 下载其中 3 个文件，逐个核对 SHA-256，放进当前 Agent 实际读取的 skills 目录下名为 `gameshot` 的文件夹，整体替换里面的旧内容。

## 命令行安装

以下 Bash 命令适用于 macOS、Linux、WSL 与 Windows 上的 Git Bash。脚本不会猜测平台，必须显式指定 `--target` 或 `--dir`，无参数只显示帮助并退出。清单 `manifest.sha256` 使用 LF 行尾；安装器也会忽略行尾的 `\r`。

Skill 正文安装到 Agent Skills 通用目录 `~/.agents/skills/gameshot`（Codex、Gemini CLI、GitHub Copilot、OpenCode 共用）：

```bash
bash <(curl -fsSL https://gameshot.games/gameshot-skill/install.sh) --target agents
```

Claude Code 按官方约定从 `~/.claude/skills` 发现个人 Skill；下面的命令把正文装到通用目录，再建一个指向同一实体的兼容软链，不复制第二份：

```bash
bash <(curl -fsSL https://gameshot.games/gameshot-skill/install.sh) --target claude
```

装到自定义目录：

```bash
bash <(curl -fsSL https://gameshot.games/gameshot-skill/install.sh) \
  --dir "$HOME/path/to/skills/gameshot"
```

安装器先把完整包下载到同一磁盘的临时目录，逐文件验证 SHA-256 与 Skill 身份，全部通过后才一次替换目标目录。人类说明 `README.md` 不会放进 Skill 安装目录。

安装器会在本地生成 `.gameshot-actor-id`（权限 `0600`），更新时保留。它是可轮换的随机 UUID，仅用于把同一直接消费实例跨网页、Skill、MCP、RSS 与 API 去重，不是账号、API Key 或授权。从 Gameshot 接入页复制命令时可用 `--actor <uuid-v4>` 与其它渠道复用同一随机假名标识；不传也能正常使用。不希望参与跨渠道分析，就在安装命令后追加 `--no-actor`：安装器会保存本地退出标记，后续更新与旧目录迁移都不会重新生成 Actor，以后显式传入 `--actor <uuid-v4>` 才会重新加入。安装器还会在本地生成只忽略这两个文件的 `.gitignore`，避免项目级安装时误提交。

## 安装后验证

1. 重启 Agent 或开启新会话。
2. 让 Agent 列出它发现的 skills，确认只有一份 `gameshot`。
3. 提问：`过去 24 小时游戏圈最重要的 5 件事是什么？`
4. 也可以直接输入 `gameshot`（`gamesoft` 同样可以）。这会读取游戏日报。

成功的回答会写明时间范围，给出中文摘要，并把标题链接到 Gameshot 站内阅读页。

## 能查询什么

Gameshot 目前能查的全部内容，以 [给 Agent 的使用说明](https://gameshot.games/api/v1/agent) 为准；新能力会先加在那里。现在包括：

- 过去 24 小时或最近 7 天的精选与全部公开动态，可按发售、行业、爆料、评测、电竞、优惠分类。一手来源用单独的筛选，不占分类。
- 游戏、平台、厂商和话题关键词（最近 7 天）。
- 现在最热的多源事件，以及每个事件的最新进展、报道时间线和综述。
- 最新或指定日期的游戏日报。只输入 `gameshot` 或 `gamesoft` 也会打开最新一期。

超过 7 天的历史搜索暂不保证。周报和月报按期读取，地址写在使用说明里。

## 不装 Skill 也能用

- 让 Agent 读 [https://gameshot.games/api/v1/agent](https://gameshot.games/api/v1/agent)，按里面的说明查询。
- 支持远程 MCP 的客户端可以接 `https://gameshot.games/api/mcp`，工具返回的内容与上面相同。

## 内容、许可与署名

- `LICENSE` 中的 MIT License 只覆盖 Skill 指令与随附文件。
- Gameshot 服务与数据输出适用 [Gameshot 公开使用规则](https://gameshot.games/terms)。匿名、无需 API Key 只说明技术访问方式，不代表所有用途均获许可。
- 第三方原文及全文版权仍归原作者，不因经过 Gameshot 而改变。
- 个人非商业、公益非商业和组织内部使用免费。面向外部的商业产品、收费服务、客户交付、代理接口、数据转售、公开镜像、批量公开再分发或对外模型产品须先取得书面授权；仅标注「数据来源：Gameshot」不代表已取得授权。
- 商业授权联系站点运营者。attribution 与 canonical 继续用于机器识别和追溯；重要引用回第三方原文核对。

详细接入文档：[gameshot.games/agent](https://gameshot.games/agent)

反馈：[gameshot.games/feedback](https://gameshot.games/feedback)