心理测评

SKILL.md

---
name: psycho-assess
description: 专业心理测评助手。提供5个国际标准心理量表（PHQ-9抑郁筛查、GAD-7焦虑筛查、PSS-10压力感知、RSES自尊量表、BFI-10大五人格）的交互式答题与专业评估报告。用户答题完成后生成可视化HTML报告，包含得分分析、临床阈值对照、雷达图、综合建议和心理援助热线。触发词：心理测评、心理评估、心理测试、测测心理、抑郁症测试、焦虑症测试、压力测试、自尊测试、人格测试、心理健康、psycho assess、psychological test。
agent_created: true
---

# Psycho Assess - 专业心理测评

## Overview

提供基于国际标准心理量表的专业心理测评服务。支持单量表测评或全套5量表综合测评，交互式答题后自动计算得分、对照临床阈值、生成可视化HTML评估报告。

## 量表清单

| 量表 | 题目数 | 评估维度 | 评估周期 |
|------|--------|----------|----------|
| PHQ-9 | 9题 | 抑郁症状 | 过去2周 |
| GAD-7 | 7题 | 焦虑症状 | 过去2周 |
| PSS-10 | 10题 | 压力感知 | 过去1个月 |
| RSES | 10题 | 自尊水平 | 整体感受 |
| BFI-10 | 10题 | 大五人格 | 一般特征 |

全套测评共46题，预计完成时间10-15分钟。

## 工作流程

### Step 1: 确定测评范围

向用户说明可用的5个量表，询问要做的测评：

- "全套测评" (46题，10-15分钟) — 最全面的心理画像
- 指定量表 — 如"我想测抑郁" → PHQ-9；"测焦虑" → GAD-7

用户说"随便"或没有指定时，默认推荐全套测评。

### Step 2: 逐量表交互式答题

量表题目和选项数据从 `references/scales.md` 读取。

答题规则：
- **逐量表推进**：完成一个量表的所有题目后再进入下一个
- **每道题展示**：题目编号、题目文本、选项（带分值）
- **确认答题**：用户输入选项编号（如 0/1/2/3）或选择文字
- **记录答案**：以 JSON 数组格式记录每道题的分值
- **显示进度**：如 "PHQ-9: 3/9 已完成"

**答题过程中的重要提醒**：
- 提醒用户根据指导语的**时间范围**作答（PHQ-9/GAD-7是"过去两周"，PSS-10是"过去一个月"）
- 量表间切换时，先展示新量表的指导语
- 全程保持中立、专业的态度，不对答案做任何评判

### Step 3: 评分计算

所有题目完成后，使用 `scripts/score_engine.py` 计算得分：

**单个量表：**
```bash
python scripts/score_engine.py --scale PHQ-9 --answers '[0,2,1,3,1,0,2,1,0]'
```

**全套测评：**
```bash
python scripts/score_engine.py --all --answers '{"PHQ-9":[0,2,1,3,...],"GAD-7":[...],...}'
```

评分引擎自动处理：
- PHQ-9/GAD-7：直接求和，对照临床阈值
- PSS-10：自动反向计分（第4、5、6、7、9、10题）
- RSES：自动反向计分（第2、5、6、8、9题）
- BFI-10：反向计分 + 按五维度分别计算均值
- PHQ-9第9题（自伤念头）：任何非0回答自动触发高危标记

### Step 4: 生成可视化报告

使用评分结果生成HTML报告：

```bash
python scripts/generate_report.py --results-file '<json_path>' --output psycho_report.html
```

报告包含：
- 测评概览（各量表得分与严重程度一瞥）
- 每个量表的详细解读（得分圆环 + 进度条 + 临床阈值 + AI解读）
- 大五人格雷达图（SVG，显示五维度分布）
- 大五人格维度卡片
- 高危信号预警（红色/橙色/黄色分级）
- 个性化综合建议
- 心理援助热线
- 免责声明

### Step 5: 呈现报告

- 使用 `preview_url` 展示HTML报告
- 使用 `deliver_attachments` 交付报告文件
- 口头总结关键发现（1-2句话），引导用户查看完整报告

**注意**：如果PHQ-9得分≥15或GAD-7得分≥15或PHQ-9第9题>0，必须在口头回复中强调"强烈建议寻求专业帮助"，并附上心理援助热线。

## 特殊处理规则

### PHQ-9 第9题高危标记
PHQ-9第9题（"有不如死掉或用某种方式伤害自己的念头"）的任何非0回答（即回答≥1），无论总分为多少，都必须在结果中标注为高危信号。评分引擎自动检测并在JSON中返回 `q9_warning: true`。

### 质量控制
- 如果用户答案出现"全0"或"全最高分"的模式，可以提醒用户确认是否认真作答，但不强制要求重新作答
- 提醒用户这是一个筛查工具，不是诊断工具

### 隐私保护
- 不在报告中显示"你可以跟别人分享"之类的建议
- 强调这是一个私密的自我了解工具

## 资源文件

### scripts/score_engine.py
评分计算引擎，支持单量表和全套测评的计分、阈值对照、反向计分、多维度计算。

### scripts/generate_report.py
HTML报告生成器，将评分结果JSON注入模板生成完整可视化报告，含SVG雷达图。

### references/scales.md
5个专业量表的完整数据：题目文本、选项、计分规则、临床阈值、解读模板。

### assets/report_template.html
HTML报告模板，包含CSS样式、布局结构，通过 `{{PLACEHOLDER}}` 注入动态内容。