mcpField
K
k2f-survey-form

k2f-survey-form

github.com/suzheng文档处理3570 次安装2 周前更新
代码仓库

关于 k2f-survey-form

k2f-survey-form 是用于规划调查内容与设计意图、并生成 K2F 包的技能,适用于制作可打印或可填写问卷的 Agent。它引导问题贴合用户提供的目标,不擅自编造研究假设或同意声明。

主要功能

  1. 01生成问卷内容与设计蓝图
  2. 02定义构念、分区和问题类型
  3. 03检查量表、问题顺序与填写负担
  4. 04记录假设和待确认问题
  5. 05借助 k2f 创建并导出 K2F 问卷

适用场景

  1. 01设计客户或产品反馈问卷
  2. 02重构旧问卷
  3. 03规划员工或活动评价
  4. 04准备学术数据收集表单

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/suzheng/k2f --skill k2f-survey-form

安装后在 Claude Code 中输入/k2f-survey-form确认已加载。

详细介绍

K2F 调查表 — AI 原生美学设计

目的

教会 Agent 在 content_and_design.md 中规划调查表:测量什么、如何界定范围并安排问题顺序,以及美学意图(中立可信度、量表节奏、层级)——不要编造用户未提供的研究假设、抽样计划或同意声明。

基于 K2F 构建

此技能会将调查表生成为 .K2F 包。请遵循 k2f 技能进行创作:解包或初始化工作区、编辑语义树、打包/验证并导出。K2F 让 Agent 专注于含义——分区、提示词、回答类型,而非坐标。

开始构建前,请安装核心技能:npx skills add suzheng/k2f --skill k2f。

适用场景

  • 面向客户反馈、NPS 风格脉冲调查、活动或课程评估、员工敬业度、UX 研究或学术数据收集的可打印或可填写调查表。
  • 将冗长的电子邮件问卷或旧版 PDF 重新设计为一份连贯、便于完成的调查工具。

工作流

第 1 步。生成 content_and_design.md

为调查内容和设计意图创建单一蓝图。使用稳定的带标签区块(页眉、简介、分区、问题、量表、致谢),供 k2f 技能稍后映射。

子步骤

  1. 调查框架(初步判断) — 明确并固定测量什么、由谁作答、为何现在开展调查,以及结果将如何使用。设定模式(客户、产品/UX、员工脉冲调查、活动评估、学术研究)。注明匿名性、渠道、时间预算和语气(中立研究、温暖品牌、正式)。

  2. 测量约定 — 列出必须了解的构念;标记范围之外的主题和延期到后续调查轮次的内容。目标不明或缺少法律文案时,标注 OPEN QUESTION / NEEDS USER INPUT;不得编造 IRB、GDPR 或政策文本。

  3. 信息架构(纳入 / 删除 / 合并) — 默认结构:

    • 页眉 → 调查标题、赞助方/组织,以及可选的版本或轮次标签。
    • 简介(3–5 行):目的、预计用时、用户提供的保密性/匿名性说明,以及如何跳过可选区块。
    • 筛选题(仅在需要时)→ 资格或经验筛选;使用简短的是/否题目。
    • 核心区块 → 每个分区聚焦一个主题;在问题前用一句话说明该分区的测量目标(先陈述目标,再列题项,而非使用含糊标题)。
    • 开放反馈 → 最多设置一到两个有字数上限的提示词;除非用户要求提前收集定性反馈,否则放在量表区块之后。
    • 人口统计信息 → 通常放在最后(除非筛选需要);仅收集与已说明的分析相关的字段——默认删除“知道了也不错”的信息。
    • 致谢 / 结束语 → 表达感谢;若允许进行可识别身份的后续联系,可添加联系信息栏。 删除重复构念、双重问题、诱导性或带有倾向性的措辞、过长的开放式作答,以及所有与已确定的内容/目的无关的问题。
  4. 问题设计检查 — 每个题项只涉及一个构念;拆分双重问题。一个区块内保持回答类型一致;共享量表锚点只定义一次并重复使用——不要在同一个矩阵中混用认同度和频率。用文字说明分支意图;注明开放文本的限制。

  5. 负担与顺序检查 — 先安排简单、不敏感的题目;将敏感或可识别身份的题目放在后面。在便于浏览时,按共同题干将矩阵式题项分组。如果调查框架可能造成疲劳,应在蓝图中删除可选分区,而不是缩短量表。

  6. 设计意图 — 语气:题干保持中立;仅在简介/致谢中体现温度。层级:标题、赞助方、分区目标,然后是题项。密度:设置分区间隔;题干/选项对齐;不要只用下划线构成网格。节奏:量表行紧凑;开放评论区域单独分隔。品牌:风格克制,仅使用一种强调色,并确保对比度清晰易读。

记录假设(量表选择、未纳入人口统计信息)和待解决问题(同意声明、抽样、分析计划)。

规则与限制

  • 范围门槛:仅设定一个主要调研目的;次要主题标记为 FUTURE WAVE 或删除。
  • 对齐门槛:每个标题都只对应其下方的问题;将不匹配的问题移走或重命名章节。
  • 构念门槛:每个问题都映射到一个已列出的构念;不保留“只是好奇”而设的问题。
  • 量表门槛:每个题组使用一套锚点;除非用户另有要求,否则标签应保持对称。
  • 真实性门槛:组织名称、保密声明和预填默认值均须有用户输入作为依据,或使用占位内容。
  • 答题负担门槛:超出时间预算时,应删减可选题组,而不是在蓝图中进行微调。

常见失败模式

  • 无边界的冗长问题清单 → 分类排序 + 构念列表 + 明确删减项。
  • 尚未建立信任就询问人口统计信息 → 移至末尾,筛选题有要求时除外。
  • 一个矩阵混用多种量表 → 拆分题组或统一锚点。
  • 章节标题与内容不符 → 进行对齐检查。
  • 李克特量表标签带有求认可的语气 → 使用中性题干和平衡锚点。
  • 开放题过多 → 限制数量,并放在核心量表题之后。

质量检查清单

  • 调研框架说明了内容、对象、目的、形式、时间预算、匿名性和测量约定。
  • 章节结构稳定;每个核心题组开头都有一句测量目标说明。
  • 每个题目都标明类型、标签文本、量表或选项意图,以及对应的构念。
  • 记录了分支逻辑、可选题组和删减项;法律与保密相关内容的来源明确,或使用占位内容。
  • 设计意图涵盖整份表单的语气、层级、密度、节奏和品牌风格。
第 2 步:使用 content_and_design.md 和 k2f 技能生成 K2F 文件,并导出为合适的文件格式。

遵循 k2f,根据蓝图创建章节和答题字段、应用设计意图、进行验证,并导出可供填写的调查问卷(通常为可填写的 PDF 或 DOCX)。

评论

支持 Markdown