如果你是程序员,你最近在思考如何通过编写更专业的 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 观点等。!