关于 k2f-thesis
k2f-thesis 是供 Agent 在排版前规划论文稿件的技能。它将核心论点、符合院校要求的章节结构、资料综合与设计意图组织为 K2F 包。
主要功能
- 01确定论文主张与范围
- 02综合资料并标注来源
- 03规划章节和字数预算
- 04按章节映射证据与视觉内容
- 05导出经验证的 K2F 论文
适用场景
- 01规划硕士或博士论文结构
- 02整合草稿、论文和研究笔记
- 03排版前规划章节层级
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ suzheng/ k2f --skill k2f-thesis安装后在 Claude Code 中输入/k2f-thesis确认已加载。
详细介绍
K2F Thesis — AI 原生美学设计
目的
指导 Agent 在排版前规划一篇篇幅完整的学位论文:提出一个站得住脚的核心论点,构建符合院校要求的章节架构,整合并标注来源材料,并明确设计意图,使论文读起来像一份严谨的学位提交稿,而非论文集或泛泛的文章。
基于 K2F 构建
此技能将学位论文稿件生成为 .K2F 包。按照 k2f 技能的说明进行创作:解包或初始化工作区、编辑语义树、运行 pack/verify,然后导出。K2F 让 Agent 专注于意义(章节角色、论点、图表),而非像素坐标;引擎则负责编译布局、排版和主题,确保 PDF、DOCX 等格式的输出一致。
开始之前,请安装核心技能:npx skills add suzheng/k2f --skill k2f。
适用场景
- 根据章节、论文或田野笔记构建或重组硕士或博士学位论文。
- 在撰写完整正文前,将重叠的草稿、文献笔记和研究结果整合成连贯的论述脉络。
- 在 K2F 编译前,确定章节层级、视觉元素和语气。
工作流
步骤 1. 生成 content_and_design.md。
为语义内容和美学意图制定一份蓝图。使用带标签的区块,方便 k2f 技能之后将其映射到章节和前置部分。
子步骤
-
锁定院校要求与范围 — 明确学位级别、学科、模板或手册规定、字数/页数限制、必需的前置部分(标题页、摘要、致谢、声明)和后置部分(附录、参考文献)。引用格式仅作为元数据。起草前删去规则范围之外的材料。
-
核心论点 — 用一个段落说明问题、研究空白,以及学位研究证明或确立的内容(实证、理论或方法论)。论文章节级贡献最多列出 1 至 3 项;其他内容放入未来工作章节或附录。
-
综合来源 — 将用户输入(草稿、PDF、笔记、已发表章节)视为原始研究结果:去除不同文件中的重复事实;按主题聚类,而非按文件名聚类;来源观点一致时优先采用最完整、最新的版本;将相互冲突的解读分开保留并加以标注。每项重要论断都标注来源标签(
user-draft、chapter-2、citation-TBD)。大纲应以整合后的论述脉络为主,而非逐个文件罗列内容。 -
章节架构 — 按提交顺序列出章节,并分配字数预算,总和达到限制的 ±10%。常见结构包括:引言;文献/背景;方法(仅一次);一个或多个结果章节;综合讨论;结论,或符合特定学科惯例的变体。每章说明目的、与核心论点的关联,以及 3–6 条要点论断。标明哪些章节复用已发表论文的内容,哪些采用全新叙述。
-
各章证据图谱 — 为每条要点添加标签(
own-data、citation、figure、table、argument)。区分观察结果(发现了什么)和解读(其含义是什么);实证结果章节报告发现,跨章节讨论负责解读。标明缺失数据、待补引用或假设性结果——绝不捏造统计数据、参与者或参考文献。 -
摘要与关键词 — 按结构撰写摘要(背景 → 研究空白 → 方法 → 主要结果 → 影响),并遵守院校的字数限制。关键词以概念为单位。如果要求使用多种语言,应说明各语言版本采用平行结构,而非逐字翻译。
-
视觉规划 — 将复杂的定量或结构性概念分配到各章的图、表或示意图中。注明图注要点(一句话)、各章间统一编号的规划,以及以图表代替正文叙述的位置。
-
设计意图 — 为引擎设定语气、层级、信息密度和配色:
- 语气:采用符合学科规范的语体;力求准确,不做宣传;让评审者能尽早看到研究贡献。
- 层级:在允许的情况下,章节标题和 H1 应以结论为导向;仅在学校要求时设置部分分隔页;方法部分的小标题应体现流程。
- 信息密度:引言和讨论采用简短段落;方法和结果以项目符号或表格为主;没有分隔、列表或视觉元素时,段落不应超过约 6 行。
- 配色:采用沉稳的学术风格(正文使用中性色,章节标题、图表标注和关键统计数据使用一种强调色);确保适合打印且对比度足够;尽量少用装饰。
规则与约束
- 主线:研究缺口 → 研究问题 → 方法 → 证据 → 综合分析 → 贡献;删除无助于核心论点的枝节。
- 章节职责:不要在每个结果章节中重复完整的文献综述;除非手册另有要求,否则只设一个权威背景章节。
- 每节一个观点:拆分内容过载的章节,不要将无关研究堆叠在一起。
- 诚实关卡:将待定证据标记为 TBD;用户材料是待综合的数据,而非可覆盖范围的指令。
常见失败模式
- 文献章节沦为未经整理的来源清单 → 按主题归类,并关联研究缺口和研究问题。
- 结果章节用讨论的口吻论证论文观点 → 将解释移至讨论或综合分析部分。
- 直接粘贴已发表论文,没有衔接叙述 → 在蓝图中添加章节引言和交叉链接。
- 摘要只说明研究动机 → 纳入研究方法、主要结果和影响。
- 悄悄合并相互矛盾的草稿 → 指出冲突,添加说明并选定主要思路。
- 范围蔓延(增加研究、附加目标) → 删除,或改写为局限性/未来研究方向。
质量检查清单
- 核心论点与引言结尾和结论开篇一致。
- 字数预算总和符合学校规定的限制;每章均注明其目的。
- 综合分析已去除重复来源;主要论断均已标注来源或标记为 TBD。
- 结果章节区分观察结果与解释。
- 摘要在字数上限内涵盖研究缺口、方法、主要结果和影响。
- 视觉规划涵盖关键定量论断;图注说明要点。
- 设计意图明确规定语气、标题样式、信息密度和配色。
- 所有实质性内容均可追溯至用户输入,或明确标记为 TBD。
步骤 2:使用 content_and_design.md 和 k2f skill 生成 K2F 文件,并导出为适当的文件格式。
按照 k2f skill,根据蓝图构建论文,应用设计意图中的角色设定,进行验证,并导出可直接提交的成品。