sui-blog
基于Astro构建的个人技术博客平台，支持Markdown管理和静态生成。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：sui-blog。 它的用途是：基于Astro构建的个人技术博客平台，支持Markdown管理和静态生成。 完整的 Skill 内容见：https://321skill.com/skills/sui-blog/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我想用sui-blog搭建我的技术博客，已经克隆了仓库，接下来该怎么创建第一篇关于React Hooks的文章？” 它会引导你运行`bun run new-blog`命令生成文章模板，并解释如何在Markdown文件中编写标题、描述和标签，最后通过`bun run dev`在本地预览效果。
介绍
sui-blog是一个专为技术内容创作者设计的个人博客平台，旨在解决搭建和维护高性能、易于管理的技术博客的复杂性问题。它通过Astro静态站点生成器构建，将Markdown文件自动转换为美观、快速的静态网页，让创作者可以专注于内容本身，而无需操心繁琐的网站运维。
使用sui-blog非常简单。开发者只需将Markdown格式的博客文章放置在指定的contents/blog/目录下，系统便会自动处理页面生成、标签分类、全文搜索索引构建以及OGP图片生成等一系列工作。项目提供了bun run new-blog等便捷命令来创建新文章模板，并通过bun run dev启动本地开发服务器进行实时预览。
这个Skill非常适合有技术背景的内容创作者，特别是前端开发、全栈开发以及希望建立个人技术品牌的技术博主。它提供了现代化的技术栈和开箱即用的功能，如暗色模式、响应式设计和RSS订阅，能够满足技术分享的基本需求。
对于使用者，建议在开始前确保已安装Bun或Node.js环境。由于项目深度集成了Astro的静态生成和Islands架构，非常适合部署在Cloudflare Workers等边缘计算平台以获得极致的访问速度。需要注意的是，其交互功能（如搜索）依赖于客户端JavaScript，在构建后是完全静态的站点。
核心特点
与许多通用博客框架不同，sui-blog深度集成了针对技术博客的优化工作流，如通过Satori在构建时静态生成每篇文章的OGP图片，以及使用Pagefind实现无需后端服务的客户端全文搜索，在保持纯静态部署的同时提供了动态体验。
注意事项
由于采用纯静态生成（SSG），不适合需要实时用户交互（如评论、点赞）或高频内容更新的博客场景。
常见问题
sui-blog支持评论功能吗？
默认不支持。它是一个静态站点，如需评论，需要自行集成第三方服务（如Giscus、Utterances）。
部署一定要用Cloudflare Workers吗？
不是必须的。构建生成的`dist`文件夹是纯静态文件，可以部署到任何静态托管服务（如Vercel、Netlify、GitHub Pages）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/sui-blog/raw/index.md 读取 sui-blog 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/sui-blog/raw/index.md（查看排版版本）