| name | platform-aware-citation |
| description | Use when writing content that cites sources (URLs, numbers, quotes) across social platforms — each platform has different rules for whether bare URLs should appear at all. Prevents inline URL overflow on platforms where links are unclickable or unwanted (小红书, Instagram-like). Applies whenever a Writer receives research with URLs and must decide per-platform how to surface citations. |
Platform-Aware Citation
Core Principle
"URL 必须真实" ≠ "URL 必须出现"。这是两层独立决策。第一层：来源是否可信。第二层：此平台是否应该显示 URL。两层都要判断。
Per-Platform Rules
公众号 / Newsletter（长文）
- 每个事实声明 → 内联 Markdown 链接
[描述](url) + 来源标注
- 数据数字 → 标注来源平台名称
- 理由：读者环境支持点击，可信度依赖可追溯来源
小红书 / 竖屏短图文
- 正文禁止裸 URL（app 内外链不可点击，是视觉噪音）
- 数据用文字表达："来自 xxx 项目"、"GitHub 上 xxx 个 star"、"HN xxx 分"
- 结尾可选"相关项目"区域：文字列出项目名，不放链接
- 理由：小红书 app 内超链接无法点击，裸 URL 只会让读者复制失败后放弃
微博 / Twitter-like（字数受限）
- 字数允许时：放 至多 1 个最关键 URL（通常是最高热度来源）
- 字数不允许时：省略 URL，保留数字 + 项目名
- 禁止超过 1 个 URL（多链接被算法识别为外链垃圾）
- 理由：字数硬约束优先；单 URL 比多 URL 传播效果更好
决策流程
收到 research.md → 有 URL 需要引用？
├── 是 → 当前平台是什么？
│ ├── 公众号 → 全部内联链接
│ ├── 小红书 → 正文 0 个 URL，文字替代
│ └── 微博 → 0 或 1 个，看字数
└── 否 → 不涉及
Common Mistakes
| 错误理由 | 现实 |
|---|
| "约束说 URL 必须真实，我就放进去" | "真实"≠"必须出现"，两层独立判断 |
| "字数没限制就多塞 URL" | 平台 UX 规则比字数限制更优先 |
| "公众号过了，小红书也应该差不多" | 两个平台 URL 规则完全相反 |
| "用户能看懂裸 URL 是什么意思" | 不可点击的 URL 是噪音，不是来源 |
| "其他 Writer 放了 URL，我也放" | 每个平台独立判断，不参考其他平台输出 |
