# Medaibox 科研结果交付包安装说明

本包遵循 open Agent Skills 目录约定。

你只需要把 skill 文件夹复制到 AI 工具对应的 skills 目录中，工具会自动发现并在合适的时候调用这些 skill。

---

## 一、当前你会安装什么

本包当前分为两层：

1. `foundation-skills/`
   - 当前已装箱：**174 个** skill
   - 其中 **130 个**来自上游 non-blocklist skills，**44 个**来自本地公开 / 科研向补充 skills
   - 适合作为基础能力层

2. `workflow-skills/`
   - 当前共 **7 个** Medaibox 科研结果交付 workflow skill
   - 适合作为增值工作流层

如果你只是先测试整条交付链路，**先安装 `workflow-skills/` 也可以**。
如果你要安装完整版本，直接安装 `foundation-skills/ + workflow-skills/`。

---

## 二、支持的全局安装目录（推荐）

| 工具 | 目录 |
|------|------|
| Cursor | `~/.cursor/skills/` |
| Claude Code | `~/.claude/skills/` |
| Codex | `~/.codex/skills/` |
| Gemini CLI | `~/.gemini/skills/` |

---

## 三、支持的项目级安装目录

| 工具 | 目录 |
|------|------|
| Cursor | `.cursor/skills/` |
| Claude Code | `.claude/skills/` |
| Codex | `.codex/skills/` |
| Gemini CLI | `.gemini/skills/` |

---

## 四、推荐安装方式

### 方案 A：完整安装（foundation + workflow）

#### Codex
```bash
mkdir -p ~/.codex/skills/
cp -R foundation-skills/* ~/.codex/skills/
cp -R workflow-skills/* ~/.codex/skills/
```

#### Claude Code
```bash
mkdir -p ~/.claude/skills/
cp -R foundation-skills/* ~/.claude/skills/
cp -R workflow-skills/* ~/.claude/skills/
```

#### Cursor
```bash
mkdir -p ~/.cursor/skills/
cp -R foundation-skills/* ~/.cursor/skills/
cp -R workflow-skills/* ~/.cursor/skills/
```

#### Gemini CLI
```bash
mkdir -p ~/.gemini/skills/
cp -R foundation-skills/* ~/.gemini/skills/
cp -R workflow-skills/* ~/.gemini/skills/
```

---

## 五、仅安装 workflow-skills（快速试跑）

#### Codex
```bash
mkdir -p ~/.codex/skills/
cp -R workflow-skills/* ~/.codex/skills/
```

#### Claude Code
```bash
mkdir -p ~/.claude/skills/
cp -R workflow-skills/* ~/.claude/skills/
```

#### Cursor
```bash
mkdir -p ~/.cursor/skills/
cp -R workflow-skills/* ~/.cursor/skills/
```

#### Gemini CLI
```bash
mkdir -p ~/.gemini/skills/
cp -R workflow-skills/* ~/.gemini/skills/
```

---

## 六、项目级安装示例

以 Codex 为例：

```bash
mkdir -p .codex/skills/
cp -R /path/to/medaibox_research_delivery_pack/foundation-skills/* .codex/skills/
cp -R /path/to/medaibox_research_delivery_pack/workflow-skills/* .codex/skills/
```

如果你只是想先测试 workflow：

```bash
mkdir -p .codex/skills/
cp -R /path/to/medaibox_research_delivery_pack/workflow-skills/* .codex/skills/
```

---

## 七、安装后如何验证

### 方法 1：直接触发整条 workflow

```text
请把这份科研分析结果整理成一个正式交付包
```

或：

```text
请使用 research-delivery-orchestrator 帮我把结果整理成交付流程
```

### 方法 2：逐个测试 workflow skill

- `research-results-intake`
- `results-summary-brief`
- `results-to-html-delivery`
- `results-to-slides`
- `expert-review-pack`
- `delivery-bundle-builder`
- `research-delivery-orchestrator`

### 方法 3：直接看内置 demo

- `examples/demo_frailty_readmission_delivery/`

---

## 八、合规提醒

当前版本已经把 **174 个** foundation skill 装入实际销售包。

但你在继续增删第三方基础 skill 时，仍然需要确认：

1. 原始 `LICENSE` / `NOTICE` 文件已保留
2. 如果某个 skill 子目录有单独许可证，以子目录许可证为准
3. 许可不清楚的，不要直接放入商业 ZIP
4. 当前有 **4 个** skill 进入 blocklist：`docx`、`pdf`、`pptx`、`xlsx`

详见：
- `THIRD_PARTY_NOTICES.md`
- `docs/FOUNDATION_SKILLS_FIRST_RELEASE_ALLOWLIST_CN.md`
- `docs/FOUNDATION_SKILLS_BLOCKLIST_CN.md`

---

## 九、当前建议

最实际的使用顺序是：

1. 先查看 `examples/demo_frailty_readmission_delivery/`
2. 再安装 `workflow-skills/` 测试真实交付链路
3. 若要完整使用，再安装 `foundation-skills/`
4. 最后用 `build_release_zip.sh` 输出正式销售版 ZIP
