跳到主要内容

人工共建指南

不用 AI，也完全可以给这个站点写出很像样的内容。

关键不是写得多，而是先想清楚，再下笔。

先别急着总结，先做判断​

对一条新资源，我最建议先回答这几个问题：

  • 它到底解决了什么问题
  • 它和我已经知道的资料相比，有什么新的东西
  • 它最强的地方在哪里
  • 它最虚的地方在哪里
  • 它适合谁，不适合谁

如果这些问题都还模糊，先别写正文。

一个简单但够用的人工阅读法​

第一遍：只看结构​

别急着记笔记，先看：

  • 它的目录怎么排
  • 作者想把你带到哪里
  • 它是偏入门、偏架构、偏实战，还是偏观点

这一遍的目标不是学会，而是定性。

第二遍：挑最有区分度的部分​

别平均用力。

去找那些真正能把它和别的资源区分开的章节、案例或观点。通常就是这些部分，决定这条资源该不该被收进来。

第三遍：带着问题回看​

这时候再回头看细一点，重点问：

  • 这部分对真实项目有什么帮助
  • 这是长期判断，还是只对当前框架成立
  • 我以后还会不会回来翻它

怎么写，才不像摘要​

最简单的办法就是强迫自己写“取舍句”。

比如不要写：

  • “本书系统介绍了……”

而要写：

  • “这条资源最值钱的不是基础概念，而是它把 X 讲成了工程问题。”
  • “如果你现在只想快速入门，这部分其实可以先跳。”
  • “它讲得最虚的地方是……”

一旦你开始写这种句子，文档就不太会滑回摘要腔。

写不下去时，用这个最小骨架​

资源总览页​

  • 这是什么
  • 为什么收它
  • 适合谁 / 不适合谁
  • 我建议怎么用

锐评页​

  • 它最强的点
  • 它的问题或边界
  • 值不值得投入时间
  • 我的使用方式

学习沉淀页​

  • 先挂会继续写下去的内容
  • 不要为了完整而补空页

最后自问一句​

如果把资源名字抹掉，这篇文档还成立吗？

如果答案是“成立”，说明你写得还不够具体，还没有真正抓住这条资源的特征。