vibecode-pro-max-kit:把 AI 编码助手变成一支工程团队
GitHub: withkynam/vibecode-pro-max-kit | Stars: ⭐ 467 | 协议: MIT | 安装: 一行 curl 命令
这个项目最扎心的一句话在 README 第一屏:
"Your AI forgets. This remembers."「你的 AI 会失忆。这个让它记住。」
作者是 flowser.ai 团队,5 月 27 日创建,两天 467 Star。目标用户覆盖了从「刚学会 Vibe Coding 的 CEO」到「在生产环境写代码的 Staff Engineer」——本质上,只要你在用 AI 写代码,这个项目就跟你有关系。
它到底解决了什么问题?
AI 编码助手(Claude Code、Codex、Cursor 等)有一个结构性的缺陷:它们没有「工程流程」,也没有「持久记忆」。
具体表现为四个痛点:
每次开新会话,上下文归零。 你上次花 20 分钟跟 AI 对齐的技术栈、代码规范、架构约定,关掉窗口就全没了。下次得从头来一遍。
文档写了就过期。 你辛辛苦苦写了 CLAUDE.md、项目文档,代码一改,文档就成了废纸。没人维护,也没法自动更新。
大任务跑到一半崩了。 上下文窗口满了,AI 开始产生幻觉,写到第三个小时的代码全废,你得从头开始。
没有规格,没有评审,没法协作。 PM 没办法在代码写出来之前看看 AI 打算干什么。AI 直接撸代码,撸完你发现方向偏了。
这个项目给 AI 编码助手装了一套完整的软件开发工程体系——不是一个简单的 CLAUDE.md 模板,而是 12 个专业 Agent + 32 个 Skill + 7 个生命周期 Hook,把「需求 → 调研 → 方案 → 实现 → 测试 → 评审 → 合入」的完整流程固化为 AI 的行为约束。
核心亮点
1. RIPER-5 规格驱动流程:AI 必须先懂再写
这是整个项目最核心的设计——RIPER-5 五阶段开发流程:
🔍 RESEARCH(调研)→ 💡 INNOVATE(探索方案)→ 📋 PLAN(写规格)→ ⚡ EXECUTE(实现)→ ✅ REVIEW(评审合入)重点是每个阶段都有硬性的权限限制,不是「建议」,是「做不到」:
RESEARCH 阶段:AI 只能读文件、搜代码、查文档——不允许提建议,不允许写代码,连「我觉得可以这样改」都不能说。就像一个只做调研不表态的分析师。
INNOVATE 阶段:可以提出 2-3 种方案并对比优劣,但不能执行 Bash 命令,不能改文件。只出想法,不动手。
PLAN 阶段:写详细的实现规格——要改哪些文件、接口怎么变、影响范围多大、怎么验证——但只能写到
process/目录里,不能动源代码。EXECUTE 阶段:严格按 Plan 实现,任何偏离都要先停下来问你要不要更新 Plan。不允许「顺手重构一下」,不允许「我觉得再加个功能更好」。
REVIEW 阶段:自动跑 tester → code-reviewer → code-simplifier → security-review 的质量流水线。
为什么这个设计重要? 因为 AI 最大的问题不是「不会写代码」,而是「太着急写代码」——你一句话它就开始撸,撸完发现架构不对、规范不对、甚至需求理解错了。RIPER-5 强制 AI 在动手之前先理解、先规划、先对齐。
每个阶段之间的切换需要你明确说 go,不会自动推进。你始终握有控制权。

2. 12 个专业 Agent + 32 个 Skill:一个完整的虚拟工程团队
这不是一个通用 Prompt,而是 12 个角色分明、权限隔离的 Agent 定义:
| Agent | 职责 | 权限 |
|---|---|---|
| vc-research-agent | 调研代码库、查文档、搜集事实 | 只读:Read、Grep、Glob、WebSearch |
| vc-innovate-agent | 提出多种方案,对比优劣 | 不可执行命令 |
| vc-plan-agent | 写详细实现规格 | 只能写 process/ 目录 |
| vc-execute-agent | 严格按 Plan 实现代码 | 完整写权限,但不可偏离 Plan |
| vc-tester | 针对 diff 自动生成测试 | — |
| vc-code-reviewer | 代码评审,检查生产就绪度 | — |
| vc-debugger | 根据错误信息定位根因 | — |
| vc-code-simplifier | 重构简化,消除冗余 | — |
| vc-git-manager | 生成规范的 commit message | — |
| vc-ui-ux-designer | UI/UX 实现时辅助设计 | — |
| vc-security-reviewer | 安全检查 | — |
| vc-update-process-agent | 功能完成后自动更新上下文文档 | — |
32 个 Skill 则通过关键词自动匹配触发。比如你说「加一个 webhook」,vc-security 和 vc-scenario 这两个 Skill 会自动浮上来——因为 webhook 涉及安全(签名验证)和场景覆盖(重试、幂等)。

3. 自进化的「永久记忆」:越用越聪明
这是项目最独特的地方——它不是一次性帮你配好 CLAUDE.md 就完事了。
上下文路由系统:项目知识不是塞在一个巨大的文件里,而是按领域自动分域:
process/context/
├── all-context.md # 根路由——读任务,加载相关领域
├── tests/all-tests.md # 测试相关
├── container/all-container.md # Docker / 部署 / 基础设施
├── uxui/all-uxui.md # 组件、设计 Token、样式规范
└── {你的领域}/all-{domain}.md # 任何有 3+ 文档的领域自动建
AI 处理支付功能时,只加载支付相关的上下文——而不是把你全部代码库文档都塞进上下文窗口。

自更新机制:每完成一个功能,vc-update-process-agent 会自动把这次开发中的关键发现——架构决策、调试心得、新增模式——写回到对应的上下文文件里。你的第 100 个功能会自动受益于前 99 个功能的经验积累。
抗上下文压缩:Plans、Reports、Context 全部持久化在磁盘上。即使上下文窗口压缩(compaction)了,Session Init Hook 会把关键状态重新注入。跑三个小时的大任务不会中途崩掉。
4. 支持 7 种 AI 编码工具,30 秒安装
curl-fsSL https://raw.githubusercontent.com/withkynam/vibecode-pro-max-kit/main/install.sh | bash然后在 Claude Code 里说一句 Run vc-setup。
Setup 过程不是机械地填模板——Agent 会跟你对话,理解你的项目是什么、给谁用、架构怎么设计的、有什么约定俗成的规范……然后它深度扫描代码库,把真实内容填进上下文文件,不留任何 placeholder。
支持的平台:Claude Code、Codex CLI、Cursor、Windsurf、Antigravity(Gemini CLI)、OpenCode、GitHub Copilot。
安装时会自动备份你已有的 .claude/ 配置到 .vibecode-backup/,已有的 process/ 目录不会被覆盖。
和同类项目比
| vibecode-pro-max-kit | Superpowers | GSD | |
|---|---|---|---|
| 开发流程 | RIPER-5 五阶段 + 权限硬限制 | 固定工作流 | 单任务 |
| Agent 数量 | 12 个专业 Agent | 插件式 | 无 |
| 上下文管理 | 领域路由 + 自动更新 | 插件记忆 | 磁盘持久化 |
| 团队协作 | 共享 Spec、Plan、评审产物 | 单人 | 单人 |
| 多工具支持 | 7 种 AI 编码工具 | Claude Code 插件 | 14 种运行时 |
| 安装 | 一行 curl + 自动配置 | 插件市场 | npx |
(注:Superpowers 是 Claude Code 的插件平台,GSD 是另一个 AI 编码 Harness——两个都是同赛道的项目。GSD 支持的运行时更多(14 种),但 vibecode 在每个平台上做得更深——完整的 Agent 体系、Skill 发现、生命周期 Hook。)
适合谁用?
用 Claude Code / Codex / Cursor 写代码的开发者——如果你每天跟 AI 结对编程,这个 Harness 能让你的 AI 搭档从一个「记性差的实习生」变成「有流程意识的 senior engineer」
Vibe Coding 的产品经理 / 创业者——你把需求描述给 AI,它先生成 Spec 给你审批,过了再实现。你有机会在代码写出来之前纠正方向
带团队的 Tech Lead——Spec 和 Plan 是团队共享的评审产物,不只是 AI 的自言自语
一点提醒
项目目前仍然是早期阶段(创建才两天),文档非常详尽但实际体验还需要自己踩坑验证
12 个 Agent 的模型默认都设为
sonnet,如果你用的是 Opus 或其他模型,建议根据任务复杂度自己调整强依赖 Claude Code 的 hooks 机制,其他平台(Cursor、Copilot 等)的体验会打折扣——这是 Agent 工具链生态的现实差距
项目 GitHub: withkynam/vibecode-pro-max-kit
夜雨聆风