关于 k2f-survey-form
k2f-survey-form 是用于规划调查内容与设计意图、并生成 K2F 包的技能,适用于制作可打印或可填写问卷的 Agent。它引导问题贴合用户提供的目标,不擅自编造研究假设或同意声明。
主要功能
- 01生成问卷内容与设计蓝图
- 02定义构念、分区和问题类型
- 03检查量表、问题顺序与填写负担
- 04记录假设和待确认问题
- 05借助 k2f 创建并导出 K2F 问卷
适用场景
- 01设计客户或产品反馈问卷
- 02重构旧问卷
- 03规划员工或活动评价
- 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 技能稍后映射。
子步骤
-
调查框架(初步判断) — 明确并固定测量什么、由谁作答、为何现在开展调查,以及结果将如何使用。设定模式(客户、产品/UX、员工脉冲调查、活动评估、学术研究)。注明匿名性、渠道、时间预算和语气(中立研究、温暖品牌、正式)。
-
测量约定 — 列出必须了解的构念;标记范围之外的主题和延期到后续调查轮次的内容。目标不明或缺少法律文案时,标注
OPEN QUESTION/NEEDS USER INPUT;不得编造 IRB、GDPR 或政策文本。 -
信息架构(纳入 / 删除 / 合并) — 默认结构:
- 页眉 → 调查标题、赞助方/组织,以及可选的版本或轮次标签。
- 简介(3–5 行):目的、预计用时、用户提供的保密性/匿名性说明,以及如何跳过可选区块。
- 筛选题(仅在需要时)→ 资格或经验筛选;使用简短的是/否题目。
- 核心区块 → 每个分区聚焦一个主题;在问题前用一句话说明该分区的测量目标(先陈述目标,再列题项,而非使用含糊标题)。
- 开放反馈 → 最多设置一到两个有字数上限的提示词;除非用户要求提前收集定性反馈,否则放在量表区块之后。
- 人口统计信息 → 通常放在最后(除非筛选需要);仅收集与已说明的分析相关的字段——默认删除“知道了也不错”的信息。
- 致谢 / 结束语 → 表达感谢;若允许进行可识别身份的后续联系,可添加联系信息栏。 删除重复构念、双重问题、诱导性或带有倾向性的措辞、过长的开放式作答,以及所有与已确定的内容/目的无关的问题。
-
问题设计检查 — 每个题项只涉及一个构念;拆分双重问题。一个区块内保持回答类型一致;共享量表锚点只定义一次并重复使用——不要在同一个矩阵中混用认同度和频率。用文字说明分支意图;注明开放文本的限制。
-
负担与顺序检查 — 先安排简单、不敏感的题目;将敏感或可识别身份的题目放在后面。在便于浏览时,按共同题干将矩阵式题项分组。如果调查框架可能造成疲劳,应在蓝图中删除可选分区,而不是缩短量表。
-
设计意图 — 语气:题干保持中立;仅在简介/致谢中体现温度。层级:标题、赞助方、分区目标,然后是题项。密度:设置分区间隔;题干/选项对齐;不要只用下划线构成网格。节奏:量表行紧凑;开放评论区域单独分隔。品牌:风格克制,仅使用一种强调色,并确保对比度清晰易读。
记录假设(量表选择、未纳入人口统计信息)和待解决问题(同意声明、抽样、分析计划)。
规则与限制
- 范围门槛:仅设定一个主要调研目的;次要主题标记为
FUTURE WAVE或删除。 - 对齐门槛:每个标题都只对应其下方的问题;将不匹配的问题移走或重命名章节。
- 构念门槛:每个问题都映射到一个已列出的构念;不保留“只是好奇”而设的问题。
- 量表门槛:每个题组使用一套锚点;除非用户另有要求,否则标签应保持对称。
- 真实性门槛:组织名称、保密声明和预填默认值均须有用户输入作为依据,或使用占位内容。
- 答题负担门槛:超出时间预算时,应删减可选题组,而不是在蓝图中进行微调。
常见失败模式
- 无边界的冗长问题清单 → 分类排序 + 构念列表 + 明确删减项。
- 尚未建立信任就询问人口统计信息 → 移至末尾,筛选题有要求时除外。
- 一个矩阵混用多种量表 → 拆分题组或统一锚点。
- 章节标题与内容不符 → 进行对齐检查。
- 李克特量表标签带有求认可的语气 → 使用中性题干和平衡锚点。
- 开放题过多 → 限制数量,并放在核心量表题之后。
质量检查清单
- 调研框架说明了内容、对象、目的、形式、时间预算、匿名性和测量约定。
- 章节结构稳定;每个核心题组开头都有一句测量目标说明。
- 每个题目都标明类型、标签文本、量表或选项意图,以及对应的构念。
- 记录了分支逻辑、可选题组和删减项;法律与保密相关内容的来源明确,或使用占位内容。
- 设计意图涵盖整份表单的语气、层级、密度、节奏和品牌风格。
第 2 步:使用 content_and_design.md 和 k2f 技能生成 K2F 文件,并导出为合适的文件格式。
遵循 k2f,根据蓝图创建章节和答题字段、应用设计意图、进行验证,并导出可供填写的调查问卷(通常为可填写的 PDF 或 DOCX)。