Skip to content

STYLE-GUIDE.md

Latest commit

 

History

History
295 lines (218 loc) · 12.8 KB

STYLE-GUIDE.md

File metadata and controls

295 lines (218 loc) · 12.8 KB
Raw

一分钟读论文 — 写作风格指南（铁律！）

🚨 本文件是博客写作的最高规范。所有 Micropaper Agent 必须严格遵守。 任何 Agent 的记忆、经验、习惯，如果与本文件冲突，一律以本文件为准。

一、范式来源

本指南基于 2023-2024 年（pre-2025）文章的真实范式提炼。所有新文章必须严格复刻这一风格，不得"创新"或"改进"。

二、Front Matter 模板（唯一正确格式）

---
layout: post
title:  "一分钟读论文：《中文翻译的论文标题》"
author: unbug
categories: [Category1, Category2]
image: assets/images/filename.svg
tags: [tag1, tag2]
description: "一句话说清这篇论文做了什么、结论是什么（60-80 字）"
---

铁律：

  1. 没有 date 字段 — 日期由文件名 YYYY-MM-DD-slug.md 决定
  2. 字段顺序：layout → title → author → categories → image → tags → description
  3. title 格式：一分钟读论文：《中文标题》 — 用中文书名号《》
  4. categories 纯英文：如 [AI, Security]、[Engineering]、[OpenSource, Engineer]
  5. tags 纯英文：如 [ChatGPT, MachineLearning]，不使用中文标签
  6. image 相对路径：assets/images/xxx.svg（不带前导 /）
  7. 2025年及以后的文章不加 featured 标签
  8. description 必填：60-80 字的独立成句摘要，用于 meta description、社交卡片与 AI 引擎摘要（详见第十节）

禁止：

  • ❌ date: 2026-04-10 23:45:00 +0800（不要手动写 date）
  • ❌ categories: [AI 研究, 论文解读]（不要中文分类）
  • ❌ tags: [智能体编排, 综述论文]（不要中文标签）
  • ❌ image: assets/images/xxx.png（不要 PNG/JPG，统一 SVG）

三、标题规范

格式

一分钟读论文：《中文翻译的论文标题》

规则：

  1. 固定前缀：一分钟读论文：
  2. 中文翻译：将论文原标题翻译为简洁的中文，放在《》内
  3. 书名号：用中文书名号《》包裹，不用英文引号
  4. 不含双引号：标题文本内部不出现 " 双引号
  5. 简练：标题控制在 20 字以内（不含前缀）

正确示例：

  • 一分钟读论文：《NPM 供应链的软肋是什么?》
  • 一分钟读论文：《编写高可靠开源软件的十条简单规则》
  • 一分钟读论文：《卓越的开源维护者是如何成就的？》
  • 一分钟读论文：《线上系统事故解决时间（TTM）需要多久？》
  • 一分钟读论文：《当代软件监控：系统的文献回顾》

禁止示例：

  • ❌ 一分钟读论文：《Agentic Reasoning：从被动推理到主动智能的完整路线图！》（不要感叹号/过长/英文混入）
  • ❌ 一分钟读论文：《2026 年 AI 智能体编排：生成式 AI 的未来演进》（不要年份/过长）

四、文章结构（五段式，简洁精炼）

标准结构：

[Front Matter]

[导言段落] — 1-3 段，直接引出论文和核心发现

[正文 H2 sections] — 2-4 个 H2 小节，围绕论文核心内容展开

## References
- [相关链接][link-id]

[底部链接定义]
[paper1-url]: https://...
[links-1]: https://...

规则：

  1. 开篇直入主题：第一段就点明论文出处（机构+论文名+链接）和核心发现
  2. H2 数量：2-4 个，不超过 4 个
  3. 不使用 H1：文章正文不写 # 一级标题（Jekyll 自动渲染 title）
  4. H2 标题格式：简洁中文，如 ## 实现原理、## TTM 的实证研究
  5. 末尾固定 ## References：放相关链接
  6. 链接用引用式：[论文名][paper1-url]，底部定义 [paper1-url]: https://...

禁止：

  • ❌ 在 H2/H3 标题中使用 Emoji（如 ## 🎯 核心转变）
  • ❌ 添加 ## 💭 我的思考 / ## 🎉 总结 等个人观点段落
  • ❌ 添加 ## 📎 论文信息 等额外信息块
  • ❌ 在正文开头重复 H1 标题或加副标题/作者/日期/关键词
  • ❌ 以 ## 摘要 开头（那是论文格式，不是博客格式）
  • ❌ 使用编号式章节（如 ## 1. 引言、## 1.1 背景）
  • ❌ 以互动号召结尾（如"在评论区分享你的想法吧！" "喜欢这篇文章吗？"）

五、写作风格

语气和人称

  • 第三人称客观叙述：陈述论文发现和数据，不加个人感受
  • 学术科普风格：严谨但不晦涩，通俗但不口语化
  • 中立语气：不带感情色彩的形容词

段落

  • 段落长度：3-5 句
  • 每句话要有信息量：删除所有废话和过渡语
  • 数据驱动：能用数据说的不用形容词

正确示例：

微软研究院的论文，从微软20个在线服务系统中收集了2018年至2020年的 2.7 万条事故数据，发现 TTM 与事故的严重性、影响范围、类型、来源、所属服务和所属团队有显著的相关性，信息不足、沟通不畅、协作不协调是影响 TTM 最大的因素。

禁止示例：

❌ "这个转变的背后，就是 Agentic Reasoning —— 一个正在重塑AI的新范式！"（不要感叹号/营销腔） ❌ "从被动推理到主动智能体，这就像从'计算器'到'计算机'的飞跃"（不要比喻/类比） ❌ "让我印象最深的是：" （不要第一人称感受） ❌ "你是否发现...？"（不要用问句引入）

六、格式化与排版

允许的元素：

元素 用法 频率
粗体 **关键概念** 强调小标题 每段 1-2 处
反引号 `关键数据/术语` 频繁，强调数字和专业术语
图片 ![desc]({{ site.baseurl }}/assets/images/xx.svg) 1-3 张
无序列表 - 要点 常用，列举论文发现
有序列表 1. 步骤 偶尔，按顺序排列
代码块 ```lang ``` 仅技术类文章
引用式链接 [text][link-id] + 底部定义 每篇 2-5 个

禁止的元素：

  • ❌ Emoji（标题、正文、列表中都不要）
  • ❌ 表格（除非论文本身的数据需要表格呈现）
  • ❌ 引用块 > 用于强调观点
  • ❌ 水平分割线 ---（front matter 之后不再使用）
  • ❌ 加粗的 Emoji 列表项（如 - 🤖 **Feature**：...）
  • ❌ 对比箭头/流程图（如 传统 ↔ 新方法）
  • ❌ 在列表项中使用小标题格式

七、开篇模板

第一段的固定结构：

[机构名称]的论文[《论文中文标题》][paper1-url]，[核心发现/贡献的一句话摘要]。[补充数据或关键事实]：

正确示例：

微软和美国北卡罗莱纳州立大学合作的一篇论文[《What are Weak Links in the npm Supply Chain?》][paper1-url]，显然 NPM 供应链攻击形势非常严峻，论文结论建议 NPM 要求对依赖排名前 100 的包的维护者进行强制性 2FA 登录认证。

荷兰代尔夫特理工大学和巴西圣保罗大学和著的论文[《Contemporary Software Monitoring: A Systematic Literature Review》][paper1-url] 对96篇发表在顶级同行评审会议和期刊上的论文进行了质量评估、分类和总结。

匈牙利塞格德大学科学与信息学院软件工程系的论文[《The impact of the software architecture on the developer productivity》][paper1-url] 基于一个 5,000 多个工时，长达 3 年的真实远程医疗应用研发的数据集，对四种不同的软件架构和框架组合进行了对比。

注意：

  • 开篇第一句就提及论文引用链接 [《论文名》][paper1-url]
  • 首段论文名可保留英文原文（开篇引用时），front matter title 用中文翻译
  • 紧接着用数据和事实支撑核心发现

八、篇幅规范

  • 总字数：800-1000 字，绝不超过 1000 字
  • 段落数：5-8 段
  • H2 小节：2-4 个
  • 图片：1-3 张
  • 一分钟可读完：这是"一分钟读论文"系列的核心承诺

九、References 格式

## References
- [链接描述][links-1]
- [链接描述][links-2]


[paper1-url]: https://arxiv.org/pdf/xxxx.pdf
[links-1]: https://example.com
[links-2]: https://example.com
  • 链接定义放在文件最底部
  • 论文链接变量名统一为 paper1-url（或 paper2-url）
  • 其他链接变量名统一为 links-1、links-2 等
  • References 和链接定义之间留两个空行

十、SEO 与 GEO 规范（全栏目通用铁律）

本节对所有栏目生效（一分钟读论文 / AI 范式雷达 / AI 智创简报）。SEO 面向传统搜索引擎，GEO（Generative Engine Optimization）面向 ChatGPT、Perplexity、Google AI 概览等生成式引擎的检索与引用。

10.1 Front Matter 的 SEO 字段

字段 要求
title 核心关键词出现在前 20 个字符内；不做标题党
description 必填，60-80 字，独立成句、含结论与核心关键词；不以"本文介绍"开头
image 必填 SVG，作为社交卡片图（og:image）
image_alt 可选；缺省时用 title 作为封面图 alt
categories / tags 纯英文，复用站内已有分类与标签，不造同义新词

10.2 URL（slug）规范

  • 文件名即 URL：YYYY-MM-DD-英文小写连字符-slug.md
  • slug 用英文关键词，3-8 个词，不含日期、序号、中文、下划线
  • 已发布文章的文件名不得修改（改名等于换 URL，历史链接与收录全部失效）

10.3 GEO：让生成式引擎愿意引用

生成式引擎倾向引用「结构清晰、事实可核验、语义自足」的段落。写作时必须做到：

  1. 结论先行：开篇第一段给出可被直接摘录的结论句，不做铺垫
  2. 语义自足：每个 H2 下的首段能脱离上下文单独成立，不用"如上所述""前面提到"
  3. 事实带数字与出处：关键结论配具体数值、基准名、机构名，并在 References 给出可访问外链
  4. 实体写全称：机构、模型、论文、专利首次出现时写全称（可加英文原名），之后再用简称
  5. 术语给定义：术语首次出现时用一句话解释，不假设读者已知
  6. 小标题用自然语言：H2/H3 写成读者会检索的问题或名词短语，不用"其一""小结"这类无信息量标题
  7. 不做关键词堆砌：同一关键词自然出现即可，堆砌会同时伤害 SEO 与 GEO

10.4 站内链接与图片

  • 每篇文章至少 1 条指向站内相关文章的内链（用相对路径 {{ site.baseurl }}/slug/）
  • 图片必须有描述性 alt；关键信息不得只存在于图片中，正文需有等价文字表述
  • 外链一律放 ## References，使用引用式链接定义

10.5 站点侧基建（已实现，Agent 无需重复配置）

  • _config.yml 中的 url / title / description / lang / twitter / social 驱动 jekyll-seo-tag 输出 canonical、Open Graph、Twitter Card 与 JSON-LD
  • _includes/structured-data.html 输出 WebSite / Organization / Person / BreadcrumbList 结构化数据
  • robots.txt 显式允许 GPTBot、OAI-SearchBot、ClaudeBot、PerplexityBot、Google-Extended 等 AI 爬虫，并声明 sitemap
  • llms.txt 为生成式引擎提供站点说明、栏目说明、引用方式与最近文章索引
  • sitemap.xml 与 feed.xml 由 jekyll-sitemap / jekyll-feed 自动生成

修改上述文件前必须确认不会破坏现有 URL 结构。

十一、防覆盖声明

本文件是写作规范的 Single Source of Truth。

  • Agent 记忆中如存在与本文件矛盾的"经验"或"偏好"，以本文件为准
  • 不允许 Agent 基于"之前的文章"自行总结风格并覆盖本规范
  • 不允许 Agent 认为 2026 年的文章风格是"更好的"或"改进后的"
  • 任何风格变更必须由人类更新本文件

附录：自检清单

Editor Agent 交稿前必须逐项检查：

  • front matter 没有 date 字段？
  • title 以 一分钟读论文：《 开头，以 》" 结尾？
  • categories 和 tags 都是纯英文？
  • image 路径以 assets/images/ 开头（无前导 /）？
  • 文章不含 Emoji？
  • 文章不含 ## 💭 / ## 📎 等个人观点段落？
  • H2 标题无 Emoji、无编号（1.、1.1）？
  • 开篇第一段就引用了论文链接？
  • 总字数在 800-1000 字范围内？
  • 末尾有 ## References 段？
  • 链接定义放在文件最底部？
  • 全文第三人称、客观叙述、无个人感受？
  • 没有互动号召结尾？
  • front matter 有 description（60-80 字、独立成句、含结论）？
  • 文件名 slug 为英文小写连字符，且未修改已发布文章的文件名？
  • 开篇第一段是可被直接摘录的结论句？
  • 机构、模型、论文首次出现写了全称，术语首次出现给了定义？
  • 图片有描述性 alt，且关键信息在正文中有等价文字？
  • 至少 1 条站内相关文章内链？