k2f-one-pager

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

K2F One Pager — AI-Native Aesthetic Design

K2F One Pager — AI 原生美学设计

Purpose

用途

Teach agents to author

content_and_design.md

for single-page decision and narrative documents: what belongs on one page, how to tier information for executive scan, and aesthetic intent (tone, hierarchy, density)—not K2F packaging or export.

指导 Agent 编写

content_and_design.md

，用于单页决策与叙事文档：规划单页应包含的内容、如何为高管快速浏览对信息进行分层，以及美学意图（语气、层级、密度）；不涉及 K2F 封装或导出。

Built on K2F

基于 K2F 构建

This skill produces one pagers as

.K2F

packages. Follow the k2f skill for authoring: unpack or init a workspace, edit the semantic tree, pack/verify, and export. K2F keeps agents on meaning (sections, claims, evidence shapes, CTA)—not coordinates—while the engine compiles layout, typography, and theme into export-ready output.

Before you build, install the core skill:

npx skills add suzheng/k2f --skill k2f

此 skill 会生成

.K2F

包形式的单页文档。编写时遵循 k2f skill：解包或初始化工作区，编辑 semantic tree，执行打包/验证并导出。K2F 让 Agent 专注于语义（章节、主张、证据形式、CTA），而非坐标；引擎会将布局、排版和主题编译为可直接导出的输出。

构建前，安装核心 skill：

npx skills add suzheng/k2f --skill k2f

。

When to Use

使用场景

Product or feature briefs, initiative proposals, solution/company overviews, partnership summaries, or release summaries on one page.
Alignment before detailed design, eng handoff, or launch comms.
One scannable artifact—not pitch decks, flyers, posters, full PRDs, or multi-page reports.

Not for: deep technical design, research decks, or event promos centered on date/venue and one bold CTA (k2f-flyer).

以单页形式呈现产品或功能简报、专项计划提案、解决方案/公司概览、合作摘要或发布总结。
在详细设计、工程交接或发布沟通前达成共识。
一份可快速浏览的成果物——而不是 pitch deck、传单、海报、完整 PRD 或多页报告。

**不适用于：**深度技术设计、研究型演示文稿，或以日期/地点和单个醒目 CTA 为中心的事件宣传（k2f-flyer）。

Workflow

工作流

Step 1. Generate the content_and_design.md

第 1 步：生成 content_and_design.md

Blueprint semantic content plus design intent in labeled section blocks for a single canvas.

Sub-steps

One-pager lock — The one job (approval, release summary, solution sell). Audience, channel (print PDF, email, wiki), and genre—pick one archetype; do not merge incompatible skeletons.
Archetype & section order — Fixed vertical stack with headings:
- Decision / product: thesis → problem (pain + why now) → solution (what, not UI) → users → metrics (baseline + target) → in/out scope → constraints → open questions → optional owner/next step.
- Release / changelog: version, date, summary → Added → Fixed → Breaking → Known issues → Upgrade note → CTA only with a real destination.
- Solution / company: audience → one-line offer → three differentiators → proof → optional pricing → one next step.
- Initiative pitch: problem → approach → impact → resources/timeline → ask → risks.
Scan layers — Glance: title, thesis, hero metric or version. Scan: 2–4 bullet blocks. Detail: sources and fine print—subordinate to thesis.
Content tiers — Thesis (page story), Evidence (numbers, quotes, lists), Boundary (scope, constraints, explicit “none”). Second-page material → cut or appendix link.
Honesty — No invented metrics, dates, customers, or breaking changes. Missing input →
```
None
```
,
```
No … provided
```
, or
```
TBD
```
; unknown version/date →
```
—
```
with label.
Cut pass — Drop essays, feature catalogs, APIs, duplicate metrics. Replace vague goals with measurable outcomes or TBD. One primary CTA; extras in a contact line.
Design intent (no coordinates):
- Tone: evidence-led for decisions; factual for releases; confident solution voice only with proof—one adjective pair.
- Hierarchy: thesis largest; consistent section labels; hero metric/version as anchor; boundaries smallest.
- Density: ~250–450 words unless user overrides; bullets over prose; ~5 bullets max per block; short parallel columns for in/out scope only.
- Rhythm: mix bullets with one visual intent (metric row, logo band, timeline chips)—avoid bullet walls.
- Contrast: light ground, accent on thesis/metrics/CTA; readable brand colors.

Rules & constraints

One page, one thesis—split combined angles into separate one-pagers.
Changelog: every standard section present; empty → explicit None-style copy.
Capabilities at outcome level, not screen specs.
Metrics: baseline + target or TBD—no decoration.
Crisp in/out scope; MVP vs later when relevant.
CTA only with real destinations—no placeholders.

Common failure modes

Failure	Fix
Deck/PRD paste	Collapse to archetype; one idea per bullet; park depth in out-of-scope.
Flyer tone on product brief	Problem + metrics before slogans.
Skipped release sections	Labeled blocks with None-style text.
Vague problem	Pain + signal or TBD.
Scope creep	Boundary tier + out-of-scope list.
Two theses	One job per page.
Fabricated proof	Stub or NEEDS USER INPUT.

Quality checklist

Lock: job, audience, genre, channel.
Archetype order; thesis in glance layer.
Thesis / Evidence / Boundary; word budget noted.
Claims traceable or stubbed; scope/changelog sections complete.
Design intent: tone, hierarchy, density, rhythm, contrast.
One primary next step; no fake CTAs.

在单一画布中，用带标签的章节区块勾勒语义内容与设计意图。

子步骤

单页锁定——明确唯一任务（审批、发布摘要、方案推介）、受众、渠道（打印 PDF、邮件、wiki）和体裁；选择一种文档原型，不要混用互不兼容的结构骨架。
文档原型与章节顺序——采用带标题的固定纵向结构：
- 决策/产品：核心论点 → 问题（痛点 + 为何此时）→ 解决方案（做什么，而非 UI）→ 用户 → 指标（基线 + 目标）→ 范围内/范围外 → 约束 → 待决问题 → 可选的负责人/下一步。
- 发布/变更日志：版本、日期、摘要 → 新增 → 修复 → 破坏性变更 → 已知问题 → 升级说明 → 仅在有真实目标地址时使用 CTA。
- 解决方案/公司：受众 → 一句话方案 → 三项差异化优势 → 证据 → 可选定价 → 一个下一步。
- 专项计划提案：问题 → 方法 → 影响 → 资源/时间线 → 诉求 → 风险。
浏览层级——快速一览：标题、核心论点、主指标或版本。定向扫读：2–4 个要点区块。深入阅读：来源和细则——从属于核心论点。
内容层级——论点（页面叙事）、证据（数字、引用、列表）、边界（范围、约束、明确的“无”）。属于第二页的材料 → 删除或附上附录链接。
真实性——不得虚构指标、日期、客户或破坏性变更。缺少输入时 →
```
None
```
、
```
No … provided
```
或
```
TBD
```
；版本/日期未知时 →
```
—
```
，并附上标签。
删减环节——删除长篇论述、功能目录、API 和重复指标。将模糊目标替换为可衡量的结果或 TBD。设置一个主要 CTA；其他信息放在联系信息行中。
设计意图（不涉及坐标）：
- 语气：决策类以证据为导向；发布类保持客观；解决方案类仅在有证据支撑时才采用自信语气——使用一对形容词。
- 层级：核心论点最大；章节标签保持一致；以主指标/版本作为视觉锚点；边界信息最小。
- 密度：除非用户另有要求，约 250–450 词；优先使用要点而非段落；每个区块最多约 5 个要点；仅对范围内/范围外使用简短并列栏。
- 节奏：在要点之间加入一种视觉意图（指标行、Logo 横带、时间线标签）——避免连续大段要点。
- 对比：使用浅色背景；在核心论点/指标/CTA 上使用强调色；采用易读的品牌色。

规则与约束

单页、单一论点——将多个角度拆分为不同的单页文档。
变更日志：每个标准章节都必须存在；为空时 → 使用明确的 None 风格文案。
能力应描述到结果层面，而不是屏幕规格。
指标：基线 + 目标，或 TBD——不得将其作为装饰。
清晰界定范围内/范围外；适用时区分 MVP 与后续阶段。
CTA 仅指向真实目标地址——不得使用占位内容。

常见失败模式

失败模式	修复方式
粘贴 Deck/PRD 内容	收敛为一种文档原型；每个要点只表达一个想法；将深度内容放入范围外。
产品简报采用 flyer 语气	先呈现问题 + 指标，再使用口号。
跳过发布章节	使用带 None 风格文案的标注区块。
问题描述模糊	痛点 + 信号或 TBD。
范围膨胀	设置边界层级并列出范围外内容。
两个论点	每页只完成一个任务。
虚构证据	使用占位内容或 NEEDS USER INPUT。

质量检查清单

锁定：任务、受众、体裁、渠道。
文档原型顺序；核心论点位于快速一览层。
论点/证据/边界；注明字数预算。
主张可追溯或使用占位内容；范围/变更日志章节完整。
设计意图：语气、层级、密度、节奏、对比。
一个主要下一步；不得有虚假 CTA。

Step 2. Use the content_and_design.md and k2f skill to generate a K2F file and export to an appropriate file format.

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

Follow k2f to build the single page from the blueprint, apply design roles, verify, and export (usually PDF).

遵循 k2f，根据蓝图构建单页，应用 design roles，验证并导出（通常为 PDF）。