Anthropic 黑客松冠军的 Claude Code 最佳实践,建议程序员全员收藏!

375 阅读6分钟

如果你是程序员,你最近在思考如何通过编写更专业的  commands、agents、rules、skills  来提升自己或团队的 AI Coding 效果。

本文介绍的这个仓库,你一定不能错过!!

图片

作者是 @affaanmustafa,2025 年9月份,他纽约的 Anthropic x Forum Ventures 黑客松中拿下冠军,赢得了 1.5 万美金等值的 Anthropic API 额度!

他近日公开了自己使用 Claude Code  的“最佳实践”。

图片

Github 地址:github.com/affaan-m/ev…

everything-claude-code/
|-- .claude-plugin/   # Plugin and marketplace manifests
|   |-- plugin.json         # Plugin metadata and component paths
|   |-- marketplace.json    # Marketplace catalog for /plugin marketplace add
|
|-- agents/           # Specialized subagents for delegation
|   |-- planner.md           # Feature implementation planning
|   |-- architect.md         # System design decisions
|   |-- tdd-guide.md         # Test-driven development
|   |-- code-reviewer.md     # Quality and security review
|   |-- security-reviewer.md # Vulnerability analysis
|   |-- build-error-resolver.md
|   |-- e2e-runner.md        # Playwright E2E testing
|   |-- refactor-cleaner.md  # Dead code cleanup
|   |-- doc-updater.md       # Documentation sync
|
|-- skills/           # Workflow definitions and domain knowledge
|   |-- coding-standards/           # Language best practices
|   |-- backend-patterns/           # API, database, caching patterns
|   |-- frontend-patterns/          # React, Next.js patterns
|   |-- continuous-learning/        # Auto-extract patterns from sessions (Longform Guide)
|   |-- strategic-compact/          # Manual compaction suggestions (Longform Guide)
|   |-- tdd-workflow/               # TDD methodology
|   |-- security-review/            # Security checklist
|   |-- eval-harness/               # Verification loop evaluation (Longform Guide)
|   |-- verification-loop/          # Continuous verification (Longform Guide)
|
|-- commands/         # Slash commands for quick execution
|   |-- tdd.md              # /tdd - Test-driven development
|   |-- plan.md             # /plan - Implementation planning
|   |-- e2e.md              # /e2e - E2E test generation
|   |-- code-review.md      # /code-review - Quality review
|   |-- build-fix.md        # /build-fix - Fix build errors
|   |-- refactor-clean.md   # /refactor-clean - Dead code removal
|   |-- learn.md            # /learn - Extract patterns mid-session (Longform Guide)
|   |-- checkpoint.md       # /checkpoint - Save verification state (Longform Guide)
|   |-- verify.md           # /verify - Run verification loop (Longform Guide)
|   |-- setup-pm.md         # /setup-pm - Configure package manager (NEW)
|
|-- rules/            # Always-follow guidelines (copy to ~/.claude/rules/)
|   |-- security.md         # Mandatory security checks
|   |-- coding-style.md     # Immutability, file organization
|   |-- testing.md          # TDD, 80% coverage requirement
|   |-- git-workflow.md     # Commit format, PR process
|   |-- agents.md           # When to delegate to subagents
|   |-- performance.md      # Model selection, context management
|
|-- hooks/            # Trigger-based automations
|   |-- hooks.json                # All hooks config (PreToolUse, PostToolUse, Stop, etc.)
|   |-- memory-persistence/       # Session lifecycle hooks (Longform Guide)
|   |-- strategic-compact/        # Compaction suggestions (Longform Guide)
|
|-- scripts/          # Cross-platform Node.js scripts (NEW)
|   |-- lib/                     # Shared utilities
|   |   |-- utils.js             # Cross-platform file/path/system utilities
|   |   |-- package-manager.js   # Package manager detection and selection
|   |-- hooks/                   # Hook implementations
|   |   |-- session-start.js     # Load context on session start
|   |   |-- session-end.js       # Save state on session end
|   |   |-- pre-compact.js       # Pre-compaction state saving
|   |   |-- suggest-compact.js   # Strategic compaction suggestions
|   |   |-- evaluate-session.js  # Extract patterns from sessions
|   |-- setup-package-manager.js # Interactive PM setup
|
|-- tests/            # Test suite (NEW)
|   |-- lib/                     # Library tests
|   |-- hooks/                   # Hook tests
|   |-- run-all.js               # Run all tests
|
|-- contexts/         # Dynamic system prompt injection contexts (Longform Guide)
|   |-- dev.md              # Development mode context
|   |-- review.md           # Code review mode context
|   |-- research.md         # Research/exploration mode context
|
|-- examples/         # Example configurations and sessions
|   |-- CLAUDE.md           # Example project-level config
|   |-- user-CLAUDE.md      # Example user-level config
|
|-- mcp-configs/      # MCP server configurations
|   |-- mcp-servers.json    # GitHub, Supabase, Vercel, Railway, etc.
|
|-- marketplace.json  # Self-hosted marketplace config (for /plugin marketplace add)

核心思想

图片

  • 把 Claude Code 当成长期合伙人,用配置「轻量微调」而不是造复杂架构,重点是减少重复、保护上下文、让并行开发更高效。
  • 控制启用的 MCP / 插件数量,避免工具太多把上下文窗口挤爆,影响性能。

Skills / Commands

图片

  • Skills 就是可复用的工作流提示词,限定在特定场景,比如 /refactor-clean 清理死代码和零散 md,/tdd/e2e/test-coverage 负责测试流程,可以在一次提示里链式组合多个命令。
  • Skills 以 markdown 文件存放在 ~/.claude/skills,Commands 则是以「斜杠命令」方式快速执行,存放在 ~/.claude/commands

Hooks(钩子自动化)

图片

  • Hooks 是基于事件的自动化,触发点包括:工具调用前后、用户发消息时、Claude 回答结束、压缩上下文前,以及权限通知等。
  • 示例:在执行 npm / pytest 等长命令之前提醒你用 tmux;PostToolUse 自动跑 Prettier、TypeScript 检查,或者在会话结束前自动扫描 console.log
  • 推荐用 hookify 插件用自然语言生成 Hook,而不是手写 JSON。

Subagents(子代理)

图片

  • Subagents 是由主 Claude 调度的子进程,负责某一类任务(如 planner、architect、tdd-guide、code-reviewer、security-reviewer 等),可以前台或后台跑,隔离权限、节约主会话上下文。
  • 每个子代理只开放有限的工具 / MCP,使其专注于一小块职责,比如专门跑 e2e、解决 build 错误或做 refactor-clean。

规则与记忆

图片

  • ~/.claude/rules 里放「永远要遵守」的最佳实践,可以是单一 CLAUDE.md,也可以是按安全、代码风格、测试、Git 工作流、agents、性能等拆分的多文件结构。
  • 规则内容包括:禁止代码中 emoji、前端避免紫色、必须先测试再部署、优先模块化、禁止提交 console.log 等,为整个项目定下统一行为准则。

MCP(Model Context Protocol)

图片

  • MCP 是把外部服务「挂接」到 Claude 的协议,本质是对 API 的高层封装,方便对数据库、部署平台、Supabase 等进行查询与操作,比如 Supabase MCP 可直接列表、跑 SQL。
  • Chrome MCP 让 Claude 能自主在浏览器里点击、查看页面,提升探索能力;但 MCP / 工具过多会极大消耗上下文,因此建议配置 20–30 个 MCP,但每个项目只启用 5–10 个、少于约 80 个工具。

插件(Plugins)

图片

  • 插件是「打包好的工具集」,可以包含 skill + MCP + hooks 等,避免手工配置;可以通过 marketplace 地址添加后,在 /plugins 界面安装,比如 mgrep 提供比 ripgrep 更好的搜索。
  • LSP 类插件(如 typescript-lsp、pyright-lsp)在没有 IDE 的情况下提供类型检查和跳转能力,但同样要注意它们对上下文窗口的影响。

效率 Tips

图片

  • 快捷键:Ctrl+U 删整行、! 快速 shell 命令、@ 搜索文件、/ 进入命令、Shift+Enter 多行输入、Tab 查看思考、Esc Esc 中断执行等。
  • 并行:用 /fork 分叉对话处理互不影响的任务,配合 Git worktree 为不同分支开独立 Claude 实例;用 tmux 跑长时间的前后端服务并实时看日志。
  • mgrep 支持本地和 --web 搜索;其它有用命令包括 /rewind 回到之前状态、/statusline 定制状态栏、/checkpoints 文件级撤销点、/compact 手动压缩上下文。

编辑器与工作流图片

  • 作者偏好 Zed:Rust 写的轻量编辑器,和 Claude 深度集成,有 Agent 面板、实时文件追踪、命令面板(CMD+Shift+R)、低资源占用、支持 Vim 模式等。
  • 推荐布局:左边终端跑 Claude Code,右边 Zed;启用自动保存、文件监听以及 Git 集成,用编辑器审查 Claude 的改动后再提交。
  • VSCode / Cursor 也可以,通过终端 + \ide 同步或装官方扩展获得类似效果。

作者自己的 Setup图片

  • 插件:安装了十几个(如 ralph-wiggum、frontend-design、commit-commands、security-guidance、pr-review-toolkit、typescript-lsp、pyright-lsp、hookify、mgrep 等),但通常只同时启用 4–5 个。
  • MCP:配置了 GitHub、Firecrawl、Supabase、memory、sequential-thinking、Vercel、Railway、Cloudflare 系列、ClickHouse、Ableton、Magic 等约 14 个,通过 disabledMcpServers 针对不同项目禁用一部分,从而控制上下文占用。
  • 还有自定义状态栏(展示用户、目录、分支、脏标记、剩余上下文百分比、模型、时间、待办数),清晰的 rules / agents 目录结构以及一组关键 Hooks,使整个开发和协作流程高度自动化。

最后的几点要诀

图片

  • 配置是「轻量微调」,别过度复杂化。
  • 上下文是稀缺资源,要持续关掉不用的 MCP / 插件。
  • 利用并行执行(fork 对话、worktree)、自动化(hooks)、和有边界的 subagents,最大化 Claude Code 的开发效率与可靠性。

需要的朋友可以把仓库下载下来深入研究一下,结合作者提供的配套文章。

欢迎关注我的公众号:悟鸣AI,后续会陆续分享比较有用的 AI 工具和比较好的 AI 经验,比较客观理性的 AI 观点等。!

image.png