关于 k2f-intake-form
k2f-intake-form 指导 Agent 在起草前规划表单内容与设计,适用于诊所、机构、法律、咨询和报名场景。它强调字段结构、信息顺序与设计意图,并要求缺失的法律或临床文案由用户提供。
主要功能
- 01规划表单内容与设计蓝图
- 02审查必收信息和附件
- 03组织字段、分区与填写顺序
- 04标注字段类型和答题空间
- 05记录假设与待确认问题
- 06通过 k2f 生成并导出表单
适用场景
- 01制作可打印或可填写的接诊表
- 02将旧版 PDF 或邮件问卷改为统一表单
- 03为服务或项目报名设计信息收集表
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ suzheng/ k2f --skill k2f-intake-form安装后在 Claude Code 中输入/k2f-intake-form确认已加载。
详细介绍
K2F Intake Form — AI 原生美学设计
用途
教会 Agent 在 content_and_design.md 中为信息收集表制定蓝图:在关系或个案开始前收集哪些信息、如何安排和分组问题,以及美学意图(语气、层级、可填写密度);同时避免凭空编造用户未提供的临床流程、法律同意文本或资格规则。
基于 K2F 构建
此技能将信息收集表生成为 .K2F 包。按照 k2f 技能进行编写:解包或初始化工作区、编辑语义树、打包/验证并导出。K2F 让 Agent 专注于含义——分区、标签、字段角色,而非坐标。
开始构建前,安装核心技能:npx skills add suzheng/k2f --skill k2f。
适用场景
- 用于诊所、机构、法律、咨询或入学登记的可打印或可填写的信息收集表,以及将邮件问卷、旧版 PDF 或多步骤向导重新设计为统一表单包。
工作流
步骤 1.生成 content_and_design.md
用于表单内容和设计意图的单一蓝图。使用带标签的区块(页眉、说明、分区、字段行、同意、审核),供 k2f 技能后续映射。
子步骤
-
信息收集框架 — 领域(医疗保健、专业服务、创意简报、内部项目)、组织、受众(新患者、客户、供应商)、提交路径、页数预算(通常为 1–2 页;仅在受监管的分区或签名区块需要时增加页数)、语气档位(冷静临床、温暖服务、正式合规)。
-
倾听与需求审查 — 根据简报或模板,列出必须收集的信息(身份、联系方式、就诊原因、日期、保险编号、紧急联系人)。对由附件提供依据的项目做一次标记。未知项标记为
OPEN QUESTION或NEEDS USER INPUT;切勿猜测法定或临床措辞。 -
信息架构(纳入/删减/合并) — 默认结构(根据框架需要调整顺序):
- 页眉 → 表单标题、组织、可选的徽标说明,以及用户提供的版本或生效日期。
- 说明(2–4 行):需要携带的材料、预计所需时间、数据用途,以及有疑问时的联系对象。
- 身份与联系方式 → 法定姓名、出生日期或相关情况下的年龄门槛、电话、电子邮件、地址;适用时填写紧急联系人。
- 原因与背景 → 来访原因、转介来源、紧急程度、服务类别或项目类型。
- 领域分区 → 仅添加用户或模板要求的分区(例如保险、病史、范围、预算、利益相关方);每个分区只围绕一个主题。
- 偏好与后勤安排 → 日程、沟通、无障碍需求;使用紧凑的行,不写长篇说明。
- 同意与声明 → 仅使用用户提供或占位的法律文本时,才添加签名、日期和复选框。
- 审核意图 → 摘要与前面的分区保持一致;标签完全相同。
- 删减重复的联系方式、无关问卷、重复录入的附件数据和可选的兴趣爱好。
-
分区流程检查 — 先问简单信息;敏感病史放在文档中段;同意放在最后。先问是/否,再问“如果是,请描述……”。默认采用一个可滚动的表单包;仅在用户要求时,才在蓝图中命名向导步骤。
-
字段类型检查 — 按提示词类型选择字段:单行事实信息;用于背景说明的短文本区(2–4 行);可控的是/否或选择行;附格式说明的日期字段;签名区块意图。开放文本的字数或行数限制需写入标签。如有疑问,选择更短的形式——信息收集是为了了解情况,不是写回忆录。
-
设计意图 — 语气:尊重、低压力;仅在用户提供文案时使用法律/临床措辞。层级:先显示标题和组织信息;分区标题醒目;标签清晰。密度:分区之间留出间隔;标签与字段配对对齐;不使用下划线网格。节奏:事实信息行搭配小型多行文本区;同意内容单独分开。品牌:克制设计,仅用一种强调色,并确保对比度易读。
记录假设(顺序、删去的可选项)与待确认问题(会影响字段或同意内容的阻碍)。
规则与限制
- 真实性关卡:组织名称、临床问题、同意条款和预填默认值均可追溯至用户输入或明确标注的占位内容。
- 范围关卡:明确本次受理范围内 / 范围外的内容;提交后的流程只用一行说明,不要写成计划。
- 单一目的关卡:每个字段只询问一件事;拆分复合问题。
- 避免重复关卡:附件中的数据 → 使用引用或“已另行提供”复选框,而不是要求完整重填。
- 同意关卡:不得虚构 HIPAA、GDPR 或治疗同意内容;标记为
NEEDS USER INPUT。 - 长度关卡:内容溢出 → 删除可选部分或移至后续表单;不要在蓝图中缩小字体。
常见失败模式
- 规划长文或向导式要点堆砌 → 改为带标签的字段,并注明字段类型和答题空间要求。
- 在收集基本联系信息前询问敏感问题 → 调整顺序。
- 缺少说明或签名栏 → 添加简短的提交方式说明和确认意图。
- 泛泛的问卷(“介绍一下自己”)→ 替换为具体、针对领域的问题。
- 引入新问题的审核步骤 → 审核内容仅对应前面的各部分。
质量检查清单
- 已记录表单框架、页数预算、语气和需求审核(必须收集的内容与附件)。
- 已明确章节顺序和范围内 / 范围外的内容;已说明删减项。
- 每个字段均注明类型、标签文本和答题空间要求;已注明条件式追问。
- 同意和法律条款栏已留占位或注明来源;已列出假设与待明确问题。
- 设计意图涵盖整份表单的语气、层级、密度、节奏和品牌。
步骤 2:使用 content_and_design.md 和 k2f 技能生成 K2F 文件,并导出为合适的文件格式。
按照 k2f,根据蓝图创建各章节和表单字段、应用设计意图、进行验证,并导出可供提交的受理表单(通常为可填写 PDF 或 DOCX)。