用途
k2f-fillable-pdf 是一项用于指导 AI 智能体创作可填写 PDF 表单的技能。其目标是让智能体撰写 content_and_design.md，用于那些人们真正会填写完成的表单——包括申请、登记、信息采集包与合规工作表。它要求给出明确的静态文案、包含类型与约束的完整字段清单、符合逻辑的分段流程，以及针对「扫描与输入」场景调优的审美意图；而不是一份泛泛的问卷堆砌，也不是把输入框粘贴到静态 PDF 上。
基于 K2F
该技能将可填写文档生成为 .K2F 包。制作时需遵循 k2f 技能：解包或初始化工作区、编辑语义树、运行 pack/verify，然后导出。K2F 让智能体专注于含义（标签、字段角色、说明、分组），而非像素坐标；由引擎将布局、排版与交互字段编译为一致的输出。
在开始构建前，先安装核心技能：
npx skills add suzheng/k2f --skill k2f
使用场景
- 根据需求或既有纸质 PDF，创建新的申请、登记、信息采集、入职或合规表单。
- 在重建前重构混乱的旧版表单。
- 将一份长表单拆分为便于扫描的多个分段，同时保留用户提供的法律或政策原文措辞。
工作流程
第一步：生成 content_and_design.md
这是一份将「读者所见」（静态）与「填写者所填」（交互）以及引擎可解读的设计意图合并在一起的蓝图。使用带标签的区块；页面映射稍后在 k2f 中完成。
子步骤：
- 填写场景：由谁填写（申请人、员工、患者）、单独填写还是附带材料、预计耗时、提交路径，以及必填与可选分段。删除不影响结果的字段。
- 静态层：标题、版本或生效日期、签发方身份、简短的「如何填写」步骤、隐私或保留声明（仅来自用户文本）、分段引言与页脚（第 x 页 / 共 y 页、联系方式）。绝不编造法律条款。
- 字段清单：以表格或结构化列表给出：稳定 id、人类可读标签、控件类型（单行文本、多行文本、复选框、单选组、下拉框、日期、签名确认）、是否必填、占位符或格式提示、选择字段的选项、最大长度或行数、帮助文本（最多一行）。将单选与复选框组归到同一问题下，并说明是互斥还是多选语义。
- 信息架构：按认知流程排序：身份识别 → 详细信息 → 选择 → 授权 → 复核。每段聚集 5–9 个字段；主题变化时开启新分段。短标签与输入框组成双列行；段落、多行回答与声明区使用整行宽度。将条件区块（如「仅当 Employment = Yes 时显示雇主区块」）明确写成规则，而非隐含布局。
- 设计意图：语气（机构化、临床冷静、友好采集）、层级（标题最大；分段用 H2；标签中等字重；帮助文本更小更浅）、密度（充裕的纵向节奏，避免满屏方框）、对齐（标签右对齐或成对时顶部对齐；选择组在问题下缩进）、强调色（用于分段条或必填标记的单一颜色）、对比度（标签与说明达到 WCAG AA）。说明哪些复选框需要清晰的点击目标，哪些是行内法律文本。
第二步：用 content_and_design.md 与 k2f 技能生成 K2F 文件并导出
按 k2f 从蓝图实例化页面、从字段清单绑定字段角色、校验，并导出可填写 PDF 交付物。
规则与约束
- 标签清晰：每个字段都回答了「什么的？」（如「工作邮箱」而非「邮箱」）。
- 一问一控件模式：互斥用单选；多选用复选框；不要混用。
- 必填诚慎：标注可选字段；不要默认全部必填。
- 逐字把关：政策、同意与认证文本仅从用户来源复制。
- 填写路径：当场景需要时，最后一段包含认证姓名、日期、签名字段。
常见失败模式
- 用占位符替代标签 → 增加可见标签；占位符仅作提示。
- 钓鱼式表单 → 删掉没有明确复核方或系统用途的字段。
- 字段顺序随机 → 按场景流程重排；把相关行归组。
- 重复询问（城市出现在两段）→ 合并或仅交叉引用一次。
- 单选/复选选项未指明 → 显式列出每个选项标签。
- 密集单列马拉松 → 拆分段；短项用标签+字段配对。
- 缺少条件逻辑 → 在受影响字段旁记录显示/隐藏规则。
- 泛化的「表单模板」语气 → 在设计意图中设定语气与签发方语境。
质量检查清单
- 每个交互控件都在字段清单中出现，并带类型与必填标记。
- 分段顺序与填写场景一致；Tab 流在成对项内按从上到下、从左到右。
- 静态说明出现在其所约束的字段之前。
- 选择字段列出完整、不重叠的选项。
- 法律或政策文本由用户提供且未改动。
- 设计意图涵盖语气、层级、密度与强调色，且不含布局坐标。
- 没有孤立标签，也没有在场景中缺乏用途的字段。
限制与暂未提供
现有资料未说明该技能的收费方式、支持的具体文件格式清单、各平台的兼容情况或实际效果数据，这些信息暂未提供。资料明确要求：法律与政策文本必须由用户提供且不得编造或改写。