# 化妆品安全评估基础与实践 — Skill 安装与配置说明

> 本 Skill 基于国家药监局相关法规及技术导则编制，参考《化妆品安全评估基础与实践》（李金菊主编，中国医药科技出版社 2025）。


---

## 目录

1. [文件结构](#文件结构)
2. [通用安装方式](#通用安装方式)
3. [各平台详细配置](#各平台详细配置)
   - [WorkBuddy / CodeBuddy](#1-workbuddy--codebuddy)
   - [Treawork.cn (Trae Work CN)](#2-treaworkcn-trae-work-cn)
   - [Qoder.work.cn (QoderWork CN)](#3-qoderworkcn-qoderwork-cn)
   - [OpenCode](#4-opencode)
4. [使用方式对比](#使用方式对比)

---

## 文件结构

```
safety-assessment-practice/
├── SKILL.md                    # 主入口 — 核心框架+导航+查找指南
├── chapters/
│   ├── ch01-overview.md        # 安全评估概述（四步法、MoS、发展历程）
│   ├── ch02-toxicology.md      # 毒理学基础（局部+系统毒性）
│   ├── ch03-new-methods.md     # 新技术方法（AOP/NAMs/NGRA/TTC）
│   ├── ch04-human-safety.md    # 人体安全评估（皮肤结构、儿童、透皮吸收）
│   ├── ch05-regulations.md     # 法规体系（条例四层架构、国际对比）
│   ├── ch06-technology-support.md  # 2024 技术支撑体系（9项指南详解）
│   ├── ch07-submission-requirements.md  # 提交要求（注册/备案流程）
│   ├── ch08-report-writing.md  # 报告编写原则（12项核心内容、SED）
│   ├── ch09-case-studies.md    # 10   案例（含配方表、SED计算、风险物质）
│   └── ch10-enterprise-system.md  # 企业体系建设（全生命周期）
├── glossary.md                 # 56 个核心术语中英文对照
├── patterns.md                 # 8 种安全评估模式
├── cheatsheet.md               # 10 张决策速查表
├── README.md                   # 本文档
└── safety-assessment-practice-skill.zip  #（可选）完整打包文件
```

---

## 通用安装方式

多数平台使用统一的 `SKILL.md` 格式。安装即把一个包含 `SKILL.md` 的文件夹放到对应平台的 skill 目录下。

### 方式 A：直接复制文件夹

```
safety-assessment-practice/        # 整个文件夹
├── SKILL.md
├── chapters/
├── glossary.md
├── patterns.md
└── cheatsheet.md
```

### 方式 B：解压 zip 文件

提供 `safety-assessment-practice-skill.zip`，解压后得到上述文件夹。

---

## 各平台详细配置

### 1. WorkBuddy / CodeBuddy

**Skill 目录**：

```
~/.workbuddy/skills/safety-assessment-practice/
```

Windows 完整路径：`C:\Users\<用户名>\.workbuddy\skills\safety-assessment-practice\`

**安装步骤**：

1. 将 `safety-assessment-practice/` 文件夹复制到 `~/.workbuddy/skills/` 目录下
2. 重启 WorkBuddy

**使用方式**：

- 对话中输入 `@skill:safety-assessment-practice` 手动引用
- 或直接提问涉及化妆品安全评估的问题，AI 自动匹配

---

### 2. Treawork.cn (Trae Work CN)

**官方文档**：<https://docs.trae.ai/solo/skills>

**安装步骤（二选一）**：

**方法一：上传 zip**

1. 左侧栏顶部点击 **技能 (Skills)**
2. 点击右上角 **上传技能 (Upload Skill)**
3. 选择 `safety-assessment-practice-skill.zip`
4. 安装后自动启用

**方法二：复制文件夹**

1. 将 `safety-assessment-practice/` 文件夹复制到 Treawork 的 skill 目录
2. 重启 Treawork

**使用方式**：

- 输入 **`/`** 选择 skill
- 或通过 `@skill:` 引用
- 或直接描述需求，AI 自动匹配

---

### 3. Qoder.work.cn (QoderWork CN)

**官方文档**：<https://help.aliyun.com/zh/lingma/qoderwork-cn/user-guide/skills>

**Skill 目录**：

```
~/.qoderwork/skills/safety-assessment-practice/
```

**安装步骤（三选一）**：

**方法一：上传文件**

- 左侧导航 → **扩展** → **技能** → **安装技能** → 上传 zip

**方法二：复制文件夹**

- 将文件夹复制到 `~/.qoderwork/skills/` 目录

**方法三：生成分享链接（团队协作）**

- 在技能页面 → 点击分享图标 → 生成链接 → 发给同事一键安装

**使用方式**：

- 自动触发：直接描述需求，AI 自动匹配
- `/` 快捷调用：输入 `/` 弹出 skill 列表
- `@` 补充上下文
- 对话中指定：`使用化妆品安全评估 skill 评估原料XX`

---

### 4. OpenCode

**官方文档**：<http://opencode.school/lessons/skills>

**Skill 目录**：

| 平台          | 全局路径                                      | 项目级路径               |
| ----------- | ----------------------------------------- | ------------------- |
| Windows     | `C:\Users\<用户名>\.config\opencode\skills\` | `.opencode/skills/` |
| macOS/Linux | `~/.config/opencode/skills/`              | `.opencode/skills/` |

**安装步骤**：

1. 将 `safety-assessment-practice/` 文件夹复制到对应目录
2. 重启 OpenCode

**验证安装**：

```
请列出所有已安装的 skill
```

或

```
skill list
```

**使用方式**：

- 自动触发：问题匹配 skill 描述时自动加载
- 手动调用：`使用 safety-assessment-practice skill 评估原料甘油`

> OpenCode 遵循 agentskills.io 开放标准，与 Claude Code、Cursor、Codex 等 40+ 工具互通。

---

## 使用方式对比

| 平台                | Skill 系统 | 安装方式                             | 调用方式            | 支持 zip |
| ----------------- | -------- | -------------------------------- | --------------- | ------ |
| **WorkBuddy**     | ✅ 原生     | 复制到 `~/.workbuddy/skills/`       | `@skill:` 引用    | ✅      |
| **Treawork.cn**   | ✅ 原生     | 技能管理 → 上传                        | `/` 或 `@skill:` | ✅      |
| **Qoder.work.cn** | ✅ 原生     | 复制到 `~/.qoderwork/skills/` 或上传   | 自动/`/`/`@`      | ✅      |
| **OpenCode**      | ✅ 原生     | 复制到 `~/.config/opencode/skills/` | 自动/手动指定         | ✅      |

---

> **更新记录**：2026-07-29 — 初始版本，覆盖 6 大平台配置说明
