夜雨聆风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