主题
判断只有一条：一篇博客要能被下一次写作找到，而不是只被下一次搜索碰到。
站点能把 Markdown 渲染成页面，只解决了「发得出去」。真正会腐坏的是写法——每篇重新发明开口、证据、步骤和收束。把这四件事收成合同，写作才能被安装，而不是被临场发挥。
案例
这个站上线后的前三篇，有判断，没有骨架。上线宣言列了待办，Markdown 主线列了好处，技术选型把构建期能力写清楚了，但三篇的目录长得都不一样。读者进下一篇，还要重新学习「这篇在哪一段给结论」。
同一次重构里，我把写作收成仓库里的 blog-post skill。缺的不是又一个模板填空，是固定顺序：先说主题，再给现场，再说判断或方法，然后让人能上手，最后收回来。白话说明在怎么写。
观点
这五件事是骨架，风格是口气，配图和关联是附件。不要揉成一件。
| 合同 | 解决什么 | 不解决什么 |
|---|---|---|
| 五件事 | 一篇怎样才算写完 | 口气、配色 |
| 写作风格 | 开口和密度 | 目录结构 |
| 风格化配图 | 判断的静物 | 必须正确的字和数 |
| 关联索引 | 主张之间的边，带 why |
共同标签凑出来的相关 |
风格有六种：essay / howto / narrative / thesis / field-notes / explainer。它们只改每一节怎么说话。howto 也不能没有主题和观点；essay 也不能没有实操。
案例这一节是「最好有」。没有真实现场，就整节删掉，不要编一个「某公司曾经」。
实操
- 安装 skill：
npx skills find blog postnpx skills add xdxer/xdxer.github.io --skill blog-postfind-skills 能搜到它，是因为 description 写了触发词。公开仓库里有一份合格 SKILL.md，CLI 就能装。
- 在
src/content/posts/<slug>.md写正文。大标题就用这五个词：
## 主题## 案例## 观点## 实操## 总结观点 和 方法 二选一。细节用 H3。frontmatter 带上 style、related、hero。
- 校验并发布：
python3 skills/blog-post/scripts/related-index.pynpm run build脚本会查关联边，也会查这五节是否按序出现。缺案例只提醒；缺另外四节或顺序乱了，不能过。通过后再提交 main。
2026-09-15 更新：五节后来改成了五件事要素——判断、例子、理由或方法、能用的一步、边界——小标题按内容起，脚本不再查标题顺序，只查关联边、参考是否在最后和 wiki 来源页。锁死标题不适用于所有主题。
配图默认跟站点：炭黑桌、奶油纸、铜、金线。从同一张底板 image_edit，不重新抽签。金线只在「这篇在连别的东西」时出现。精确数字和结构图用代码画，不要生成。
索引在 /graph/。显式 related 优先，回链自动出现，系列补顺序，标签只做兜底。
总结
有些能力明确不做：
| 能力 | 结论 |
|---|---|
| 把正文生成进图片 | 模型不配碰必须正确的字 |
| 自动给所有旧文两两连边 | 没有主张的边比没有边更糟 |
| 六种风格写成六套填空模板 | 风格是口气，不是第二副骨架 |
| 没有现场就编案例 | 宁可缺这一拍 |
可安装，不是因为写作变成了流水线，而是因为判断、现场、步骤和边界终于有固定的住处。
工程层那条「构建期做完」没有变，见技术选型与取舍。
