用途
K2F Policy Document 旨在教会智能体在排版之前先为政策文件制定蓝图:可扫描的规则架构、面向员工的通俗语言层,以及正式层级结构——同时不编造用户或 HR/法律未提供的福利、法律义务、管辖范围或审批路径。
基于 K2F
该技能将政策文件生成为 .K2F 包。创作时需遵循 k2f 技能:解包或初始化工作区、编辑语义树、运行 pack/verify,然后导出。K2F 让智能体关注含义(章节、强调、表格)而非像素坐标,同时由引擎将布局、排版和主题编译为一致且可导出的输出。
在构建之前,请安装核心技能:npx skills add suzheng/k2f --skill k2f
适用场景
- 新建或刷新的单项政策页面(PTO、远程办公、费用、行为准则、差旅、安全、休假类型)。
- 必须与内部风格保持一致、但首次扫描即可找到内容的手册章节。
- 将草稿或粘贴的政策语言重新格式化为可供 HR 或法律审查的可发布结构。
不适用于:仅聊天式政策问答、AgentRC 评分政策或律师级合同(应使用 k2f-contract)。
工作流程
第 1 步:生成 content_and_design.md
一份将信息架构与设计意图配对的蓝图。标记 k2f 技能后续可映射到章节、标注和强调的块。
子步骤:
- 文件框架 — 政策标题、文档 ID(如用户提供)、生效日期、版本、政策负责人(团队/角色)以及适用性(实体、地点、雇佣类型)。说明这是新政策、修订还是取代先前文本;仅从用户输入中链接先前版本。
- 目的与范围 — 两个简短块:政策存在的原因(最多一段)以及谁/何时适用。删除重复标题的叙述;当范围跨越用户未指定的地区时标记 HR VERIFY。
- 速览层 — 快速摘要(3–5 个要点或一个短段落):员工在阅读细节前必须知道的内容。这是扫描锚点——不是每条规则的副本。
- 定义 — 仅包含会改变本政策合规含义的术语;省略字典式词汇表。
- 政策声明 — 编号规则:明确主体、情态动词(必须/不得/需批准)和结果。每项义务一个要点;不要在同一个要点中混合“政策 + 操作方法”。
- 程序 — 单独编号的流程:如何请求、报告、升级或记录合规(表格、系统、时间线仅来自用户)。程序引用规则;不以散文形式重述规则。
- 角色与职责 — 紧凑矩阵或要点:员工、经理、HR、IT、财务、法律——每一步谁做什么。
- 例外与审批 — 谁可以授予例外、所需文档以及记录存放位置。如未知,标记 APPROVAL PATH — USER TO CONFIRM。
- 相关政策与引用 — 仅当用户命名时才提供交叉链接和外部法规;不得虚构引用。
- 执行与疑问 — 仅当用户提供时才包含后果或渐进式纪律;否则标记 LEGAL/HR TO CONFIRM。边缘情况的联系人以及单一疑问渠道。
- 修订历史 — 表格或列表:版本、日期、变更摘要、批准人——在用户填写前标记 TBD 占位符。
- 设计意图 — 清晰优先于装饰:
- 语气:中性、权威,摘要使用通俗语言;编号规则使用正式精确语言;不使用营销或致歉语气。
- 层级:标题和适用性优先;速览和政策声明最强;程序和角色次要;修订历史第三。
- 密度:适中——短段落,规则和程序使用要点;当用户提供数字时,角色或阈值使用表格;避免大段文字。
- 配色:克制的中性色,正文高对比度,在必须/不得、截止日期和审批路径上使用最少强调色;WCAG AA;不使用与规则竞争的库存图片。
规则与约束
- 来源门:强制性或特定管辖区的语言须逐字来自用户;所有其他草稿标记 FOR HR/LEGAL REVIEW。
- 诚实门:不得编造 PTO 天数、金额限制、法律引用、系统或审批人姓名。
- 分离门:规则放在政策声明中;步骤放在程序中;不要将规则隐藏在程序段落内。
- 适用性门:每项义务都指明约束对象;地理范围不明 → 标记,不要默默假定美国默认。
- 单一主题门:每份蓝图一个政策主题;拆分不相关主题(例如差旅与费用),除非用户明确要求具有命名部分的合并手册章节。
常见失败模式
- 散文式引言且无速览 → 员工永远找不到规则。
- 规则埋在 FAQ 叙述中 → 将命令式内容提取为编号政策声明。
- 程序先于规则 → 重新排序,让“是什么”先于“如何做”。
- 快速摘要与完整章节重复 → 摘要保持简短;细节放在下方。
- 通用 AI 手册语气 → 替换为用户术语、系统和审批人,或标记 TBD。
- 缺少联系对象 → 边缘情况流入非正式渠道。
- 修订但修订历史中未说明变更内容 → 合规跟踪中断。
- 将面向员工的通俗文本与特权法律分析混合 → 仅保留对外语气。
质量检查清单
- 框架包含适用性、生效日期以及新建/修订/取代状态。
- 速览层可独立存在;政策声明编号且为命令式。
- 程序分离;角色和例外路径存在或标记 TBD。
- 用户强制文本逐字保留;不编造限制、引用或联系人。
- 相关政策仅来自用户输入。
- 设计意图明确规则与程序的语气、层级、密度和强调。
第 2 步:使用 content_and_design.md 和 k2f 技能生成 K2F 文件并导出为适当文件格式
遵循 k2f 从蓝图构建政策,应用设计意图角色,验证,并为 HR/法律审查导出(通常为 PDF 或 DOCX)。