# 人物 Skills 安装与使用指南

每个下载包都是一个可独立使用的人物 Skill。单人 ZIP 解压后会得到一个以英文短名命名的文件夹，其中至少包含：

```text
zhang-xinyu/
├─ SKILL.md
└─ references/
   └─ public-record.md
```

`SKILL.md` 是 Agent 的主要说明，`references/public-record.md` 是公开记录证据库。使用观点研究、采访设计或公开表达分析时，应让 Agent 同时读取证据库。

## 在 Codex 中安装

### Windows 用户级安装

1. 下载人物 ZIP。
2. 打开 `%USERPROFILE%\.codex\skills\`。如果 `skills` 目录不存在，可以创建它。
3. 将 ZIP **直接解压到 `skills` 目录**。
4. 确认最终路径类似：

```text
C:\Users\你的用户名\.codex\skills\zhang-xinyu\SKILL.md
```

5. 新建或重新打开一个 Codex 任务，让技能目录重新载入。
6. 在提示词中用 `$技能名` 显式调用，例如：

```text
使用 $zhang-xinyu，基于公开记录整理張心瑜女士在女性成长方面的
公开行动，并区分已知事实、合理追问项和不能推断的立场。
```

下载“全部人物 Skills”后，同样直接解压到 `%USERPROFILE%\.codex\skills\`。合集 ZIP 内的 64 个人物文件夹会直接落在该目录下。

> 如果解压后出现 `skills\zhang-xinyu\zhang-xinyu\SKILL.md`，说明额外多套了一层目录。请将内层 `zhang-xinyu` 文件夹移动到 `skills` 目录下。

## 在项目中随仓库使用

如果团队希望把 Skills 与项目一起版本管理，可以把人物文件夹放进项目约定的 Skills 目录，并在项目的 Agent 入口说明中指出位置。例如：

```text
your-project/
├─ AGENTS.md
└─ .agents/
   └─ skills/
      └─ zhang-xinyu/
         ├─ SKILL.md
         └─ references/public-record.md
```

不同 Agent 对项目级技能目录的命名约定可能不同，应以目标 Agent 的官方说明或团队配置为准。关键要求是保持人物文件夹内部结构不变，并让 Agent 能发现 `SKILL.md`。

## 在其他通用 Agent 中使用

如果目标 Agent 支持 Markdown Skills 或指令包：

1. 将完整人物文件夹放入它配置的 Skills、Rules 或 Instructions 目录。
2. 将 `SKILL.md` 设为入口文件。
3. 确保相对链接 `references/public-record.md` 可以被读取。
4. 用 Skill 名称和具体任务调用。

如果目标 Agent 不原生支持 Skills：

1. 在会话或知识库中同时加载 `SKILL.md` 与 `references/public-record.md`。
2. 告诉 Agent 遵守 `SKILL.md` 中的任务边界。
3. 提供议题、时间范围、输出格式和是否需要逐条来源。

示例提示词：

```text
请将已加载的 zhang-xinyu/SKILL.md 作为任务规则，并读取
zhang-xinyu/references/public-record.md。围绕“苏港教育文化交流”设计
6 个采访问题；每个问题说明证据起点，不预设本人答案。
```

OpenAI 的 Skills API 也支持以目录文件或单个 ZIP 上传 Skill；如果你通过 API 管理 Skills，可直接使用单人 ZIP 作为上传文件。参见 [OpenAI Skills API](https://developers.openai.com/api/reference/python/resources/skills/methods/create)。

## 推荐调用结构

为了得到稳定结果，提示词最好包含四项：

```text
使用 $<skill-name>
任务：要完成什么
范围：议题和时间范围
输出：格式、长度、是否逐条列来源
边界：是否禁止推断、模拟口吻或代本人表态
```

例如：

```text
使用 $zhang-xinyu。
任务：整理張心瑜女士与女性成长有关的公开行动，并生成活动主持人背景资料。
范围：只使用 Skill 证据库中已核实的材料。
输出：先列事实表，再给 150 字第三人称介绍，每条事实附来源。
边界：不模拟本人语气，不把公开行动扩写为个人完整立场。
```

## 适合的任务

- 带来源的人物背景研究；
- 公开观点或行动的时间线；
- 采访问题和追问设计；
- 活动介绍、字幕和主持人口播；
- 多人物公开观点或行动对照；
- 发现证据不足之处并形成后续检索清单。

## 使用边界

- 人物 Skill 不是数字分身，不应以第一人称冒充本人。
- 摘要不是逐字引语；需要引用原话时，应打开来源核对上下文。
- “可核实公开行动”不等于人物的完整个人立场。
- 涉及最新职务、新事件、投资、法律或政策判断时，应重新联网核验。
- 公开资料不足时，Agent 应明确说明缺口，不能用常识补写人物观点。

## 安装检查

安装后可以用以下问题测试：

```text
请列出当前可用的人物 Skills，并确认 $zhang-xinyu 是否能被发现。
```

若未发现 Skill，请检查：

- 文件是否位于 `<skills目录>\zhang-xinyu\SKILL.md`；
- ZIP 是否多解压了一层同名目录；
- `SKILL.md` 的 YAML 头部是否仍在文件最上方；
- Agent 是否需要重启任务或重新载入工作区；
- 目标 Agent 是否支持自动发现 Skills，或需要手动加载入口文件。