Claude Workflow V2：通用 Claude Code 工作流插件

本文介绍 claude-workflow-v2，一个通用的 Claude Code 工作流插件，由 CloudAI-X 开发维护。它提供了 7 个专业代理、26 个斜杠命令、14 个知识领域和 14 个自动化钩子，让 Claude Code 在各类开发场景中更顺手。截至目前，该项目在 GitHub 上已获得 1.4k stars，主要使用 Python 编写。

项目简介

claude-workflow-v2 兼容 skills.sh，支持 Claude Code、Cursor、Codex、Windsurf、Cline 等 35+ AI 代理。它通过预定义的代理、命令、技能和钩子，让 AI 编码助手在开发场景中表现更专业。

核心特性

• 7 个专业代理：orchestrator（任务编排）、code-reviewer（代码审查）、debugger（调试）、docs-writer（文档编写）、security-auditor（安全审计）、refactorer（重构）、test-architect（测试架构），根据任务类型自动激活
• 26 个斜杠命令：覆盖输出风格切换、Git 工作流、代码验证、并行分析、规划重构和项目 onboarding
• 14 个知识领域：按需加载的领域知识，涵盖架构设计、性能优化、API 设计、数据库设计、DevOps 等
• 14 个自动化钩子：在编辑、提交、会话启动等事件触发时自动执行安全扫描、格式化、类型检查等操作
• 多代理兼容：通过 skills.sh 可在 35+ AI 编码代理中复用技能

技术栈

• Python 3 - 钩子脚本和自动化工具
• JavaScript - 部分命令和集成逻辑
• Shell - 系统集成和部署脚本
• Markdown - 代理、命令、技能的定义格式

安装指南

前置要求

• Claude Code v1.0.33 或更高版本
• Python 3（钩子脚本需要）
• Git（版本控制功能需要）
• Node.js（可选，npm 命令需要）

安装步骤

项目提供 5 种安装方式：

方式一：skills.sh（推荐，适用于任何代理）

npx skills add CloudAI-X/claude-workflow-v2

自动将技能安装到 Claude Code、Cursor、Codex、Windsurf、Cline 等 35+ AI 代理中。

方式二：npx 完整插件安装（Claude Code 专属）

npx install-claude-workflow-v2@latest

安装完整的插件：代理、命令、技能和钩子。

方式三：CLI 每会话加载

git clone https://github.com/CloudAI-X/claude-workflow-v2.git
claude --plugin-dir ./claude-workflow-v2

方式四：Agent SDK 编程加载

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Hello",
  options: {
    plugins: [{ type: "local", path: "./claude-workflow-v2" }],
  },
})) {
  // 插件命令、代理和技能现在可用
}

方式五：永久安装

claude plugin install project-starter

使用示例

自动生成提交信息

/project-starter:commit

查看暂存的更改，自动生成符合 Conventional Commits 规范的提交信息。

完整 Git 工作流

/project-starter:commit-push-pr

一键完成提交、推送和创建 PR。

发布前验证

/project-starter:verify-changes

启动多代理验证：构建检查 → 测试运行 → 代码检查 → 安全扫描。

代理自动激活

当你说"登录功能坏了，用户收到 401 错误"时，debugger 代理自动激活，检查认证中间件，定位问题并给出修复建议。

命令参考

输出风格

Git 工作流

验证命令

项目链接

• GitHub 仓库：https://github.com/CloudAI-X/claude-workflow-v2
• 许可证：MIT