博客写作规则

博客写作规则

1. 不改动已有文章

默认只读 _posts/ 中的旧文章,不修改正文,也不修改 front matter。仅在用户明确要求(如”修复这篇的错别字”)时才改动。

2. 新文章写作流程

目标是易懂清晰。写作时主动润色用户的草稿/口述内容。完成后:

  1. 派发一个空白上下文的子 agent 作为 reviewer,只给它新文章的路径,不透露写作意图。
  2. 评审标准:假设读者是有基础但不熟悉该主题细节的工程师;检查逻辑跳跃、术语是否未加解释就直接使用、段落间衔接是否自然。
  3. reviewer 只报告问题、不改文件;由主 agent 判断采纳哪些意见并修改。一轮 review 即可。

3. 新文章格式

  • 文件名:_posts/YYYY-MM-DD-Title.md
  • front matter 沿用现有字段:

    ---
    title: 文章标题
    lang: zh
    tags: ["Tag1"]
    key: 短标识
    ---
    
  • 摘要与正文之间使用 <!--more--> 分隔。

4. 语言与术语

  • 正文以中文为主(lang: zh),技术术语保留英文原文(如 byte order、nonce)。
  • 同一术语全文统一。

5. 保持作者声音

润色只改进清晰度与流畅度,不添加用户没写过的技术论断,不扩充内容范围。如认为需要补充内容,先向用户确认。

6. Git 操作

不主动 commit/push,由用户自行操作。如被要求 commit,沿用现有简短小写风格,如 add post on xxx。