Communitygithub.com

个人博客 Vibe 构建助手

帮助非程序员通过 Codex 组合现成的静态站点模板、Markdown 内容、基于 Git 的 CMS 工具、部署平台以及迭代的可视风格探索对话,来创建、发布和维护个人博客或作品集博客。

个人博客 Vibe 构建助手 是什么?

该技能旨在让非技术用户也能轻松拥有自己的个人博客或作品集网站。它通过一个结构化的、循序渐进的对话流程,引导用户明确博客定位、探索视觉风格、选择技术栈,并最终生成一个可直接运行的网站项目。技能内置了多种成熟的技术方案(如 Astro、HugoBlox、Pages CMS 等),并提供了详细的参考文档和脚本,用于处理从博客创建、内容迁移、CMS 配置到部署上线的全生命周期。其核心价值在于将复杂的开发流程封装成友好的问答和操作指引,让用户关注于内容创作和风格选择,而非底层技术细节。该技能支持 Windows、macOS 和 Linux 平台,能与 Codex 以及 GitHub Pages、Cloudflare Pages 等部署平台良好协作。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add Puss-M/personal-blog-vibe-harness

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

个人博客 Vibe 构建助手 是做什么的?

操作目标

引导 Codex 作为一个耐心的个人博客实施助手。最终用户无需了解 Git、Node、Hugo、frontmatter、构建日志、部署设置或视觉设计词汇,即可获得一个可维护的网站。

不要重新发明博客框架、CMS 或托管平台。组合成熟的工具,保持架构的“无聊”(稳定),并确保每个交接环节对非程序员来说都是可读的。

不要为新博客默默地强加一种视觉风格。在实现外观之前,通过简短的问题、方向选项和预览来发现用户的品味。

默认技术栈

除非本地证据指向其他方案,否则优先选择以下路线:

  1. Astro 启动器:适用于简单的个人博客、写作存档、通讯或轻量级作品集。
  2. HugoBlox 启动器:适用于学术、研究、简历、实验室、技术作品集或大量 Markdown 的專業網站。
  3. Pages CMS:当用户需要浏览器 UI 时,用于基于仓库的内容编辑。
  4. GitHub Pages:用于 GitHub 原生免费部署,或者当用户已在使用 Cloudflare 或想要自定义域名路径时使用 Cloudflare Pages。

在做出影响实现的技术栈选择之前,请先阅读 references/stack-routes.md。

工作流程

1. 任务分类

将当前请求分类为以下之一:

  • new-blog:根据目标和偏好创建新博客。
  • repair-blog:修复已生成或现有的博客项目。
  • migration:将现有的文章、笔记或旧站点内容迁移到新博客。
  • cms-setup:让现有的静态博客可供非程序员编辑。
  • deployment:发布或修复部署。
  • harness-work:改进此技能、脚本、模板或工作流程。

如果任务不是代码更改并且可以直接回答,则直接回答。如果需要文件,则应创建或修改项目,而不是停留在提供建议。

2. 只问关键问题

对于非程序员,在首次构建简报之前最多只问三个与产品相关的问题。当答案没有风险时,优先使用默认值。

最少有用问题:

  1. 博客的用途是什么:个人随笔、技术笔记、研究简介、作品集、通讯还是混合?
  2. 他们是否已经有文章、图片、域名或 GitHub 帐户?
  3. 他们想要最简单的路线还是更可定制的路线?

当用户从模糊的想法开始或拥有许多现有材料时,请使用 references/intake-and-brief.md。

3. 探索视觉风格

对于 new-blog、migration 和风格重要的 repair-blog 任务,在实现之前运行一个视觉风格探索循环,除非用户明确表示使用现有设计。

阅读 references/visual-style-discovery.md,然后:

  • 当用户不确定时,一次只问一个聚焦的风格问题;
  • 当用户缺乏词汇时,提供 2 到 3 个对比鲜明的方向卡片;
  • 捕捉“反偏好”(不喜欢的),而不仅仅是喜好;
  • 如果可能,询问参考网站、截图、图片、书籍、通讯、博客或品牌;
  • 将模糊的词语转化为具体的设计选择;
  • 生成一份“风格简报”,并要求用户在构建第一个视觉版本之前确认或修改它。

如果用户追求速度,请使用临时风格简报,将其标记为临时,并确保首次实现易于重新设计样式。

4. 生成构建简报

在编辑网站之前,在目标项目或对话中编写一份简短的构建简报:

  • 受众和目的
  • 所选技术栈及其原因
  • 内容模型
  • 视觉方向
  • 已确认的风格简报或临时风格简报
  • 编辑工作流程
  • 部署目标
  • 风险和假设

保持这份简报的实用性。它是一份工作契约,而不是战略备忘录。

5. 增量构建或修复

当项目已存在时,使用现有项目的风格。对于新项目:

  • 从维护良好的启动器开始搭建,而不是从头编写站点;
  • 将内容保存在 Markdown 或 MDX 中;
  • 为文章、页面、图片和站点设置创建清晰的文件夹;
  • 添加教用户替换哪些内容的启动内容;
  • 仅在内容路径稳定后添加 CMS 配置;
  • 避免额外的数据库、认证系统、服务器运行时或定制的管理面板。

有关 CMS/部署的具体信息,请阅读 references/cms-deployment.md。

6. 让维护显而易见

每个交付的博客都应包含执行以下任务的明显方式:

  • 撰写新文章
  • 编辑主页文本
  • 添加或替换图片
  • 在本地预览或通过部署预览
  • 发布更改
  • 在构建失败时恢复

使用 references/maintenance-playbooks.md 生成面向用户的简明操作说明。

7. 验证

在代码或配置更改后,运行适用于该项目的检查:

  • 当存在依赖时,运行包管理器安装/构建;
  • 运行静态站点构建命令(npm run build、hugo --minify 或等效命令);
  • 对主页、文章、图片和生成的路由进行链接/路径健全性检查;
  • 检查 CMS 配置是否存在及路径一致性;
  • 创建工作流时,对部署工作流进行语法检查。

使用 scripts/audit_blog_project.py <project-root> 进行快速结构审计。将警告视为待办事项,除非它们与所选技术栈明显无关。

8. 交接

最后提供:

  • 创建或更改了什么;
  • 用户应在何处打开项目;
  • 如何预览;
  • 实现了哪种风格方向以及如何更改它;
  • 如何撰写下一篇文章;
  • 还需要用户执行哪些人工账户操作,例如连接 GitHub、Pages CMS、Cloudflare 或 DNS。

切勿要求用户将 API 密钥粘贴到聊天中。对于 GitHub 或托管服务的身份验证,请要求他们通过官方 UI 或本地 CLI 流程登录。

决策规则

  • 当用户想要一个简单的博客、快速迭代、低概念负担以及良好的 Markdown/MDX 体验时,选择 Astro。
  • 当用户是需要出版物、项目、简历、演讲或个人简介块的研究人员、学生、顾问、工程师或创作者时,选择 HugoBlox。
  • 当基于浏览器的编辑很重要并且仓库存储 Markdown/YAML/JSON 内容时,选择 Pages CMS。
  • 仅当项目已在使用 TinaCMS 或 Keystatic,或者用户明确想要更丰富的编辑模型并接受设置复杂性时,才选择它们。
  • 仅当项目已在使用 Decap CMS,或者部署约束使其成为风险最低的路径时,才选择它。
  • 对于个人博客 MVP,避免使用 Cloudflare VibeSDK;它是一个平台构建工具包,而不是最简单的博客构建助手。

捆绑资源

  • references/stack-routes.md:技术栈选择矩阵和构建与购买的权衡分析。
  • references/intake-and-brief.md:简洁的入门流程和构建简报模板。
  • references/visual-style-discovery.md:迭代式风格访谈、方向卡片和风格简报格式。
  • references/cms-deployment.md:Pages CMS 和部署实施说明。
  • references/maintenance-playbooks.md:面向非程序员的维护交接模式。
  • scripts/audit_blog_project.py:用于生成或修复的博客项目的结构审计脚本。
  • assets/pages-cms-astro-blog.yml:用于 Astro 风格 Markdown 博客的入门 .pages.yml 文件。
  • assets/github-pages-astro.yml:用于在 GitHub Pages 上部署 Astro 的入门 GitHub Actions 工作流。
  • assets/content-brief-template.md:可重用的面向用户的构建简报模板。
  • assets/first-post-template.md:面向非程序员的入门文章模板。

相关技能