k2f-checklist

用途

K2F Checklist 用于教智能体在 content_and_design.md 中规划清单蓝图：需要核验什么、如何分组与排序条目，以及设计意图（可扫描性、复选框节奏、操作语气）。它不会虚构用户未提供的组织政策、合规门槛或阈值。

该技能基于 K2F 构建，产出的清单以 .K2F 包形式存在。编写时需遵循 k2f 技能：解包或初始化工作区、编辑语义树、打包/验证并导出。K2F 让智能体关注含义——章节、条目标签、勾选状态——而非坐标。

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

适用场景

发布前、部署、迁移、活动、旅行或交接核验，用户会反复执行或在时间压力下执行一次。
将运行手册或尽职调查清单整合为一份可打印或可填写的清单。
多工作流就绪场景，分组章节优于扁平列表。

工作流程

第 1 步：生成 content_and_design.md

为清单内容与设计意图生成单一蓝图。使用带标签的块（标题带、上下文行、章节、复选框行、触发条件、备注），供 k2f 技能后续映射。

子步骤：

清单框架——领域、执行者、一次性还是重复使用、页面预算（通常每个阶段一页）。语气：平静流程式、时间紧迫的部署式或正式合规式。
范围与需求审计——门槛、工具、风险、审批和决策标准（停止、回滚、升级）。未知项标记为 OPEN QUESTION 或 NEEDS USER INPUT；绝不虚构 SLA 或阈值。
信息架构（保留/删减/合并）——选择主导主线：
- 顺序重要时按时间阶段（如 Pre → Execute → Post；Plan → Pack → Go）。
- 团队独立推进时按并行工作流（财务、法务、运营）——每个章节自包含。
- 仅在需要时混合；阶段标题下带工作流子块。默认块：
- 标题与上下文 → 清单名称、日期/版本槽位、负责人或角色（若提供）。
- 如何使用（2–3 行）：何时运行、预计时间、“完成”的含义。
- 核心章节 → 主题分组，每组 4–12 个条目；优先使用动词 + 可观察结果（如“发布分支上 CI 通过”），而非主题词（如“测试”）。
- 触发条件/例外 → 用户定义的回滚、停止发布或升级行。
- 可选附录意图 → 链接、工单 ID 或数据室指针——不重复清单条目。删减模糊条目（如“再次检查质量”）、跨阶段重复项、叙述性段落，以及不构成所述目标门槛的锦上添花项。
条目契约检查——每行一个动作、一个可验证完成状态；同级条目使用平行动词。仅在要求时添加优先级或负责人。将“如果为是……”的后续项放在父项下。
定制检查——仅根据用户输入或指定模板添加特定上下文章节（迁移、标志、行业条目）。重复使用时保持章节顺序稳定。
设计意图——语气：直接；紧迫感通过章节标签而非警报文案传达。层级：标题、上下文，然后章节标题在复选框行之上。密度：拆分冗长无区分的列表。节奏：每项一行；触发条件与常规行分开。品牌：克制的强调色；适合打印的对比度。
记录假设（章节顺序、省略的可选项）与开放问题（缺失的阈值、负责人或政策文本）。

规则与约束

可验证性门槛：每个条目都要回答“我怎么知道它完成了？”——否则重写或删减。
真实性门槛：审批、环境、指标和法律步骤须追溯到用户输入或明确占位符。
范围门槛：记录本清单的范围内/范围外；清单后工作流用一行说明，而非运行手册长文。
单动作门槛：将复合行（“审查并部署并通知”）拆分为独立条目或有序子步骤。
门槛排序：在时间顺序清单中，阻塞项（测试、审批、备份）出现在不可逆步骤之前。
活文档门槛：仅在要求时注明状态跟踪意图；不虚构状态枚举。

常见失败模式

无阶段或主题的扁平流水账 → 按时间或工作流重新分组。
条目先于前置条件（“部署到生产”先于“预发已验证”）→ 重排时间主线。
用户提到风险时缺少触发条件或回滚行 → 添加触发条件章节或标记 NEEDS USER INPUT。
忽略用户技术栈的通用模板 → 仅注入用户指定的工具和门槛。
用长篇说明替代可勾选行 → 转换为复选框条目加简短使用说明块。
每个阶段重复检查 → 保留在最早的门槛章节一次。

质量清单

框架、页面预算、语气和需求审计（门槛、工具、触发条件）已记录。
信息架构选择（阶段、工作流或混合）明确；范围内/外和删减已说明。
每个条目是一个可验证动作，措辞平行；后续项与父项关联。
触发条件/停止条件已提供或占位；假设与开放问题已列出。
设计意图覆盖整个清单的语气、层级、密度、节奏和品牌。

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

遵循 k2f 从蓝图实例化章节和复选框条目，应用设计意图，验证并导出可运行清单（通常为可填写 PDF 或 DOCX）。