lonelydoctor/survey-linter

survey-linter 是做什么的？

在发送问卷前审核其是否存在偏见性问题——一个Claude技能+零依赖命令行工具。

概述

survey-linter 是一个轻量级的技能，可集成到 Claude 或其他 AI 代理中，用于分析问卷题目中潜在的偏见。它支持多种输入格式，输出详细的审核报告，标注有问题的题目并提供修改建议。

功能

• 检测引导性问题、带有感情色彩的措辞
• 识别选项不平衡或遗漏的选项
• 标记文化敏感或可能导致歧视的表述
• 支持 JSON、CSV 和纯文本输入
• 零外部依赖，仅需 Python 标准库
• 输出结构化 JSON 或人性化 Markdown 报告

使用方法

作为 Claude 技能

1. 将本技能配置到你的 Claude 项目中。
2. 向 Claude 提供问卷内容，例如：

请审核以下问卷题目是否存在偏见：

问题1: 你难道不认为我们的产品是最好的吗？
  - 是的
  - 当然
  - 绝对是

3. Claude 将调用 survey-linter 并返回审核结果。

作为独立 CLI

# 克隆仓库
$ git clone https://github.com/lonelydoctor/survey-linter

# 运行审核
$ python lint.py survey.json

输入格式

支持 JSON 数组或 JSON 对象，每个题目包含 id（可选）、text（必须）和 options（可选）字段。

示例：

[
  {
    "id": "q1",
    "text": "你难道不认为我们的产品是最好的吗？",
    "options": ["是的", "当然", "绝对是"]
  }
]

输出报告

工具会标记每个题目的潜在偏见到一个 issues 数组中：

{
  "questions": [
    {
      "id": "q1",
      "issues": [
        {
          "type": "leading_wording",
          "description": "问题使用了引导性措辞 '难道不认为'，暗示期望回答。",
          "suggestion": "改为更中性的提问，如 '您如何评价我们的产品？'"
        }
      ]
    }
  ]
}

配置

可选环境变量：

• SURVEY_LINTER_STRICT：设置为 true 启用更严格检查
• SURVEY_LINTER_FORMAT：输出格式，json 或 markdown（默认：json）

许可

MIT