Quartz Blog Frontmatter Normalizer

Workflow

1. Locate target markdown files (usually under Quartz content folder).
2. For each file:
   • Read and parse frontmatter.
   • Ensure description exists:
     • If missing or empty, generate one short Chinese sentence summarizing the post.
   • Ensure draft exists:
     • If missing, set draft: true.
   • Ensure tags are English kebab-case strings:
     • Translate Chinese tags to English first.
     • Normalize each tag to kebab-case (lowercase-words-with-hyphen).
   • Rename file stem to kebab-case.
   • If the filename changed, ensure aliases includes the original title:
     • If aliases missing, create it.
     • If aliases exists, append (do not replace).
     • De-duplicate if the title is already present.
     • If title is missing, report it and do not add aliases.
3. Verify no article body lines changed.
4. Report changed files and any tags that required manual translation choices.

Tag Conversion Policy

• Prefer explicit translation for domain terms (example: 前端 -> frontend, 后端 -> backend).
• Avoid pinyin unless user explicitly requests it.
• If a Chinese tag is ambiguous, stop and ask for a one-time mapping decision.

Filename Policy

• Use kebab-case ASCII filename stems.
• Keep .md extension.
• If source filename is non-ASCII and no clear English translation is available, ask for slug mapping before rename.

Verification Checklist

• Every target file has description and draft in frontmatter.
• draft defaults to true only when originally missing.
• All tags are English kebab-case.
• Markdown body is byte-equivalent before vs after.
• Renamed filenames are kebab-case.
• For renamed files, aliases contains the original title.
• For non-renamed files, do not add or modify aliases.