soumatheusgomes/vibe-coding-toolkit

🎧 Vibe Coding Toolkit – AI辅助开发的实用工作流

是什么 – 一套文档化的工具、提示词和配置模板，让开发者能够将大型语言模型编码助手（Claude Code、OpenAI Codex 等）作为团队中一个有纪律的成员使用。该仓库不提供新模型；它提供的是一个流程，以及使该流程在生产环境中可重复的“粘合剂”（插件、钩子、Lint规则、子代理编排）。

为何重要 – 许多AI编码指南止步于“粘贴大提示词，祈祷好运”。本工具包展示了一个真实世界的流程，解决了作者在生产级金融科技项目中遇到的具体痛点：

• 会话连续性（运行之间的记忆保持）
• 防止代理过度生成或偏离请求
• 并行子代理（审查、数据库、测试）专业化协作，互不干扰文件
• 自动质量门控强制（ESLint/Biome），将警告转为可追踪的错误
• 轻量级“超能力”纪律，强制在编写任何代码前完成头脑风暴 → 计划 → 实施 → 审查循环

核心组件

组件	功能	使用方法
超能力 (docs/tools/01‑superpowers.md)	强制执行头脑风暴 → 计划 → 实施 → 审查循环；最具影响力的习惯。	安装 Claude-Code 插件 superpowers@claude-plugins-official，并在让模型编写代码前调用该技能。
子代理编排 (02‑subagent‑orchestration.md)	以“波次”方式运行多个专业化代理实例，确保它们从不同时编辑同一文件。	遵循文档中描述的协议；仓库包含波次分发提示词的模板。
RTK令牌代理 (03‑rtk-token-proxy.md)	CLI 工具，将重复命令（git status、diff、log 等）重写为紧凑的节省令牌形式。	在会话中使用提供的脚本作为这些命令的即插即用替代品。
波尼泰尔与穴居人角色 (04‑ponytail.md / 05‑caveman.md)	简单的决策与沟通策略，保持代理专注且简洁。	在工作开始前，将角色提示词添加到 Claude/Codex 会话中。
质量门控（ESLint/Biome） (06‑eslint‑biome‑quality‑gates.md)	将选定的 Lint 警告转为硬错误，强制执行每文件不超过 350 行的上限，并记录违规。	运行预准备的提示词 08‑eslint‑quality‑gates‑install.md（或从 templates/eslint/ 复制配置文件）。
Graphify 与 Context7 (07‑graphify.md / 12‑context7.md)	构建代码库的持久知识图谱，并将最新库文档注入模型上下文。	部署文档中描述的可选 MCP 服务器；工具包展示了如何将其接入 Claude。
Obsidian 内存 (08‑obsidian‑memory.md)	存储在 Obsidian 仓库中的长期项目笔记，通过 MCP 协议由代理访问。	初始化仓库，并将 MEMORY.md 索引指向它。
提示词库 (docs/prompts/*.md)	用于常见任务的即用型提示词：清理 Lint、多代理代码审查、文件大小重构等。	将整个提示词粘贴到 Claude/Codex（或任何可读取 URL 的 LLM）中，让代理执行。
模板 (templates/…)	代码模板 CLAUDE.md、ESLint 配置、钩子示例和 CLI 的最小 settings.json。	将所需文件复制到项目中，并根据 Playbook 中的说明调整路径。

快速上手

1. 安装 Claude Code 并添加官方插件市场（README 中的一行命令）。

   npm install -g @anthropic-ai/claude-code
   /plugin marketplace add anthropics/claude-plugins-official
   /plugin install superpowers@claude-plugins-official
   cp templates/CLAUDE.md.template CLAUDE.md
   

2. 阅读 Playbook – docs/02-playbook-onboarding.md。它通过一个完整的端到端示例项目，展示每个工具如何融入时间线（安装 → 设置 → 头脑风暴 → 计划 → 子代理波次 → 审查 → 发布）。
3. 选择单一工具，若只需快速见效。例如，为强制 350 行规则，运行 README 中显示的一行提示词，或从 templates/eslint/ 复制 ESLint 配置。

适合谁使用

• 已经可以访问 Claude Code、Codex 或类似 LLM 编码助手，并希望获得可重复、生产级工作流的开发者。
• 那些在“粘贴提示词 + 期望”会话中挣扎过、丢失上下文或代理互相覆盖文件的团队。
• 习惯进行适度 CLI 操作，并愿意阅读简短葡萄牙语文档的人（核心概念已内联说明，实际提示词为英文）。

成熟度与状态

• 该仓库是来自一个私有金融科技项目的方法论提取。原始代码受 NDA 保护。作者表示这些实践已在生产中使用，但仓库本身仅包含文档、提示词和配置模板——无编译二进制文件。
• 历史较短，因为该仓库旨在成为活体指南；作者优化工作流或添加新插件时，预期会更新。

许可证 – MIT（见 LICENSE）。

---

总结 – Vibe Coding Toolkit 是一个具体、开源的指南，用于将 AI 编码助手转变为有纪律的团队成员。它提供了缺失的“粘合剂”（插件、提示词、Lint 门控、子代理编排），使开发者能从随意的提示词“黑客”转向可重复、生产就绪的开发流程。