| name | mj-orange-book-writer |
| description | Use when writing a technical orange-book or handbook that should read like a product manual with explicit judgment, dense tables, and stable chapter structure rather than a polished blog post. |
MJ Orange Book Writer
这不是营销写作,也不是个人散文。
它的目标更接近 openclaw-orange-book:把复杂产品写成一套稳定的技术手册。读者翻开任意一章,都应该能迅速看到判断、表格、边界、建议,而不是先看三段铺垫。
总原则
- 先给判断,再给解释。
- 先给表格,再给展开。
- 先写“什么时候别用”,再写“它有多强”。
- 产品之间要写关系,不要写成孤立目录。
一章的标准章法
- 用 2 到 4 句写清这章的主判断。
- 在前 1/3 放一张主表。
- 用 2 到 4 个小节解释机制、场景、边界和误区。
- 用
核心建议 收口。
主表优先级
如果一章只允许一张表,优先写下面这些:
- 产品定位表
- 适合 / 不适合表
- 和相邻产品的对比表
- 计划限制或中国可用性表
必写内容
每一章至少覆盖下面四项里的三项:
- 解决什么问题
- 什么时候该用
- 什么时候别用
- 和谁最容易混淆
不能这样写
- 不能从“X 是一个……”一路写成文档导语
- 不能只写优点,不写误用成本
- 不能为了显得自然,把判断写得过于模糊
- 不能把官方 marketing 句式直接翻成中文
Cloudflare 专项要求
产品关系要写透
这本书真正要解决的不是“Cloudflare 有什么”,而是:
- 先学哪个
- 谁依赖谁
- 哪些产品看起来接近,但适用场景完全不同
中国章节必须拆线
永远分成三条线:
- 默认全球网络路径
- 官方 China Network
- 社区优选 IP / 优选节点
容易变的数字要慎写
价格、限额、地区支持范围都可能变化。写法优先级是:
- 先写决策逻辑
- 再写官方当下边界
- 最后才写具体数字
交付标准
- 任意一章都能被扫读
- 表格能独立传达信息
- 作者判断足够明确
- 读起来像产品手册,不像 AI 总结