[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-CloudAI-X--claude-workflow-v2":3,"tool-CloudAI-X--claude-workflow-v2":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",148568,2,"2026-04-09T23:34:24",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":77,"owner_twitter":78,"owner_website":76,"owner_url":79,"languages":80,"stars":93,"forks":94,"last_commit_at":95,"license":96,"difficulty_score":97,"env_os":98,"env_gpu":99,"env_ram":98,"env_deps":100,"category_tags":106,"github_topics":107,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":116,"updated_at":117,"faqs":118,"releases":147},6076,"CloudAI-X\u002Fclaude-workflow-v2","claude-workflow-v2","Universal Claude Code workflow plugin with agents, skills, hooks, and commands","claude-workflow-v2 是一款专为提升软件开发效率设计的通用工作流插件，旨在让 Claude Code、Cursor 等主流 AI 编程助手变得更“聪明”且具备团队协作能力。它解决了传统 AI 辅助编程中上下文理解碎片化、缺乏自动化流程以及代码质量把控不足的痛点，通过引入模块化架构，将复杂的开发任务转化为标准化的自动操作。\n\n这款工具特别适合软件开发者、技术团队负责人及追求高效工作流的工程师使用。无论是日常代码提交、架构设计，还是安全审查与故障排查，claude-workflow-v2 都能提供强力支持。其核心亮点在于内置了 7 个专用智能体（Agents），可自动扮演调试员、代码审查员或安全专家等角色；同时提供 26 条快捷指令和 14 项专业技能，让用户能通过简单的斜杠命令（如自动生成提交信息、一键验证变更）完成从编码到部署的全链路操作。此外，它还支持钩子（Hooks）机制，能自动执行格式化、安全检查等脚本，确保代码在交付前符合高标准。通过灵活适配 35 多种 AI 代理，claude-workflow-v2 帮助开发者将重复性工作交给 AI，从而更专注于核心逻辑创新","claude-workflow-v2 是一款专为提升软件开发效率设计的通用工作流插件，旨在让 Claude Code、Cursor 等主流 AI 编程助手变得更“聪明”且具备团队协作能力。它解决了传统 AI 辅助编程中上下文理解碎片化、缺乏自动化流程以及代码质量把控不足的痛点，通过引入模块化架构，将复杂的开发任务转化为标准化的自动操作。\n\n这款工具特别适合软件开发者、技术团队负责人及追求高效工作流的工程师使用。无论是日常代码提交、架构设计，还是安全审查与故障排查，claude-workflow-v2 都能提供强力支持。其核心亮点在于内置了 7 个专用智能体（Agents），可自动扮演调试员、代码审查员或安全专家等角色；同时提供 26 条快捷指令和 14 项专业技能，让用户能通过简单的斜杠命令（如自动生成提交信息、一键验证变更）完成从编码到部署的全链路操作。此外，它还支持钩子（Hooks）机制，能自动执行格式化、安全检查等脚本，确保代码在交付前符合高标准。通过灵活适配 35 多种 AI 代理，claude-workflow-v2 帮助开发者将重复性工作交给 AI，从而更专注于核心逻辑创新。","# project-starter\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Claude Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude%20Code-v1.0.33+-blue.svg)](https:\u002F\u002Fcode.claude.com)\n[![PRs Welcome](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-brightgreen.svg)](https:\u002F\u002Fgithub.com\u002FCloudAI-X\u002Fclaude-workflow-v2\u002Fpulls)\n\nA universal Claude Code workflow plugin with specialized agents, skills, hooks, and output styles for any software project. Compatible with [skills.sh](https:\u002F\u002Fskills.sh) — works with Claude Code, Cursor, Codex, and 35+ AI agents.\n\n---\n\n## Quick Start\n\n### Option 1: skills.sh (Recommended — Any Agent)\n\n```bash\nnpx skills add CloudAI-X\u002Fclaude-workflow-v2\n```\n\nInstalls skills to Claude Code, Cursor, Codex, Windsurf, Cline, and 35+ other AI agents automatically.\n\n### Option 2: npx (Claude Code — Full Plugin)\n\n```bash\nnpx install-claude-workflow-v2@latest\n```\n\nInstalls the complete plugin: agents, commands, skills, and hooks.\n\n### Option 3: CLI (Per-Session)\n\n```bash\n# Clone the plugin\ngit clone https:\u002F\u002Fgithub.com\u002FCloudAI-X\u002Fclaude-workflow-v2.git\n\n# Run Claude Code with the plugin\nclaude --plugin-dir .\u002Fclaude-workflow-v2\n```\n\n### Option 4: Agent SDK\n\n```typescript\nimport { query } from \"@anthropic-ai\u002Fclaude-agent-sdk\";\n\nfor await (const message of query({\n  prompt: \"Hello\",\n  options: {\n    plugins: [{ type: \"local\", path: \".\u002Fclaude-workflow-v2\" }],\n  },\n})) {\n  \u002F\u002F Plugin commands, agents, and skills are now available\n}\n```\n\n### Option 5: Install Permanently\n\n```bash\n# Install from marketplace (when available)\nclaude plugin install project-starter\n\n# Or install from local directory\nclaude plugin install .\u002Fclaude-workflow-v2\n```\n\n### Verify Installation\n\nAfter loading the plugin, verify it's working:\n\n```\n> \u002Fplugin\n```\n\nTab to **Installed** - you should see `project-starter` listed.\nTab to **Errors** - should be empty (no errors).\n\nThese commands become available:\n\n```\n\u002Fproject-starter:architect    # Architecture-first mode\n\u002Fproject-starter:rapid        # Ship fast mode\n\u002Fproject-starter:commit       # Auto-generate commit message\n\u002Fproject-starter:verify-changes  # Multi-agent verification\n```\n\n---\n\n## What's Included\n\n| Component    | Count | Description                                                             |\n| ------------ | ----- | ----------------------------------------------------------------------- |\n| **Agents**   | 7     | Specialized subagents for code review, debugging, security, etc.        |\n| **Commands** | 26    | Slash commands for workflows, output styles, planning, and onboarding   |\n| **Skills**   | 14    | Knowledge domains with on-demand context loading                        |\n| **Hooks**    | 14    | Automation scripts for formatting, security, metrics, and notifications |\n\n---\n\n## Usage Examples\n\n### Commands in Action\n\n**Auto-commit your changes:**\n\n```\n> \u002Fproject-starter:commit\n\nLooking at staged changes...\n✓ Created commit: feat(auth): add JWT refresh token endpoint\n```\n\n**Full git workflow:**\n\n```\n> \u002Fproject-starter:commit-push-pr\n\n✓ Committed: feat: add user dashboard\n✓ Pushed to origin\u002Ffeature\u002Fdashboard\n✓ Created PR #42: https:\u002F\u002Fgithub.com\u002Fyou\u002Frepo\u002Fpull\u002F42\n```\n\n**Verify before shipping:**\n\n```\n> \u002Fproject-starter:verify-changes\n\nSpawning verification agents...\n├─ build-validator: ✓ Build passes\n├─ test-runner: ✓ 42 tests pass\n├─ lint-checker: ⚠ 2 warnings (non-blocking)\n└─ security-scanner: ✓ No vulnerabilities\n\nReady to ship!\n```\n\n### Agents in Action\n\nAgents spawn automatically based on your request:\n\n**You say:** \"The login is broken, users get 401 errors\"\n\n```\n[debugger agent activated]\n→ Checking auth middleware... found issue\n→ Token validation uses wrong secret in production\n→ Fix: Update AUTH_SECRET in .env.production\n```\n\n**You say:** \"Review my changes\"\n\n```\n[code-reviewer agent activated]\n→ Analyzing 3 files changed...\n✓ Logic is correct\n⚠ Missing null check on line 42\n⚠ Consider adding rate limiting to this endpoint\n```\n\n**You say:** \"Add authentication to the API\"\n\n```\n[orchestrator agent activated]\n→ Breaking down into subtasks:\n  1. Design auth schema (spawning architect)\n  2. Implement JWT middleware\n  3. Add login\u002Fregister endpoints\n  4. Write tests (spawning test-architect)\n  5. Update API docs (spawning docs-writer)\n```\n\n### Skills in Action\n\nSkills provide domain knowledge automatically:\n\n**You ask:** \"How should I structure the payment service?\"\n\n```\n[designing-architecture skill applied]\n→ Recommending hexagonal architecture\n→ Payment providers as adapters\n→ Core domain isolated from infrastructure\n```\n\n**You ask:** \"Make this endpoint faster\"\n\n```\n[optimizing-performance skill applied]\n→ Adding database indexes\n→ Implementing response caching\n→ Using pagination for large results\n```\n\n### Hooks in Action\n\nHooks run automatically on events:\n\n**Security block (pre-edit):**\n\n```\n⛔ BLOCKED: Potential secret detected\n   File: src\u002Fconfig.ts, Line 5\n   Pattern: API key (sk-...)\n\n   Remove the secret and use environment variables.\n```\n\n**Auto-format (post-edit):**\n\n```\n✓ Formatted with prettier: src\u002Fcomponents\u002FButton.tsx\n✓ Formatted with black: scripts\u002Fdeploy.py\n```\n\n**Desktop notifications:**\n\n```\n🔔 \"Claude needs input\" - when waiting for your response\n🔔 \"Task complete\" - when finished\n```\n\n---\n\n## Commands Reference\n\nAll commands use the format `\u002Fproject-starter:\u003Ccommand>`.\n\n### Output Styles\n\n| Command                      | Mode                                          |\n| ---------------------------- | --------------------------------------------- |\n| `\u002Fproject-starter:architect` | System design mode - architecture before code |\n| `\u002Fproject-starter:rapid`     | Fast development - ship quickly, iterate      |\n| `\u002Fproject-starter:mentor`    | Teaching mode - explain the \"why\"             |\n| `\u002Fproject-starter:review`    | Code review mode - strict quality             |\n\n### Git Workflow (Inner-Loop)\n\n| Command                              | Purpose                                   |\n| ------------------------------------ | ----------------------------------------- |\n| `\u002Fproject-starter:commit`            | Auto-generate conventional commit message |\n| `\u002Fproject-starter:commit-push-pr`    | Commit → Push → Create PR (full workflow) |\n| `\u002Fproject-starter:quick-fix`         | Fast fix for lint\u002Ftype errors             |\n| `\u002Fproject-starter:add-tests`         | Generate tests for recent changes         |\n| `\u002Fproject-starter:lint-fix`          | Auto-fix all linting issues               |\n| `\u002Fproject-starter:sync-branch`       | Sync with main (rebase or merge)          |\n| `\u002Fproject-starter:summarize-changes` | Generate standup\u002FPR summaries             |\n\n### Verification\n\n| Command                            | Purpose                                 |\n| ---------------------------------- | --------------------------------------- |\n| `\u002Fproject-starter:verify-changes`  | Multi-subagent adversarial verification |\n| `\u002Fproject-starter:validate-build`  | Build process validation                |\n| `\u002Fproject-starter:run-tests`       | Tiered test execution                   |\n| `\u002Fproject-starter:lint-check`      | Code quality checks                     |\n| `\u002Fproject-starter:security-scan`   | Security vulnerability detection        |\n| `\u002Fproject-starter:code-simplifier` | Post-implementation cleanup             |\n\n### Planning & Refactoring\n\n| Command                               | Purpose                                    |\n| ------------------------------------- | ------------------------------------------ |\n| `\u002Fproject-starter:plan`               | Persistent PLAN.md with phase tracking     |\n| `\u002Fproject-starter:refactor-guided`    | 4-phase systematic refactoring with safety |\n| `\u002Fproject-starter:dependency-upgrade` | Safe dependency upgrades with rollback     |\n\n### Onboarding & Knowledge\n\n| Command                                   | Purpose                                   |\n| ----------------------------------------- | ----------------------------------------- |\n| `\u002Fproject-starter:tutorial`               | Interactive guided tutorial for new users |\n| `\u002Fproject-starter:bootstrap-repo`         | 10-agent parallel repo exploration        |\n| `\u002Fproject-starter:save-session-learnings` | Persist session discoveries to docs       |\n| `\u002Fproject-starter:metrics`                | View agent performance metrics            |\n\n---\n\n## Agents\n\nAgents are specialized subagents that Claude spawns automatically based on your task.\n\n| Agent              | Purpose                          | Auto-Triggers                                                |\n| ------------------ | -------------------------------- | ------------------------------------------------------------ |\n| `orchestrator`     | Coordinate multi-step tasks      | \"improve\", \"enhance\", \"build\", \"architecture\", complex tasks |\n| `code-reviewer`    | Review code quality              | \"review\", \"PR review\", \"lint\", code changes                  |\n| `debugger`         | Systematic bug investigation     | Errors, crashes, memory leaks, timeouts, race conditions     |\n| `docs-writer`      | Technical documentation          | README, changelogs, migration guides, release notes          |\n| `security-auditor` | Security vulnerability detection | Auth, encryption, secrets, OAuth, JWT, CORS                  |\n| `refactorer`       | Code structure improvements      | Tech debt, code smells, complexity reduction                 |\n| `test-architect`   | Design test strategies           | Test plans, mocking, flaky tests, integration\u002FE2E            |\n\n---\n\n## Skills\n\nSkills are knowledge domains that Claude uses autonomously when relevant.\n\n| Skill                         | Domain                                                |\n| ----------------------------- | ----------------------------------------------------- |\n| `analyzing-projects`          | Understand codebase structure and patterns            |\n| `designing-tests`             | Unit, integration, E2E test approaches                |\n| `designing-architecture`      | Clean Architecture, Hexagonal, etc.                   |\n| `optimizing-performance`      | Speed up applications, identify bottlenecks           |\n| `managing-git`                | Version control, conventional commits                 |\n| `designing-apis`              | REST\u002FGraphQL patterns and best practices              |\n| `parallel-execution`          | Multi-subagent parallel task execution patterns       |\n| `web-design-guidelines`       | Self-contained UI audit (A11Y, PERF, RD, SEC, I18N)   |\n| `vercel-react-best-practices` | React\u002FNext.js performance optimization (45 rules)     |\n| `convex-backend`              | Convex backend development (functions, schemas, etc.) |\n| `database-design`             | Schema design, indexing, query optimization           |\n| `devops-infrastructure`       | Docker, CI\u002FCD, deployment, IaC, monitoring            |\n| `error-handling`              | Error patterns, structured logging, retry\u002Fcircuit     |\n| `security-patterns`           | Auth, RBAC, secrets, CORS, rate limiting, headers     |\n\n---\n\n## Hooks\n\nHooks run automatically on specific events.\n\n| Hook                  | Trigger       | Action                                  |\n| --------------------- | ------------- | --------------------------------------- |\n| Security scan         | Edit\u002FWrite    | Blocks commits with potential secrets   |\n| File protection       | Edit\u002FWrite    | Blocks edits to lock files, .env, .git  |\n| Auto-format           | Edit\u002FWrite    | Runs prettier\u002Fblack\u002Fgofmt by file type  |\n| TypeScript check      | Edit\u002FWrite    | Runs `tsc --noEmit` on .ts\u002F.tsx files   |\n| Pre-commit check      | Bash          | Detects debug statements & temp markers |\n| Branch protection     | Bash          | Warns on commits to protected branches  |\n| Command logging       | Bash          | Logs to `.claude\u002Fcommand-history.log`   |\n| Environment check     | Session start | Validates Node.js, Python, Git          |\n| Prompt analysis       | User prompt   | Suggests appropriate agents             |\n| Auto-verify           | Task complete | Runs tests\u002Flint, reports results        |\n| Doc update suggest    | Task complete | Suggests CLAUDE.md updates for changes  |\n| Session metrics       | Task complete | Logs session telemetry to metrics file  |\n| Input notification    | Input needed  | Desktop notification                    |\n| Complete notification | Task complete | Desktop notification                    |\n\n---\n\n## Examples\n\nFor detailed multi-agent orchestration examples, see the [examples\u002F](.\u002Fexamples\u002F) directory:\n\n| Example                                                                          | Description                                            |\n| -------------------------------------------------------------------------------- | ------------------------------------------------------ |\n| [Comprehensive Code Review](.\u002Fexamples\u002Forchestration\u002Fcomprehensive-code-review\u002F) | 6-agent sequential workflow for thorough code analysis |\n\nEach example includes:\n\n- **README.md** - Overview and quick start\n- **workflow.md** - Exact prompts to use\n- **verification.md** - How to verify it works\n- **sample-outputs\u002F** - Example agent outputs\n\n---\n\n## Configuration\n\n### Add Permissions to Your Project\n\nCopy the permissions template to your project:\n\n```bash\nmkdir -p \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.claude\ncp templates\u002Fsettings.local.json.template \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.claude\u002Fsettings.local.json\n```\n\nThis pre-allows common safe commands so you don't get prompted every time.\n\n### Add Team Conventions\n\nCopy the CLAUDE.md template to your project root:\n\n```bash\ncp templates\u002FCLAUDE.md.template \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002FCLAUDE.md\n```\n\nThen customize with your:\n\n- Package manager commands\n- Test\u002Fbuild\u002Flint commands\n- Code conventions\n- Architecture decisions\n\n### MCP Servers\n\nCopy the MCP template to enable integrations like Slack, GitHub, Sentry:\n\n```bash\ncp templates\u002Fmcp.json.template \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.mcp.json\n```\n\nThen configure the environment variables for the servers you want to use.\n\n### GitHub Action (@.claude in PRs)\n\nEnable Claude to respond to PR comments by installing the GitHub Action:\n\n```bash\n# In your repository\nclaude \u002Finstall-github-action\n```\n\nThis enables:\n\n- Tag `@claude` in PR comments to get code suggestions\n- Auto-update `CLAUDE.md` during code review\n- Claude responds to review feedback automatically\n\n**Example PR comment:**\n\n```\n@claude please add input validation to the email field\n```\n\n**Team workflow tip:** Use `@claude` to update your `CLAUDE.md` with learnings from code review:\n\n```\n@claude add a note to CLAUDE.md that we should always validate email format before API calls\n```\n\n---\n\n## Extending the Plugin\n\n### Add Custom Commands\n\nCreate `.md` files in `commands\u002F`:\n\n```markdown\n---\nallowed-tools: Bash(git:*), Read, Write\ndescription: What this command does\nargument-hint: [optional arguments]\n---\n\n[Command instructions here]\n```\n\n### Add Custom Agents\n\nCreate `.md` files in `agents\u002F`:\n\n```markdown\n---\nname: my-agent\ndescription: What it does. Use PROACTIVELY when [triggers].\ntools: Read, Write, Edit, Bash\nmodel: sonnet\n---\n\n[Agent instructions here]\n```\n\n### Add Custom Skills\n\nCreate subdirectories in `skills\u002F` with a `SKILL.md` file:\n\n```markdown\n---\nname: my-skill\ndescription: Guides [domain]. Use when [triggers].\n---\n\n[Skill knowledge and patterns here]\n```\n\n---\n\n## Plugin Structure\n\n```\nclaude-workflow\u002F\n├── .claude-plugin\u002F\n│   ├── plugin.json           # Required: Plugin manifest\n│   └── marketplace.json      # Optional: Marketplace metadata\n├── agents\u002F                   # 7 specialized agents\n│   ├── orchestrator.md\n│   ├── code-reviewer.md\n│   ├── debugger.md\n│   ├── docs-writer.md\n│   ├── security-auditor.md\n│   ├── refactorer.md\n│   └── test-architect.md\n├── commands\u002F                 # 26 slash commands\n│   ├── architect.md          # Output styles\n│   ├── rapid.md\n│   ├── mentor.md\n│   ├── review.md\n│   ├── commit.md             # Git workflow\n│   ├── commit-push-pr.md\n│   ├── quick-fix.md\n│   ├── add-tests.md\n│   ├── lint-fix.md\n│   ├── sync-branch.md\n│   ├── summarize-changes.md\n│   ├── verify-changes.md     # Verification\n│   ├── validate-build.md\n│   ├── run-tests.md\n│   ├── lint-check.md\n│   ├── security-scan.md\n│   ├── code-simplifier.md\n│   ├── parallel-review.md    # Parallel\n│   ├── parallel-analyze.md\n│   ├── plan.md               # Planning & refactoring\n│   ├── refactor-guided.md\n│   ├── dependency-upgrade.md\n│   ├── tutorial.md           # Onboarding & knowledge\n│   ├── bootstrap-repo.md\n│   ├── save-session-learnings.md\n│   └── metrics.md\n├── skills\u002F                   # 14 knowledge domains\n│   ├── analyzing-projects\u002F\n│   ├── convex-backend\u002F\n│   ├── database-design\u002F\n│   ├── designing-apis\u002F\n│   ├── designing-architecture\u002F\n│   ├── designing-tests\u002F\n│   ├── devops-infrastructure\u002F\n│   ├── error-handling\u002F\n│   ├── managing-git\u002F\n│   ├── optimizing-performance\u002F\n│   ├── parallel-execution\u002F\n│   ├── security-patterns\u002F\n│   ├── vercel-react-best-practices\u002F\n│   └── web-design-guidelines\u002F\n├── hooks\u002F\n│   ├── hooks.json            # Hook configuration\n│   └── 14 automation scripts # Pre\u002Fpost tool, session, metrics, notifications\n├── templates\u002F                # User-copyable templates\n│   ├── CLAUDE.md.template\n│   ├── settings.json.template\n│   ├── settings.local.json.template\n│   └── mcp.json.template\n├── CLAUDE.md                 # Plugin development guidelines\n└── README.md\n```\n\n---\n\n## Requirements\n\n- **Claude Code** v1.0.33 or later\n- **Python 3** (for hook scripts)\n- **Node.js** (optional, for npm commands)\n- **Git** (for version control features)\n\n---\n\n## Multi-Agent Compatibility (skills.sh)\n\nThis repo is fully compatible with [skills.sh](https:\u002F\u002Fskills.sh) — the universal agent skills platform. Our 14 skills work with **38+ AI coding agents**:\n\n| Agent           | Install Method                                                       |\n| --------------- | -------------------------------------------------------------------- |\n| **Claude Code** | `npx skills add CloudAI-X\u002Fclaude-workflow-v2` or full plugin install |\n| **Cursor**      | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n| **Codex**       | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n| **Windsurf**    | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n| **Cline**       | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n| **35+ more**    | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n\n> **Note:** `npx skills add` installs **skills only**. For the full Claude Code experience (agents, commands, hooks), use `npx install-claude-workflow-v2@latest`.\n\n---\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](.\u002FCONTRIBUTING.md).\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature\u002Famazing-feature`)\n3. Commit your changes (`git commit -m 'feat: add amazing feature'`)\n4. Push to the branch (`git push origin feature\u002Famazing-feature`)\n5. Open a Pull Request\n\n---\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FCloudAI-X_claude-workflow-v2_readme_c0ddceb1e6bc.png)](https:\u002F\u002Fwww.star-history.com\u002F#CloudAI-X\u002Fclaude-workflow-v2&type=date&legend=top-left)\n\n## Credits\n\n- Plugin created by [@cloudxdev](https:\u002F\u002Fx.com\u002Fcloudxdev)\n- Workflow patterns inspired by [Boris Cherny](https:\u002F\u002Fx.com\u002Fbcherny) (creator of Claude Code)\n\n## License\n\nMIT - see [LICENSE](.\u002FLICENSE) for details.\n","# 项目启动器\n\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Claude Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude%20Code-v1.0.33+-blue.svg)](https:\u002F\u002Fcode.claude.com)\n[![欢迎提交PR](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-brightgreen.svg)](https:\u002F\u002Fgithub.com\u002FCloudAI-X\u002Fclaude-workflow-v2\u002Fpulls)\n\n一个通用的 Claude Code 工作流插件，为任何软件项目提供专业化的智能体、技能、钩子和输出样式。兼容 [skills.sh](https:\u002F\u002Fskills.sh) — 可与 Claude Code、Cursor、Codex 以及 35 多种 AI 智能体协同工作。\n\n---\n\n## 快速入门\n\n### 选项 1：skills.sh（推荐 — 适用于任何智能体）\n\n```bash\nnpx skills add CloudAI-X\u002Fclaude-workflow-v2\n```\n\n会自动将技能安装到 Claude Code、Cursor、Codex、Windsurf、Cline 等 35 多种 AI 智能体中。\n\n### 选项 2：npx（Claude Code — 完整插件）\n\n```bash\nnpx install-claude-workflow-v2@latest\n```\n\n安装完整的插件：包括智能体、命令、技能和钩子。\n\n### 选项 3：CLI（单次会话）\n\n```bash\n# 克隆插件\ngit clone https:\u002F\u002Fgithub.com\u002FCloudAI-X\u002Fclaude-workflow-v2.git\n\n# 使用插件运行 Claude Code\nclaude --plugin-dir .\u002Fclaude-workflow-v2\n```\n\n### 选项 4：智能体 SDK\n\n```typescript\nimport { query } from \"@anthropic-ai\u002Fclaude-agent-sdk\";\n\nfor await (const message of query({\n  prompt: \"Hello\",\n  options: {\n    plugins: [{ type: \"local\", path: \".\u002Fclaude-workflow-v2\" }],\n  },\n})) {\n  \u002F\u002F 插件中的命令、智能体和技能现已可用\n}\n```\n\n### 选项 5：永久安装\n\n```bash\n# 从市场安装（待上线时）\nclaude plugin install project-starter\n\n# 或从本地目录安装\nclaude plugin install .\u002Fclaude-workflow-v2\n```\n\n### 验证安装\n\n加载插件后，请验证其是否正常工作：\n\n```\n> \u002Fplugin\n```\n\n使用 Tab 键切换到 **Installed**，您应能看到 `project-starter` 列出。再切换到 **Errors**，此处应为空（无错误）。\n\n此时以下命令将可用：\n\n```\n\u002Fproject-starter:architect    # 架构优先模式\n\u002Fproject-starter:rapid        # 快速交付模式\n\u002Fproject-starter:commit       # 自动生成提交信息\n\u002Fproject-starter:verify-changes  # 多智能体验证\n```\n\n---\n\n## 包含内容\n\n| 组件      | 数量 | 描述                                                             |\n| ---------- | ---- | ----------------------------------------------------------------------- |\n| **智能体** | 7    | 用于代码审查、调试、安全等的专业子智能体                        |\n| **命令**   | 26   | 用于工作流、输出样式、规划和入职的斜杠命令                      |\n| **技能**   | 14   | 支持按需加载上下文的知识领域                                      |\n| **钩子**   | 14   | 用于格式化、安全、指标统计和通知的自动化脚本                     |\n\n---\n\n## 使用示例\n\n### 命令实战\n\n**自动提交更改：**\n\n```\n> \u002Fproject-starter:commit\n\n正在查看暂存的更改...\n✓ 创建了提交：feat(auth): 添加 JWT 刷新令牌端点\n```\n\n**完整 Git 工作流：**\n\n```\n> \u002Fproject-starter:commit-push-pr\n\n✓ 提交：feat: 添加用户仪表板\n✓ 推送到 origin\u002Ffeature\u002Fdashboard\n✓ 创建了 PR #42：https:\u002F\u002Fgithub.com\u002Fyou\u002Frepo\u002Fpull\u002F42\n```\n\n**发布前验证：**\n\n```\n> \u002Fproject-starter:verify-changes\n\n正在启动验证智能体...\n├─ build-validator: ✓ 构建通过\n├─ test-runner: ✓ 42 个测试全部通过\n├─ lint-checker: ⚠ 2 条警告（非阻塞）\n└─ security-scanner: ✓ 未发现漏洞\n\n可以发布！\n```\n\n### 智能体实战\n\n智能体会根据您的请求自动启动：\n\n**您说：** “登录功能坏了，用户收到 401 错误”\n\n```\n[调试智能体已激活]\n→ 检查认证中间件... 发现问题\n→ 生产环境中的令牌验证使用了错误的密钥\n→ 解决方案：更新 .env.production 中的 AUTH_SECRET\n```\n\n**您说：** “请审查我的更改”\n\n```\n[代码审查智能体已激活]\n→ 正在分析 3 个修改文件...\n✓ 逻辑正确\n⚠ 第 42 行缺少空值检查\n⚠ 建议在此端点添加限流机制\n```\n\n**您说：** “为 API 添加认证功能”\n\n```\n[协调智能体已激活]\n→ 将任务分解为子任务：\n  1. 设计认证架构（启动架构师）\n  2. 实现 JWT 中间件\n  3. 添加登录\u002F注册端点\n  4. 编写测试用例（启动测试架构师）\n  5. 更新 API 文档（启动文档编写者）\n```\n\n### 技能实战\n\n技能会自动提供领域知识：\n\n**您问：** “支付服务应该如何设计？”\n\n```\n[设计架构技能生效]\n→ 推荐采用六边形架构\n→ 将支付服务商作为适配器\n→ 核心业务层与基础设施层隔离\n```\n\n**您问：** “如何让这个端点更快？”\n\n```\n[性能优化技能生效]\n→ 添加数据库索引\n→ 实施响应缓存\n→ 对大量结果使用分页\n```\n\n### 钩子实战\n\n钩子会在特定事件发生时自动触发：\n\n**安全拦截（编辑前）：**\n\n```\n⛔ 已阻止：检测到潜在密钥\n   文件：src\u002Fconfig.ts，第 5 行\n   模式：API 密钥 (sk-...)\n\n   请移除密钥，并使用环境变量。\n```\n\n**自动格式化（编辑后）：**\n\n```\n✓ 使用 Prettier 格式化：src\u002Fcomponents\u002FButton.tsx\n✓ 使用 Black 格式化：scripts\u002Fdeploy.py\n```\n\n**桌面通知：**\n\n```\n🔔 “Claude 等待输入” - 当等待您的回复时\n🔔 “任务已完成” - 当任务结束时\n```\n\n---\n\n## 命令参考\n\n所有命令均采用 `\u002Fproject-starter:\u003C命令>` 的格式。\n\n### 输出样式\n\n| 命令                      | 模式                                          |\n| ---------------------------- | --------------------------------------------- |\n| `\u002Fproject-starter:architect` | 系统设计模式 - 先设计架构再写代码             |\n| `\u002Fproject-starter:rapid`     | 快速开发模式 - 快速交付并迭代                 |\n| `\u002Fproject-starter:mentor`    | 教学模式 - 解释“为什么”                       |\n| `\u002Fproject-starter:review`    | 代码审查模式 - 严格把控质量                   |\n\n### Git 工作流（内循环）\n\n| 命令                              | 用途                                   |\n| ------------------------------------ | ----------------------------------------- |\n| `\u002Fproject-starter:commit`            | 自动生成规范化的提交信息               |\n| `\u002Fproject-starter:commit-push-pr`    | 提交 → 推送 → 创建 PR（完整流程）       |\n| `\u002Fproject-starter:quick-fix`         | 快速修复 Lint 或类型错误               |\n| `\u002Fproject-starter:add-tests`         | 为最近的更改生成测试用例               |\n| `\u002Fproject-starter:lint-fix`          | 自动修复所有 Lint 问题                 |\n| `\u002Fproject-starter:sync-branch`       | 与主分支同步（变基或合并）             |\n| `\u002Fproject-starter:summarize-changes` | 生成站会或 PR 摘要                     |\n\n### 验证\n\n| 命令                            | 用途                                 |\n| ---------------------------------- | --------------------------------------- |\n| `\u002Fproject-starter:verify-changes`  | 多子代理对抗式验证                   |\n| `\u002Fproject-starter:validate-build`  | 构建流程验证                         |\n| `\u002Fproject-starter:run-tests`       | 分层测试执行                         |\n| `\u002Fproject-starter:lint-check`      | 代码质量检查                       |\n| `\u002Fproject-starter:security-scan`   | 安全漏洞检测                         |\n| `\u002Fproject-starter:code-simplifier` | 实施后清理                           |\n\n### 规划与重构\n\n| 命令                               | 用途                                    |\n| ------------------------------------- | ------------------------------------------ |\n| `\u002Fproject-starter:plan`               | 持久化 PLAN.md 文件，跟踪各阶段进展     |\n| `\u002Fproject-starter:refactor-guided`    | 四阶段系统性重构，确保安全             |\n| `\u002Fproject-starter:dependency-upgrade` | 安全升级依赖项，并支持回滚           |\n\n### 新手引导与知识积累\n\n| 命令                                   | 用途                                   |\n| ----------------------------------------- | ----------------------------------------- |\n| `\u002Fproject-starter:tutorial`               | 针对新用户的交互式引导教程             |\n| `\u002Fproject-starter:bootstrap-repo`         | 10个子代理并行探索代码库               |\n| `\u002Fproject-starter:save-session-learnings` | 将会话中的发现持久化到文档中           |\n| `\u002Fproject-starter:metrics`                | 查看子代理性能指标                     |\n\n---\n\n## 子代理\n\n子代理是 Claude 根据您的任务自动创建的专用子代理。\n\n| 子代理              | 用途                          | 自动触发条件                                                |\n| ------------------ | -------------------------------- | ------------------------------------------------------------ |\n| `orchestrator`     | 协调多步骤任务      | “改进”、“增强”、“构建”、“架构设计”、复杂任务 |\n| `code-reviewer`    | 审查代码质量              | “评审”、“PR 审核”、“代码风格检查”、代码变更                  |\n| `debugger`         | 系统性排查 bug     | 错误、崩溃、内存泄漏、超时、竞态条件     |\n| `docs-writer`      | 编写技术文档          | README、变更日志、迁移指南、发布说明          |\n| `security-auditor` | 检测安全漏洞        | 认证、加密、敏感信息、OAuth、JWT、CORS                  |\n| `refactorer`       | 改进代码结构        | 技术债务、代码异味、降低复杂度                 |\n| `test-architect`   | 设计测试策略        | 测试计划、模拟、不稳定测试、集成\u002F端到端测试            |\n\n---\n\n## 技能\n\n技能是 Claude 在相关场景下自主使用的知识领域。\n\n| 技能                         | 领域                                                |\n| ----------------------------- | ----------------------------------------------------- |\n| `analyzing-projects`          | 理解代码库结构和模式            |\n| `designing-tests`             | 单元测试、集成测试、端到端测试方法                |\n| `designing-architecture`      | 清晰架构、六边形架构等                   |\n| `optimizing-performance`      | 加速应用，识别瓶颈           |\n| `managing-git`                | 版本控制，遵循规范提交                 |\n| `designing-apis`              | REST\u002FGraphQL 模式及最佳实践              |\n| `parallel-execution`          | 多子代理并行执行任务模式       |\n| `web-design-guidelines`       | 自包含 UI 审计（A11Y、PERF、RD、SEC、I18N）   |\n| `vercel-react-best-practices` | React\u002FNext.js 性能优化（45 条规则）     |\n| `convex-backend`              | Convex 后端开发（函数、模式等）         |\n| `database-design`             | 数据库模式设计、索引优化、查询优化           |\n| `devops-infrastructure`       | Docker、CI\u002FCD、部署、基础设施即代码、监控     |\n| `error-handling`              | 错误模式、结构化日志记录、重试\u002F熔断机制     |\n| `security-patterns`           | 认证、RBAC、敏感信息、CORS、限流、HTTP 头部     |\n\n---\n\n## 钩子\n\n钩子会在特定事件发生时自动运行。\n\n| 钩子                  | 触发条件       | 动作                                  |\n| --------------------- | ------------- | --------------------------------------- |\n| 安全扫描         | 编辑\u002F写入    | 阻止包含潜在敏感信息的提交   |\n| 文件保护       | 编辑\u002F写入    | 阻止对锁定文件、.env、.git 的编辑  |\n| 自动格式化       | 编辑\u002F写入    | 根据文件类型运行 prettier\u002Fblack\u002Fgofmt |\n| TypeScript 检查  | 编辑\u002F写入    | 对 .ts\u002F.tsx 文件运行 `tsc --noEmit`   |\n| 提交前检查       | Bash 脚本    | 检测调试语句及临时标记             |\n| 分支保护         | Bash 脚本    | 警告对保护分支的提交               |\n| 命令日志记录     | Bash 脚本    | 日志记录至 `.claude\u002Fcommand-history.log` |\n| 环境检查         | 会话开始     | 验证 Node.js、Python、Git 是否正常  |\n| 提示分析         | 用户提示     | 推荐合适的子代理                   |\n| 自动验证         | 任务完成     | 运行测试\u002F代码风格检查，报告结果    |\n| 文档更新建议     | 任务完成     | 建议更新 CLAUDE.md 以反映更改       |\n| 会话指标         | 任务完成     | 将会话遥测数据记录到指标文件中     |\n| 输入提醒         | 需要输入     | 桌面通知                           |\n| 完成提醒         | 任务完成     | 桌面通知                           |\n\n---\n\n## 示例\n\n有关详细的多子代理编排示例，请参阅 [examples\u002F](.\u002Fexamples\u002F) 目录：\n\n| 示例                                                                          | 描述                                            |\n| -------------------------------------------------------------------------------- | ------------------------------------------------------ |\n| [全面代码审查](.\u002Fexamples\u002Forchestration\u002Fcomprehensive-code-review\u002F) | 6个子代理按顺序协作，进行彻底的代码分析 |\n\n每个示例包括：\n\n- **README.md** - 概述及快速入门\n- **workflow.md** - 具体使用提示\n- **verification.md** - 如何验证其有效性\n- **sample-outputs\u002F** - 子代理输出示例\n\n---\n\n## 配置\n\n### 为项目添加权限\n\n将权限模板复制到您的项目中：\n\n```bash\nmkdir -p \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.claude\ncp templates\u002Fsettings.local.json.template \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.claude\u002Fsettings.local.json\n```\n\n这将预先允许常用的安全命令，避免每次操作都需确认。\n\n### 添加团队规范\n\n将 CLAUDE.md 模板复制到你的项目根目录：\n\n```bash\ncp templates\u002FCLAUDE.md.template \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002FCLAUDE.md\n```\n\n然后根据你的需求进行自定义：\n\n- 包管理器命令\n- 测试\u002F构建\u002F代码检查命令\n- 代码规范\n- 架构决策\n\n### MCP 服务器\n\n复制 MCP 模板以启用 Slack、GitHub、Sentry 等集成：\n\n```bash\ncp templates\u002Fmcp.json.template \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.mcp.json\n```\n\n然后配置你想要使用的服务器的环境变量。\n\n### GitHub Action（在 PR 中使用 @.claude）\n\n通过安装 GitHub Action，使 Claude 能够回复 PR 评论：\n\n```bash\n# 在你的仓库中\nclaude \u002Finstall-github-action\n```\n\n这将启用以下功能：\n\n- 在 PR 评论中标记 `@claude` 以获取代码建议\n- 在代码审查期间自动更新 `CLAUDE.md`\n- Claude 会自动回复审查反馈\n\n**PR 评论示例：**\n\n```\n@claude 请为邮箱字段添加输入验证\n```\n\n**团队工作流程提示：** 使用 `@claude` 来根据代码审查中的经验更新 `CLAUDE.md`：\n\n```\n@claude 在 CLAUDE.md 中添加一条注释，说明我们在调用 API 之前应始终验证邮箱格式\n```\n\n---\n\n## 扩展插件\n\n### 添加自定义命令\n\n在 `commands\u002F` 目录下创建 `.md` 文件：\n\n```markdown\n---\nallowed-tools: Bash(git:*), Read, Write\ndescription: 此命令的作用\nargument-hint: [可选参数]\n---\n\n[命令的具体操作步骤]\n```\n\n### 添加自定义代理\n\n在 `agents\u002F` 目录下创建 `.md` 文件：\n\n```markdown\n---\nname: my-agent\ndescription: 它的功能。在 [触发条件] 时主动使用。\ntools: Read, Write, Edit, Bash\nmodel: sonnet\n---\n\n[代理的操作指南]\n```\n\n### 添加自定义技能\n\n在 `skills\u002F` 目录下创建子目录，并在其中包含一个 `SKILL.md` 文件：\n\n```markdown\n---\nname: my-skill\ndescription: 指导 [领域]。在 [触发条件] 时使用。\n---\n\n[技能相关的知识和模式]\n```\n\n---\n\n## 插件结构\n\n```\nclaude-workflow\u002F\n├── .claude-plugin\u002F\n│   ├── plugin.json           # 必需：插件清单\n│   └── marketplace.json      # 可选：市场元数据\n├── agents\u002F                   # 7 个专业代理\n│   ├── orchestrator.md\n│   ├── code-reviewer.md\n│   ├── debugger.md\n│   ├── docs-writer.md\n│   ├── security-auditor.md\n│   ├── refactorer.md\n│   └── test-architect.md\n├── commands\u002F                 # 26 个斜杠命令\n│   ├── architect.md          # 输出样式\n│   ├── rapid.md\n│   ├── mentor.md\n│   ├── review.md\n│   ├── commit.md             # Git 工作流\n│   ├── commit-push-pr.md\n│   ├── quick-fix.md\n│   ├── add-tests.md\n│   ├── lint-fix.md\n│   ├── sync-branch.md\n│   ├── summarize-changes.md\n│   ├── verify-changes.md     # 验证\n│   ├── validate-build.md\n│   ├── run-tests.md\n│   ├── lint-check.md\n│   ├── security-scan.md\n│   ├── code-simplifier.md\n│   ├── parallel-review.md    # 并行\n│   ├── parallel-analyze.md\n│   ├── plan.md               # 规划与重构\n│   ├── refactor-guided.md\n│   ├── dependency-upgrade.md\n│   ├── tutorial.md           # 入职培训与知识普及\n│   ├── bootstrap-repo.md\n│   ├── save-session-learnings.md\n│   └── metrics.md\n├── skills\u002F                   # 14 个知识领域\n│   ├── analyzing-projects\u002F\n│   ├── convex-backend\u002F\n│   ├── database-design\u002F\n│   ├── designing-apis\u002F\n│   ├── designing-architecture\u002F\n│   ├── designing-tests\u002F\n│   ├── devops-infrastructure\u002F\n│   ├── error-handling\u002F\n│   ├── managing-git\u002F\n│   ├── optimizing-performance\u002F\n│   ├── parallel-execution\u002F\n│   ├── security-patterns\u002F\n│   ├── vercel-react-best-practices\u002F\n│   └── web-design-guidelines\u002F\n├── hooks\u002F\n│   ├── hooks.json            # 钩子配置\n│   └── 14 个自动化脚本     # 工具前后、会话、指标、通知等\n├── templates\u002F                # 用户可复制的模板\n│   ├── CLAUDE.md.template\n│   ├── settings.json.template\n│   ├── settings.local.json.template\n│   └── mcp.json.template\n├── CLAUDE.md                 # 插件开发指南\n└── README.md\n```\n\n---\n\n## 系统要求\n\n- **Claude Code** v1.0.33 或更高版本\n- **Python 3**（用于钩子脚本）\n- **Node.js**（可选，用于 npm 命令）\n- **Git**（用于版本控制功能）\n\n---\n\n## 多代理兼容性（skills.sh）\n\n此仓库与 [skills.sh](https:\u002F\u002Fskills.sh)——通用代理技能平台——完全兼容。我们的 14 种技能可与 **38+ 个 AI 编码代理** 一起使用：\n\n| 代理           | 安装方法                                                       |\n| --------------- | -------------------------------------------------------------------- |\n| **Claude Code** | `npx skills add CloudAI-X\u002Fclaude-workflow-v2` 或完整插件安装 |\n| **Cursor**      | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n| **Codex**       | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n| **Windsurf**    | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n| **Cline**       | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n| **35+ 其他**    | `npx skills add CloudAI-X\u002Fclaude-workflow-v2`                        |\n\n> **注意：** `npx skills add` 只会安装 **技能**。若要获得完整的 Claude Code 体验（代理、命令、钩子），请使用 `npx install-claude-workflow-v2@latest`。\n\n---\n\n## 贡献\n\n欢迎贡献！请参阅 [CONTRIBUTING.md](.\u002FCONTRIBUTING.md)。\n\n1. 分支仓库\n2. 创建特性分支 (`git checkout -b feature\u002Famazing-feature`)\n3. 提交更改 (`git commit -m 'feat: 添加超赞功能'`)\n4. 推送到分支 (`git push origin feature\u002Famazing-feature`)\n5. 打开拉取请求\n\n---\n\n## 星标历史\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FCloudAI-X_claude-workflow-v2_readme_c0ddceb1e6bc.png)](https:\u002F\u002Fwww.star-history.com\u002F#CloudAI-X\u002Fclaude-workflow-v2?type=date&legend=top-left)\n\n## 致谢\n\n- 插件由 [@cloudxdev](https:\u002F\u002Fx.com\u002Fcloudxdev) 创建\n- 工作流模式灵感来源于 [Boris Cherny](https:\u002F\u002Fx.com\u002Fbcherny)（Claude Code 的创造者）\n\n## 许可证\n\nMIT - 详情请参阅 [LICENSE](.\u002FLICENSE)。","# claude-workflow-v2 快速上手指南\n\n`claude-workflow-v2` 是一个通用的 Claude Code 工作流插件，提供专用的智能体（Agents）、技能（Skills）、钩子（Hooks）和输出风格，适用于任何软件项目。它兼容 Claude Code、Cursor、Codex 等 35+ 种 AI 编程助手。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Linux, macOS, 或 Windows (WSL2 推荐)\n*   **核心依赖**：\n    *   [Node.js](https:\u002F\u002Fnodejs.org\u002F) (建议 v18+)\n    *   [Git](https:\u002F\u002Fgit-scm.com\u002F)\n*   **AI 客户端**（任选其一）：\n    *   **Claude Code** (官方 CLI，推荐)\n    *   Cursor IDE\n    *   其他支持 `skills.sh` 或本地插件加载的 AI 代理\n\n> **注意**：本工具主要设计用于命令行环境或集成开发环境中的 AI 对话界面。\n\n## 安装步骤\n\n您可以根据使用习惯选择以下任意一种安装方式。\n\n### 方式一：通用安装（推荐）\n适用于 Claude Code、Cursor、Codex、Windsurf、Cline 等 35+ 种 AI 代理。此方式通过 `skills.sh` 自动配置。\n\n```bash\nnpx skills add CloudAI-X\u002Fclaude-workflow-v2\n```\n\n### 方式二：完整插件安装（仅限 Claude Code）\n如果您使用的是原生 Claude Code CLI，并希望安装包含所有智能体、命令、技能和钩子的完整版本：\n\n```bash\nnpx install-claude-workflow-v2@latest\n```\n\n### 方式三：临时会话使用（CLI）\n无需永久安装，仅在当前会话中加载插件：\n\n```bash\n# 1. 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002FCloudAI-X\u002Fclaude-workflow-v2.git\n\n# 2. 带插件启动 Claude Code\nclaude --plugin-dir .\u002Fclaude-workflow-v2\n```\n\n### 验证安装\n启动 AI 助手后，输入以下命令检查插件状态：\n\n```text\n> \u002Fplugin\n```\n*   切换到 **Installed** 标签页，应能看到 `project-starter`。\n*   切换到 **Errors** 标签页，应为空（无报错）。\n\n## 基本使用\n\n安装成功后，您可以直接使用 `\u002Fproject-starter:\u003C命令>` 格式的指令来增强开发流程。\n\n### 1. 切换工作模式\n根据任务类型选择合适的输出风格：\n\n*   **架构优先模式**（适合新项目或重构）：\n    ```text\n    > \u002Fproject-starter:architect\n    ```\n*   **快速交付模式**（适合快速迭代）：\n    ```text\n    > \u002Fproject-starter:rapid\n    ```\n*   **代码审查模式**（严格质量检查）：\n    ```text\n    > \u002Fproject-starter:review\n    ```\n\n### 2. 自动化 Git 工作流\n自动处理提交信息生成、推送和 PR 创建：\n\n*   **自动生成规范提交信息**：\n    ```text\n    > \u002Fproject-starter:commit\n    ```\n    *输出示例：`✓ Created commit: feat(auth): add JWT refresh token endpoint`*\n\n*   **完整流程（提交 -> 推送 -> 创建 PR）**：\n    ```text\n    > \u002Fproject-starter:commit-push-pr\n    ```\n\n### 3. 多智能体验证\n在发布前自动调用多个子智能体进行构建、测试、Lint 和安全扫描：\n\n```text\n> \u002Fproject-starter:verify-changes\n```\n*系统将自动执行：构建验证、测试运行、代码检查和安全扫描，并汇总报告。*\n\n### 4. 智能体自动触发\n您无需手动调用智能体，只需在自然语言描述中提及相关任务，系统会自动激活对应的专用智能体：\n\n*   **场景：修复 Bug**\n    *   用户输入：\"登录功能坏了，用户收到 401 错误\"\n    *   系统反应：自动激活 `debugger` 智能体排查认证中间件和 Token 问题。\n\n*   **场景：代码审查**\n    *   用户输入：\"审查我的更改\"\n    *   系统反应：自动激活 `code-reviewer` 智能体分析文件变更，指出逻辑错误或潜在风险。\n\n*   **场景：复杂功能开发**\n    *   用户输入：\"为 API 添加认证功能\"\n    *   系统反应：自动激活 `orchestrator` 智能体，拆解任务并协调 `architect`、`test-architect` 等子智能体并行工作。\n\n### 5. 自动化钩子（Hooks）\n以下操作将在后台自动运行，无需额外指令：\n*   **安全拦截**：尝试提交包含 API Key 或_SECRET 的代码时会被自动阻断。\n*   **自动格式化**：保存或编辑文件时，自动运行 `prettier` 或 `black` 进行格式化。\n*   **类型检查**：编辑 TypeScript 文件时自动运行 `tsc --noEmit`。","某全栈开发者正紧急修复一个生产环境的支付模块漏洞，并需要在半小时内完成代码修复、测试验证及上线部署。\n\n### 没有 claude-workflow-v2 时\n- **流程割裂低效**：开发者需手动切换终端，依次执行代码修改、运行测试、检查 Lint、构建项目，最后再手动编写 Git 提交信息和创建 PR，耗时且易出错。\n- **缺乏深度自检**：AI 仅生成代码片段，无法自动调用安全扫描或单元测试代理，导致潜在的逻辑漏洞（如空指针异常）未被及时发现。\n- **上下文切换频繁**：为了确认修复是否影响其他模块，开发者需反复向 AI 解释项目架构，或在不同工具间复制粘贴错误日志进行调试。\n- **提交规范难统一**：手动编写的 Commit Message 往往不符合团队规范，导致后续 Code Review 困难，版本历史混乱。\n\n### 使用 claude-workflow-v2 后\n- **一键自动化闭环**：只需输入 `\u002Fproject-starter:commit-push-pr`，claude-workflow-v2 自动完成从代码提交、推送到远程仓库再到创建 Pull Request 的全流程。\n- **多代理协同验证**：执行 `\u002Fproject-starter:verify-changes` 后，内置的构建验证器、测试运行器及安全扫描代理并行工作，确保“构建通过、测试全绿、无高危漏洞”后才允许发布。\n- **智能故障定位**：当描述“支付回调失败”时，debugger 代理自动激活，直接定位到环境变量配置错误并给出修复方案，无需人工介入排查。\n- **标准化输出**：`\u002Fproject-starter:commit` 命令自动生成符合约定式提交规范的 Message（如 `fix(payment): validate webhook signature`），保持版本史清晰专业。\n\nclaude-workflow-v2 将分散的开发动作整合为智能工作流，让开发者从繁琐的流程操作中解放，专注于核心业务逻辑的突破。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FCloudAI-X_claude-workflow-v2_e58662c4.png","CloudAI-X","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FCloudAI-X_e4935f73.jpg","Agents\u002FWorkflows\u002FDocs",null,"cloudaixdev@gmail.com","cloudxdev","https:\u002F\u002Fgithub.com\u002FCloudAI-X",[81,85,89],{"name":82,"color":83,"percentage":84},"Python","#3572A5",75.3,{"name":86,"color":87,"percentage":88},"JavaScript","#f1e05a",15.3,{"name":90,"color":91,"percentage":92},"Shell","#89e051",9.5,1320,187,"2026-04-09T07:52:48","MIT",1,"未说明","不需要 GPU",{"notes":101,"python":98,"dependencies":102},"该工具是 Claude Code 的插件\u002F工作流扩展，而非独立的 AI 模型，因此不需要本地 GPU 或大量内存。运行环境主要依赖 Node.js (通过 npx 执行) 和 Claude Code CLI。支持通过 skills.sh 集成到 Cursor、Codex 等多种代理中。部分钩子功能可能需要预装 Prettier、Black、GoFmt 或 TypeScript 等语言特定的格式化和检查工具。",[103,104,105],"Node.js (npx)","Claude Code CLI","@anthropic-ai\u002Fclaude-agent-sdk (可选)",[13,14,15],[108,109,110,111,112,113,114,115],"agent-skills","ai","ai-agents","claude-code","codex","cursor","skills","workflow","2026-03-27T02:49:30.150509","2026-04-10T10:28:42.590449",[119,124,128,133,138,143],{"id":120,"question_zh":121,"answer_zh":122,"source_url":123},27534,"hooks.json 加载时报错 \"expected: object, received: undefined\" 是什么原因？","该错误表明 hooks.json 的文件结构不正确，缺少必需的顶层包装对象。请检查 hooks.json 的语法和结构，确保其符合 Claude Code 插件的 Schema 要求，即必须包含有效的对象结构而非未定义或格式错误的内容。","https:\u002F\u002Fgithub.com\u002FCloudAI-X\u002Fclaude-workflow-v2\u002Fissues\u002F3",{"id":125,"question_zh":126,"answer_zh":127,"source_url":123},27530,"为什么插件加载失败，提示 plugin.json 或 hooks.json 格式错误？","这是因为配置文件使用了错误的 Schema 格式。plugin.json 不应使用 npm package.json 的惯例（例如 repository 字段必须是字符串而不是对象），且 hooks.json 必须包含必需的包装对象。请检查并修正这两个文件的结构，确保符合 Claude Code 的实际 Schema 规范，移除不属于规范的字段。",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},27531,"在 WSL 或无头 Linux 服务器上，verify-on-complete 钩子因缺少 notify-send 而报错怎么办？","可以通过创建一个 stub 脚本来解决。运行以下命令创建伪命令，将通知记录到日志文件而不是弹出窗口：\n\nsudo tee \u002Fusr\u002Flocal\u002Fbin\u002Fnotify-send \u003C\u003C 'SCRIPT'\n#!\u002Fbin\u002Fbash\n# Log notifications to file - stub for WSL where notify-send isn't available\necho \"[$(date '+%Y-%m-%d %H:%M:%S')] $1: $2\" >> ~\u002F.claude-notifications.log\nexit 0\nSCRIPT\nsudo chmod +x \u002Fusr\u002Flocal\u002Fbin\u002Fnotify-send\n\n之后可以使用 tail -f ~\u002F.claude-notifications.log 查看通知日志。","https:\u002F\u002Fgithub.com\u002FCloudAI-X\u002Fclaude-workflow-v2\u002Fissues\u002F5",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},27532,"如何编排多个 Agent 进行顺序工作（如综合代码审查）？","项目已在 examples\u002Forchestration\u002Fcomprehensive-code-review\u002F 目录下添加了多 Agent 编排示例。该示例展示了如何按顺序运行 6 个专用 Agent（代码审查员 -> 调试员 -> 安全审计员 -> 测试架构师 -> 重构员 -> 文档撰写员），收集各自的 Markdown 报告，并生成包含关键发现和执行建议的汇总报告。用户可以参考该目录下的工作流提示、验证指南和样本输出。","https:\u002F\u002Fgithub.com\u002FCloudAI-X\u002Fclaude-workflow-v2\u002Fissues\u002F2",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},27533,"无法通过 Marketplace 安装插件，提示缺少文件怎么办？","这通常是因为仓库中缺少 marketplace.json 文件。维护者已修复此问题，确保仓库根目录下包含正确的 marketplace.json 文件即可正常通过 Marketplace 安装。","https:\u002F\u002Fgithub.com\u002FCloudAI-X\u002Fclaude-workflow-v2\u002Fissues\u002F1",{"id":144,"question_zh":145,"answer_zh":146,"source_url":137},27535,"有没有关于多 Agent 协作的具体实战案例可以参考？","有的。项目提供了一个经过生产环境验证的代码审查编排系统案例。该系统能串行运行 6 个不同角色的 Agent，生成 6-7 份详细报告（每份 15-25KB），并最终整合成一份包含可执行建议的执行摘要。相关脚本、配置模板和真实输出示例均位于 examples\u002F 目录中，适用于各类项目。",[]]