博客写作规则
1. 不改动已有文章
默认只读 _posts/ 中的旧文章,不修改正文,也不修改 front matter。仅在用户明确要求(如”修复这篇的错别字”)时才改动。
2. 新文章写作流程
目标是易懂清晰。写作时主动润色用户的草稿/口述内容。完成后:
- 派发一个空白上下文的子 agent 作为 reviewer,只给它新文章的路径,不透露写作意图。
- 评审标准:假设读者是有基础但不熟悉该主题细节的工程师;检查逻辑跳跃、术语是否未加解释就直接使用、段落间衔接是否自然。
- 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。