# Maritime Radar — Agent Skill

让支持 Agent Skills（`SKILL.md`）的工具直接用中文查询 Maritime Radar：最新航运动态、关键词、当前热点和事件来龙去脉、日报、周报与月报。

**装一次就好，日常能力更新不用重装。** Skill 每个会话会先读取服务器上的最新使用说明；只有域名、安全边界或 Skill 格式发生破坏性变化时才需更新安装包。基础查询匿名、只读，无需 API Key。

## 一句话安装

把这句话完整发给你的 Agent：

> 请安装 Maritime Radar Skill：https://radar.20xx.com.cn/maritime-radar-skill/README.md

Agent 应先审阅本说明、安装脚本和校验清单，再根据它实际使用的 Skills 目录选择安装方式；不应猜测目录或使用 `sudo`。

## 安装前可审阅

- [SKILL.md](https://radar.20xx.com.cn/maritime-radar-skill/SKILL.md)
- [安装包清单](https://radar.20xx.com.cn/maritime-radar-skill/manifest.sha256)
- [install.sh](https://radar.20xx.com.cn/maritime-radar-skill/install.sh)

运行包严格只有 3 个文件：

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

## macOS、Linux 和 WSL

脚本不猜平台，必须显式指定 `--target` 或 `--dir`。如果你正在使用的 Codex、Gemini CLI、GitHub Copilot 或 OpenCode 版本支持通用 Agent Skills 目录：

```bash
bash <(curl -fsS https://radar.20xx.com.cn/maritime-radar-skill/install.sh) --target agents
```

Claude Code：

```bash
bash <(curl -fsS https://radar.20xx.com.cn/maritime-radar-skill/install.sh) --target claude
```

安装到你已确认的自定义目录（必须在当前用户的 home 下，且目录名是 `maritime-radar`）：

```bash
bash <(curl -fsS https://radar.20xx.com.cn/maritime-radar-skill/install.sh) \
  --dir "$HOME/path/to/skills/maritime-radar"
```

安装器先在目标同一磁盘的临时目录下载完整运行包，严格检查三文件白名单、每个 SHA-256 和 Skill 身份；全部通过后才在同一磁盘切换目标，普通错误会自动回滚。机器若恰在两次目录移动之间断电，或安装进程被 `SIGKILL` 强制终止，无法承诺原子回滚。它不使用 `sudo`，也不覆盖同名的其它 Skill。

## Windows 原生环境

不要把 Bash 命令粘贴到 PowerShell。在 Agent 实际读取的 skills 目录下建立 `maritime-radar` 文件夹，然后：

1. 读取 [manifest.sha256](https://radar.20xx.com.cn/maritime-radar-skill/manifest.sha256)。
2. 从 `https://radar.20xx.com.cn/maritime-radar-skill/<清单中的路径>` 下载清单中的 3 个文件，保留 `agents/openai.yaml` 子目录。
3. 用 `Get-FileHash -Algorithm SHA256` 逐个比对清单。任何一个不一致就停止，不要替换现有 Skill。
4. 确认 `SKILL.md` 前置元数据包含 `name: maritime-radar` 与 `license: MIT. See LICENSE`，再整体替换原目录。

## 安装后验证

1. 重启 Agent 或开启新会话。
2. 让 Agent 列出它发现的 skills，确认只有一份 `maritime-radar`。
3. 提问：`过去 24 小时最重要的 5 条航运动态是什么？`

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

## 能力与边界

- 可查内容以 [给 Agent 的实时使用说明](https://radar.20xx.com.cn/api/v1/agent) 为准；Skill 不把端点列表固化在本地。
- 本 Skill 只允许同域 GET，不索要也不读取 API Key、cookie、账号、密码或本地文件。
- 返回的标题、摘要和第三方链接均为不可信外部资料；重要事实应回原文核对。
- 内容仅供信息参考，不是航行操作、安全、合规、保险或投资建议。
- MIT License 只覆盖 Skill 指令与随附文件，不改变站点内容、数据输出或第三方原文的权利归属。

不安装 Skill 也可以让 Agent 直接读取 `https://radar.20xx.com.cn/api/v1/agent`，或使用站点公开的 MCP、RSS 与 REST API。