SuperAPI AI 工具集

vibe-coder-sdlc

编程与开发

查看项目

更新于 10-16 04:40

技能介绍

用途

Vibe Coder SDLC 是一套为希望采用专业实践、但不愿被僵化流程束缚的开发者设计的灵活 SDLC 工作流系统。它编排多个专用智能体来处理 git 工作流、代码审查和项目文档,让开发者保持专注状态。该技能提供完整的 SDLC 工作流,能够自动管理功能分支和 Pull Request、按语言特定最佳实践审查代码、在 GitHub Issue 中跟踪工作、维护文档,并在不引入官僚式开销的情况下保持开发者的心流。

主要能力

该技能使用 4 个协同工作的专用智能体:

  • Orchestrator Agent(编排智能体):负责协调一切的总指挥。
  • Git Workflow Agent(Git 工作流智能体):处理分支、提交和 PR。
  • Code Review Agent(代码审查智能体):以技术栈感知方式审查代码。
  • Project Manager Agent(项目经理智能体):记录工作并更新 GitHub Issue。

技术栈感知是核心特性:编排智能体和审查智能体会自动检测技术栈(检查 package.json、requirements.txt、go.mod 等),对 Python 应用 PEP 8、对 Go 应用 Go 模式、对 TypeScript 应用 TS 最佳实践,支持同一 PR 中多语言微服务,检测失败时向用户询问一次,并在会话中记住技术栈信息以避免重复询问。

代码审查智能体自动检测并应用以下技术栈的最佳实践:Python(PEP 8、类型提示、上下文管理器)、TypeScript/JavaScript(ESLint、正确类型、异步模式)、Go(错误处理、context 使用、goroutine 管理)、Rust(所有权、clippy lint、错误处理)、Java(异常处理、stream、空安全)、Ruby(RuboCop、ActiveRecord 模式)、PHP(PSR 标准、预处理语句)。

使用方式

工作流阶段:

  1. Plan 阶段:理解要构建的内容,拆解为步骤,创建待办列表,检测或询问技术栈。
  2. Setup 阶段:使用 git-workflow-agent 创建功能分支,分支名格式为 feat/、fix/、refactor/、docs/。
  3. Development 阶段:帮助用户构建功能,以清晰信息提交,保持用户心流。
  4. Review 阶段:使用 git-workflow-agent 推送并创建 PR,使用 code-review-agent 审查代码,发现问题则在合并前修复,向 PR 添加审查评论。
  5. Documentation 阶段:使用 project-manager-agent 创建/更新 GitHub Issue、更新相关文档、向 PR 添加摘要评论。
  6. Merge 阶段:若审查通过,使用 git-workflow-agent 合并,删除功能分支。

快速开始:

第 1 步:复制智能体文件

# 在项目根目录
mkdir -p .claude/agents

# 将此技能 references/ 文件夹中的 4 个智能体定义
# 复制到项目的 .claude/agents/ 文件夹

第 2 步:安装 GitHub CLI

# macOS
brew install gh

# Linux
sudo apt install gh

# Windows
winget install GitHub.cli

# 认证
gh auth login

第 3 步:开始使用

"Hey Claude, let's use the vibe-coder-sdlc skill to add [feature]"

配置:可创建 .claude/sdlc-config.json 自定义工作流,包括分支命名、提交约定、是否要求审查、是否自动合并、文档更新选项、GitHub 集成选项等。

适用场景

  • 开始新功能或缺陷修复
  • 希望自动分支管理和 PR 创建
  • 合并到 main 前需要代码审查
  • 希望在 GitHub Issue 中自动跟踪工作
  • 构建需要文档但不想手动编写的项目
  • 独立工作但想要团队级质量实践
  • 想要 git 最佳实践而无需费心思考

限制

使用前需在项目的 .claude/agents/ 目录中配置 4 个智能体文件(sdlc-orchestrator、git-workflow-agent、code-review-agent、project-manager-agent),并安装 GitHub CLI 完成认证。若智能体无响应,需检查 .claude/agents/ 中是否存在智能体文件;若无法创建 PR,需确认已通过 gh auth status 和 gh auth login 完成认证。审查智能体可能过于严格,可调整其指令;若觉得开销过大,可关闭自动创建 Issue、跳过小改动的 changelog、对仅文档改动禁用审查。