[HexoPress] AI 协作开发与 OpenSpec 工作流

HexoPress 不仅在产品中集成了 AI 写作助手,在开发过程本身也积极拥抱 AI 协作。项目采用了 OpenSpec 工作流来驱动功能的设计和实现,并在仓库中保留了完整的配置和实践记录。

什么是 OpenSpec

OpenSpec 是一种规范驱动的开发工作流。它的核心理念是:在写代码之前,先用结构化的规范(Spec)来描述功能的需求、设计和约束。AI 助手可以基于这些规范来理解项目上下文,生成更准确的代码和建议。

与传统的「直接让 AI 写代码」不同,OpenSpec 强调的是人与 AI 的协作过程:

  1. 探索阶段:与 AI 一起分析需求,厘清问题边界
  2. 规范阶段:将讨论的结果沉淀为结构化的规范文档
  3. 实现阶段:基于规范进行编码,AI 可以参考规范提供更精准的帮助
  4. 验证阶段:对照规范检查实现是否完整和正确

HexoPress 中的实践

在 HexoPress 的仓库中,你可以找到完整的 OpenSpec 配置:

openspec/config.yaml 定义了项目的上下文信息,包括技术栈、编码规范和工件生成规则。openspec/specs/ 目录下保存了多个功能模块的规范文档,涵盖了仪表盘布局、标签管理、AI 聊天面板、AI 预设、编辑器体验等核心功能。

openspec/changes/archive/ 中则保存了已完成的变更记录,你可以看到每个功能从需求分析到实现完成的完整过程。

多 AI 助手支持

HexoPress 的开发环境配置了多个 AI 助手的工作流定义,包括 Claude、Codex 和 Gemini。这些配置位于 .agent/.claude/.codex/.gemini/ 目录下,定义了统一的技能集(探索、创建变更、继续变更、应用变更、验证、归档等)。

这意味着无论你习惯使用哪个 AI 编码助手,都可以在 HexoPress 项目中使用 OpenSpec 工作流。

为什么值得关注

对于开发者来说,HexoPress 的 OpenSpec 实践有几个值得关注的点:

真实的案例。 这不是一个演示项目,而是一个正在活跃开发的真实产品。你可以看到 OpenSpec 在实际项目中是如何运作的,包括它的优势和局限。

完整的记录。 从规范文档到变更归档,整个过程都保留在仓库中。你可以回溯每个功能的设计决策,理解「为什么这样做」而不仅仅是「做了什么」。

可复制的模式。 HexoPress 的 OpenSpec 配置可以作为你自己项目的参考。如果你想在自己的项目中尝试 AI 协作开发,这里有一套经过实践验证的配置模板。

参与 AI 协作开发

如果你想参与 HexoPress 的开发,OpenSpec 工作流可以帮助你更快地理解项目。在开始一个新功能之前,你可以先阅读相关的规范文档,了解现有的设计决策和约束。在实现过程中,AI 助手可以基于这些规范提供更有针对性的建议。

这种工作方式特别适合开源项目的协作——规范文档充当了设计意图的载体,让新的贡献者不需要通过大量的代码阅读就能理解项目的设计思路。