让 AI 编程不再「盲写」：vaultspec-core 把决策先写下来的开发框架

你用 AI 写代码的时候，有没有这种感觉——Claude 噼里啪啦生成一堆，但方向对不对、决策有没有记录、下次换个 context 回来全忘了？

这不是 Claude 的问题，是你没给它一个「工作剧本」。

vaultspec-core 就是干这个的。它是一个专为 AI 编程 Agent 设计的 Spec-Driven 开发框架，核心理念就一句话：在写代码之前，先把决策写下来。

它怎么工作的

vaultspec-core 把开发拆成 5 个强制阶段，每个阶段 AI 都要产出实体文档，不能跳步：

1. Research（研究） — AI 先调研问题、竞品方案、技术选项
2. ADR（架构决策） — 基于研究结论，写一份「决策记录」，为什么要这样选、权衡了什么
3. Plan（计划） — 把决策拆成可执行的步骤，不是直接写代码
4. Execute（执行） — AI 按计划逐阶段写代码，你中途可以干预
5. Review（审查） — 最终交付前做代码审计，输出审查报告

每个阶段的产物都存在项目根目录的 .vault/ 文件夹里，以 Markdown 格式保存。

为什么有意思

多人协作时巨有用。 A 问了 Claude 做了调研和决策，B 接手时代码还是新的、但 .vault/ 里有一整套决策上下文，Claude 一读就接上了。不用 no prompting。

和传统 spec 文件不一样的是，vaultspec 的 artifact 是结构化的——ADR 有固定格式、计划有检查清单、执行有日志，这套东西 AI 能直接读进去作为下一阶段的输入。

它还自带 MCP Server。 安装后 Claude Code 可以直接调用 vault discovery 和文档创建工具，不用装额外的插件。Python 3.13+ 环境装起来也很快。

使用方式

# 装 CLI
git clone https://github.com/wgergely/vaultspec-core.git
cd vaultspec-core
uv sync

# 初始化项目
vaultspec-core install --target ./my-project

# 指定 Claude Code 环境
vaultspec-core install claude --target ./my-project

# 打开 Claude Code，剩下的交给规则引擎
cd my-project
claude

装好后 AI 会自动遵守 pipeline 规则——你说「Research options for adding full-text search to the API」，它就会乖乖先去 .vault/research/ 写调研报告，不会直接蹦出一堆代码。

适合谁

如果你是一个人作战、代码量不大，可能感觉有点重。但对于 团队用 AI 编程、多人交接项目、或者代码库有历史债务需要追踪决策 的场景，这套框架的价值立刻就体现出来了。

底层技术是 Python 3.13+，需要 uv 包管理，有 10 个捆绑技能覆盖研发全流程，目前还在积极维护（最新版本 0.1.56，2026 年 6 月还有更新）。

GitHub：https://github.com/wgergely/vaultspec-core

GitHub: https://github.com/wgergely/vaultspec-core