X Xiaowu

心得

一些我反复确认的小信条——关于取舍、克制、工程与真诚。它们大多先成了这个站点的开发规范，再沉淀成这里的句子。

取舍 · Trade-offs

  1. §2.4.1

    长期 > 短期

    永远向前看。今天的省力，是明天的债。

  2. §2.4.2

    少 > 多

    不确定要不要做，就默认不做。加上去永远比删下来容易。

  3. §2.4.3

    优雅 > 方便

    便利不是最高目标，对项目最贴切才是。

  4. §2.4.4

    一致 > 新鲜

    3 个月后回看仍合适，才值得引入。

克制 · Restraint

  1. §0

    留白是内容，克制是态度

    极简不是简陋。每一处装饰都要回答「不加会更好吗」。

  2. §1

    全站只一种强调色

    除中性灰阶外，克制蓝是唯一的声音。

  3. §5

    动效要无感

    时长 ≤300ms，缓动统一，能不动就不动。

工程 · Craft

  1. §2.1

    文档先行

    文档是唯一真理来源，每个决策都能引用到某一条。

  2. §2.2

    RFC 再动手

    跨文件的改动，先写清背景、取舍、回滚，再写代码。

  3. §5.2

    增量，不顺手重构

    不顺眼的代码先记进想法池，下次专门处理。

真诚 · Honesty

  1. §1

    删掉一句也成立的句子，就删

    简洁是对读者时间的尊重。

  2. §9

    不编造经历与数据

    不确定的数字加「约」，链接必须真实可达。

  3. §8

    AI 辅助要透明披露

    AI 主笔或超过三成段落，frontmatter 标 aiAssisted。