k2f-fillable-pdf

K2F 可填写 PDF — AI 原生美学设计

目的

教会 Agent 编写 content_and_design.md，用于制作人们真正会填写的表单：明确的静态文案、包含类型和约束的完整字段清单、合乎逻辑的分区流程，以及针对浏览和填写优化的美学意图——而不是泛泛的问卷堆砌，也不是在静态 PDF 上直接贴框。

基于 K2F 构建

此技能将生成可填写文档，并打包为 .K2F 包。按照 k2f 技能的说明进行编写：解包或初始化工作区、编辑语义树、运行打包/验证，然后导出。K2F 让 Agent 专注于含义（标签、字段角色、说明、分组），而非像素坐标；引擎会将布局、排版和交互字段编译为一致的输出。

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

适用场景

• 根据需求或现有纸质 PDF 创建新的申请、注册、信息收集、入职或合规表单。
• 重构杂乱的旧表单，然后重新构建。
• 将一份较长的表单拆分为便于浏览的多个分区，同时保留用户提供的法律或政策原文。

工作流

步骤 1：生成 content_and_design.md

一份蓝图，融合读者看到的内容（静态）与读者填写的内容（交互式），并包含引擎可解读的设计意图。使用带标签的区块；稍后在 k2f 中映射页面。

子步骤

1. 完成场景 — 由谁填写（申请人、工作人员、患者），是独立填写还是附带附件，预计用时、提交途径，以及必填与选填部分。删除不会影响结果的字段。

2. 静态层 — 标题、版本或生效日期、发布方身份、简短的“填写说明”步骤、仅依据用户文本提供的隐私或保留期限声明、各部分的介绍，以及页脚（第 x 页，共 y 页；联系方式）。切勿编造法律条款。

3. 字段清单 — 表格或结构化列表：稳定 ID、面向用户的标签、控件类型（单行文本、多行文本、复选框、单选按钮组、下拉菜单、日期、签名确认）、必填标记、占位符或格式提示、选择字段的选项、最大长度或行数、帮助文本（最多一行）。将单选按钮组和复选框组归在同一个问题下，并明确说明互斥或多选语义。

4. 信息架构 — 按认知流程排序：识别 → 详情 → 选择 → 授权 → 审核。每个部分安排 5–9 个字段；主题转换时开始新部分。简短标签与输入框成对放在双列中；段落、多行回答和声明区块使用全宽布局。将条件区块（“仅当 Employment = Yes 时显示雇主区块”）写成明确规则，而非暗示性的布局。

5. 设计意图 — 语气（机构正式、临床沉稳、友好的信息采集）、层级（标题最大；部分标题为 H2；标签使用中等字重；帮助文本更小、更浅）、密度（垂直间距充足；避免满屏方框）、对齐（标签右对齐或与输入框顶端对齐；选项组缩进到问题下方）、强调色（用一种颜色显示部分栏或必填标记）、对比度（标签和说明符合 WCAG AA）。说明哪些复选框需要明显易点的点击区域，哪些位于法律文本行内。

规则与约束

• 标签清晰：每个字段都要回答“是什么？”（“工作邮箱”，而不是“邮箱”）。
• 一个问题，一种控件模式：互斥选项用单选按钮；多选用复选框；不要混用。
• 如实标注必填项：标明选填字段；不要默认所有字段都是必填项。
• 原文把关：政策、同意和认证文本只能逐字复制用户来源中的内容。
• 完成流程：如果使用场景需要，最后一个部分包含认证人姓名、日期和签名字段。

常见问题

• 占位符取代了标签 → 添加可见标签；占位符仅用于提示。
• 探查式表单 → 删除没有明确审核者或系统用途的字段。
• 字段顺序杂乱 → 按场景流程重新排序；将相关行分组。
• 重复询问（在两个部分中填写城市） → 合并或只询问一次，并在其他位置交叉引用。
• 未指定单选按钮或复选框选项 → 明确列出每个选项标签。
• 单列内容过密、填写时间过长 → 拆分部分；简短项目使用“标签 + 字段”成对布局。
• 缺少条件逻辑 → 在相关字段旁记录显示/隐藏规则。
• 语气像通用“表单模板” → 在设计意图中设定语气和发布方背景。

质量检查清单

• 每个交互控件都在字段清单中列出类型和必填标记。
• 各部分顺序符合完成场景；Tab 顺序从上到下，在双列字段中从左到右。
• 静态说明放在其管辖字段之前。
• 选择字段列出完整且互不重叠的选项。
• 法律或政策文本由用户提供，且未作更改。
• 设计意图涵盖语气、层级、密度和强调色，不包含布局坐标。
• 没有无归属的标签，也没有在场景中用途不明的字段。

第 2 步：使用 content_and_design.md 和 k2f 技能生成 K2F 文件，并导出为合适的文件格式。

遵循 k2f，根据蓝图实例化页面，绑定清单中的字段角色，进行验证，并导出可填写的 PDF 交付文件。