Skip to content

Latest commit

 

History

History
26 lines (19 loc) · 1.16 KB

File metadata and controls

26 lines (19 loc) · 1.16 KB

AGENTS.md

本目录是文章草稿和已发布文章的工作区。修改时保持简单、克制,优先维护作者原有表达。

工作原则

  • 只改用户指定的文章或明确相关的文件。
  • 不要整理、重命名或删除无关文件。
  • 发现已有未提交修改时,默认视为用户改动,不要回滚。
  • 编辑 Markdown 时保留 front matter、标题层级和原有写作风格。
  • 技术文章优先写清楚事实、边界和例子,少用空泛总结。

文章格式

  • 文件名通常使用 YYYY-MM-DD-slug.md
  • 正文以中文为主,代码、命令和 API 名称保留英文原文。
  • 章节标题可以编号,但要保持层级一致。
  • 引用外部资料时,优先使用文末脚注或简短参考链接。
  • 使用 「」作为中文的引号。
  • 不要过分使用换行符。
  • 单个单词不要使用反引号,除非这是一个比较明确的行内代码片段。如果代码片段长度超过40个字符,改成正规的代码引用,即三个反引号形态。

验证

  • 修改后用 rgsed 检查相关段落。
  • 大改后查看 git diff -- <file>,确认没有误改正文或格式。