SuperAPI AI Directory

style-guide

Writing & research

View repository

Updated 10-15 21:55

About this skill

Global Style Guidelines

This skill defines the global style rules for Chinese technical writing.

Core files: STYLE.md

How to use

When writing or doing quality checks, read STYLE.md, and follow the prohibitions and check items in it.

Scope of application

  • Long-form official account articles → gracker-writer references this specification
  • General content quality checks → content-quality-gate references this specification
  • X/Twitter short posts → referenced independently
  • AIW technical books → there are additional requirements at the end of STYLE.md

Rules at a glance

Prohibited

  1. Big-tech jargon (empowerment, closed loop, foundation, lever...)
  2. Reporting-style phrasing (in summary, it is not hard to see, it is worth noting...)
  3. Internet memes (YYDS, juejuezi, dimensional strike...)
  4. High-frequency AI clichés (to put it plainly, essentially, in other words...)
  5. AI contrastive sentence pattern ("not X but Y" at most 2 times per article)
  6. Exaggerated metaphors and emotional slogans

Requirements

  • Use precise engineering terminology
  • Facts first, judgment after
  • Let data speak, avoid vague adjectives
  • Metaphors can only serve as scaffolding
  • Code/data/charts must have context

For the complete rules, see STYLE.md。