# 课件 01 · MedHarness 体系总览

> 时长：60 分钟（讲 40 + 答 20）
> 受众：第一次接触 MedHarness 的所有人（工程师 / PM / Compliance Officer）
> 前置：无

---

## 学习目标

学完本节，你能：
1. 用一句话说清 MedHarness 是什么 / 不是什么
2. 复述 6 层架构每层的职责
3. 知道 5 条红线
4. 找到任何一个 Skill / Hook / MCP 的源码位置

---

## 1. MedHarness 一句话定位（10 min）

> **一套面向医疗数据 SaaS 公司的开源 AI Coding 落地体系。
> HIPAA + PIPL + 数据安全法 + 健康医疗数据安全指南双合规。
> 6 个月从"零散个人用 AI 编辑器"到"企业级、可审计、可演进"。**

### 不是什么（明确边界）

- ❌ **不是 Cursor / Claude Code 的替代** — 我们是研发**体系**，不是 IDE
- ❌ **不是 PHI 检测库** — 用 Microsoft Presidio，我们加医疗专属层
- ❌ **不是新 LLM 框架** — LangChain / LlamaIndex 红海
- ❌ **不是医疗器械软件** — 那是 IEC 62304 工具链
- ❌ **不是实时 AIOps 监控** — 不是我们的强项

只做**"医疗 SaaS 的 AI Coding 落地全套体系"**——一个垂直点。

---

## 2. 为什么需要这套体系（10 min）

通用 AI Coding 生态（spec-kit / OpenSpec 等 spec 框架 + Claude Code / Cursor 等 AI 编辑器 + Anthropic Skills / MCP 等扩展机制）解决了 60% 的问题。剩下 40% 是**医疗特有的工程纪律**：

| 问题 | 通用工具 | 医疗特有 |
|---|---|---|
| 代码质量 | spec-driven 解决 | ✅ |
| 测试覆盖 | TDD / pytest 解决 | ✅ |
| **PHI 永不裸入 prompt** | ❌ 不解决 | 🔴 必须 |
| **模型按数据分级路由** | ❌ 不解决 | 🔴 必须 |
| **6 年 WORM 审计可重放** | ❌ 不解决 | 🔴 必须 |
| **异构性 Compliance-Agent** | ❌ 不解决 | 🔴 必须 |
| **PIPL 跨境数据流监管** | ❌ 不解决 | 🔴 必须 |

这些不是工具问题，是**研发体系**问题。MedHarness 把这些"叠加"到通用工具之上。

---

## 3. 6 层架构（15 min）

```
L6 治理     技术委员会 + 合规委员会 + Skill Owner 制
─────────────────────────────────────────────────
L5 合规    数据分级 / PHI 脱敏 / 模型 allowlist / 审计血缘
           ↑↓ 横切，所有动作必经
─────────────────────────────────────────────────
L4 SOP     12 步主通道 + 5 步 micro 通道
─────────────────────────────────────────────────
L3 Skill   23 Skill（5 合规 + 16 通用 + 2 别名）
─────────────────────────────────────────────────
L2 Harness Orchestrator + 6 Sub-agent + Memory + 9 Hook + 8 MCP
─────────────────────────────────────────────────
L1 模型    编码 / Review / 架构 / 长文 / 脱敏 / 合规独立
```

### 每层一句话

- **L1**：哪个模型干哪个活（按数据分级 + 异构性）
- **L2**：Claude Code 的 Harness（Skill / Sub-agent / Memory / Hook / MCP）
- **L3**：23 个领域知识包（合规 + PRD + 实现 + 验证 + 审计 ...）
- **L4**：12 步 / 5 步 SOP 路径（速度 / 合规双轨）
- **L5**：横切所有层的合规闸门（哪个动作都得过）
- **L6**：人的治理（双委员会 + Skill Owner）

详 [docs/architecture/dependency-graph.md](../../docs/architecture/dependency-graph.md)。

---

## 4. 5 条红线（5 min）

**任何 PR / commit / 决策必自检**：

| # | 红线 | 违反 |
|---|---|---|
| R1 | L4 PHI 永不裸入 prompt | 监管处罚 |
| R2 | 模型按 allowlist 路由 | 合规违规 |
| R3 | 审计全量记录 | 监管无法重放 |
| R4 | 测试数据合规（合成 + 指纹） | 反演风险 |
| R5 | License 永久 Apache 2.0 / CC BY-SA 4.0 | 社区信任崩盘 |

详 [CLAUDE.md §1](../../CLAUDE.md)。

---

## 5. 仓库导览（10 min · 演示）

```
medharness/
├── README.md                  ← 5 分钟上手
├── CLAUDE.md                  ← 项目级红线 + Skill 索引
├── AGENTS.md                  ← AI 协作者协议
├── HANDOFF.md                 ← 新会话接手必读
├── 研发交付SOP-v2.md           ← 12 步主通道
├── 研发交付SOP-v2.2-micro.md   ← 5 步 micro
├── .claude/
│   ├── skills/ × 23           ← Skill 系统
│   └── sub_agents/ × 6        ← Sub-agent 配置
├── mcp/ × 8                   ← MCP server（L5 合规层载体）
├── scripts/hooks/ × 9         ← Hook 脚本
├── openspec/                  ← spec + change 工作目录
├── examples/                  ← 完整示例 change
├── docs/                      ← 架构 / 路线图 / 商业边界
├── training/                  ← 培训方法论（本课件所在）
└── tools/                     ← customize.py
```

### 跟我打开 5 个核心文件
1. README.md — 看"5 分钟上手"
2. CLAUDE.md §1 — 看 5 红线
3. .claude/skills/compliance-precheck/SKILL.md — 看一个 Skill 长啥样
4. mcp/phi-detector/server.py — 看一个 MCP server
5. examples/示例-患者匹配最小可行版/proposal.md — 看 SOP 入口长啥样

---

## 6. 现场练习（10 min）

每人在自己电脑跑一遍：

```bash
git clone https://github.com/charliehzm/medharness.git
cd medharness
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
bash dryrun_e2e_v2.sh --ci
```

**检查点**：
- [ ] 输出有 `AUDIT_BUNDLE_患者匹配最小可行版_<ts>.tar.gz` 吗？
- [ ] 输出有 sha256 hash 吗？
- [ ] 没有？哪一步卡了？记下问题

---

## 课后作业

1. 读完 [README.md](../../README.md) + [CLAUDE.md](../../CLAUDE.md)
2. 在 GitHub Discussions 提一个你最大的疑问（任何方面）
3. 下次课前完成 [02-12步SOP手把手.md](02-12步SOP手把手.md) 的 §1-2

---

## 自检（结业前）

- [ ] 我能用一句话说清 MedHarness 是什么
- [ ] 我能复述 6 层架构每层职责
- [ ] 我背得出 5 条红线
- [ ] 我知道 23 个 Skill 在哪个目录
- [ ] 我跑通了 dryrun
