VersoXBT/claude-initial-setup

[](https://github.com/VersoXBT/claude-initial-setup/stargazers) [](https://github.com/VersoXBT/claude-initial-setup/blob/main/LICENSE) [](https://github.com/VersoXBT/claude-initial-setup/releases) # Claude Code 入门套件 一款开箱即用的 Claude Code 插件，包含 **75 项技能**、**14 个代理**、**15 个斜杠命令**、**8 条规则** 和 **6 个钩子**，涵盖 TypeScript、Python、Go、Rust、React、Next.js、FastAPI、Django、Docker、CI/CD、安全、测试等内容。包含适用于 Cursor、GitHub Copilot 和 OpenAI Codex 的跨 AI 配置文件。 ## 目录 - [为什么使用本项目](#why-use-this) - [快速开始](#quick-start) - [包含内容](#what-is-included) - [Claude Code 代理](#claude-code-agents) - [斜杠命令](#slash-commands) - [技能目录](#skills-catalog) - [规则](#rules) - [钩子](#hooks) - [跨 AI 兼容性](#cross-ai-compatibility) - [仓库结构](#repository-structure) - [自定义](#customization) - [卸载](#uninstall) - [贡献](#contributing) - [许可证](#license) ## 为什么使用本项目 大多数开发者启动 Claude Code 时都是一片空白——没有技能，没有代理，没有编码标准。本插件可在 60 秒内为您提供一个生产就绪的基础。 - **75 项精选技能**，涵盖 25 个类别，让 Claude Code 开箱即用，掌握您技术栈的最佳实践 - **14 个专业代理**，用于代码审查、安全审计、TDD、调试、架构等——随时可作为子代理生成 - **15 个斜杠命令**，映射到开发者实际使用的工作流：`/review`、`/tdd`、`/debug`、`/security-check`、`/plan` - **8 条规则**，执行编码标准（不可变性、约定式提交、80% 以上测试覆盖率），无需手动配置 - **6 个钩子**，用于在每个工具事件上自动格式化、安全检查和 lint 提醒 - **跨 AI 支持**——同样的最佳实践导出为 Cursor、GitHub Copilot 和 OpenAI Codex 配置格式 无论您编写 TypeScript、Python、Go、Rust 还是 Java，本入门套件都能让 Claude Code 立即高效工作。 ## 快速开始 ### 作为 Claude Code 插件安装 ``` /plugin marketplace add VersoXBT/claude-initial-setup /plugin install claude-initial-setup@claude-initial-setup ``` ### 手动安装 ``` git clone https://github.com/VersoXBT/claude-initial-setup.git cd claude-initial-setup chmod +x install.sh ./install.sh ``` 安装脚本会将所有 75 项技能符号链接到 `~/.claude/skills/`。 ### 安装单个技能 ``` mkdir -p ~/.claude/skills ln -sfn /path/to/claude-initial-setup/skills/typescript/strict-typescript ~/.claude/skills/strict-typescript ``` ## 包含内容 | 组件 | 数量 | 描述 | |-----------|-------|-------------| | Skills（技能） | 75 | 跨 25 个类别的 SKILL.md 文件 | | Agents（代理） | 14 | 用于委托任务的专业子代理 | | Commands（命令） | 15 | 用于通用工作流的斜杠命令 | | Rules（规则） | 8 | 编码标准和指南 | | Hooks（钩子） | 6 | 工具事件的自动化触发器 | ## Claude Code 代理 代理是您可以生成用于委托任务的专业子代理。每个代理都有定义的角色、工具集和流程。 | 代理 | 用途 | |-------|---------| | `planner` | 复杂功能的实施规划 | | `architect` | 系统设计和架构决策 | | `code-reviewer` | 代码质量、安全性、可维护性审查 | | `security-reviewer` | OWASP 漏洞、密钥、注入检测 | | `tdd-guide` | 测试驱动开发，80% 以上覆盖率执行 | | `debugger` | 带假设测试的系统化调试 | | `build-error-resolver` | 以最小差异修复构建/类型错误 | | `refactor-cleaner` | 死代码清理和整合 | | `doc-updater` | 文档和 README 更新 | | `performance-optimizer` | 性能分析、缓存、优化 | | `database-reviewer` | Schema 设计、查询优化、迁移审查 | | `api-designer` | REST/GraphQL API 设计和审查 | | `devops-engineer` | Docker、CI/CD、基础设施 | | `e2e-runner` | Playwright 端到端测试 | ## 斜杠命令 用于通用开发工作流的斜杠命令。 | 命令 | 描述 | |---------|-------------| | `/review` | 对最近更改运行代码审查 | | `/tdd` | 启动 TDD 工作流（红-绿-重构） | | `/debug` | 系统化调试流程 | | `/build-fix` | 增量修复构建错误 | | `/security-check` | OWASP 安全审计 | | `/refactor` | 死代码清理和重构 | | `/test-coverage` | 分析并提高测试覆盖率 | | `/optimize` | 性能分析和优化 | | `/plan` | 创建实施计划 | | `/deploy-check` | 部署前验证 | | `/api-review` | 审查 API 设计 | | `/db-review` | 审查数据库 Schema/查询 | | `/update-docs` | 更新文档 | | `/lint-fix` | 自动修复 lint 和格式问题 | | `/checkpoint` | Git commit 检查点 | ## 技能目录 75 项技能，组织为 25 个类别。点击任意类别以展开。

核心工作流 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `commit-conventions` | 约定式提交格式、类型、范围、破坏性变更 | | `branching-strategy` | Git Flow 与主干开发对比、分支命名、merge 与 rebase 对比 | | `pr-workflow` | PR 模板、审查流程、CI 门控、合并策略 |

编码风格 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `immutability-patterns` | 展开运算符、Object.freeze、structuredClone、immer | | `file-organization` | 基于功能 vs 基于类型、barrel 导出、共置 | | `naming-conventions` | 变量、函数、类、文件、数据库列 |

调试 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `systematic-debugging` | 二分法调试、假设测试、bisect | | `log-analysis` | 结构化日志、日志级别、关联 ID | | `error-tracing` | 堆栈跟踪读取、source map、错误边界 |

TypeScript (3 项技能)

| 技能 | 描述 | |-------|-------------| | `strict-typescript` | strictNullChecks、noUncheckedIndexedAccess、类型收窄 | | `type-patterns` | 可辨识联合、品牌类型、模板字面量类型 | | `generics-mastery` | 泛型约束、条件类型、映射类型、infer |

Go (3 项技能)

| 技能 | 描述 | |-------|-------------| | `idiomatic-go` | 错误处理、接口、结构体嵌入、包组织 | | `error-handling-go` | 自定义错误类型、错误包装、哨兵错误、errors.Is/As | | `concurrency-patterns-go` | Goroutines、channels、WaitGroup、context、工作者池 |

Rust (3 项技能)

| 技能 | 描述 | |-------|-------------| | `ownership-borrowing` | 所有权规则、借用、生命周期、Box/Rc/Arc | | `error-handling-rust` | Result/Option、? 运算符、thiserror、anyhow | | `cargo-workflows` | 工作区、特性标志、build.rs、clippy/fmt |

Python (3 项技能)

| 技能 | 描述 | |-------|-------------| | `pythonic-patterns` | 推导式、生成器、上下文管理器、装饰器 | | `type-hints-guide` | Protocol、TypeVar、ParamSpec、Generic、Literal | | `project-structure-python` | pyproject.toml、src 布局、uv/rye/poetry、虚拟环境 |

FastAPI (3 项技能)

| 技能 | 描述 | |-------|-------------| | `async-fastapi` | 异步端点、后台任务、中间件、WebSockets | | `pydantic-validation` | BaseModel、字段/模型验证器、计算字段 | | `dependency-injection-fastapi` | Depends()、安全依赖、数据库会话 |

Django (3 项技能)

| 技能 | 描述 | |-------|-------------| | `django-orm-mastery` | QuerySets、select/prefetch_related、F/Q 对象、注解 | | `drf-api-patterns` | 序列化器、ViewSets、权限、分页、过滤 | | `django-admin-customization` | ModelAdmin、内联、自定义操作、列表过滤器 |

React 和 Next.js (3 项技能)

| 技能 | 描述 | |-------|-------------| | `component-patterns` | 复合组件、render props、HOC、组合 | | `hooks-mastery` | 自定义 hooks、useCallback、useMemo、useRef、useReducer | | `nextjs-app-router` | 服务端组件、路由处理程序、中间件、流式传输 |

Express 和 Node.js (3 项技能)

| 技能 | 描述 | |-------|-------------| | `middleware-patterns` | 中间件链、认证、速率限制、CORS、验证 | | `express-error-handling` | 异步错误、自定义错误类、集中式中间件 | | `rest-api-node` | RESTful 约定、分页、过滤、版本控制 |

Java (3 项技能)

| 技能 | 描述 | |-------|-------------| | `spring-boot-patterns` | 注解、依赖注入、profiles、actuator | | `maven-gradle-guide` | pom.xml、build.gradle.kts、多模块、依赖管理 | | `junit-testing` | JUnit 5、Mockito、MockMvc、Testcontainers |

Docker (3 项技能)

| 技能 | 描述 | |-------|-------------| | `dockerfile-best-practices` | 多阶段构建、层缓存、非 root 用户 | | `docker-compose-guide` | 服务、网络、卷、健康检查、profiles | | `multi-stage-builds` | 构建器模式、distroless 镜像、缓存挂载 |

CI/CD (3 项技能)

| 技能 | 描述 | |-------|-------------| | `github-actions-guide` | 工作流语法、可复用工作流、矩阵策略 | | `pipeline-patterns` | 流水线设计、制品管理、环境晋升 | | `deploy-strategies` | 蓝绿部署、金丝雀发布、滚动更新、特性开关 |

数据库 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `schema-design-guide` | 规范化、索引策略、约束、命名 | | `query-optimization` | EXPLAIN ANALYZE、索引调优、N+1 检测 | | `migration-patterns` | 零停机迁移、数据迁移、回滚 |

安全 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `owasp-top-10-prevention` | SQL 注入、XSS、CSRF、SSRF、身份验证失效 | | `secret-management` | 环境变量、vault 模式、密钥轮换 | | `input-validation-guide` | Zod、Pydantic、允许列表、清理 |

代码审查 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `review-checklist` | 检查内容、严重级别、建设性反馈 | | `automated-review-setup` | ESLint、Prettier、hus/lint-staged、CODEOWNERS | | `pr-standards` | PR 大小限制、描述模板、审查 SLA |

性能 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `profiling-guide` | Chrome DevTools、cProfile、pprof、火焰图 | | `caching-strategies` | Redis、CDN、浏览器缓存、stale-while-revalidate | | `lazy-loading-patterns` | 代码分割、动态导入、React.lazy、Suspense |

Claude API (3 项技能)

| 技能 | 描述 | |-------|-------------| | `anthropic-sdk-guide` | Python/TS SDK、messages API、流式传输、prompt 缓存 | | `prompt-engineering` | 系统 prompt、少样本、思维链、结构化输出 | | `tool-use-patterns` | 工具 schemas、多工具编排、并行工具使用 |

MCP 开发 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `mcp-server-creation` | 服务器脚手架、传输、生命周期钩子、测试 | | `mcp-tool-design` | 命名、输入 schemas、错误响应、分页 | | `mcp-resource-patterns` | 资源 URI、模板、订阅、动态资源 |

代理模式 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `multi-agent-orchestration` | 编排器、流水线、共识、委托模式 | | `context-management` | 上下文窗口优化、摘要、RAG、修剪 | | `agent-communication` | 消息传递、共享状态、事件驱动、发布/订阅 |

钩子 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `pre-post-hooks` | PreToolUse、PostToolUse、Stop 钩子、匹配器模式 | | `automation-triggers` | 自动格式化、自动 lint、自动测试、文件变更响应 | | `hook-recipes` | 现成配方：prettier、tsc、密钥泄露防护 |

代理编排 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `subagent-patterns` | 何时使用子代理、类型、结果处理 | | `parallel-task-execution` | 扇出/扇入、并行工具调用、后台代理 | | `task-coordination` | 任务依赖、负责人分配、状态跟踪 |

记忆管理 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `memory-patterns` | MEMORY.md 结构、主题文件、保存 vs 跳过决策 | | `context-optimization` | Token 预算、渐进式披露、子代理防火墙 | | `knowledge-persistence` | 从修正中学习、模式提取 |

测试 (3 项技能)

| 技能 | 描述 | |-------|-------------| | `tdd-workflow` | 红-绿-重构、测试优先、80% 以上覆盖率目标 | | `test-architecture` | 测试组织、fixtures、工厂、隔离 | | `mocking-strategies` | Mock vs stub vs spy、测试用 DI、何时不使用 mock |

## 规则 规则在整个项目中执行编码标准。它们由 Claude Code 自动加载。 | 规则 | 内容 | |------|---------| | `coding-style` | 不可变性、文件组织、命名、小函数 | | `git-workflow` | 约定式提交、分支命名、PR 流程 | | `testing` | TDD、80% 覆盖率、测试类型、隔离 | | `security` | 密钥、输入验证、注入防护 | | `performance` | 先分析、缓存、懒加载 | | `api-design` | REST 约定、错误格式、分页 | | `database` | 规范化、索引、迁移、N+1 防护 | | `agents` | 代理编排、何时使用哪个代理 | ## 钩子 在 Claude Code 工具事件上运行的自动化触发器。由于这是一个入门套件，所有钩子都是非阻塞的（仅警告）。编辑 `hooks/hooks.json` 以自定义行为。 - 长时间运行命令的 Tmux 提醒 - git push 前的审查提醒 - 包安装安全检查 - JS/TS 编辑后的 Prettier 提醒 - 编辑文件上的 Console.log 警告 - TypeScript 检查提醒 ## 跨 AI 兼容性 本插件包含适用于其他 AI 编程助手的配置文件，因此无论您使用哪种工具，都能应用同样的最佳实践。 | 文件 | AI 工具 | 描述 | |------|---------|-------------| | `AGENTS.md` | OpenAI Codex | 开发约定和代理上下文 | | `.github/copilot-instructions.md` | GitHub Copilot | 简短指令说明 | | `.cursor/rules/claude-initial-setup.mdc` | Cursor (现代) | 带元数据的 MDC 规则 | | `.cursorrules` | Cursor (旧版) | 纯 Markdown 规则 | ## 仓库结构 ``` claude-initial-setup/ .claude-plugin/ plugin.json # Plugin manifest marketplace.json # Marketplace metadata agents/ # 14 specialized subagents commands/ # 15 slash commands hooks/ hooks.json # Automation triggers rules/ # 8 coding standards skills/ # 75 skills across 25 categories / / SKILL.md .github/ copilot-instructions.md # GitHub Copilot .cursor/ rules/ claude-initial-setup.mdc # Cursor AGENTS.md # OpenAI Codex .cursorrules # Cursor (legacy) install.sh # Symlink installer uninstall.sh # Symlink remover ``` ## 自定义 ### 修改技能 直接编辑任何 `SKILL.md`。更改将在下一个 Claude Code 会话中生效。 ### 添加参考文件 对于需要更深层内容的技能，添加一个 `references/` 子目录： ``` skills/typescript/strict-typescript/ SKILL.md references/ compiler-options.md migration-guide.md ``` ### 创建新技能 1. 在 `skills/` 中的相应类别下创建一个目录 2. 添加一个包含 YAML frontmatter 的 `SKILL.md`（`name` 和 `description` 为必填字段） 3. 运行 `./install.sh` 将新技能符号链接到 `~/.claude/skills/` ### 禁用技能 移除其符号链接而不删除源文件： ``` rm ~/.claude/skills/ ``` ## 卸载 移除所有符号链接的技能： ``` ./uninstall.sh ``` 或移除单个技能： ``` rm ~/.claude/skills/ ``` ## 贡献 欢迎贡献。要添加新技能、代理或命令： 1. Fork 本仓库 2. 创建一个功能分支 (`git checkout -b feat/new-skill-name`) 3. 按照现有目录结构添加您的文件 4. 确保任何新的 `SKILL.md` 具有有效的 YAML frontmatter，包含 `name` 和 `description` 5. 通过运行 `./install.sh` 并验证技能在 Claude Code 中加载来进行测试 6. 打开一个 pull request，清晰描述该技能涵盖的内容及其用途 对于错误报告或功能请求，请在 [GitHub Issues](https://github.com/VersoXBT/claude-initial-setup/issues) 页面上开启一个 issue。 ## 许可证 [MIT](https://github.com/VersoXBT/claude-initial-setup/blob/main/LICENSE)

标签：AI编程, AV绕过, Claude, Cursor, CVE检测, Django, DLL 劫持, Docker, FastAPI, GitHub Copilot, Go, LLM工具, MIT协议, OpenAI Codex, Python, React, Ruby工具, Rust, Starter Kit, Syscalls, TDD, TypeScript, 人工智能, 代码助手, 代码审查, 单元测试, 可视化界面, 大语言模型, 威胁情报, 安全插件, 安全防御评估, 开发工具包, 开发者工具, 提示词工程, 无后门, 日志审计, 服务器监控, 用户模式Hook绕过, 策略决策点, 网络流量审计, 网络调试, 脚手架, 自动化, 请求拦截, 逆向工具