将问卷项目转化为清晰的研究编码本、计分规则、反向计分检查、变量名以及可直接分析的 TSV/Markdown 表格。
调查表代码编制器
功能概述
调查表代码编制器是一项面向实际任务的技能，主要用于当用户需要组织调查表项目、 缩放尺寸、 变量名称、 评分规则、 反分数项目或数据输入 sp 时使用此技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
问卷代码本生成器
用途
当用户需要整理心理学、教育学、公共卫生、社会科学或学生研究项目中的问卷条目、量表维度、变量名、计分规则、反向计分条目或数据录入规范时，请使用本技能。
核心输出是一份结构清晰的代码本，可直接复制粘贴至 Word、Excel、SPSS、R、Mplus 或研究方案文档中。
触发时机
当用户提出以下任一请求时，请激活本技能：
- 将问卷条目转换为代码本。
- 为问卷条目生成变量名。
- 标注反向计分条目并推导计分规则。
- 构建包含维度、条目编号、作答锚点及总分计算方式的表格。
- 为 Excel / SPSS / R / Mplus 准备数据录入规范。
- 检验问卷计分是否具备内部一致性。
- 将杂乱的量表描述转化为分析就绪的表格。
必需的输出格式
当用户提供问卷条目时，除非用户明确要求其他格式，否则请按以下顺序输出以下五个部分：
量表代码本 / Codebook
提供一个 TSV 表格，包含以下列：variable、item_id、dimension、item_text、response_range、reverse_scored、scoring_note、missing_rule。计分规则 / Scoring rules
说明如何计算各维度得分与总分；明确指出应采用“总和分”还是“均值分”。若用户未提供缺失值处理规则，则建议采用透明、可复现的规则，例如：“仅当某维度下至少 80% 的条目为有效值时，才计算该维度的均值分”。反向计分检查 / Reverse-scoring check
列出所有需反向计分的变量，并给出换算公式。对于 1–5 量表，使用reversed = 6 - original；对于 0–4 量表，使用reversed = 4 - original。分析软件变量建议 / Analysis-ready variable names
提供简短、易读、符合编程惯例的变量名。避免空格、中文标点、连字符及过长名称。在适用情况下，使用前缀如dep_（抑郁）、anx_（焦虑）、smu_（社交媒体使用）、sleep_（睡眠）、neuro_（神经质）、eant_（情绪调节）等。质量控制提示 / QC checklist
指出潜在问题：重复的条目 ID、不一致的作答范围、缺失的维度标注、反向计分标识模糊等。
变量命名规则
- 仅允许使用小写字母、数字和下划线（
_）。 - 必须以字母开头。
- 尽量将变量名控制在 20 个字符以内。
- 保留量表原始顺序，使用两位数字编号，例如：
dep_01、dep_02、anx_01。 - 当量表含多个维度时，应在变量名中加入对应维度前缀。
- 若用户明确要求兼容旧版 Mplus（legacy Mplus-safe names），则变量名不得超过 8 个字符。
反向计分公式
对于最小值为 min、最大值为 max 的条目：
reversed_score = min + max - original_score
常见示例：
- 1–5 量表：
reverse = 6 - original。 - 1–7 量表：
reverse = 8 - original。 - 0–4 量表：
reverse = 4 - original。 - 0–10 量表：
reverse = 10 - original。
缺失值处理规则建议
优先采用用户已明确指定的缺失值处理规则；若未提供：
- 维度均值分：仅当该维度下至少 80% 的条目为有效值时进行计算。
- 总量表均值分：仅当全量表中至少 80% 的条目为有效值时进行计算。
- 除非用户明确要求插补（imputation），否则禁止静默式填补缺失值。
可选辅助脚本
本技能附带脚本 scripts/make_codebook.py，可将简易 CSV 格式的条目文件自动转换为 Markdown 格式代码本与 TSV 格式变量映射表。该脚本仅依赖 Python 标准库模块，无需额外安装依赖。
输入 CSV 文件需包含以下列：
item_id,item_text,dimension,scale_min,scale_max,reverse
示例命令：
python3 scripts/make_codebook.py examples/demo_items.csv --out-dir output
若系统中不可用 python3，可尝试：
python scripts/make_codebook.py examples/demo_items.csv --out-dir output
安全性与完整性保障
- 不得虚构问卷条目文字或计分规则。
- 对存疑的反向计分判断，须明确标注为“不确定”。
- 缩写条目标签时，不得改变其原始含义。
- 除非用户提供量表手册原文或明确要求核查权威临界值（clinical cutoff），否则不得自行设定临床判定阈值。
- 在转化计分逻辑时，须严格区分：条目级反向计分、维度得分计算、总量表得分计算三类操作。
热门AI工具
相关专题
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
0
2026.10.22
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。
0
2026.10.22
PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.5万人学习
共6课时 | 54.7万人学习
