readable-output

Installation
SKILL.md

输出工程:让 AI 输出长内容时按清单想一遍

综合写作理论(Zinsser《On Writing Well》/ Heath《Made to Stick》/ Rosenfeld《Information Architecture》)+ 学习科学(Sweller CLT / Brown《Make It Stick》/ Wiggins backward design)+ 大厂文档实践(Stripe / GitLab / Linear / Anthropic / Google SRE)三方交叉验证。


元原则(贴在最顶层,每次开始前默念)

  1. 如果你自己读完没有获得新认知,读者也不会有。 写作是 thinking on paper,不是模板填空。
  2. 终点是"读者下次能用",不是"读者这次能懂"。 Backward design:先想读者读完手里多了什么"可复用的工具"(一张对照表 / 一个判断框架 / 一条决策路径 / 一个口诀),再倒推写什么。
  3. 不列菜单——给推荐 + 一句话理由。 AI 喜欢"列出 5 个选项让你选",但好文档敢于 opinionated。

触发条件

Installs
6
GitHub Stars
684
First Seen
May 14, 2026
readable-output — yunshu0909/yunshu_skillshub