Platform Aware Citation

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.

fufankeji cbf8428 2 files · 5.0 KB Updated

File contents

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,我也放" 每个平台独立判断,不参考其他平台输出

fufankeji/fufan-vibecodingcourse/tree/main/Stage7_Superpowers_Applied/Lesson13_SpecKit_Superpowers_Cooperation/nanoclaw-v2-backend/.claude/skills/platform-aware-citation commit cbf84287b0

Frequently asked questions

npx skillmds@latest add fufankeji/platform-aware-citation