本目录是文章草稿和已发布文章的工作区。修改时保持简单、克制,优先维护作者原有表达。
- 只改用户指定的文章或明确相关的文件。
- 不要整理、重命名或删除无关文件。
- 发现已有未提交修改时,默认视为用户改动,不要回滚。
- 编辑 Markdown 时保留 front matter、标题层级和原有写作风格。
- 技术文章优先写清楚事实、边界和例子,少用空泛总结。
- 文件名通常使用
YYYY-MM-DD-slug.md。 - 正文以中文为主,代码、命令和 API 名称保留英文原文。
- 章节标题可以编号,但要保持层级一致。
- 引用外部资料时,优先使用文末脚注或简短参考链接。
- 使用 「」作为中文的引号。
- 不要过分使用换行符。
- 单个单词不要使用反引号,除非这是一个比较明确的行内代码片段。如果代码片段长度超过40个字符,改成正规的代码引用,即三个反引号形态。
- 修改后用
rg或sed检查相关段落。 - 大改后查看
git diff -- <file>,确认没有误改正文或格式。