Claude Code 的 Vibe Coding Skill，重点是“别让它一口气乱改”

安装方式

把最新版 SKILL.md 放到项目的 .claude/skills/vibe-coding-tutor/SKILL.md。页面上也提供一条可直接复制的安装命令。

Claude Code 会怎么工作？

先判断你是在需求、技术方案、实现、Debug、测试、Git 还是部署阶段，再只给当前最小动作。复杂任务不会默认大规模重构。

为什么需要 Quality Gate？

因为“代码生成完成”不等于“功能完成”。每一步都需要有可检查的证据，例如 typecheck、lint、test、build、终端输出、浏览器页面或 git diff。

知识从哪里来？

优先读取公开知识库 tradecatlabs/vibe-coding-cn 的当前内容；如果运行环境不能实时读取，会明确告诉你本轮发生了降级。

推荐的 Claude Code 项目节奏

先让 Claude Code 读取项目入口、约束、已有文档和关键配置，再把需求转换成可检查的目标。实现阶段不要一次给“大而全”的任务，而是切成能在一次修改后立即验证的单元，例如先补一个接口、先修一个报错、先跑通一个页面流程。

每轮修改后优先检查 git diff，确认没有越界改动；然后根据项目执行 typecheck、lint、tests、build 或本地运行。只有这些证据通过，才进入下一轮。

Debug 时怎么避免反复乱改？

遇到错误时先固定现象：保留完整报错、复现步骤、环境版本和最近改动。然后只改变一个变量，重新运行验证。如果新改动没有减少错误范围，就回滚，而不是继续叠补丁。

例如缺少依赖时，正确动作可能只是安装依赖并重新启动；只有当错误仍然存在，才继续检查 import、包版本、运行目录或构建配置。这样可以防止简单问题被 AI 扩大成架构问题。

什么时候让 Claude Code 自己写，什么时候找轮子？

业务流程、适配层和项目特有规则通常适合直接实现；成熟的基础设施能力则优先复用。判断时关注维护活跃度、许可证、文档、生态兼容性、替换成本和接入复杂度，而不是只看 Star 数。

如果采用第三方库，还要把边界写清楚：输入输出、错误处理、数据模型、权限、回滚方式和测试覆盖。AI 的职责是把成熟能力安全接进项目，而不是复制粘贴一堆不可维护代码。

Claude Code Skill 常见问题

安装以后会自动改代码吗？ Skill 本身是执行规则，不等于自动授权所有写操作；实际能力仍取决于 Claude Code 当前会话权限和你允许它使用的工具。

能和现有 CLAUDE.md 共存吗？ 可以。项目级规则继续负责项目事实和约束，Skill 负责通用的 Vibe Coding 执行方法，两者应避免互相覆盖。

适合已有项目吗？ 适合。已有项目更需要先读现状、缩小修改面、保留 Git 检查点并用现有测试体系验收。