心理测评

Other

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

Install

openclaw skills install @bettermen/psycho-assess

Psycho Assess - 专业心理测评

Overview

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

量表清单

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

全套测评共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 计算得分:

单个量表:

python scripts/score_engine.py --scale PHQ-9 --answers '[0,2,1,3,1,0,2,1,0]'

全套测评:

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报告:

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}} 注入动态内容。