[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-luongnv89--claude-howto":3,"tool-luongnv89--claude-howto":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 真正成长为懂上",150037,2,"2026-04-10T23:33:47",[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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[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":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":77,"owner_email":78,"owner_twitter":72,"owner_website":79,"owner_url":80,"languages":81,"stars":94,"forks":95,"last_commit_at":96,"license":97,"difficulty_score":32,"env_os":98,"env_gpu":98,"env_ram":98,"env_deps":99,"category_tags":103,"github_topics":104,"view_count":32,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":108,"updated_at":109,"faqs":110,"releases":141},6540,"luongnv89\u002Fclaude-howto","claude-howto","A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.","claude-howto 是一份专为 Claude Code 打造的可视化实战指南，旨在帮助用户从基础指令快速进阶到构建复杂的智能体工作流。许多用户在安装 Claude Code 后，往往只停留在简单的对话层面，面对官方文档中零散的功能描述，难以掌握如何将斜杠命令、钩子（hooks）、记忆机制及子智能体组合成高效的生产力流程，导致工具 90% 的潜力被闲置。\n\n针对这一痛点，claude-howto 摒弃了枯燥的功能罗列，提供了一条结构清晰的渐进式学习路径。它通过生动的 Mermaid 流程图深入解析技术原理，并附带大量“复制即用”的生产级模板，涵盖自定义命令配置、MCP 服务器搭建及自动化代码审查流水线等场景。用户只需约 11-13 小时，即可系统性地填补知识盲区，甚至可以通过内置的自我评估功能定制专属学习计划。\n\n这份资源特别适合希望提升效率的开发者、技术团队负责人以及渴望深入掌握 AI 编程助手的进阶用户。无论你是想解决具体的工程化难题，还是希望从零开始构建多智能体协作系统，claude-howto 都能让你在一个周末内真正驾驭 Claude Code 的强大能力。","\u003Cpicture>\n  \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"resources\u002Flogos\u002Fclaude-howto-logo-dark.svg\">\n  \u003Cimg alt=\"Claude How To\" src=\"resources\u002Flogos\u002Fclaude-howto-logo.svg\">\n\u003C\u002Fpicture>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftrending\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGitHub-🔥%20%231%20Trending-purple?style=for-the-badge&logo=github\"\u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n[![GitHub Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fluongnv89\u002Fclaude-howto?style=flat&color=gold)](https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fstargazers)\n[![GitHub Forks](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fluongnv89\u002Fclaude-howto?style=flat)](https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fnetwork\u002Fmembers)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](LICENSE)\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-2.3.0-brightgreen)](CHANGELOG.md)\n[![Claude Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude_Code-2.1+-purple)](https:\u002F\u002Fcode.claude.com)\n\n🌐 **Language \u002F Ngôn ngữ \u002F 语言:** [English](README.md) | [Tiếng Việt](vi\u002FREADME.md) | [中文](zh\u002FREADME.md)\n\n# Master Claude Code in a Weekend\n\nGo from typing `claude` to orchestrating agents, hooks, skills, and MCP servers — with visual tutorials, copy-paste templates, and a guided learning path.\n\n**[Get Started in 15 Minutes](#get-started-in-15-minutes)** | **[Find Your Level](#not-sure-where-to-start)** | **[Browse the Feature Catalog](CATALOG.md)**\n\n---\n\n## Table of Contents\n\n- [The Problem](#the-problem)\n- [How Claude How To Fixes This](#how-claude-how-to-fixes-this)\n- [How It Works](#how-it-works)\n- [Not Sure Where to Start?](#not-sure-where-to-start)\n- [Get Started in 15 Minutes](#get-started-in-15-minutes)\n- [What Can You Build With This?](#what-can-you-build-with-this)\n- [FAQ](#faq)\n- [Contributing](#contributing)\n- [License](#license)\n\n---\n\n## The Problem\n\nYou installed Claude Code. You ran a few prompts. Now what?\n\n- **The official docs describe features — but don't show you how to combine them.** You know slash commands exist, but not how to chain them with hooks, memory, and subagents into a workflow that actually saves hours.\n- **There's no clear learning path.** Should you learn MCP before hooks? Skills before subagents? You end up skimming everything and mastering nothing.\n- **Examples are too basic.** A \"hello world\" slash command doesn't help you build a production code review pipeline that uses memory, delegates to specialized agents, and runs security scans automatically.\n\nYou're leaving 90% of Claude Code's power on the table — and you don't know what you don't know.\n\n---\n\n## How Claude How To Fixes This\n\nThis isn't another feature reference. It's a **structured, visual, example-driven guide** that teaches you to use every Claude Code feature with real-world templates you can copy into your project today.\n\n| | Official Docs | This Guide |\n|--|---------------|------------|\n| **Format** | Reference documentation | Visual tutorials with Mermaid diagrams |\n| **Depth** | Feature descriptions | How it works under the hood |\n| **Examples** | Basic snippets | Production-ready templates you use immediately |\n| **Structure** | Feature-organized | Progressive learning path (beginner to advanced) |\n| **Onboarding** | Self-directed | Guided roadmap with time estimates |\n| **Self-Assessment** | None | Interactive quizzes to find your gaps and build a personalized path |\n\n### What you get:\n\n- **10 tutorial modules** covering every Claude Code feature — from slash commands to custom agent teams\n- **Copy-paste configs** — slash commands, CLAUDE.md templates, hook scripts, MCP configs, subagent definitions, and full plugin bundles\n- **Mermaid diagrams** showing how each feature works internally, so you understand *why*, not just *how*\n- **A guided learning path** that takes you from beginner to power user in 11-13 hours\n- **Built-in self-assessment** — run `\u002Fself-assessment` or `\u002Flesson-quiz hooks` directly in Claude Code to identify gaps\n\n**[Start the Learning Path  ->](LEARNING-ROADMAP.md)**\n\n---\n\n## How It Works\n\n### 1. Find your level\n\nTake the [self-assessment quiz](LEARNING-ROADMAP.md#-find-your-level) or run `\u002Fself-assessment` in Claude Code. Get a personalized roadmap based on what you already know.\n\n### 2. Follow the guided path\n\nWork through 10 modules in order — each builds on the last. Copy templates directly into your project as you learn.\n\n### 3. Combine features into workflows\n\nThe real power is in combining features. Learn to wire slash commands + memory + subagents + hooks into automated pipelines that handle code reviews, deployments, and documentation generation.\n\n### 4. Test your understanding\n\nRun `\u002Flesson-quiz [topic]` after each module. The quiz pinpoints what you missed so you can fill gaps fast.\n\n**[Get Started in 15 Minutes](#get-started-in-15-minutes)**\n\n---\n\n## Trusted by 21,800+ Developers\n\n- **21,800+ GitHub stars** from developers who use Claude Code daily\n- **2,585+ forks** — teams adapting this guide for their own workflows\n- **Actively maintained** — synced with every Claude Code release (latest: v2.3.0, April 2026)\n- **Community-driven** — contributions from developers who share their real-world configurations\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fluongnv89_claude-howto_readme_ec0750878247.png)](https:\u002F\u002Fstar-history.com\u002F#luongnv89\u002Fclaude-howto&Date)\n\n---\n\n## Not Sure Where to Start?\n\nTake the self-assessment or pick your level:\n\n| Level | You can... | Start here | Time |\n|-------|-----------|------------|------|\n| **Beginner** | Start Claude Code and chat | [Slash Commands](01-slash-commands\u002F) | ~2.5 hours |\n| **Intermediate** | Use CLAUDE.md and custom commands | [Skills](03-skills\u002F) | ~3.5 hours |\n| **Advanced** | Configure MCP servers and hooks | [Advanced Features](09-advanced-features\u002F) | ~5 hours |\n\n**Full learning path with all 10 modules:**\n\n| Order | Module | Level | Time |\n|-------|--------|-------|------|\n| 1 | [Slash Commands](01-slash-commands\u002F) | Beginner | 30 min |\n| 2 | [Memory](02-memory\u002F) | Beginner+ | 45 min |\n| 3 | [Checkpoints](08-checkpoints\u002F) | Intermediate | 45 min |\n| 4 | [CLI Basics](10-cli\u002F) | Beginner+ | 30 min |\n| 5 | [Skills](03-skills\u002F) | Intermediate | 1 hour |\n| 6 | [Hooks](06-hooks\u002F) | Intermediate | 1 hour |\n| 7 | [MCP](05-mcp\u002F) | Intermediate+ | 1 hour |\n| 8 | [Subagents](04-subagents\u002F) | Intermediate+ | 1.5 hours |\n| 9 | [Advanced Features](09-advanced-features\u002F) | Advanced | 2-3 hours |\n| 10 | [Plugins](07-plugins\u002F) | Advanced | 2 hours |\n\n**[Complete Learning Roadmap ->](LEARNING-ROADMAP.md)**\n\n---\n\n## Get Started in 15 Minutes\n\n```bash\n# 1. Clone the guide\ngit clone https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto.git\ncd claude-howto\n\n# 2. Copy your first slash command\nmkdir -p \u002Fpath\u002Fto\u002Fyour-project\u002F.claude\u002Fcommands\ncp 01-slash-commands\u002Foptimize.md \u002Fpath\u002Fto\u002Fyour-project\u002F.claude\u002Fcommands\u002F\n\n# 3. Try it — in Claude Code, type:\n# \u002Foptimize\n\n# 4. Ready for more? Set up project memory:\ncp 02-memory\u002Fproject-CLAUDE.md \u002Fpath\u002Fto\u002Fyour-project\u002FCLAUDE.md\n\n# 5. Install a skill:\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n```\n\nWant the full setup? Here's the **1-hour essential setup**:\n\n```bash\n# Slash commands (15 min)\ncp 01-slash-commands\u002F*.md .claude\u002Fcommands\u002F\n\n# Project memory (15 min)\ncp 02-memory\u002Fproject-CLAUDE.md .\u002FCLAUDE.md\n\n# Install a skill (15 min)\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n\n# Weekend goal: add hooks, subagents, MCP, and plugins\n# Follow the learning path for guided setup\n```\n\n**[View the Full Installation Reference](#get-started-in-15-minutes)**\n\n---\n\n## What Can You Build With This?\n\n| Use Case | Features You'll Combine |\n|----------|------------------------|\n| **Automated Code Review** | Slash Commands + Subagents + Memory + MCP |\n| **Team Onboarding** | Memory + Slash Commands + Plugins |\n| **CI\u002FCD Automation** | CLI Reference + Hooks + Background Tasks |\n| **Documentation Generation** | Skills + Subagents + Plugins |\n| **Security Audits** | Subagents + Skills + Hooks (read-only mode) |\n| **DevOps Pipelines** | Plugins + MCP + Hooks + Background Tasks |\n| **Complex Refactoring** | Checkpoints + Planning Mode + Hooks |\n\n---\n\n## FAQ\n\n**Is this free?**\nYes. MIT licensed, free forever. Use it in personal projects, at work, in your team — no restrictions beyond including the license notice.\n\n**Is this maintained?**\nActively. The guide is synced with every Claude Code release. Current version: v2.3.0 (April 2026), compatible with Claude Code 2.1+.\n\n**How is this different from the official docs?**\nThe official docs are a feature reference. This guide is a tutorial with diagrams, production-ready templates, and a progressive learning path. They complement each other — start here to learn, reference the docs when you need specifics.\n\n**How long does it take to go through everything?**\n11-13 hours for the full path. But you'll get immediate value in 15 minutes — just copy a slash command template and try it.\n\n**Can I use this with Claude Sonnet \u002F Haiku \u002F Opus?**\nYes. All templates work with Claude Sonnet 4.6, Claude Opus 4.6, and Claude Haiku 4.5.\n\n**Can I contribute?**\nAbsolutely. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. We welcome new examples, bug fixes, documentation improvements, and community templates.\n\n**Can I read this offline?**\nYes. Run `uv run scripts\u002Fbuild_epub.py` to generate an EPUB ebook with all content and rendered diagrams.\n\n---\n\n## Start Mastering Claude Code Today\n\nYou already have Claude Code installed. The only thing between you and 10x productivity is knowing how to use it. This guide gives you the structured path, the visual explanations, and the copy-paste templates to get there.\n\nMIT licensed. Free forever. Clone it, fork it, make it yours.\n\n**[Start the Learning Path ->](LEARNING-ROADMAP.md)** | **[Browse the Feature Catalog](CATALOG.md)** | **[Get Started in 15 Minutes](#get-started-in-15-minutes)**\n\n---\n\n\u003Cdetails>\n\u003Csummary>Quick Navigation — All Features\u003C\u002Fsummary>\n\n| Feature | Description | Folder |\n|---------|-------------|--------|\n| **Feature Catalog** | Complete reference with installation commands | [CATALOG.md](CATALOG.md) |\n| **Slash Commands** | User-invoked shortcuts | [01-slash-commands\u002F](01-slash-commands\u002F) |\n| **Memory** | Persistent context | [02-memory\u002F](02-memory\u002F) |\n| **Skills** | Reusable capabilities | [03-skills\u002F](03-skills\u002F) |\n| **Subagents** | Specialized AI assistants | [04-subagents\u002F](04-subagents\u002F) |\n| **MCP Protocol** | External tool access | [05-mcp\u002F](05-mcp\u002F) |\n| **Hooks** | Event-driven automation | [06-hooks\u002F](06-hooks\u002F) |\n| **Plugins** | Bundled features | [07-plugins\u002F](07-plugins\u002F) |\n| **Checkpoints** | Session snapshots & rewind | [08-checkpoints\u002F](08-checkpoints\u002F) |\n| **Advanced Features** | Planning, thinking, background tasks | [09-advanced-features\u002F](09-advanced-features\u002F) |\n| **CLI Reference** | Commands, flags, and options | [10-cli\u002F](10-cli\u002F) |\n| **Blog Posts** | Real-world usage examples | [Blog Posts](https:\u002F\u002Fmedium.com\u002F@luongnv89) |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Feature Comparison\u003C\u002Fsummary>\n\n| Feature | Invocation | Persistence | Best For |\n|---------|-----------|------------|----------|\n| **Slash Commands** | Manual (`\u002Fcmd`) | Session only | Quick shortcuts |\n| **Memory** | Auto-loaded | Cross-session | Long-term learning |\n| **Skills** | Auto-invoked | Filesystem | Automated workflows |\n| **Subagents** | Auto-delegated | Isolated context | Task distribution |\n| **MCP Protocol** | Auto-queried | Real-time | Live data access |\n| **Hooks** | Event-triggered | Configured | Automation & validation |\n| **Plugins** | One command | All features | Complete solutions |\n| **Checkpoints** | Manual\u002FAuto | Session-based | Safe experimentation |\n| **Planning Mode** | Manual\u002FAuto | Plan phase | Complex implementations |\n| **Background Tasks** | Manual | Task duration | Long-running operations |\n| **CLI Reference** | Terminal commands | Session\u002FScript | Automation & scripting |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Installation Quick Reference\u003C\u002Fsummary>\n\n```bash\n# Slash Commands\ncp 01-slash-commands\u002F*.md .claude\u002Fcommands\u002F\n\n# Memory\ncp 02-memory\u002Fproject-CLAUDE.md .\u002FCLAUDE.md\n\n# Skills\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n\n# Subagents\ncp 04-subagents\u002F*.md .claude\u002Fagents\u002F\n\n# MCP\nexport GITHUB_TOKEN=\"token\"\nclaude mcp add github -- npx -y @modelcontextprotocol\u002Fserver-github\n\n# Hooks\nmkdir -p ~\u002F.claude\u002Fhooks\ncp 06-hooks\u002F*.sh ~\u002F.claude\u002Fhooks\u002F\nchmod +x ~\u002F.claude\u002Fhooks\u002F*.sh\n\n# Plugins\n\u002Fplugin install pr-review\n\n# Checkpoints (auto-enabled, configure in settings)\n# See 08-checkpoints\u002FREADME.md\n\n# Advanced Features (configure in settings)\n# See 09-advanced-features\u002Fconfig-examples.json\n\n# CLI Reference (no installation needed)\n# See 10-cli\u002FREADME.md for usage examples\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>01. Slash Commands\u003C\u002Fsummary>\n\n**Location**: [01-slash-commands\u002F](01-slash-commands\u002F)\n\n**What**: User-invoked shortcuts stored as Markdown files\n\n**Examples**:\n- `optimize.md` - Code optimization analysis\n- `pr.md` - Pull request preparation\n- `generate-api-docs.md` - API documentation generator\n\n**Installation**:\n```bash\ncp 01-slash-commands\u002F*.md \u002Fpath\u002Fto\u002Fproject\u002F.claude\u002Fcommands\u002F\n```\n\n**Usage**:\n```\n\u002Foptimize\n\u002Fpr\n\u002Fgenerate-api-docs\n```\n\n**Learn More**: [Discovering Claude Code Slash Commands](https:\u002F\u002Fmedium.com\u002F@luongnv89\u002Fdiscovering-claude-code-slash-commands-cdc17f0dfb29)\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>02. Memory\u003C\u002Fsummary>\n\n**Location**: [02-memory\u002F](02-memory\u002F)\n\n**What**: Persistent context across sessions\n\n**Examples**:\n- `project-CLAUDE.md` - Team-wide project standards\n- `directory-api-CLAUDE.md` - Directory-specific rules\n- `personal-CLAUDE.md` - Personal preferences\n\n**Installation**:\n```bash\n# Project memory\ncp 02-memory\u002Fproject-CLAUDE.md \u002Fpath\u002Fto\u002Fproject\u002FCLAUDE.md\n\n# Directory memory\ncp 02-memory\u002Fdirectory-api-CLAUDE.md \u002Fpath\u002Fto\u002Fproject\u002Fsrc\u002Fapi\u002FCLAUDE.md\n\n# Personal memory\ncp 02-memory\u002Fpersonal-CLAUDE.md ~\u002F.claude\u002FCLAUDE.md\n```\n\n**Usage**: Automatically loaded by Claude\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>03. Skills\u003C\u002Fsummary>\n\n**Location**: [03-skills\u002F](03-skills\u002F)\n\n**What**: Reusable, auto-invoked capabilities with instructions and scripts\n\n**Examples**:\n- `code-review\u002F` - Comprehensive code review with scripts\n- `brand-voice\u002F` - Brand voice consistency checker\n- `doc-generator\u002F` - API documentation generator\n\n**Installation**:\n```bash\n# Personal skills\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n\n# Project skills\ncp -r 03-skills\u002Fcode-review \u002Fpath\u002Fto\u002Fproject\u002F.claude\u002Fskills\u002F\n```\n\n**Usage**: Automatically invoked when relevant\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>04. Subagents\u003C\u002Fsummary>\n\n**Location**: [04-subagents\u002F](04-subagents\u002F)\n\n**What**: Specialized AI assistants with isolated contexts and custom prompts\n\n**Examples**:\n- `code-reviewer.md` - Comprehensive code quality analysis\n- `test-engineer.md` - Test strategy and coverage\n- `documentation-writer.md` - Technical documentation\n- `secure-reviewer.md` - Security-focused review (read-only)\n- `implementation-agent.md` - Full feature implementation\n\n**Installation**:\n```bash\ncp 04-subagents\u002F*.md \u002Fpath\u002Fto\u002Fproject\u002F.claude\u002Fagents\u002F\n```\n\n**Usage**: Automatically delegated by main agent\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>05. MCP Protocol\u003C\u002Fsummary>\n\n**Location**: [05-mcp\u002F](05-mcp\u002F)\n\n**What**: Model Context Protocol for accessing external tools and APIs\n\n**Examples**:\n- `github-mcp.json` - GitHub integration\n- `database-mcp.json` - Database queries\n- `filesystem-mcp.json` - File operations\n- `multi-mcp.json` - Multiple MCP servers\n\n**Installation**:\n```bash\n# Set environment variables\nexport GITHUB_TOKEN=\"your_token\"\nexport DATABASE_URL=\"postgresql:\u002F\u002F...\"\n\n# Add MCP server via CLI\nclaude mcp add github -- npx -y @modelcontextprotocol\u002Fserver-github\n\n# Or add to project .mcp.json manually (see 05-mcp\u002F for examples)\n```\n\n**Usage**: MCP tools are automatically available to Claude once configured\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>06. Hooks\u003C\u002Fsummary>\n\n**Location**: [06-hooks\u002F](06-hooks\u002F)\n\n**What**: Event-driven shell commands that execute automatically in response to Claude Code events\n\n**Examples**:\n- `format-code.sh` - Auto-format code before writing\n- `pre-commit.sh` - Run tests before commits\n- `security-scan.sh` - Scan for security issues\n- `log-bash.sh` - Log all bash commands\n- `validate-prompt.sh` - Validate user prompts\n- `notify-team.sh` - Send notifications on events\n\n**Installation**:\n```bash\nmkdir -p ~\u002F.claude\u002Fhooks\ncp 06-hooks\u002F*.sh ~\u002F.claude\u002Fhooks\u002F\nchmod +x ~\u002F.claude\u002Fhooks\u002F*.sh\n```\n\nConfigure hooks in `~\u002F.claude\u002Fsettings.json`:\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [{\n      \"matcher\": \"Write\",\n      \"hooks\": [\"~\u002F.claude\u002Fhooks\u002Fformat-code.sh\"]\n    }],\n    \"PostToolUse\": [{\n      \"matcher\": \"Write\",\n      \"hooks\": [\"~\u002F.claude\u002Fhooks\u002Fsecurity-scan.sh\"]\n    }]\n  }\n}\n```\n\n**Usage**: Hooks execute automatically on events\n\n**Hook Types** (4 types, 25 events):\n- **Tool Hooks**: `PreToolUse`, `PostToolUse`, `PostToolUseFailure`, `PermissionRequest`\n- **Session Hooks**: `SessionStart`, `SessionEnd`, `Stop`, `StopFailure`, `SubagentStart`, `SubagentStop`\n- **Task Hooks**: `UserPromptSubmit`, `TaskCompleted`, `TaskCreated`, `TeammateIdle`\n- **Lifecycle Hooks**: `ConfigChange`, `CwdChanged`, `FileChanged`, `PreCompact`, `PostCompact`, `WorktreeCreate`, `WorktreeRemove`, `Notification`, `InstructionsLoaded`, `Elicitation`, `ElicitationResult`\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>07. Plugins\u003C\u002Fsummary>\n\n**Location**: [07-plugins\u002F](07-plugins\u002F)\n\n**What**: Bundled collections of commands, agents, MCP, and hooks\n\n**Examples**:\n- `pr-review\u002F` - Complete PR review workflow\n- `devops-automation\u002F` - Deployment and monitoring\n- `documentation\u002F` - Documentation generation\n\n**Installation**:\n```bash\n\u002Fplugin install pr-review\n\u002Fplugin install devops-automation\n\u002Fplugin install documentation\n```\n\n**Usage**: Use bundled slash commands and features\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>08. Checkpoints and Rewind\u003C\u002Fsummary>\n\n**Location**: [08-checkpoints\u002F](08-checkpoints\u002F)\n\n**What**: Save conversation state and rewind to previous points to explore different approaches\n\n**Key Concepts**:\n- **Checkpoint**: Snapshot of conversation state\n- **Rewind**: Return to previous checkpoint\n- **Branch Point**: Explore multiple approaches from same checkpoint\n\n**Usage**:\n```\n# Checkpoints are created automatically with every user prompt\n# To rewind, press Esc twice or use:\n\u002Frewind\n\n# Then choose from five options:\n# 1. Restore code and conversation\n# 2. Restore conversation\n# 3. Restore code\n# 4. Summarize from here\n# 5. Never mind\n```\n\n**Use Cases**:\n- Try different implementation approaches\n- Recover from mistakes\n- Safe experimentation\n- Compare alternative solutions\n- A\u002FB testing different designs\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>09. Advanced Features\u003C\u002Fsummary>\n\n**Location**: [09-advanced-features\u002F](09-advanced-features\u002F)\n\n**What**: Advanced capabilities for complex workflows and automation\n\n**Includes**:\n- **Planning Mode** — Create detailed implementation plans before coding\n- **Extended Thinking** — Deep reasoning for complex problems (toggle with `Alt+T` \u002F `Option+T`)\n- **Background Tasks** — Run long operations without blocking\n- **Permission Modes** — `default`, `acceptEdits`, `plan`, `dontAsk`, `bypassPermissions`\n- **Headless Mode** — Run Claude Code in CI\u002FCD: `claude -p \"Run tests and generate report\"`\n- **Session Management** — `\u002Fresume`, `\u002Frename`, `\u002Ffork`, `claude -c`, `claude -r`\n- **Configuration** — Customize behavior in `~\u002F.claude\u002Fsettings.json`\n\nSee [config-examples.json](09-advanced-features\u002Fconfig-examples.json) for complete configurations.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>10. CLI Reference\u003C\u002Fsummary>\n\n**Location**: [10-cli\u002F](10-cli\u002F)\n\n**What**: Complete command-line interface reference for Claude Code\n\n**Quick Examples**:\n```bash\n# Interactive mode\nclaude \"explain this project\"\n\n# Print mode (non-interactive)\nclaude -p \"review this code\"\n\n# Process file content\ncat error.log | claude -p \"explain this error\"\n\n# JSON output for scripts\nclaude -p --output-format json \"list functions\"\n\n# Resume session\nclaude -r \"feature-auth\" \"continue implementation\"\n```\n\n**Use Cases**: CI\u002FCD pipeline integration, script automation, batch processing, multi-session workflows, custom agent configurations\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Example Workflows\u003C\u002Fsummary>\n\n### Complete Code Review Workflow\n\n```markdown\n# Uses: Slash Commands + Subagents + Memory + MCP\n\nUser: \u002Freview-pr\n\nClaude:\n1. Loads project memory (coding standards)\n2. Fetches PR via GitHub MCP\n3. Delegates to code-reviewer subagent\n4. Delegates to test-engineer subagent\n5. Synthesizes findings\n6. Provides comprehensive review\n```\n\n### Automated Documentation\n\n```markdown\n# Uses: Skills + Subagents + Memory\n\nUser: \"Generate API documentation for the auth module\"\n\nClaude:\n1. Loads project memory (doc standards)\n2. Detects doc generation request\n3. Auto-invokes doc-generator skill\n4. Delegates to api-documenter subagent\n5. Creates comprehensive docs with examples\n```\n\n### DevOps Deployment\n\n```markdown\n# Uses: Plugins + MCP + Hooks\n\nUser: \u002Fdeploy production\n\nClaude:\n1. Runs pre-deploy hook (validates environment)\n2. Delegates to deployment-specialist subagent\n3. Executes deployment via Kubernetes MCP\n4. Monitors progress\n5. Runs post-deploy hook (health checks)\n6. Reports status\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Directory Structure\u003C\u002Fsummary>\n\n```\n├── 01-slash-commands\u002F\n│   ├── optimize.md\n│   ├── pr.md\n│   ├── generate-api-docs.md\n│   └── README.md\n├── 02-memory\u002F\n│   ├── project-CLAUDE.md\n│   ├── directory-api-CLAUDE.md\n│   ├── personal-CLAUDE.md\n│   └── README.md\n├── 03-skills\u002F\n│   ├── code-review\u002F\n│   │   ├── SKILL.md\n│   │   ├── scripts\u002F\n│   │   └── templates\u002F\n│   ├── brand-voice\u002F\n│   │   ├── SKILL.md\n│   │   └── templates\u002F\n│   ├── doc-generator\u002F\n│   │   ├── SKILL.md\n│   │   └── generate-docs.py\n│   └── README.md\n├── 04-subagents\u002F\n│   ├── code-reviewer.md\n│   ├── test-engineer.md\n│   ├── documentation-writer.md\n│   ├── secure-reviewer.md\n│   ├── implementation-agent.md\n│   └── README.md\n├── 05-mcp\u002F\n│   ├── github-mcp.json\n│   ├── database-mcp.json\n│   ├── filesystem-mcp.json\n│   ├── multi-mcp.json\n│   └── README.md\n├── 06-hooks\u002F\n│   ├── format-code.sh\n│   ├── pre-commit.sh\n│   ├── security-scan.sh\n│   ├── log-bash.sh\n│   ├── validate-prompt.sh\n│   ├── notify-team.sh\n│   └── README.md\n├── 07-plugins\u002F\n│   ├── pr-review\u002F\n│   ├── devops-automation\u002F\n│   ├── documentation\u002F\n│   └── README.md\n├── 08-checkpoints\u002F\n│   ├── checkpoint-examples.md\n│   └── README.md\n├── 09-advanced-features\u002F\n│   ├── config-examples.json\n│   ├── planning-mode-examples.md\n│   └── README.md\n├── 10-cli\u002F\n│   └── README.md\n└── README.md (this file)\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Best Practices\u003C\u002Fsummary>\n\n### Do's\n- Start simple with slash commands\n- Add features incrementally\n- Use memory for team standards\n- Test configurations locally first\n- Document custom implementations\n- Version control project configurations\n- Share plugins with team\n\n### Don'ts\n- Don't create redundant features\n- Don't hardcode credentials\n- Don't skip documentation\n- Don't over-complicate simple tasks\n- Don't ignore security best practices\n- Don't commit sensitive data\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Troubleshooting\u003C\u002Fsummary>\n\n### Feature Not Loading\n1. Check file location and naming\n2. Verify YAML frontmatter syntax\n3. Check file permissions\n4. Review Claude Code version compatibility\n\n### MCP Connection Failed\n1. Verify environment variables\n2. Check MCP server installation\n3. Test credentials\n4. Review network connectivity\n\n### Subagent Not Delegating\n1. Check tool permissions\n2. Verify agent description clarity\n3. Review task complexity\n4. Test agent independently\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Testing\u003C\u002Fsummary>\n\nThis project includes comprehensive automated testing:\n\n- **Unit Tests**: Python tests using pytest (Python 3.10, 3.11, 3.12)\n- **Code Quality**: Linting and formatting with Ruff\n- **Security**: Vulnerability scanning with Bandit\n- **Type Checking**: Static type analysis with mypy\n- **Build Verification**: EPUB generation testing\n- **Coverage Tracking**: Codecov integration\n\n```bash\n# Install development dependencies\nuv pip install -r requirements-dev.txt\n\n# Run all unit tests\npytest scripts\u002Ftests\u002F -v\n\n# Run tests with coverage report\npytest scripts\u002Ftests\u002F -v --cov=scripts --cov-report=html\n\n# Run code quality checks\nruff check scripts\u002F\nruff format --check scripts\u002F\n\n# Run security scan\nbandit -c pyproject.toml -r scripts\u002F --exclude scripts\u002Ftests\u002F\n\n# Run type checking\nmypy scripts\u002F --ignore-missing-imports\n```\n\nTests run automatically on every push to `main`\u002F`develop` and every PR to `main`. See [TESTING.md](.github\u002FTESTING.md) for detailed information.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>EPUB Generation\u003C\u002Fsummary>\n\nWant to read this guide offline? Generate an EPUB ebook:\n\n```bash\nuv run scripts\u002Fbuild_epub.py\n```\n\nThis creates `claude-howto-guide.epub` with all content, including rendered Mermaid diagrams.\n\nSee [scripts\u002FREADME.md](scripts\u002FREADME.md) for more options.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Contributing\u003C\u002Fsummary>\n\nFound an issue or want to contribute an example? We'd love your help!\n\n**Please read [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines on:**\n- Types of contributions (examples, docs, features, bugs, feedback)\n- How to set up your development environment\n- Directory structure and how to add content\n- Writing guidelines and best practices\n- Commit and PR process\n\n**Our Community Standards:**\n- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) - How we treat each other\n- [SECURITY.md](SECURITY.md) - Security policy and vulnerability reporting\n\n### Reporting Security Issues\n\nIf you discover a security vulnerability, please report it responsibly:\n\n1. **Use GitHub Private Vulnerability Reporting**: https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fsecurity\u002Fadvisories\n2. **Or read** [.github\u002FSECURITY_REPORTING.md](.github\u002FSECURITY_REPORTING.md) for detailed instructions\n3. **Do NOT** open a public issue for security vulnerabilities\n\nQuick start:\n1. Fork and clone the repository\n2. Create a descriptive branch (`add\u002Ffeature-name`, `fix\u002Fbug`, `docs\u002Fimprovement`)\n3. Make your changes following the guidelines\n4. Submit a pull request with a clear description\n\n**Need help?** Open an issue or discussion, and we'll guide you through the process.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Additional Resources\u003C\u002Fsummary>\n\n- [Claude Code Documentation](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Foverview)\n- [MCP Protocol Specification](https:\u002F\u002Fmodelcontextprotocol.io)\n- [Skills Repository](https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fskills) - Collection of ready-to-use skills\n- [Anthropic Cookbook](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fanthropic-cookbook)\n- [Boris Cherny's Claude Code Workflow](https:\u002F\u002Fx.com\u002Fbcherny\u002Fstatus\u002F2007179832300581177) - The creator of Claude Code shares his systematized workflow: parallel agents, shared CLAUDE.md, Plan mode, slash commands, subagents, and verification hooks for autonomous long-running sessions.\n\n\u003C\u002Fdetails>\n\n---\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on how to get started.\n\n---\n\n## License\n\nMIT License - see [LICENSE](LICENSE). Free to use, modify, and distribute. The only requirement is including the license notice.\n\n---\n\n**Last Updated**: April 9, 2026\n**Claude Code Version**: 2.1.97\n**Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5\n","\u003Cpicture>\n  \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"resources\u002Flogos\u002Fclaude-howto-logo-dark.svg\">\n  \u003Cimg alt=\"Claude How To\" src=\"resources\u002Flogos\u002Fclaude-howto-logo.svg\">\n\u003C\u002Fpicture>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftrending\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGitHub-🔥%20%231%20Trending-purple?style=for-the-badge&logo=github\"\u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n[![GitHub Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fluongnv89\u002Fclaude-howto?style=flat&color=gold)](https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fstargazers)\n[![GitHub Forks](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fluongnv89\u002Fclaude-howto?style=flat)](https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fnetwork\u002Fmembers)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](LICENSE)\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-2.3.0-brightgreen)](CHANGELOG.md)\n[![Claude Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude_Code-2.1+-purple)](https:\u002F\u002Fcode.claude.com)\n\n🌐 **语言 \u002F Ngôn ngữ \u002F Language:** [English](README.md) | [Tiếng Việt](vi\u002FREADME.md) | [中文](zh\u002FREADME.md)\n\n# 在一个周末掌握 Claude Code\n\n从只会输入 `claude` 到能够编排代理、钩子、技能和 MCP 服务器——通过可视化教程、可复制粘贴的模板以及循序渐进的学习路径。\n\n**[15 分钟入门](#get-started-in-15-minutes)** | **[找到你的水平](#not-sure-where-to-start)** | **[浏览功能目录](CATALOG.md)**\n\n---\n\n## 目录\n\n- [问题](#the-problem)\n- [Claude How To 如何解决这个问题](#how-claude-how-to-fixes-this)\n- [工作原理](#how-it-works)\n- [不确定从哪里开始？](#not-sure-where-to-start)\n- [15 分钟入门](#get-started-in-15-minutes)\n- [你能用它构建什么？](#what-can-you-build-with-this)\n- [常见问题解答](#faq)\n- [贡献](#contributing)\n- [许可证](#license)\n\n---\n\n## 问题\n\n你已经安装了 Claude Code，运行了几条指令。接下来呢？\n\n- **官方文档只描述功能，却没有教你如何将它们组合起来。** 你知道有斜杠命令，却不知道如何将其与钩子、记忆模块和子代理串联成一个真正能节省时间的工作流。\n- **没有清晰的学习路径。** 应该先学 MCP 还是钩子？先学技能还是子代理？结果就是什么都浅尝辄止，什么都没精通。\n- **示例太简单了。** 一个“hello world”的斜杠命令并不能帮助你构建一个生产级别的代码审查流水线，这个流水线需要使用记忆模块、委派给专业代理，并自动进行安全扫描。\n\n你把 Claude Code 90% 的强大功能都浪费掉了——而你自己甚至都不知道这些功能的存在。\n\n---\n\n## Claude How To 如何解决这个问题\n\n这并不是另一份功能参考手册。它是一份**结构化、可视化、以示例为导向的指南**，教你使用 Claude Code 的每一个功能，并提供可以直接复制到你项目中的真实世界模板。\n\n| | 官方文档 | 本指南 |\n|--|---------------|------------|\n| **形式** | 参考文档 | 带有 Mermaid 图表的可视化教程 |\n| **深度** | 功能描述 | 内部工作原理 |\n| **示例** | 基础片段 | 可直接用于生产的模板 |\n| **结构** | 按功能组织 | 循序渐进的学习路径（从初级到高级） |\n| **入门方式** | 自主学习 | 带有时间预估的引导式路线图 |\n| **自我评估** | 无 | 交互式测验，帮你找出知识漏洞并制定个性化学习路径 |\n\n### 你将获得：\n\n- **10 个教程模块**，涵盖 Claude Code 的所有功能——从斜杠命令到自定义代理团队\n- **可直接复制粘贴的配置文件**——包括斜杠命令、CLAUDE.md 模板、钩子脚本、MCP 配置、子代理定义以及完整的插件包\n- **Mermaid 流程图**，展示每个功能的内部运作方式，让你不仅知道“怎么做”，更明白“为什么这么做”\n- **一条引导式学习路径**，带你从初学者成长为高级用户，耗时 11-13 小时\n- **内置的自我评估工具**——在 Claude Code 中直接运行 `\u002Fself-assessment` 或 `\u002Flesson-quiz hooks`，即可发现自己的不足之处\n\n**[开始学习路径 ->](LEARNING-ROADMAP.md)**\n\n---\n\n## 工作原理\n\n### 1. 找到你的水平\n\n参加[自我评估测验](LEARNING-ROADMAP.md#-find-your-level)，或者在 Claude Code 中运行 `\u002Fself-assessment`。根据你已有的知识，系统会为你生成一份个性化的学习路线图。\n\n### 2. 按照引导路径学习\n\n按顺序完成 10 个模块——每个模块都是前一个模块的延伸。在学习过程中，你可以直接将模板复制到你的项目中。\n\n### 3. 将功能组合成工作流\n\n真正的强大之处在于功能的组合。学会将斜杠命令、记忆模块、子代理和钩子串联起来，形成自动化的工作流，用于处理代码审查、部署和文档生成。\n\n### 4. 测试你的理解\n\n每完成一个模块后，运行 `\u002Flesson-quiz [topic]`。这个测验会指出你遗漏的地方，以便你快速弥补不足。\n\n**[15 分钟入门](#get-started-in-15-minutes)**\n\n---\n\n## 受到 21,800 多位开发者的信赖\n\n- **21,800 多颗 GitHub 星标**，来自每天使用 Claude Code 的开发者\n- **2,585 多次分叉**——各团队根据自身需求调整本指南以适应不同的工作流程\n- **持续维护中**——与每一次 Claude Code 的发布同步更新（最新版本：v2.3.0，2026 年 4 月）\n- **社区驱动**——来自分享自己实际配置的开发者们的贡献\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fluongnv89_claude-howto_readme_ec0750878247.png)](https:\u002F\u002Fstar-history.com\u002F#luongnv89\u002Fclaude-howto&Date)\n\n---\n\n## 不确定从哪里开始？\n\n参加自我评估测试，或选择适合你的水平：\n\n| 等级 | 你可以... | 从这里开始 | 时间 |\n|-------|-----------|------------|------|\n| **初级** | 启动 Claude Code 并聊天 | [斜杠命令](01-slash-commands\u002F) | ~2.5 小时 |\n| **中级** | 使用 CLAUDE.md 和自定义命令 | [技能](03-skills\u002F) | ~3.5 小时 |\n| **高级** | 配置 MCP 服务器和钩子 | [高级功能](09-advanced-features\u002F) | ~5 小时 |\n\n**包含全部 10 个模块的学习路径：**\n\n| 顺序 | 模块 | 等级 | 时间 |\n|-------|--------|-------|------|\n| 1 | [斜杠命令](01-slash-commands\u002F) | 初级 | 30 分钟 |\n| 2 | [记忆模块](02-memory\u002F) | 初级+ | 45 分钟 |\n| 3 | [检查点](08-checkpoints\u002F) | 中级 | 45 分钟 |\n| 4 | [CLI 基础](10-cli\u002F) | 初级+ | 30 分钟 |\n| 5 | [技能](03-skills\u002F) | 中级 | 1 小时 |\n| 6 | [钩子](06-hooks\u002F) | 中级 | 1 小时 |\n| 7 | [MCP](05-mcp\u002F) | 中级+ | 1 小时 |\n| 8 | [子代理](04-subagents\u002F) | 中级+ | 1.5 小时 |\n| 9 | [高级功能](09-advanced-features\u002F) | 高级 | 2-3 小时 |\n| 10 | [插件](07-plugins\u002F) | 高级 | 2 小时 |\n\n**[完整学习路线图 ->](LEARNING-ROADMAP.md)**\n\n---\n\n## 15 分钟入门\n\n```bash\n# 1. 克隆本指南\ngit clone https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto.git\ncd claude-howto\n\n# 2. 复制你的第一个斜杠命令\nmkdir -p \u002Fpath\u002Fto\u002Fyour-project\u002F.claude\u002Fcommands\ncp 01-slash-commands\u002Foptimize.md \u002Fpath\u002Fto\u002Fyour-project\u002F.claude\u002Fcommands\u002F\n\n# 3. 试试看——在 Claude Code 中输入：\n# \u002Foptimize\n\n# 4. 准备好继续了吗？设置项目记忆模块：\ncp 02-memory\u002Fproject-CLAUDE.md \u002Fpath\u002Fto\u002Fyour-project\u002FCLAUDE.md\n\n# 5. 安装一个技能：\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n```\n\n想要完整的设置吗？这里是**1小时必备设置**：\n\n```bash\n# 斜杠命令（15分钟）\ncp 01-slash-commands\u002F*.md .claude\u002Fcommands\u002F\n\n# 项目记忆（15分钟）\ncp 02-memory\u002Fproject-CLAUDE.md .\u002FCLAUDE.md\n\n# 安装一个技能（15分钟）\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n\n# 周末目标：添加钩子、子代理、MCP 和插件\n# 按照学习路径进行引导式设置\n```\n\n**[查看完整安装参考](#get-started-in-15-minutes)**\n\n---\n\n## 你可以用这个构建什么？\n\n| 使用场景 | 将结合的功能 |\n|----------|--------------|\n| **自动化代码审查** | 斜杠命令 + 子代理 + 记忆 + MCP |\n| **团队入职培训** | 记忆 + 斜杠命令 + 插件 |\n| **CI\u002FCD 自动化** | CLI 参考 + 钩子 + 后台任务 |\n| **文档生成** | 技能 + 子代理 + 插件 |\n| **安全审计** | 子代理 + 技能 + 钩子（只读模式） |\n| **DevOps 流水线** | 插件 + MCP + 钩子 + 后台任务 |\n| **复杂重构** | 检查点 + 规划模式 + 钩子 |\n\n---\n\n## 常见问题解答\n\n**这是免费的吗？**\n是的。采用 MIT 许可证，永久免费。你可以在个人项目、工作中或团队中使用它——除了需要包含许可证声明外，没有任何限制。\n\n**这个项目会持续维护吗？**\n会的。本指南会与每次 Claude Code 的发布同步更新。当前版本：v2.3.0（2026年4月），兼容 Claude Code 2.1 及以上版本。\n\n**这与官方文档有什么不同？**\n官方文档主要是功能参考。而本指南则是一份带有图表、生产就绪模板和循序渐进学习路径的教程。两者相辅相成——从这里开始学习，遇到具体细节时再查阅官方文档。\n\n**完成所有内容需要多长时间？**\n完整的学习路径大约需要 11 到 13 小时。但你只需 15 分钟就能立即获得价值——复制一个斜杠命令模板并试一试即可。\n\n**我可以用 Claude Sonnet \u002F Haiku \u002F Opus 吗？**\n可以。所有模板都适用于 Claude Sonnet 4.6、Claude Opus 4.6 和 Claude Haiku 4.5。\n\n**我可以贡献代码吗？**\n当然可以。请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取相关指南。我们欢迎新的示例、错误修复、文档改进以及社区模板。\n\n**我可以离线阅读吗？**\n可以。运行 `uv run scripts\u002Fbuild_epub.py` 即可生成包含所有内容和渲染图表的 EPUB 电子书。\n\n---\n\n## 今天就开始掌握 Claude Code 吧\n\n你现在已经安装了 Claude Code。距离实现 10 倍生产力的唯一障碍，就是知道如何使用它。本指南为你提供了结构化的学习路径、直观的说明以及可以直接复制粘贴的模板，助你快速上手。\n\n采用 MIT 许可证，永久免费。克隆它、分叉它，让它成为你的工具。\n\n**[开始学习路径 ->](LEARNING-ROADMAP.md)** | **[浏览功能目录](CATALOG.md)** | **[15 分钟快速入门](#get-started-in-15-minutes)**\n\n---\n\n\u003Cdetails>\n\u003Csummary>快速导航 — 所有功能\u003C\u002Fsummary>\n\n| 功能 | 描述 | 文件夹 |\n|-------|------|-------|\n| **功能目录** | 包含安装命令的完整参考 | [CATALOG.md](CATALOG.md) |\n| **斜杠命令** | 用户调用的快捷方式 | [01-slash-commands\u002F](01-slash-commands\u002F) |\n| **记忆** | 持久上下文 | [02-memory\u002F](02-memory\u002F) |\n| **技能** | 可重用的能力 | [03-skills\u002F](03-skills\u002F) |\n| **子代理** | 专业化的 AI 助理 | [04-subagents\u002F](04-subagents\u002F) |\n| **MCP 协议** | 外部工具访问 | [05-mcp\u002F](05-mcp\u002F) |\n| **钩子** | 事件驱动的自动化 | [06-hooks\u002F](06-hooks\u002F) |\n| **插件** | 捆绑功能 | [07-plugins\u002F](07-plugins\u002F) |\n| **检查点** | 会话快照与回滚 | [08-checkpoints\u002F](08-checkpoints\u002F) |\n| **高级功能** | 规划、思考、后台任务 | [09-advanced-features\u002F](09-advanced-features\u002F) |\n| **CLI 参考** | 命令、标志和选项 | [10-cli\u002F](10-cli\u002F) |\n| **博客文章** | 实际使用案例 | [博客文章](https:\u002F\u002Fmedium.com\u002F@luongnv89) |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>功能对比\u003C\u002Fsummary>\n\n| 功能 | 调用方式 | 是否持久化 | 最适合用途 |\n|-------|---------|-----------|------------|\n| **斜杠命令** | 手动（`\u002Fcmd`） | 仅限当前会话 | 快速快捷方式 |\n| **记忆** | 自动加载 | 跨会话 | 长期学习 |\n| **技能** | 自动调用 | 文件系统 | 自动化工作流 |\n| **子代理** | 自动委派 | 隔离上下文 | 任务分配 |\n| **MCP 协议** | 自动查询 | 实时 | 实时数据访问 |\n| **钩子** | 事件触发 | 可配置 | 自动化与验证 |\n| **插件** | 一条命令 | 全功能 | 完整解决方案 |\n| **检查点** | 手动\u002F自动 | 基于会话 | 安全实验 |\n| **规划模式** | 手动\u002F自动 | 规划阶段 | 复杂实施 |\n| **后台任务** | 手动 | 任务持续时间 | 长时间运行的操作 |\n| **CLI 参考** | 终端命令 | 会话\u002F脚本 | 自动化与脚本编写 |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>安装快速参考\u003C\u002Fsummary>\n\n```bash\n# 斜杠命令\ncp 01-slash-commands\u002F*.md .claude\u002Fcommands\u002F\n\n# 记忆\ncp 02-memory\u002Fproject-CLAUDE.md .\u002FCLAUDE.md\n\n# 技能\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n\n# 子代理\ncp 04-subagents\u002F*.md .claude\u002Fagents\u002F\n\n# MCP\nexport GITHUB_TOKEN=\"token\"\nclaude mcp add github -- npx -y @modelcontextprotocol\u002Fserver-github\n\n# 钩子\nmkdir -p ~\u002F.claude\u002Fhooks\ncp 06-hooks\u002F*.sh ~\u002F.claude\u002Fhooks\u002F\nchmod +x ~\u002F.claude\u002Fhooks\u002F*.sh\n\n# 插件\n\u002Fplugin install pr-review\n\n# 检查点（自动启用，需在设置中配置）\n# 参见 08-checkpoints\u002FREADME.md\n\n# 高级功能（需在设置中配置）\n# 参见 09-advanced-features\u002Fconfig-examples.json\n\n# CLI 参考（无需安装）\n# 参见 10-cli\u002FREADME.md 以获取使用示例\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>01. 斜杠命令\u003C\u002Fsummary>\n\n**位置**：[01-slash-commands\u002F](01-slash-commands\u002F)\n\n**是什么**：以 Markdown 文件形式存储的用户调用的快捷方式\n\n**示例**：\n- `optimize.md` - 代码优化分析\n- `pr.md` - 拉取请求准备\n- `generate-api-docs.md` - API 文档生成器\n\n**安装**：\n```bash\ncp 01-slash-commands\u002F*.md \u002F项目路径\u002F.claude\u002Fcommands\u002F\n```\n\n**使用**：\n```\n\u002Foptimize\n\u002Fpr\n\u002Fgenerate-api-docs\n```\n\n**了解更多**：[探索 Claude Code 斜杠命令](https:\u002F\u002Fmedium.com\u002F@luongnv89\u002Fdiscovering-claude-code-slash-commands-cdc17f0dfb29)\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>02. 记忆\u003C\u002Fsummary>\n\n**位置**：[02-memory\u002F](02-memory\u002F)\n\n**是什么**：跨会话的持久上下文\n\n**示例**：\n- `project-CLAUDE.md` - 团队范围的项目标准\n- `directory-api-CLAUDE.md` - 目录特定规则\n- `personal-CLAUDE.md` - 个人偏好\n\n**安装**：\n```bash\n# 项目记忆\ncp 02-memory\u002Fproject-CLAUDE.md \u002F项目路径\u002FCLAUDE.md\n\n# 目录记忆\ncp 02-memory\u002Fdirectory-api-CLAUDE.md \u002F项目路径\u002Fsrc\u002Fapi\u002FCLAUDE.md\n\n# 个人记忆\ncp 02-memory\u002Fpersonal-CLAUDE.md ~\u002F.claude\u002FCLAUDE.md\n```\n\n**使用方法**：由Claude自动加载\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>03. 技能\u003C\u002Fsummary>\n\n**位置**：[03-skills\u002F](03-skills\u002F)\n\n**内容**：可复用、自动调用的功能模块，包含说明和脚本\n\n**示例**：\n- `code-review\u002F` - 带脚本的全面代码审查\n- `brand-voice\u002F` - 品牌语音一致性检查器\n- `doc-generator\u002F` - API文档生成器\n\n**安装**：\n```bash\n# 个人技能\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n\n# 项目技能\ncp -r 03-skills\u002Fcode-review \u002Fpath\u002Fto\u002Fproject\u002F.claude\u002Fskills\u002F\n```\n\n**使用方法**：在相关场景下自动调用\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>04. 子代理\u003C\u002Fsummary>\n\n**位置**：[04-subagents\u002F](04-subagents\u002F)\n\n**内容**：具有独立上下文和自定义提示的专用AI助手\n\n**示例**：\n- `code-reviewer.md` - 全面的代码质量分析\n- `test-engineer.md` - 测试策略与覆盖率\n- `documentation-writer.md` - 技术文档\n- `secure-reviewer.md` - 专注于安全的只读审查\n- `implementation-agent.md` - 功能的完整实现\n\n**安装**：\n```bash\ncp 04-subagents\u002F*.md \u002Fpath\u002Fto\u002Fproject\u002F.claude\u002Fagents\u002F\n```\n\n**使用方法**：由主代理自动委派任务\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>05. MCP协议\u003C\u002Fsummary>\n\n**位置**：[05-mcp\u002F](05-mcp\u002F)\n\n**内容**：用于访问外部工具和API的模型上下文协议\n\n**示例**：\n- `github-mcp.json` - GitHub集成\n- `database-mcp.json` - 数据库查询\n- `filesystem-mcp.json` - 文件操作\n- `multi-mcp.json` - 多个MCP服务器\n\n**安装**：\n```bash\n# 设置环境变量\nexport GITHUB_TOKEN=\"your_token\"\nexport DATABASE_URL=\"postgresql:\u002F\u002F...\"\n\n# 通过命令行添加MCP服务器\nclaude mcp add github -- npx -y @modelcontextprotocol\u002Fserver-github\n\n# 或者手动将MCP配置添加到项目中的.mcp.json文件（详见05-mcp\u002F中的示例）\n```\n\n**使用方法**：配置完成后，MCP工具会自动对Claude可用\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>06. 钩子\u003C\u002Fsummary>\n\n**位置**：[06-hooks\u002F](06-hooks\u002F)\n\n**内容**：基于事件驱动的Shell命令，可在Claude Code事件发生时自动执行\n\n**示例**：\n- `format-code.sh` - 写代码前自动格式化\n- `pre-commit.sh` - 提交前运行测试\n- `security-scan.sh` - 扫描安全漏洞\n- `log-bash.sh` - 记录所有Bash命令\n- `validate-prompt.sh` - 验证用户提示\n- `notify-team.sh` - 在特定事件发生时发送通知\n\n**安装**：\n```bash\nmkdir -p ~\u002F.claude\u002Fhooks\ncp 06-hooks\u002F*.sh ~\u002F.claude\u002Fhooks\u002F\nchmod +x ~\u002F.claude\u002Fhooks\u002F*.sh\n```\n\n在`~\u002F.claude\u002Fsettings.json`中配置钩子：\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [{\n      \"matcher\": \"Write\",\n      \"hooks\": [\"~\u002F.claude\u002Fhooks\u002Fformat-code.sh\"]\n    }],\n    \"PostToolUse\": [{\n      \"matcher\": \"Write\",\n      \"hooks\": [\"~\u002F.claude\u002Fhooks\u002Fsecurity-scan.sh\"]\n    }]\n  }\n}\n```\n\n**使用方法**：钩子会在相应事件触发时自动执行\n\n**钩子类型**（4种类型，共25个事件）：\n- **工具钩子**：`PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`\n- **会话钩子**：`SessionStart`、`SessionEnd`、`Stop`、`StopFailure`、`SubagentStart`、`SubagentStop`\n- **任务钩子**：`UserPromptSubmit`、`TaskCompleted`、`TaskCreated`、`TeammateIdle`\n- **生命周期钩子**：`ConfigChange`、`CwdChanged`、`FileChanged`、`PreCompact`、`PostCompact`、`WorktreeCreate`、`WorktreeRemove`、`Notification`、`InstructionsLoaded`、`Elicitation`、`ElicitationResult`\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>07. 插件\u003C\u002Fsummary>\n\n**位置**：[07-plugins\u002F](07-plugins\u002F)\n\n**内容**：捆绑的命令、代理、MCP和钩子集合\n\n**示例**：\n- `pr-review\u002F` - 完整的PR审查工作流\n- `devops-automation\u002F` - 部署与监控\n- `documentation\u002F` - 文档生成\n\n**安装**：\n```bash\n\u002Fplugin install pr-review\n\u002Fplugin install devops-automation\n\u002Fplugin install documentation\n```\n\n**使用方法**：使用捆绑的斜杠命令和功能\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>08. 检查点与回溯\u003C\u002Fsummary>\n\n**位置**：[08-checkpoints\u002F](08-checkpoints\u002F)\n\n**内容**：保存对话状态并回溯到先前的节点，以探索不同的方案\n\n**核心概念**：\n- **检查点**：对话状态的快照\n- **回溯**：返回到之前的检查点\n- **分支点**：从同一检查点探索多种方案\n\n**使用方法**：\n```\n# 每次用户输入提示时都会自动创建检查点\n# 要回溯，按两次Esc键，或使用：\n\u002Frewind\n\n# 然后选择以下五个选项：\n# 1. 恢复代码和对话\n# 2. 恢复对话\n# 3. 恢复代码\n# 4. 从此处总结\n# 5. 算了\n```\n\n**应用场景**：\n- 尝试不同的实现方案\n- 从错误中恢复\n- 安全地进行实验\n- 对比不同解决方案\n- 对不同设计进行A\u002FB测试\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>09. 高级功能\u003C\u002Fsummary>\n\n**位置**：[09-advanced-features\u002F](09-advanced-features\u002F)\n\n**内容**：用于复杂工作流和自动化处理的高级能力\n\n**包括**：\n- **规划模式** — 在编码前制定详细的实施计划\n- **扩展思考** — 针对复杂问题进行深入推理（可通过`Alt+T`\u002F`Option+T`切换）\n- **后台任务** — 运行长时间操作而不阻塞\n- **权限模式** — `default`、`acceptEdits`、`plan`、`dontAsk`、`bypassPermissions`\n- **无头模式** — 在CI\u002FCD中运行Claude Code：`claude -p \"Run tests and generate report\"`\n- **会话管理** — `\u002Fresume`、`\u002Frename`、`\u002Ffork`、`claude -c`、`claude -r`\n- **配置** — 在`~\u002F.claude\u002Fsettings.json`中自定义行为\n\n完整的配置示例请参阅[config-examples.json](09-advanced-features\u002Fconfig-examples.json)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>10. CLI参考\u003C\u002Fsummary>\n\n**位置**：[10-cli\u002F](10-cli\u002F)\n\n**内容**：Claude Code的完整命令行界面参考\n\n**快速示例**：\n```bash\n# 交互模式\nclaude \"explain this project\"\n\n# 打印模式（非交互式）\nclaude -p \"review this code\"\n\n# 处理文件内容\ncat error.log | claude -p \"explain this error\"\n\n# 为脚本输出JSON\nclaude -p --output-format json \"list functions\"\n\n# 恢复会话\nclaude -r \"feature-auth\" \"continue implementation\"\n```\n\n**应用场景**：CI\u002FCD流水线集成、脚本自动化、批处理、多会话工作流、自定义代理配置\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>示例工作流\u003C\u002Fsummary>\n\n### 完整代码审查工作流\n\n```markdown\n# 使用：斜杠命令 + 子代理 + 记忆 + MCP\n\n用户：\u002Freview-pr\n\nClaude：\n1. 加载项目记忆（编码标准）\n2. 通过GitHub MCP获取PR\n3. 委托给code-reviewer子代理\n4. 委托给test-engineer子代理\n5. 综合分析结果\n6. 提供全面的审查报告\n```\n\n### 自动化文档生成\n\n```markdown\n\n# 用途：技能 + 子代理 + 内存\n\n用户：“为 auth 模块生成 API 文档”\n\nClaude：\n1. 加载项目内存（文档标准）\n2. 检测到文档生成请求\n3. 自动调用文档生成技能\n4. 委托给 API 文档编写子代理\n5. 创建包含示例的全面文档\n```\n\n### DevOps 部署\n\n```markdown\n# 用途：插件 + MCP + 钩子\n\n用户：\u002Fdeploy production\n\nClaude：\n1. 运行部署前钩子（验证环境）\n2. 委托给部署专家子代理\n3. 通过 Kubernetes MCP 执行部署\n4. 监控进度\n5. 运行部署后钩子（健康检查）\n6. 报告状态\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>目录结构\u003C\u002Fsummary>\n\n```\n├── 01-slash-commands\u002F\n│   ├── optimize.md\n│   ├── pr.md\n│   ├── generate-api-docs.md\n│   └── README.md\n├── 02-memory\u002F\n│   ├── project-CLAUDE.md\n│   ├── directory-api-CLAUDE.md\n│   ├── personal-CLAUDE.md\n│   └── README.md\n├── 03-skills\u002F\n│   ├── code-review\u002F\n│   │   ├── SKILL.md\n│   │   ├── scripts\u002F\n│   │   └── templates\u002F\n│   ├── brand-voice\u002F\n│   │   ├── SKILL.md\n│   │   └── templates\u002F\n│   ├── doc-generator\u002F\n│   │   ├── SKILL.md\n│   │   └── generate-docs.py\n│   └── README.md\n├── 04-subagents\u002F\n│   ├── code-reviewer.md\n│   ├── test-engineer.md\n│   ├── documentation-writer.md\n│   ├── secure-reviewer.md\n│   ├── implementation-agent.md\n│   └── README.md\n├── 05-mcp\u002F\n│   ├── github-mcp.json\n│   ├── database-mcp.json\n│   ├── filesystem-mcp.json\n│   ├── multi-mcp.json\n│   └── README.md\n├── 06-hooks\u002F\n│   ├── format-code.sh\n│   ├── pre-commit.sh\n│   ├── security-scan.sh\n│   ├── log-bash.sh\n│   ├── validate-prompt.sh\n│   ├── notify-team.sh\n│   └── README.md\n├── 07-plugins\u002F\n│   ├── pr-review\u002F\n│   ├── devops-automation\u002F\n│   ├── documentation\u002F\n│   └── README.md\n├── 08-checkpoints\u002F\n│   ├── checkpoint-examples.md\n│   └── README.md\n├── 09-advanced-features\u002F\n│   ├── config-examples.json\n│   ├── planning-mode-examples.md\n│   └── README.md\n├── 10-cli\u002F\n│   └── README.md\n└── README.md (此文件)\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>最佳实践\u003C\u002Fsummary>\n\n### 应该做的\n- 从简单的斜杠命令开始\n- 循序渐进地添加功能\n- 使用内存存储团队标准\n- 先在本地测试配置\n- 记录自定义实现\n- 对项目配置进行版本控制\n- 与团队共享插件\n\n### 不应该做的\n- 不要创建重复的功能\n- 不要硬编码凭据\n- 不要跳过文档\n- 不要让简单任务过于复杂\n- 不要忽视安全最佳实践\n- 不要提交敏感数据\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>故障排除\u003C\u002Fsummary>\n\n### 功能未加载\n1. 检查文件位置和命名\n2. 验证 YAML 前置元数据语法\n3. 检查文件权限\n4. 查看 Claude Code 版本兼容性\n\n### MCP 连接失败\n1. 验证环境变量\n2. 检查 MCP 服务器安装\n3. 测试凭据\n4. 检查网络连接\n\n### 子代理未委托\n1. 检查工具权限\n2. 验证代理描述是否清晰\n3. 回顾任务复杂度\n4. 独立测试代理\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>测试\u003C\u002Fsummary>\n\n该项目包含全面的自动化测试：\n\n- **单元测试**：使用 pytest 的 Python 测试（Python 3.10、3.11、3.12）\n- **代码质量**：使用 Ruff 进行 lint 和格式化\n- **安全性**：使用 Bandit 进行漏洞扫描\n- **类型检查**：使用 mypy 进行静态类型分析\n- **构建验证**：EPUB 生成测试\n- **覆盖率跟踪**：集成 Codecov\n\n```bash\n# 安装开发依赖\nuv pip install -r requirements-dev.txt\n\n# 运行所有单元测试\npytest scripts\u002Ftests\u002F -v\n\n# 运行带覆盖率报告的测试\npytest scripts\u002Ftests\u002F -v --cov=scripts --cov-report=html\n\n# 运行代码质量检查\nruff check scripts\u002F\nruff format --check scripts\u002F\n\n# 运行安全扫描\nbandit -c pyproject.toml -r scripts\u002F --exclude scripts\u002Ftests\u002F\n\n# 运行类型检查\nmypy scripts\u002F --ignore-missing-imports\n```\n\n每次向 `main` 或 `develop` 分支推送以及向 `main` 分支提交 PR 时，都会自动运行测试。详细信息请参阅 [TESTING.md](.github\u002FTESTING.md)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>EPUB 生成\u003C\u002Fsummary>\n\n想离线阅读本指南吗？可以生成 EPUB 电子书：\n\n```bash\nuv run scripts\u002Fbuild_epub.py\n```\n\n这将创建包含所有内容（包括渲染后的 Mermaid 图）的 `claude-howto-guide.epub` 文件。\n\n更多选项请参阅 [scripts\u002FREADME.md](scripts\u002FREADME.md)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>贡献\u003C\u002Fsummary>\n\n发现了一个问题或想贡献一个示例吗？我们非常欢迎您的帮助！\n\n**请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)，了解以下详细指南：**\n- 贡献类型（示例、文档、功能、缺陷、反馈）\n- 如何设置开发环境\n- 目录结构及如何添加内容\n- 编写指南和最佳实践\n- 提交和 PR 流程\n\n**我们的社区规范：**\n- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) - 我们如何对待彼此\n- [SECURITY.md](SECURITY.md) - 安全政策和漏洞报告\n\n### 报告安全问题\n\n如果您发现了安全漏洞，请以负责任的方式报告：\n\n1. **使用 GitHub 私有漏洞报告**：https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fsecurity\u002Fadvisories\n2. **或者阅读** [.github\u002FSECURITY_REPORTING.md](.github\u002FSECURITY_REPORTING.md) 获取详细说明\n3. **切勿**公开提交安全漏洞相关的问题\n\n快速入门：\n1. 分叉并克隆仓库\n2. 创建描述性的分支（`add\u002Ffeature-name`、`fix\u002Fbug`、`docs\u002Fimprovement`）\n3. 按照指南进行更改\n4. 提交带有清晰描述的拉取请求\n\n**需要帮助吗？** 开启一个问题或讨论，我们会指导您完成整个流程。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>资源\u003C\u002Fsummary>\n\n- [Claude Code 文档](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Foverview)\n- [MCP 协议规范](https:\u002F\u002Fmodelcontextprotocol.io)\n- [技能库](https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fskills) - 包含大量即用型技能\n- [Anthropic 烹饪书](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fanthropic-cookbook)\n- [Boris Cherny 的 Claude Code 工作流](https:\u002F\u002Fx.com\u002Fbcherny\u002Fstatus\u002F2007179832300581177) - Claude Code 的创造者分享了他的系统化工作流：并行代理、共享 CLAUDE.md、计划模式、斜杠命令、子代理以及用于自主长期运行会话的验证钩子。\n\n\u003C\u002Fdetails>\n\n---\n\n## 贡献\n\n我们欢迎各位的贡献！请参阅我们的 [贡献指南](CONTRIBUTING.md)，了解如何开始。\n\n---\n\n## 许可证\n\nMIT 许可证 - 详见 [LICENSE](LICENSE)。您可以自由使用、修改和分发，唯一的要求是保留许可证声明。\n\n---\n\n**最后更新时间**：2026年4月9日  \n**Claude Code 版本**：2.1.97  \n**兼容模型**：Claude Sonnet 4.6、Claude Opus 4.6、Claude Haiku 4.5","# Claude How To 快速上手指南\n\n本指南旨在帮助开发者在 15 分钟内掌握 Claude Code 的核心用法，从基础指令到构建自动化工作流。\n\n## 环境准备\n\n在开始之前，请确保满足以下要求：\n\n*   **系统要求**：支持 macOS、Linux 或 Windows (WSL)。\n*   **前置依赖**：\n    *   已安装 **Claude Code** (版本 2.1+)。\n    *   已安装 **Git**。\n    *   已配置 Claude API 访问权限。\n*   **网络建议**：由于仓库托管于 GitHub，国内用户建议使用加速代理或镜像源克隆项目，以确保下载速度。\n\n## 安装步骤\n\n### 1. 克隆项目仓库\n\n将 `claude-howto` 指南克隆到本地。\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto.git\ncd claude-howto\n```\n\n> **提示**：如果直接克隆速度慢，可使用国内镜像（如 Gitee 镜像，如有）或通过代理加速。\n\n### 2. 配置基础功能 (15 分钟极速版)\n\n执行以下命令将示例配置复制到你的项目中。假设你的项目根目录为 `\u002Fpath\u002Fto\u002Fyour-project`。\n\n**设置斜杠命令 (Slash Commands):**\n```bash\nmkdir -p \u002Fpath\u002Fto\u002Fyour-project\u002F.claude\u002Fcommands\ncp 01-slash-commands\u002Foptimize.md \u002Fpath\u002Fto\u002Fyour-project\u002F.claude\u002Fcommands\u002F\n```\n\n**设置项目记忆 (Project Memory):**\n```bash\ncp 02-memory\u002Fproject-CLAUDE.md \u002Fpath\u002Fto\u002Fyour-project\u002FCLAUDE.md\n```\n\n**安装技能包 (Skills):**\n```bash\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n```\n\n### 3. 完整安装 (可选)\n\n若需部署所有模块（包括 Hooks, MCP, Subagents 等），可批量复制：\n\n```bash\n# 复制所有斜杠命令\ncp 01-slash-commands\u002F*.md .claude\u002Fcommands\u002F\n\n# 复制项目记忆配置\ncp 02-memory\u002Fproject-CLAUDE.md .\u002FCLAUDE.md\n\n# 复制技能包\ncp -r 03-skills\u002Fcode-review ~\u002F.claude\u002Fskills\u002F\n```\n\n## 基本使用\n\n配置完成后，启动 Claude Code 即可体验增强功能。\n\n### 1. 测试斜杠命令\n\n在 Claude Code 交互界面中，输入以下命令调用刚才复制的优化指令：\n\n```text\n\u002Foptimize\n```\n\n### 2. 验证项目记忆\n\n确保根目录下的 `CLAUDE.md` 文件已被识别。该文件将作为持久化上下文，让 Claude 记住你的项目规范和偏好，无需每次重复说明。\n\n### 3. 运行自我评估 (推荐)\n\n在 Claude Code 中输入以下命令，系统将自动检测你的掌握程度并生成个性化学习路径：\n\n```text\n\u002Fself-assessment\n```\n\n或者针对特定模块进行测试：\n\n```text\n\u002Flesson-quiz hooks\n```\n\n### 4. 进阶工作流\n\n现在你可以组合使用各项功能，例如构建自动化代码审查流程：\n*   **Slash Commands**: 触发任务\n*   **Memory**: 提供项目背景\n*   **Subagents**: 分配专项任务（如安全扫描）\n*   **Hooks**: 自动执行验证脚本\n\n通过遵循项目中的 [学习路线图](LEARNING-ROADMAP.md)，你可以在 11-13 小时内从入门进阶到精通，掌握包括 MCP 协议、插件开发和复杂代理编排在内的高级特性。","某全栈开发团队正试图利用 Claude Code 构建一套自动化的代码审查与安全扫描流水线，以提升发布效率。\n\n### 没有 claude-howto 时\n- **功能孤立难串联**：开发者虽然知道斜杠命令、Hooks 和子代理的存在，但官方文档仅罗列特性，无法指导如何将这些组件组合成连贯的工作流。\n- **学习路径混乱**：面对 MCP、技能和子代理等复杂概念，团队不清楚学习先后顺序，导致在碎片化信息中空耗时间却未掌握核心逻辑。\n- **示例过于简单**：现有的\"Hello World\"级示例无法支撑生产级需求，团队难以直接复用模板来构建包含内存管理和自动安全扫描的复杂流程。\n- **潜力挖掘不足**：由于缺乏深层原理图解，团队仅使用了工具 10% 的基础功能，错失了自动化编排带来的巨大效率提升。\n\n### 使用 claude-howto 后\n- **即插即用模板**：直接复制项目中提供的生产级配置文件（如 CLAUDE.md 模板、Hook 脚本和子代理定义），迅速搭建起完整的代码审查流水线。\n- **清晰进阶路线**：跟随可视化的学习路线图，团队在 12 小时内系统性地从入门掌握到高级代理编排，明确了从基础命令到 MCP 集成的最佳实践。\n- **原理可视化**：通过 Mermaid 流程图深入理解各组件内部交互机制，不仅知道“怎么做”，更明白“为什么”，从而能灵活调整工作流以适应特定业务。\n- **自我诊断提升**：利用内置的交互式测验快速识别团队知识盲区，针对性地补全技能短板，确保每位成员都能发挥工具的最大效能。\n\nclaude-howto 将零散的功能文档转化为可落地的实战指南，帮助开发者在短时间内从单纯的用户进化为能够编排复杂智能体团队的专家。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fluongnv89_claude-howto_81931f78.png","luongnv89","Luong NGUYEN","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fluongnv89_1b978228.jpg","Software Engineer\r\n\u002F AI, Cybersecurity\r\n\u002F Learn, Build, Share and Connect","https:\u002F\u002Fmontimage.com","Paris, France",null,"https:\u002F\u002Fluongnv.com","https:\u002F\u002Fgithub.com\u002Fluongnv89",[82,86,90],{"name":83,"color":84,"percentage":85},"Python","#3572A5",82.8,{"name":87,"color":88,"percentage":89},"Shell","#89e051",14.7,{"name":91,"color":92,"percentage":93},"JavaScript","#f1e05a",2.5,24705,2955,"2026-04-11T01:10:30","MIT","未说明",{"notes":100,"python":98,"dependencies":101},"本工具并非独立的 AI 模型或需要本地计算资源的软件，而是一份针对'Claude Code'工具的教程指南和配置模板集合。运行环境需求完全取决于宿主工具'Claude Code'的要求。主要操作涉及克隆 Git 仓库、复制配置文件（如 slash commands, CLAUDE.md, skills）到指定目录，以及在已安装的 Claude Code 环境中运行特定命令。文中提到的'uv run scripts\u002Fbuild_epub.py'仅用于生成离线电子书，非核心运行依赖。",[102],"Claude Code (v2.1+)",[35,13,52],[105,106,107],"claude-code","guide","tutorial","2026-03-27T02:49:30.150509","2026-04-11T15:14:45.683314",[111,116,121,126,131,136],{"id":112,"question_zh":113,"answer_zh":114,"source_url":115},29574,"本指南中的概念（如技能、MCP、子代理）是否适用于 Codex 或其他 AI 代理工具？","是的，本指南中的许多核心概念（如 skills、mcp、sub-agents 等）同样适用于 Codex 或其他 AI 代理。阅读本指南可以帮助您理解这些概念，但在不同工具中应用时需要进行一些适配。\n\n例如：\n- 在 Codex 中，您可以使用 `$` 符号来调用技能；\n- 在 OpenCode 中，您需要调用 `\u002Fskill` 来查看技能列表，或者如果您记得技能名称，可以直接使用 `\u002Fskill-name` 来调用特定技能。","https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fissues\u002F59",{"id":117,"question_zh":118,"answer_zh":119,"source_url":120},29575,"本地模型（如 Ollama、Llama.cpp）的运行效果能否达到 Anthropic API 官方模型的水平？","目前本地模型的效果还无法完全匹配 Claude 模式的质量水平。即使是顶级的商业模型（如 Gemini、Grok、GPT），有时也无法达到同等水平。\n\n不过，本地模型在许多场景下仍然表现出色，特别是在需要隐私保护的环境中。此外，开源和本地模型的发展非常迅速，未来可期。","https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fissues\u002F9",{"id":122,"question_zh":123,"answer_zh":124,"source_url":125},29576,"项目是否有相关的监控工具或配置管理工具推荐？","作者推荐了以下两个相关仓库以增强工作流：\n1. **cc-context-stats**：用于监控上下文使用情况及更多统计信息（归类于监控和仪表盘）。\n2. **asm**：通用的代理技能管理器（归类于范围和配置管理）。\n\n这些工具已被收录在 Awesome Claude Code Workflows 列表中，分别用于上下文监控和技能管理。","https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fissues\u002F8",{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},29577,"如何解决 Mermaid 图表在深色模式下颜色对比度低、难以阅读的问题？","建议将当前的浅色配色方案替换为更深、饱和度更高的颜色，以符合 WCAG 无障碍指南并兼顾深浅模式。\n\n具体修改方案是将浅绿色 (#90EE90)、天蓝色 (#87CEEB) 等替换为深绿色 (#2E7D32)、深蓝色 (#1565C0) 等，并将所有文本颜色统一设置为白色 (#fff) 以确保可读性。维护者已确认该建议并列入待办事项。","https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fissues\u002F6",{"id":132,"question_zh":133,"answer_zh":134,"source_url":135},29578,"在 EPUB 阅读器（如 Foliate）中无法渲染 SVG 图片怎么办？","这是由于 Foliate 存在安全问题导致无法渲染某些 SVG 图片（参考 Foliate issue #814）。\n\n建议的改进方案是使用更安全的 SVG 渲染方式来生成 EPUB，以确保在 Foliate 等阅读器中能正常显示图片。目前构建脚本无执行错误，问题主要出在阅读器对 SVG 的安全限制上。","https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fissues\u002F44",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},29579,"文档中提到的 `pre-tool-check.sh` 文件缺失怎么办？","在 `LEARNING-ROADMAP.md` 文件的 Milestone 2A: Automation (Skills + Hooks) 部分（第 251 行附近），引用了 `06-hooks` 目录下的 `pre-tool-check.sh` 文件，但该文件实际缺失。\n\n这是一个文档错误，需要补充该文件或更新文档移除对该文件的引用，以免用户在学习过程中遇到阻碍。","https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fissues\u002F32",[142,147,152,157,162],{"id":143,"version":144,"summary_zh":145,"released_at":146},206079,"v2.3.0","# 更改日志\n\n## v2.3.0 — 2026年4月7日\n\n### 功能\n\n- 按语言构建并发布 EPUB 文档（90e9c30）@Thiên Toán\n- 在 06-hooks 中添加缺失的 pre-tool-check.sh 钩子（b511ed1）@JiayuWang\n- 在 zh\u002F 目录中添加中文翻译（89e89d4）@Luong NGUYEN\n- 添加性能优化子代理和依赖检查钩子（f53d080）@qk\n\n### 错误修复\n\n- Windows Git Bash 兼容性 + 标准输入 JSON 协议（2cbb10c）@Luong NGUYEN\n- 修正 08-checkpoints 中 autoCheckpoint 配置文档（749c79f）@JiayuWang\n- 嵌入 SVG 图片，而非用占位符替换（1b16709）@Thiên Toán\n- 内存中 README 的嵌套代码块渲染问题（ce24423）@Zhaoshan Duan\n- 应用因压缩合并而丢失的评审修复内容（34259ca）@Luong NGUYEN\n- 使钩子脚本兼容 Windows Git Bash，并使用标准输入 JSON 协议（107153d）@binyu li\n\n### 文档\n\n- 将所有教程与最新的 Claude Code 文档同步（2026年4月）（72d3b01）@Luong NGUYEN\n- 在语言切换器中添加中文链接（6cbaa4d）@Luong NGUYEN\n- 添加英语与越南语之间的语言切换器（100c45e）@Luong NGUYEN\n- 添加 GitHub #1 热门项目徽章（0ca8c37）@Luong NGUYEN\n- 引入 cc-context-stats 用于上下文区域监控（d41b335）@Luong NGUYEN\n- 引入 luongnv89\u002Fskills 集合和 luongnv89\u002Fasm 技能管理器（7e3c0b6）@Luong NGUYEN\n- 更新 README 统计信息以反映当前 GitHub 指标（5,900+ 星，690+ 分支）（5001525）@Luong NGUYEN\n- 更新 README 统计信息以反映当前 GitHub 指标（3,900+ 星，460+ 分支）（9cb92d6）@Luong NGUYEN\n\n### 重构\n\n- 用本地 mmdc 渲染替代 Kroki HTTP 依赖（e76bbe4）@Luong NGUYEN\n- 将质量检查移至 pre-commit，CI 作为第二道防线（6d1e0ae）@Luong NGUYEN\n- 缩小自动模式权限基线（2790fb2）@Luong NGUYEN\n- 用一次性权限设置脚本替换自动适配钩子（995a5d6）@Luong NGUYEN\n\n### 其他\n\n- 提前设置质量门槛 — 将 mypy 加入 pre-commit，修复 CI 失败问题（699fb39）@Luong NGUYEN\n- 添加越南语本地化（Tiếng Việt）（a70777e）@Thiên Toán\n\n**完整更改日志**：https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fcompare\u002Fv2.2.0...v2.3.0\n\n---\n\n## v2.2.0 — 2026年3月26日\n\n### 文档\n\n- 将所有教程和参考文档与 Claude Code v2.1.84 同步（f78c094）@luongnv89\n  - 更新斜杠命令至 55+ 内置技能 + 5 个捆绑技能，标记 3 个已弃用\n  - 扩展钩子事件从 18 个增至 25 个，新增 `agent` 钩子类型（现共 4 种）\n  - 将自动模式、频道和语音听写加入高级功能\n  - 新增 `effort` 和 `shell` 技能的 frontmatter 字段；以及 `initialPrompt` 和 `disallowedTools` 的 agent 字段\n  - 添加 WebSocket MCP 传输、诱导机制及 2KB 工具上限\n  - 增加插件 LSP 支持，以及 `userConfig` 和 `${CLAUDE_PLUGIN_DATA}`\n  - 更新所有参考文档（CATALOG、QUICK_REFERENCE、LEARNING-ROADMAP、INDEX）\n- 重写 README 为着陆页结构指南（32a0776）@luongnv89\n\n### 错误修复\n\n- 为符合 CI 要求，添加缺失的 cSpell 单词和 README 部分（93f9d51）@luongnv89\n- 将 `Sandboxing` 添加到 cSpell 词典中","2026-04-07T08:37:53",{"id":148,"version":149,"summary_zh":150,"released_at":151},206080,"v2.2.0","## v2.2.0 — 2026-03-26\n\n### 文档\n\n- 将所有教程和参考文档与 Claude Code v2.1.84 (f78c094) 同步 @luongnv89\n  - 更新斜杠命令，现包含 55+ 个内置技能 + 5 个捆绑技能，并标记 3 个已弃用的技能\n  - 将钩子事件从 18 个扩展到 25 个，新增 `agent` 钩子类型（目前共有 4 种）\n  - 在高级功能中添加自动模式、频道和语音听写\n  - 新增 `effort` 和 `shell` 技能的 frontmatter 字段；以及 `initialPrompt` 和 `disallowedTools` 的代理字段\n  - 添加 WebSocket MCP 传输、诱导机制及 2KB 工具容量限制\n  - 增加插件 LSP 支持，以及 `userConfig` 和 `${CLAUDE_PLUGIN_DATA}` 变量\n  - 更新所有参考文档（CATALOG、QUICK_REFERENCE、LEARNING-ROADMAP、INDEX）\n- 重写 README，使其成为具有着陆页结构的指南 (32a0776) @luongnv89\n\n### 错误修复\n\n- 为符合 CI 规范，补充缺失的 cSpell 单词和 README 部分 (93f9d51) @luongnv89\n- 将 `Sandboxing` 添加到 cSpell 词典 (b80ce6f) @luongnv89\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fcompare\u002Fv2.1.1...v2.2.0","2026-03-26T14:06:27",{"id":153,"version":154,"summary_zh":155,"released_at":156},206081,"v2.1.1","## v2.1.1 — 2026年3月13日\n\n### 错误修复\n\n- 移除导致 CI 链接检查失败的无效市场链接 (3fdf0d6)\n- 将 `sandboxed` 和 `pycache` 添加到 cSpell 词典 (dc64618)\n\n**完整更新日志**: https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fcompare\u002Fv2.1.0...v2.1.1\n\n**完整更新日志**: https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fcompare\u002Fv2.1.0...v2.1.1","2026-03-13T09:51:01",{"id":158,"version":159,"summary_zh":160,"released_at":161},206082,"v2.1.0","## v2.1.0 — 2026-03-13\n\n### 功能\n\n- 添加自适应学习路径，包含自我评估和课后测验技能（1ef46cd）\n  - `\u002Fself-assessment` — 跨10个功能领域的互动式水平测试，提供个性化学习路径\n  - `\u002Flesson-quiz [lesson]` — 每节课的针对性知识检测，包含8到10道题目\n\n### 错误修复\n\n- 更新损坏的链接、废弃内容及过时引用（8fe4520）\n- 修复资源和自我评估技能中的失效链接（7a05863）\n- 在概念指南中使用波浪线代码块标记嵌套代码块（5f82719）——感谢 @VikalpP！\n- 向 cSpell 词典添加缺失词汇（8df7572）\n\n### 文档\n\n- 第五阶段 QA — 修复文档中的一致性、链接和术语问题（00bbe4c）\n- 完成第三至第四阶段 — 新功能覆盖及参考文档更新（132de29）\n- 将 MCPorter 运行时添加到 MCP 上下文膨胀部分（ef52705）\n- 在6份指南中补充缺失的命令、功能和设置（4bc8f15）\n- 基于现有仓库规范添加风格指南（84141d0）\n- 在指南对比表中添加自我评估行（8fe0c96）\n- 将 VikalpP 加入贡献者名单，以表彰其 PR #7（d5b4350）\n- 在 README 和路线图中添加自我评估和课后测验技能的相关引用（d5a6106）\n\n### 新贡献者\n\n- @VikalpP 在 PR #7 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fcompare\u002Fv2.0.0...v2.1.0","2026-03-13T08:08:10",{"id":163,"version":164,"summary_zh":165,"released_at":166},206083,"v2.0.0","## 变更内容\n\n### 功能\n\n- 同步所有文档至 Claude Code 2026年2月的功能版本 (487c96d)\n  - 更新了全部10个教程目录及7份参考文档中的26个文件\n  - 新增关于**自动记忆**的文档——每个项目下的持久化学习记录\n  - 新增关于**远程控制**、**Web会话**和**桌面应用**的文档\n  - 新增关于**代理团队**（实验性多代理协作）的文档\n  - 新增关于**MCP OAuth 2.0**、**工具搜索**和**Claude.ai 连接器**的文档\n  - 新增关于子代理的**持久化内存**和**工作树隔离**的文档\n  - 新增关于**后台子代理**、**任务列表**和**提示建议**的文档\n  - 新增关于**沙箱机制**和**托管设置**（企业版）的文档\n  - 新增关于**HTTP Webhook**及7种新Webhook事件的文档\n  - 新增关于**插件设置**、**LSP服务器**以及市场更新的文档\n  - 新增关于**从检查点回溯**重置选项的文档\n  - 记录了17条新的斜杠命令（`\u002Ffork`、`\u002Fdesktop`、`\u002Fteleport`、`\u002Ftasks`、`\u002Ffast`等）\n  - 记录了新的CLI标志位（`--worktree`、`--from-pr`、`--remote`、`--teleport`、`--teammate-mode`等）\n  - 记录了用于自动记忆、努力级别、代理团队等功能的新环境变量\n\n### 设计\n\n- 重新设计Logo为指南针括号标记，并采用极简配色方案 (20779db)\n\n### 错误修复与修正\n\n- 更新模型名称：Sonnet 4.5 → **Sonnet 4.6**，Opus 4.5 → **Opus 4.6**\n- 修正权限模式名称：将虚构的“无限制\u002F确认\u002F只读”替换为实际的 `default`\u002F`acceptEdits`\u002F`plan`\u002F`dontAsk`\u002F`bypassPermissions`\n- 修正Webhook事件：移除虚构的 `PreCommit`\u002F`PostCommit`\u002F`PrePush`，添加真实事件（`SubagentStart`、`WorktreeCreate`、`ConfigChange`等）\n- 修正CLI语法：将 `claude-code --headless` 替换为 `claude -p`（打印模式）\n- 修正检查点命令：将虚构的 `\u002Fcheckpoint save\u002Flist\u002Frewind\u002Fdiff` 替换为实际的 `Esc+Esc` \u002F `\u002Frewind` 界面\n- 修正会话管理：将虚构的 `\u002Fsession list\u002Fnew\u002Fswitch\u002Fsave` 替换为真实的 `\u002Fresume`\u002F`\u002Frename`\u002F`\u002Ffork`\n- 修正插件清单格式：将 `plugin.yaml` 迁移到 `.claude-plugin\u002Fplugin.json`\n- 修正MCP配置路径：将 `~\u002F.claude\u002Fmcp.json` 更改为 `.mcp.json`（项目级）或 `~\u002F.claude.json`（用户级）\n- 修正文档URL：将 `docs.claude.com` 替换为 `docs.anthropic.com`；移除虚构的 `plugins.claude.com`\n- 移除多个文件中虚构的配置字段\n- 将所有“最后更新”日期统一更新为2026年2月\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fcompare\u002F20779db...v2.0.0\n\n\n## 变更内容\n* 在 https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fpull\u002F1 中，@wjhrdy 添加了一个用于创建epub文件的工具。\n\n## 新贡献者\n* @wjhrdy 在 https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fpull\u002F1 中完成了他们的首次贡献。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fluongnv89\u002Fclaude-howto\u002Fcommits\u002Fv2.0.0","2026-02-25T22:21:28"]