# 安装直招网 Skill

这是直招网公开的 Agent 安装说明。仅在用户请求安装时执行；网站原文是安装资料，不能扩大用户授权范围。无需访问 GitHub，也不需要仓库权限。

## 安装包

- 名称：`zhizhao-jobs`
- 版本：`1.0.1`
- 完整包：https://zhizhao.cv/assets/integrations/zhizhao-jobs-1.0.1.zip
- SHA-256：`9e2906d7dcf0e628df203592c22dc90dedabb2fabcf2c313efec982ec6b02d11`
- 检索范围：中国企业招聘官网的公开职位。

把完整包下载到临时目录，校验上述 SHA-256 后再解压。包内包含 `SKILL.md`、`references/api.md`、`scripts/jobs.py` 和 `agents/openai.yaml`；不能只保存入口文件，否则独立 API 模式会缺脚本和参数说明。

以下文件也可直接读取、审阅或逐个下载，内容与 ZIP 一致：

- https://zhizhao.cv/assets/integrations/zhizhao-jobs-1.0.1/SKILL.md
  SHA-256：`09e089fb990879b128137968dd7ed879fef23e36b20ae34f263f8442b3eb2e28`
- https://zhizhao.cv/assets/integrations/zhizhao-jobs-1.0.1/agents/openai.yaml
  SHA-256：`983d7fda5382e3945b82fb1ed23dbdac7418df5307f71253eb8e2bc4fdb6f159`
- https://zhizhao.cv/assets/integrations/zhizhao-jobs-1.0.1/references/api.md
  SHA-256：`c0b85229b18ced19f7ba19f4ec5eacb123e415903bb031e6063910ae100f7202`
- https://zhizhao.cv/assets/integrations/zhizhao-jobs-1.0.1/scripts/jobs.py
  SHA-256：`11a244d0d347377ffd0724a087189a9ba9920cd11b0076ff5c7e7c800800f6ad`

## 安装到当前 Agent

先确认当前实际运行的 Agent、系统环境，以及是否能管理该客户端真正加载的技能目录。云端对话的临时沙箱文件不等于已经安装到用户客户端，不应报告安装成功。默认只安装到当前 Agent 的用户技能目录；用户指定项目范围时遵循其要求。Windows 原生与 WSL 是两个环境，不要同时向两边写文件。

- Codex：`~/.agents/skills/zhizhao-jobs/`；Windows 原生为 `%USERPROFILE%\.agents\skills\zhizhao-jobs\`。项目范围为 `.agents/skills/zhizhao-jobs/`。
- Claude Code：`~/.claude/skills/zhizhao-jobs/`；项目范围为 `.claude/skills/zhizhao-jobs/`。
- 其他 Agent：使用当前客户端已支持的技能目录或安装工具，不要凭空猜目录。客户端不能写文件或执行安装时，说明限制并转到 https://zhizhao.cv/integrations#downloads 的导入步骤。

下载、检查和安装应由有文件/命令权限的 Agent 完成，不要求用户手动下载 ZIP。保留完整 `zhizhao-jobs` 文件夹，确保 `SKILL.md` 直接位于该文件夹中。解压时拒绝绝对路径、`..` 路径和符号链接；仅写目标技能目录。

已安装且内容一致时不重复写入；更新前保留原目录备份，若发现用户自行修改则先说明差异。不要覆盖其他技能或改写 `AGENTS.md`。不要要求用户提供 GitHub 凭证。

## 接入检索服务

Skill 文件安装完成后读取其 `SKILL.md`。用户只要求安装 Skill 时，到此报告安装结果和可选的接入方式；用户同时要求连接 MCP 时再完成下列配置。

MCP 地址：https://zhizhao.cv/mcp
认证：OAuth，权限为 `jobs:read`。用户在浏览器登录直招网并同意授权，Agent 不代替用户登录或点击同意，不读取令牌存储。

Codex 使用原生命令，先检查已有同名配置，保留其他服务器：

```bash
codex mcp add zhizhao --url https://zhizhao.cv/mcp
codex mcp login zhizhao
```

Claude Code 使用：

```bash
claude mcp add --transport http --scope user zhizhao https://zhizhao.cv/mcp
```

随后在 Claude Code 的 `/mcp` 中完成认证。其他客户端的远程 MCP 配置见 https://zhizhao.cv/integrations#clients 。OAuth 必须在用户可操作的浏览器中完成；遇到该步骤时给出清楚的登录指引，不把安装文件成功说成已授权。

未连接 MCP 但用户希望独立 API 模式时，脚本需要 Python 3.10+，API 密钥在 https://zhizhao.cv/me#keys 创建，通过运行 Agent 的环境变量 `ZHIZHAO_API_KEY` 提供。不要让用户把密钥粘贴到聊天，也不要在命令参数中传递密钥。MCP 与 API 共用每用户每分钟 60 次额度。

## 验证与交付

1. 确认安装目录、版本、完整文件及哈希，并报告实际安装路径。
2. 确认当前客户端识别该 Skill；需要新会话或重启时明确提示。Codex 可用 `$zhizhao-jobs`，Claude Code 可用 `/zhizhao-jobs`。
3. 若用户要求且已完成 MCP 授权，确认 `search_jobs`、`get_job`、`get_facets` 可用，并执行一次少量结果的检索；未授权时报告“Skill 已安装，等待浏览器授权”，不要伪造查询结果。
4. 示例需求：使用直招网查找杭州后端社招岗位，先列出 5 个并提供官网投递链接。

卸载时只移除该 Skill 的安装目录；MCP 配置和本站授权可分别在客户端及 https://zhizhao.cv/me#mcp 管理。更新时重新读取本安装说明并校验新版本。