[{"data":1,"prerenderedAt":2290},["ShallowReactive",2],{"search-docs":3,"doc-\u002Fai\u002Fskills\u002Fbest-practices":886},[4,8,12,16,20,24,28,32,36,40,44,48,52,56,60,64,68,72,76,80,84,88,92,96,100,104,108,112,116,120,124,128,132,136,140,144,148,152,156,159,162,165,169,172,175,178,182,186,190,194,198,202,206,210,214,218,222,226,230,234,238,242,246,250,254,258,262,266,269,273,277,281,285,288,291,294,298,301,304,307,310,313,316,319,322,325,329,332,336,340,344,348,352,356,359,362,365,368,371,374,377,380,383,386,389,393,396,399,402,405,408,411,414,417,420,424,428,432,435,438,442,446,450,454,458,462,466,470,474,477,480,483,487,491,494,497,500,504,507,511,515,518,521,524,527,530,533,536,539,542,545,548,551,554,557,560,563,566,569,572,575,579,583,587,591,595,599,603,606,610,614,617,620,623,626,629,633,637,640,643,646,649,652,655,658,661,664,667,670,673,676,679,682,685,688,691,694,697,700,703,706,709,712,716,720,724,728,732,736,740,744,748,752,756,760,764,768,772,775,779,783,787,790,793,796,799,802,805,808,811,814,818,822,825,829,832,835,838,841,844,848,851,854,858,862,865,869,873,876,879,882],{"path":5,"title":6,"description":7},"\u002Fabout\u002Fauthor","作者相关","只想纯粹的做一个程序员...",{"path":9,"title":10,"description":11},"\u002Fabout\u002Fjourney","心路历程","",{"path":13,"title":14,"description":15},"\u002Fai\u002Fagent\u002Fframeworks","Agent 框架","主流 Agent 框架：LangChain、LlamaIndex、AutoGen、CrewAI",{"path":17,"title":18,"description":19},"\u002Fai\u002Fagent\u002Fhooks","Agent Hooks 与自动化","Claude Agent 的 Hooks 生命周期、事件类型、典型自动化场景",{"path":21,"title":22,"description":23},"\u002Fai\u002Fagent\u002Fintroduction","AI Agent 概述","AI Agent 核心概念：感知、规划、执行、记忆",{"path":25,"title":26,"description":27},"\u002Fai\u002Fagent\u002Fpractice","Agent 实战","AI Agent 实战：构建自主任务执行系统",{"path":29,"title":30,"description":31},"\u002Fai\u002Fagent\u002Fsdk","Claude Agent SDK 开发","使用 Claude Agent SDK 构建自定义 AI Agent：架构、API、生命周期",{"path":33,"title":34,"description":35},"\u002Fai\u002Fagent\u002Fsubagents","Subagents 子代理","用 Subagents 分解复杂任务、并发执行、隔离上下文",{"path":37,"title":38,"description":39},"\u002Fai\u002Fagent\u002Ftool-use","工具调用","AI Agent 工具调用：Function Calling、Tool Use 原理与实践",{"path":41,"title":42,"description":43},"\u002Fai\u002Ffundamentals\u002Fdeep-learning","深度学习入门","深度学习基础知识：前向传播、反向传播、损失函数、优化器",{"path":45,"title":46,"description":47},"\u002Fai\u002Ffundamentals\u002Fml-basics","机器学习基础","机器学习核心概念：监督学习、无监督学习、强化学习",{"path":49,"title":50,"description":51},"\u002Fai\u002Ffundamentals\u002Fneural-networks","神经网络原理","神经网络架构：CNN、RNN、注意力机制",{"path":53,"title":54,"description":55},"\u002Fai\u002Fgetting-started","AI 学习路线","AI 技术学习路线图，从基础到实战的完整指南",{"path":57,"title":58,"description":59},"\u002Fai\u002Fllm\u002Ffine-tuning","模型微调","大模型微调技术：LoRA、QLoRA、全量微调、RLHF",{"path":61,"title":62,"description":63},"\u002Fai\u002Fllm\u002Fintroduction","大模型概述","大语言模型发展历程、核心能力与主流模型对比",{"path":65,"title":66,"description":67},"\u002Fai\u002Fllm\u002Flocal-deploy","本地部署","大模型本地部署：Ollama、vLLM、llama.cpp",{"path":69,"title":70,"description":71},"\u002Fai\u002Fllm\u002Ftransformer","Transformer 架构","Transformer 架构详解：自注意力机制、位置编码、多头注意力",{"path":73,"title":74,"description":75},"\u002Fai\u002Fmcp\u002Fclient","MCP Client 开发","MCP Client 开发指南：连接、调用、集成",{"path":77,"title":78,"description":79},"\u002Fai\u002Fmcp\u002Fdebugging","MCP 调试与排错","MCP Server 开发与集成过程中的常见问题、日志分析、诊断工具",{"path":81,"title":82,"description":83},"\u002Fai\u002Fmcp\u002Fintroduction","MCP 概述","Model Context Protocol 协议概述：架构、核心概念、应用场景",{"path":85,"title":86,"description":87},"\u002Fai\u002Fmcp\u002Fserver","MCP Server 开发","MCP Server 开发指南：资源、工具、提示词的实现",{"path":89,"title":90,"description":91},"\u002Fai\u002Fmcp\u002Ftools","MCP Tools 深入","深入理解 MCP Tools：与 Resources\u002FPrompts 的差异、Schema 设计、Annotations 与权限控制",{"path":93,"title":94,"description":95},"\u002Fai\u002Fprompt\u002Fadvanced","高级 Prompt 模式","高级 Prompt 设计模式：Tree-of-Thought、自我反思、多轮对话策略",{"path":97,"title":98,"description":99},"\u002Fai\u002Fprompt\u002Fbasics","Prompt 基础","Prompt Engineering 入门：基本概念、角色设定、输出格式控制",{"path":101,"title":102,"description":103},"\u002Fai\u002Fprompt\u002Ftechniques","提示词技巧","常用提示词技巧：Few-shot、Chain-of-Thought、ReAct",{"path":105,"title":106,"description":107},"\u002Fai\u002Frag\u002Fembedding","文本嵌入","文本嵌入模型：Embedding 原理、模型选择、相似度计算",{"path":109,"title":110,"description":111},"\u002Fai\u002Frag\u002Fintroduction","RAG 概述","检索增强生成（RAG）架构原理、优势与应用场景",{"path":113,"title":114,"description":115},"\u002Fai\u002Frag\u002Fpractice","RAG 实战","RAG 应用实战：文档问答系统、知识库搭建",{"path":117,"title":118,"description":119},"\u002Fai\u002Frag\u002Fvector-database","向量数据库","主流向量数据库对比：Milvus、Pinecone、Chroma、Weaviate",{"path":121,"title":122,"description":123},"\u002Fai\u002Fskills\u002Fbest-practices","Skill 最佳实践","编写高质量 Skill 的设计原则、常见陷阱与优化技巧",{"path":125,"title":126,"description":127},"\u002Fai\u002Fskills\u002Fcreating","创建自定义 Skill","从零编写一个可被 Agent 自动发现和调用的 Skill",{"path":129,"title":130,"description":131},"\u002Fai\u002Fskills\u002Fintroduction","Agent Skills 概述","Claude Agent Skills 概念、工作原理、与 Tools\u002FMCP 的区别",{"path":133,"title":134,"description":135},"\u002Fgolang\u002Fadvanced\u002Fconcurrency","Go - 并发深入","深入理解 Go 并发编程的核心机制。",{"path":137,"title":138,"description":139},"\u002Fgolang\u002Fadvanced\u002Fgc","Go - 垃圾回收","理解 Go 的垃圾回收机制，掌握 GC 调优方法。",{"path":141,"title":142,"description":143},"\u002Fgolang\u002Fadvanced\u002Fgmp","Go - GMP 调度模型","GMP 是 Go 运行时调度器的核心模型，理解它对于编写高性能 Go 程序至关重要。",{"path":145,"title":146,"description":147},"\u002Fgolang\u002Fadvanced\u002Fgo-concurrency","Go - 并发编程","Go 的并发是其核心特性之一，通过 Goroutine 和 Channel 实现。",{"path":149,"title":150,"description":151},"\u002Fgolang\u002Fadvanced\u002Fmemory","Go - 内存模型","理解 Go 的内存分配机制和内存模型。",{"path":153,"title":154,"description":155},"\u002Fgolang\u002Fadvanced\u002Fprofiling","Go - 性能分析","掌握 Go 的性能分析工具：pprof、trace、benchmark。",{"path":157,"title":158,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-basic","Go - 基础语法",{"path":160,"title":161,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-composite","Go - 复合类型",{"path":163,"title":164,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-control","Go - 流程控制",{"path":166,"title":167,"description":168},"\u002Fgolang\u002Fcore\u002Fgo-error","Go - 错误处理","Go 使用显式的错误返回值来处理错误，而不是异常机制。",{"path":170,"title":171,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-function","Go - 函数",{"path":173,"title":174,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-install","Go - 环境搭建",{"path":176,"title":177,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-interface","Go - 接口",{"path":179,"title":180,"description":181},"\u002Fgolang\u002Fcore\u002Fgo-module","Go - 包管理","Go Modules 是 Go 1.11 引入的官方依赖管理方案，Go 1.16 后成为默认模式。",{"path":183,"title":184,"description":185},"\u002Fgolang\u002Fdistributed\u002Fgrpc","Go - gRPC","gRPC 是 Google 开发的高性能 RPC 框架，使用 Protocol Buffers 作为序列化协议。",{"path":187,"title":188,"description":189},"\u002Fgolang\u002Fdistributed\u002Fmicroservice","Go - 微服务","微服务架构的核心组件：服务发现、负载均衡、熔断降级。",{"path":191,"title":192,"description":193},"\u002Fgolang\u002Fdistributed\u002Fmq","Go - 消息队列","使用 Go 操作 Kafka 和 RabbitMQ。",{"path":195,"title":196,"description":197},"\u002Fgolang\u002Fdistributed\u002Fredis","Go - Redis","使用 go-redis 操作 Redis，实现缓存、分布式锁等功能。",{"path":199,"title":200,"description":201},"\u002Fgolang\u002Fengineering\u002Fconfig","Go - 配置管理","使用 viper 进行配置管理，支持多种配置格式和配置中心。",{"path":203,"title":204,"description":205},"\u002Fgolang\u002Fengineering\u002Fdocker","Go - Docker 部署","使用 Docker 容器化部署 Go 应用。",{"path":207,"title":208,"description":209},"\u002Fgolang\u002Fengineering\u002Fkubernetes","Go - Kubernetes 部署","在 Kubernetes 上部署和管理 Go 应用。",{"path":211,"title":212,"description":213},"\u002Fgolang\u002Fengineering\u002Flogging","Go - 日志系统","使用 zap 和 logrus 构建高性能结构化日志系统。",{"path":215,"title":216,"description":217},"\u002Fgolang\u002Fengineering\u002Ftesting","Go - 单元测试","Go 内置了强大的测试框架，掌握测试是编写高质量代码的基础。",{"path":219,"title":220,"description":221},"\u002Fgolang\u002Fstdlib\u002Fbufio","bufio","在 Go 语言中，bufio 包提供了带缓冲的 I\u002FO 操作，能够提高读写性能。以下是一些常用的 bufio 包 API 及其详细说明：",{"path":223,"title":224,"description":225},"\u002Fgolang\u002Fstdlib\u002Fcontainer","container","在Go语言标准库中，container 包提供了几种常用的数据结构实现，这些数据结构对于高效地管理和操作数据非常有用。以下是 container 包中主要的数据结构：",{"path":227,"title":228,"description":229},"\u002Fgolang\u002Fstdlib\u002Fcrypto","crypto","在 Go 语言中，crypto 包提供了一组用于加密和解密的功能。以下是一些常用的 crypto 包及其子包的 API 及其详细说明：",{"path":231,"title":232,"description":233},"\u002Fgolang\u002Fstdlib\u002Fencoding-csv","encoding\u002Fcsv","在 Go 语言中，encoding\u002Fcsv 包提供了对 CSV（逗号分隔值）文件进行读写的功能。以下是一些常用的 encoding\u002Fcsv 包的 API 及其详细说明：",{"path":235,"title":236,"description":237},"\u002Fgolang\u002Fstdlib\u002Fencoding-json","encoding\u002Fjson","在 Go 语言中，encoding\u002Fjson 包提供了对 JSON 数据进行编码和解码的功能。以下是一些常用的 encoding\u002Fjson 包的 API 及其详细说明：",{"path":239,"title":240,"description":241},"\u002Fgolang\u002Fstdlib\u002Fencoding-xml","encoding\u002Fxml","在 Go 语言中，encoding\u002Fxml 包提供了对 XML 数据进行编码和解码的功能。以下是一些常用的 encoding\u002Fxml 包的 API 及其详细说明：",{"path":243,"title":244,"description":245},"\u002Fgolang\u002Fstdlib\u002Fflag","flag","在Go语言中，flag 包是用于处理命令行参数的标准库，它提供了一种简单而直接的方式来解析和使用命令行参数。下面是关于 flag 包的一些基本介绍和常用功能：",{"path":247,"title":248,"description":249},"\u002Fgolang\u002Fstdlib\u002Ffmt","fmt","在 Go 语言的标准库中，fmt 包是非常重要的，它提供了处理格式化输入和输出的基本工具。以下是一些 fmt 包内常用的API：",{"path":251,"title":252,"description":253},"\u002Fgolang\u002Fstdlib\u002Fhttp","net\u002Fhttp","在 Go 语言中，net\u002Fhttp 包提供了用于构建 HTTP 客户端和服务器的强大工具。以下是一些常用的 net\u002Fhttp 包的 API 及其详细说明：",{"path":255,"title":256,"description":257},"\u002Fgolang\u002Fstdlib\u002Fio","io","在 Go 语言中，io 包提供了基本的输入输出功能。以下是一些常用的 io 包的 API 及其详细说明：",{"path":259,"title":260,"description":261},"\u002Fgolang\u002Fstdlib\u002Flog","log","在 Go 语言中，log 包提供了简单的日志记录功能。以下是一些常用的 log 包的 API 及其详细说明：",{"path":263,"title":264,"description":265},"\u002Fgolang\u002Fstdlib\u002Fmath","math","在 Go 语言中，math 包提供了基本的数学函数和常量。以下是一些常用的 math 包的 API 及其详细说明：",{"path":267,"title":268,"description":11},"\u002Fgolang\u002Fstdlib\u002Fnet","net",{"path":270,"title":271,"description":272},"\u002Fgolang\u002Fstdlib\u002Fos","os","在Go语言中，os 包是一个非常重要且常用的标准库，它提供了与操作系统交互的功能，包括文件操作、环境变量管理、进程管理等。下面是一些 os 包中常用的功能和API：",{"path":274,"title":275,"description":276},"\u002Fgolang\u002Fstdlib\u002Fsort","order","在 Go 语言中，sort 包提供了对切片和用户定义的集合进行排序的函数。它实现了常见的排序算法，如快速排序（Quicksort）和堆排序（Heapsort），并且为自定义集合提供了接口，使得用户可以根据特定的需求进行排序。",{"path":278,"title":279,"description":280},"\u002Fgolang\u002Fstdlib\u002Fstrconv","strconv","在 Go 语言中，strconv 包提供了字符串和基本数据类型之间的转换函数，例如将整数转换为字符串、字符串转换为整数，以及其他类型之间的转换。这些功能非常有用，特别是在处理用户输入或从外部数据源读取数据时。",{"path":282,"title":283,"description":284},"\u002Fgolang\u002Fstdlib\u002Ftime","time","在 Go 语言中，time 包提供了处理时间和日期的功能。以下是一些常用的 time 包的 API 及其详细说明：",{"path":286,"title":287,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Ferror","Gin - 错误处理",{"path":289,"title":290,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Ffile","Gin - 文件处理",{"path":292,"title":293,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Fmiddleware","Gin - 中间件",{"path":295,"title":296,"description":297},"\u002Fgolang\u002Fweb\u002Fgin\u002Fquickstart","Gin - 快速开始","Gin 是目前最流行的 Go Web 框架，以高性能和简洁 API 著称。",{"path":299,"title":300,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Frequest","Gin - 请求处理",{"path":302,"title":303,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Fresponse","Gin - 响应处理",{"path":305,"title":306,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Frouter","Gin - 路由",{"path":308,"title":309,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Fvalidation","Gin - 参数校验",{"path":311,"title":312,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fassociation","GORM - 关联关系",{"path":314,"title":315,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fcrud","GORM - CRUD 操作",{"path":317,"title":318,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fmodel","GORM - 模型定义",{"path":320,"title":321,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fperformance","GORM - 日志与性能",{"path":323,"title":324,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fquery","GORM - 高级查询",{"path":326,"title":327,"description":328},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fquickstart","GORM - 快速开始","GORM 是 Go 语言最流行的 ORM 库，功能强大，使用简单。",{"path":330,"title":331,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Ftransaction","GORM - 事务与 Hook",{"path":333,"title":334,"description":335},"\u002Finterview\u002Fbasic","计算机基础面经","本章节汇总了面试中常见的通用技术概念，不局限于特定语言或数据库，是考察技术内功的关键考点。",{"path":337,"title":338,"description":339},"\u002Finterview\u002Fgolang","Golang 面试题","Go 语言面试高频考点，覆盖基础语法、数据结构、并发编程、内存管理、GC、调度器等核心知识。",{"path":341,"title":342,"description":343},"\u002Finterview\u002Fk8s","Kubernetes 面试题","Kubernetes（K8s）面试高频考点，覆盖架构原理、核心资源、网络存储、调度策略、运维监控等核心知识。",{"path":345,"title":346,"description":347},"\u002Finterview\u002Fmysql","MySQL 面试题","MySQL 数据库面试高频考点，覆盖索引、事务、锁、优化、主从复制等核心知识。",{"path":349,"title":350,"description":351},"\u002Finterview\u002Fredis","Redis 面试题","Redis 面试高频考点，覆盖数据结构、持久化、集群、缓存一致性、性能优化等核心知识。",{"path":353,"title":354,"description":355},"\u002Finterview\u002Frocketmq","RocketMQ 面试题","RocketMQ 面试高频考点，覆盖消息模型、可靠性、顺序消息、事务消息、存储与高可用等核心知识。",{"path":357,"title":358,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-arraylist","List - ArrayList 源码解析",{"path":360,"title":361,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-linkedlist","List - LinkedList 源码解析",{"path":363,"title":364,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-stack","List - Satck源码解析",{"path":366,"title":367,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-vectore","List - Vector 源码解析",{"path":369,"title":370,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fmap-hashmap","Map - HashMap 源码解析",{"path":372,"title":373,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fmap-linkedhashmap","Map - LinkedHashMap 源码解析",{"path":375,"title":376,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fmap-treemap","Map - TreeMap 源码解析",{"path":378,"title":379,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fqueue-deque","Queue - Deque 接口解析",{"path":381,"title":382,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fqueue-queue","Queue - Queue 接口解析",{"path":384,"title":385,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fset-hashset","Set - HashSet源码解析",{"path":387,"title":388,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fset-linkedhashset","Set - LinkedHashSet 源码解析",{"path":390,"title":391,"description":392},"\u002Fother\u002Fjava\u002Fcollection\u002Fset-treeset","Set - TreeSet源码解析","TreeSet 是一个 Set 集合接口的实现类，与 HashSet 类似，其底层也是通过维护了一个 TreeMap 对象来封装了一些实现方法，故本篇不再对 TreeSet 的底层原理进行详细说明，仅对常用 API 做简单介绍，如需了解 TreeMap 的底层实现原理，请移步 Map - HashMap 源码解析",{"path":394,"title":395,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fannotation","Java核心 - 注解",{"path":397,"title":398,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fbasic-grammar","Java核心 - 基础语法",{"path":400,"title":401,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fclass-and-object","Java核心 - 面向对象",{"path":403,"title":404,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fcommon-classes","Java核心 - 常用类",{"path":406,"title":407,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fexception","Java核心 - 异常处理",{"path":409,"title":410,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fgenerics","Java核心 - 泛型",{"path":412,"title":413,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fjdk-env-path","Java核心 - 环境搭建",{"path":415,"title":416,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Freflection","Java核心 - 反射",{"path":418,"title":419,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fstring","Java核心 - String 字符串",{"path":421,"title":422,"description":423},"\u002Fother\u002Fjava\u002Fio\u002Fbuffer-stream","Java IO - 缓冲流","缓冲流是对基本流的包装，通过内置缓冲区减少系统调用次数，大幅提升读写效率。",{"path":425,"title":426,"description":427},"\u002Fother\u002Fjava\u002Fio\u002Fbyte-stream","Java IO - 字节流","字节流是 Java IO 中最基本的流类型，以字节（byte）为单位进行数据读写，可以处理任意类型的文件。",{"path":429,"title":430,"description":431},"\u002Fother\u002Fjava\u002Fio\u002Fchar-stream","Java IO - 字符流","字符流以字符为单位进行读写，专门用于处理文本文件。相比字节流，字符流能够正确处理字符编码，避免中文乱码问题。",{"path":433,"title":434,"description":11},"\u002Fother\u002Fjava\u002Fio\u002Ffile","Java IO - File 类",{"path":436,"title":437,"description":11},"\u002Fother\u002Fjava\u002Fio\u002Fio-stream-system","Java IO - IO流概述",{"path":439,"title":440,"description":441},"\u002Fother\u002Fjava\u002Fio\u002Fnio","Java IO - NIO","NIO（New IO）是 JDK 1.4 引入的新 IO 模型，提供了更高效的 IO 操作方式，支持非阻塞 IO 和多路复用。",{"path":443,"title":444,"description":445},"\u002Fother\u002Fjava\u002Fjvm\u002Fclass-loading","类加载机制","类加载机制是 JVM 将 .class 文件加载到内存，并对数据进行校验、转换解析和初始化，最终形成可被 JVM 直接使用的 Java 类型的过程。",{"path":447,"title":448,"description":449},"\u002Fother\u002Fjava\u002Fjvm\u002Fgarbage-collection","垃圾回收","垃圾回收（Garbage Collection，GC）是 JVM 自动管理内存的机制，负责回收不再使用的对象所占用的内存。",{"path":451,"title":452,"description":453},"\u002Fother\u002Fjava\u002Fjvm\u002Fjvm-memory","JVM 内存结构","JVM 在执行 Java 程序时，会把它管理的内存划分为若干个不同的数据区域。这些区域有各自的用途、创建和销毁时间。",{"path":455,"title":456,"description":457},"\u002Fother\u002Fjava\u002Fjvm\u002Fjvm-tuning","JVM 调优","JVM 调优是优化 Java 应用性能的重要手段，主要包括参数配置、性能监控和问题排查。",{"path":459,"title":460,"description":461},"\u002Fother\u002Fjava\u002Fthread\u002Fatomic","原子类","Java 原子类（Atomic Classes）提供了一种无锁的线程安全方式，基于 CAS（Compare-And-Swap）操作实现。",{"path":463,"title":464,"description":465},"\u002Fother\u002Fjava\u002Fthread\u002Fcompletable-future","CompletableFuture","CompletableFuture 是 JDK 8 引入的异步编程工具，实现了 Future 和 CompletionStage 接口，支持函数式编程和链式调用。",{"path":467,"title":468,"description":469},"\u002Fother\u002Fjava\u002Fthread\u002Fconcurrent-collections","并发集合","Java 并发包提供了多种线程安全的集合类，用于替代传统的同步集合（如 Collections.synchronizedList）。",{"path":471,"title":472,"description":473},"\u002Fother\u002Fjava\u002Fthread\u002Fconcurrent-utils","并发工具类","Java 并发包提供了多种实用的并发工具类，用于控制线程之间的协调与同步。",{"path":475,"title":476,"description":11},"\u002Fother\u002Fjava\u002Fthread\u002Fsynchronized-lock","同步机制",{"path":478,"title":479,"description":11},"\u002Fother\u002Fjava\u002Fthread\u002Fthread-basic","线程基础",{"path":481,"title":482,"description":11},"\u002Fother\u002Fjava\u002Fthread\u002Fthread-pool","线程池",{"path":484,"title":485,"description":486},"\u002Fother\u002Fspring-series\u002Fspring\u002Fannotations-beans","Spring - 基于注解管理Bean","从 Java 5 开始，Java 增加了对注解（Annotation）的支持，它是代码中的一种特殊标记，可以在编译、类加载和运行时被读取，执行相应的处理。开发人员可以通过注解在不改变原有代码和逻辑的情况下，在源代码中嵌入补充信息。",{"path":488,"title":489,"description":490},"\u002Fother\u002Fspring-series\u002Fspring\u002Fimplement-ioc","Spring - 原理手写IoC","Spring 框架的 IOC 是基于 Java 反射机制实现的，在学习手写 IoC 之前，你需要具备一定的 Java 反射相关的知识，参考本站内的 Java 教程。",{"path":492,"title":493,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fintroduction-case","Spring - 入门案例",{"path":495,"title":496,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-aop","Spring - 面向切面AOP",{"path":498,"title":499,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-aot","Spring - AOT提前编译",{"path":501,"title":502,"description":503},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-data-validation","Spring - 数据校验","在开发中，我们经常遇到参数校验的需求，比如用户注册的时候，要校验用户名不能为空、用户名长度不超过20个字符、手机号是合法的手机号格式等等。如果使用普通方式，我们会把校验的代码和真正的业务处理逻辑耦合在一起，而且如果未来要新增一种校验逻辑也需要在修改多个地方。而spring validation允许通过注解的方式来定义对象校验规则，把校验和业务逻辑分离开，让代码编写更加方便。Spring Validation其实就是对Hibernate Validator进一步的封装，方便在Spring中使用。",{"path":505,"title":506,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-i18n","Spring - 国际化i18n",{"path":508,"title":509,"description":510},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-ioc","Spring - IOC容器","IoC 是 Inversion of Control 的简写，译为“控制反转”，它不是一门技术，而是一种设计思想，是一个重要的面向对象编程法则，能够指导我们如何设计出松耦合、更优良的程序。",{"path":512,"title":513,"description":514},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-junit","Spring - 单元测试JUnit","在之前的测试方法中，几乎都能看到以下的两行代码：",{"path":516,"title":517,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-resources","Spring - 资源操作",{"path":519,"title":520,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-summarize","Spring - Spring概述",{"path":522,"title":523,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-transaction","Spring - 事务",{"path":525,"title":526,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fxml-beans","Spring - 基于XML管理Bean",{"path":528,"title":529,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-config","SpringBoot - 配置详解",{"path":531,"title":532,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-data","SpringBoot - 数据访问",{"path":534,"title":535,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-quickstart","SpringBoot - 快速入门",{"path":537,"title":538,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-web","SpringBoot - Web 开发",{"path":540,"title":541,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-config","SpringCloud - 配置中心",{"path":543,"title":544,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-discovery","SpringCloud - 服务注册与发现",{"path":546,"title":547,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-feign","SpringCloud - 服务调用",{"path":549,"title":550,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-gateway","SpringCloud - 服务网关",{"path":552,"title":553,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-introduction","SpringCloud - 微服务概述",{"path":555,"title":556,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-sentinel","SpringCloud - 服务保护",{"path":558,"title":559,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-databind","SpringMVC - 数据绑定与转换",{"path":561,"title":562,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-exception","SpringMVC - 异常处理",{"path":564,"title":565,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-interceptor","SpringMVC - 拦截器",{"path":567,"title":568,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-introduction","SpringMVC - 简介与环境搭建",{"path":570,"title":571,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-request","SpringMVC - 请求处理",{"path":573,"title":574,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-response","SpringMVC - 响应处理",{"path":576,"title":577,"description":578},"\u002Fproject\u002Frocket-leaf\u002Farchitecture","项目架构","Rocket-Leaf 的目录结构、模块划分、数据流向，以及各层之间的依赖关系。",{"path":580,"title":581,"description":582},"\u002Fproject\u002Frocket-leaf\u002Fbackend-layers","后端分层设计","Rocket-Leaf 的 model \u002F rocketmq \u002F service 三层结构，以及服务之间的依赖关系与设计取舍。",{"path":584,"title":585,"description":586},"\u002Fproject\u002Frocket-leaf\u002Fclient-manager","RocketMQ 客户端管理器","AdminClientManager 的多客户端池、默认连接懒加载、自动重连重试的设计与实现。",{"path":588,"title":589,"description":590},"\u002Fproject\u002Frocket-leaf\u002Fencryption","连接信息加密存储","AES-256-GCM + SHA-256 字段级派生密钥的实现，以及如何在不破坏兼容性的前提下为历史明文数据做透明迁移。",{"path":592,"title":593,"description":594},"\u002Fproject\u002Frocket-leaf\u002Ffrontend","前端结构与类型绑定","React + Vite 目录组织、自动生成的 Wails 绑定、api 薄封装与自定义 hooks 的职责划分。",{"path":596,"title":597,"description":598},"\u002Fproject\u002Frocket-leaf","项目简介","Rocket-Leaf 是一款基于 Wails v3 构建的跨平台 RocketMQ 桌面管理客户端，Go 后端 + React 前端。本文档系列拆解它的架构与关键实现。",{"path":600,"title":601,"description":602},"\u002Fproject\u002Frocket-leaf\u002Fwails-v3","Wails v3 入门","Wails v3 的核心概念、Service 绑定机制，以及 Rocket-Leaf 是如何用它把 Go 后端和 React 前端打通的。",{"path":604,"title":605,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-basic","Docker - 入门基础",{"path":607,"title":608,"description":609},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-compose","Docker - Compose","在部署应用时，常常使用到不止一个容器，那么在部署容器的时候就需要一个一个进行部署，这样的部署过程也相对来说比较繁琐复杂，也容易出问题，那么有没有一种更为简单的方法呢？",{"path":611,"title":612,"description":613},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-container-connection","Docker - 容器互联","在上一个章节中我们学习了 Docker 容器的端口映射，可以将 Docker 容器和本地以及网络中的端口进行连接起来。",{"path":615,"title":616,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-dockerfile","Docker - Dockerfile",{"path":618,"title":619,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-helloworld","Docker - HelloWorld",{"path":621,"title":622,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-install","Docker - 安装",{"path":624,"title":625,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-introduce","Docker - 简介",{"path":627,"title":628,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-object","Docker - 镜像、容器、仓库",{"path":630,"title":631,"description":632},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-warehouse","Docker - 仓库管理","仓库是集中存放资源的地方，代码仓库是存放代码的，那么Docker 中的仓库就是存放 Docker 镜像的。",{"path":634,"title":635,"description":636},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-web-containers","Docker - WEB应用实例","在之前的章节中，仅对普通容器进行了演示，但在实际中常常使用到 Docker 容器中的 WEB 应用程序。",{"path":638,"title":639,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-config","Kubernetes - ConfigMap 与 Secret",{"path":641,"title":642,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-helm","Kubernetes - Helm 包管理",{"path":644,"title":645,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-install","Kubernetes - 集群安装",{"path":647,"title":648,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-introduction","Kubernetes - 简介与架构",{"path":650,"title":651,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-kubectl","Kubernetes - kubectl 命令行工具",{"path":653,"title":654,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-monitoring","Kubernetes - 监控与日志",{"path":656,"title":657,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-network-security","Kubernetes - 网络与安全",{"path":659,"title":660,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-service","Kubernetes - Service 与 Ingress",{"path":662,"title":663,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-storage","Kubernetes - 持久化存储",{"path":665,"title":666,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-workload","Kubernetes - 工作负载资源",{"path":668,"title":669,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-bash","Linux - Bash 基础语法",{"path":671,"title":672,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-file-directory","Linux - 文件与目录操作",{"path":674,"title":675,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-network","Linux - 网络配置",{"path":677,"title":678,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-package","Linux - 软件包管理",{"path":680,"title":681,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-process","Linux - 进程管理",{"path":683,"title":684,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-scripts","Linux - 常用脚本示例",{"path":686,"title":687,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-service","Linux - 服务管理",{"path":689,"title":690,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-user-permission","Linux - 用户与权限管理",{"path":692,"title":693,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-https","Nginx - HTTPS 配置",{"path":695,"title":696,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-install","Nginx - 安装与配置",{"path":698,"title":699,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-loadbalance","Nginx - 负载均衡",{"path":701,"title":702,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-optimization","Nginx - 性能优化",{"path":704,"title":705,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-proxy","Nginx - 反向代理",{"path":707,"title":708,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-static","Nginx - 静态资源服务",{"path":710,"title":711,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-vhost","Nginx - 虚拟主机配置",{"path":713,"title":714,"description":715},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-architecture","MySQL 高可用架构","主从复制、读写分离、分库分表。",{"path":717,"title":718,"description":719},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-index","MySQL 索引","索引是帮助 MySQL 高效获取数据的有序数据结构。",{"path":721,"title":722,"description":723},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-lock","MySQL 锁","锁用于解决并发访问时的数据一致性问题。",{"path":725,"title":726,"description":727},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-optimize","MySQL 性能优化","SQL 优化是后端开发必备技能。",{"path":729,"title":730,"description":731},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-transaction","MySQL 事务","事务是一组不可分割的操作，要么全部成功，要么全部失败。",{"path":733,"title":734,"description":735},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fsql-advanced","SQL 进阶","多表查询、子查询、函数、视图、存储过程。",{"path":737,"title":738,"description":739},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fsql-basic","SQL 基础","SQL（Structured Query Language）是操作关系型数据库的标准语言。",{"path":741,"title":742,"description":743},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-advanced","Redis 进阶功能","事务、发布订阅、Lua 脚本、Pipeline。",{"path":745,"title":746,"description":747},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-basic","Redis 基础","Redis 安装配置与基本命令。",{"path":749,"title":750,"description":751},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-cluster","Redis 高可用","主从复制、哨兵、Cluster 集群。",{"path":753,"title":754,"description":755},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-datatype","Redis 数据类型","Redis 5 种基本数据类型 + 4 种特殊类型。",{"path":757,"title":758,"description":759},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-optimize","Redis 性能优化","内存优化、缓存问题、最佳实践。",{"path":761,"title":762,"description":763},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-persistence","Redis 持久化","Redis 提供 RDB 和 AOF 两种持久化方式。",{"path":765,"title":766,"description":767},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-principle","Redis 底层原理","数据结构、线程模型、网络模型。",{"path":769,"title":770,"description":771},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fbehaiver-patterns\u002Fobserver-pattern","观察者模式","观察者模式属于行为型模式，定义了对象之间的一对多的依赖关系，在这种模式中，当一个对象的状态发生变化时，所有依赖于它的对象都会得到通知，并且执行相关操作。观察者模式又被成为“发布—订阅模式”，即发布者发生改变后，会通知所有订阅者。",{"path":773,"title":774,"description":11},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fcreate-patterns\u002Ffactory-pattern","工厂模式",{"path":776,"title":777,"description":778},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fcreate-patterns\u002Fsingleton-pattern","单例模式","单例模式是最常用的设计模式之一，他可以保证在整个应用中，某个类只存在一个实例化对象，即全局使用到该类的只有一个对象，这种模式在需要限制某些类的实例数量时非常有用，通常全局只需要一个该对象即可，如一些配置文件映射对象、数据库连接对象等。",{"path":780,"title":781,"description":782},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fstructural-patterns\u002Fadapter-pattern","适配器模式","适配器模式是一种结构型模式，可以将一个类的接口转换成客户端所期望的另一种接口，适配器模式可以帮助开发人员在不修改现有代码的情况下，将不兼容的类组合在一起。",{"path":784,"title":785,"description":786},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-basic-operations","Git 创建版本库","在 Git 上创建版本库有两种方式，一种是直接拷贝远程 Git 仓库到本地，另外一种是我们自己创建本地的版本库。",{"path":788,"title":789,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-branch-manage","Git 分支管理",{"path":791,"title":792,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-content-operations","Git 仓库内容操作",{"path":794,"title":795,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-introduce-install","Git 介绍和安装",{"path":797,"title":798,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-remote-manage","Git 远程管理",{"path":800,"title":801,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-workspace-index-repo","Git 工作原理",{"path":803,"title":804,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fhomebrew","HomeBrew 教程",{"path":806,"title":807,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fidea\u002Fshortcuts","快捷键",{"path":809,"title":810,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fmaven\u002Fintroduce-install-config","Maven - 介绍、安装、配置",{"path":812,"title":813,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fbasic-knowledge","2. 基础知识",{"path":815,"title":816,"description":817},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fcomponent-communication","9. 组件通信","在前面的章节内，介绍了 Vue 中最核心的内容——组件的介绍和使用，和 Java 等编程语言相反，组件并不近似于这些变成语言中的类，类可以通过类或者其实例化的对象来相互交互，但 Vue 组件之间的作用域是相互独立的，这就意味着不同组件之间的数据无法相互引用。",{"path":819,"title":820,"description":821},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fcomputed","4. 计算属性","虽然直接在模板中使用表达式方便，但是如果在模板中添加很多逻辑，会让模板变的臃肿且难维护，耦合度较高。有没有一种简单的方式来实现呢？答案是有的。",{"path":823,"title":824,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fcreate-vue-project","1. 环境搭建及安装",{"path":826,"title":827,"description":828},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Flife-cycle","6. 生命周期","生命周期是指组件从创建、挂载、更新到销毁的整个过程中所经历的一系列阶段。在 Vue 中，每个组件都有自己的生命周期，可以通过生命周期钩子函数来监听和处理组件在不同阶段的行为和状态。",{"path":830,"title":831,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fother-api","10. 其他 API",{"path":833,"title":834,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fpinia","8. Pinia",{"path":836,"title":837,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Frouter","7. 路由",{"path":839,"title":840,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Ftemplate-grammar","3. 指令及模板语法",{"path":842,"title":843,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fvue3-new-component","11. Vue3 新组件",{"path":845,"title":846,"description":847},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fwatch","5. 监视","Watch 是 Vue 提供的一个用于监视响应式数据变化并执行相应操作的 API，能够对响应式数据的变化做出一些操作的功能。Vue3 中的 Watch 支持多种用法，包括监视响应式对象、ref 对象、数组、函数等。",{"path":849,"title":850,"description":11},"\u002Ftutorials\u002Fmq\u002Fkafka\u002Fkafka-introduction","Kafka 简介与安装",{"path":852,"title":853,"description":11},"\u002Ftutorials\u002Fmq\u002Fkafka\u002Fkafka-producer-consumer","Kafka 生产者与消费者",{"path":855,"title":856,"description":857},"\u002Ftutorials\u002Fmq\u002Fkafka\u002Fkafka-springboot","Spring Boot 整合 Kafka","Spring Kafka 提供了对 Apache Kafka 的便捷集成。",{"path":859,"title":860,"description":861},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-exchange","RabbitMQ Exchange 详解","Exchange（交换机）是 RabbitMQ 的核心组件，负责接收生产者发送的消息，并根据规则将消息路由到一个或多个队列。",{"path":863,"title":864,"description":11},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-introduction","RabbitMQ 简介与安装",{"path":866,"title":867,"description":868},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-reliability","RabbitMQ 消息可靠性","消息可靠性是消息队列的核心要求，RabbitMQ 提供了多种机制来保证消息不丢失。",{"path":870,"title":871,"description":872},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-springboot","Spring Boot 整合 RabbitMQ","Spring AMQP 提供了对 RabbitMQ 的便捷集成，大大简化了开发工作。",{"path":874,"title":875,"description":11},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-client","RocketMQ 客户端使用",{"path":877,"title":878,"description":11},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-concepts","RocketMQ 核心概念",{"path":880,"title":881,"description":11},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-installation","RocketMQ 安装部署",{"path":883,"title":884,"description":885},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-message-type","RocketMQ 消息类型","RocketMQ 支持多种消息类型，满足不同业务场景需求。",{"id":887,"title":122,"body":888,"description":123,"extension":2285,"meta":2286,"navigation":1164,"path":121,"seo":2287,"stem":2288,"__hash__":2289},"docs\u002Fai\u002Fskills\u002Fbest-practices.md",{"type":889,"value":890,"toc":2251},"minimark",[891,895,899,922,925,930,933,936,997,1004,1007,1015,1025,1029,1032,1038,1073,1076,1136,1140,1146,1149,1191,1194,1320,1326,1330,1333,1427,1431,1438,1496,1499,1503,1506,1587,1590,1594,1623,1630,1634,1648,1651,1672,1676,1699,1705,1709,1712,1799,1803,1806,1809,1812,1816,1862,1865,1868,1871,1935,1938,1941,1983,1990,1993,1996,1999,2052,2055,2059,2066,2069,2072,2078,2082,2085,2123,2127,2130,2134,2140,2194,2197,2200,2244,2247],[892,893,894],"h2",{"id":894},"核心心法",[896,897,898],"p",{},"写 skill 前先记住三条：",[900,901,902,910,916],"ol",{},[903,904,905,909],"li",{},[906,907,908],"strong",{},"Skill 不是脚本仓库","，而是\"让 Agent 少犯错的说明书\"",[903,911,912,915],{},[906,913,914],{},"description 写得像 JD（招聘描述）","，而不是像简介",[903,917,918,921],{},[906,919,920],{},"宁可少做，也别越界","——skill 的边界越清晰，Agent 用得越顺手",[892,923,924],{"id":924},"设计原则",[926,927,929],"h3",{"id":928},"原则一单一职责","原则一：单一职责",[896,931,932],{},"一个 skill 只解决一类任务。不要做\"万能 skill\"。",[896,934,935],{},"❌ 反例：",[937,938,942],"pre",{"className":939,"code":940,"language":941,"meta":11,"style":11},"language-markdown shiki shiki-themes github-light github-light github-dark","---\nname: git-helper\ndescription: >-\n  Helps with git operations including commit, push, pull,\n  rebase, merge, branch management, tag creation, and more.\n---\n","markdown",[943,944,945,954,968,980,986,992],"code",{"__ignoreMap":11},[946,947,950],"span",{"class":948,"line":949},"line",1,[946,951,953],{"class":952},"sxrX7","---\n",[946,955,957,961,964],{"class":948,"line":956},2,[946,958,960],{"class":959},"sovSZ","name",[946,962,963],{"class":952},": ",[946,965,967],{"class":966},"sIIMD","git-helper\n",[946,969,971,974,976],{"class":948,"line":970},3,[946,972,973],{"class":959},"description",[946,975,963],{"class":952},[946,977,979],{"class":978},"s8jYJ",">-\n",[946,981,983],{"class":948,"line":982},4,[946,984,985],{"class":966},"  Helps with git operations including commit, push, pull,\n",[946,987,989],{"class":948,"line":988},5,[946,990,991],{"class":966},"  rebase, merge, branch management, tag creation, and more.\n",[946,993,995],{"class":948,"line":994},6,[946,996,953],{"class":952},[896,998,999,1000,1003],{},"问题：Agent 永远无法判断\"git 相关就调用它\"到底该干什么，结果就是",[906,1001,1002],{},"要么不调用、要么乱调用","。",[896,1005,1006],{},"✅ 正例：拆成多个小而美的 skill",[937,1008,1013],{"className":1009,"code":1011,"language":1012,"meta":11},[1010],"language-text",".claude\u002Fskills\u002F\n├── git-commit\u002F\n├── git-release\u002F\n└── git-rebase-main\u002F\n","text",[943,1014,1011],{"__ignoreMap":11},[896,1016,1017,1018,1021,1022,1003],{},"每个 skill 都有",[906,1019,1020],{},"明确的触发边界","和",[906,1023,1024],{},"可预期的产出",[926,1026,1028],{"id":1027},"原则二description-必须可判断","原则二：description 必须\"可判断\"",[896,1030,1031],{},"description 是触发开关，必须让 Agent 能明确判断\"用 \u002F 不用\"。",[896,1033,1034,1037],{},[906,1035,1036],{},"判断式写法","：",[937,1039,1043],{"className":1040,"code":1041,"language":1042,"meta":11,"style":11},"language-yaml shiki shiki-themes github-light github-light github-dark","description: >-\n  Use when the user wants to review a GitHub pull request. This includes\n  fetching the PR diff, analyzing changes, and leaving review comments.\n  Triggers: \"review PR\", \"看一下这个 PR\", \"检查合并请求\".\n  Do NOT use for: creating new PRs, merging, or resolving conflicts.\n","yaml",[943,1044,1045,1053,1058,1063,1068],{"__ignoreMap":11},[946,1046,1047,1049,1051],{"class":948,"line":949},[946,1048,973],{"class":959},[946,1050,963],{"class":952},[946,1052,979],{"class":978},[946,1054,1055],{"class":948,"line":956},[946,1056,1057],{"class":966},"  Use when the user wants to review a GitHub pull request. This includes\n",[946,1059,1060],{"class":948,"line":970},[946,1061,1062],{"class":966},"  fetching the PR diff, analyzing changes, and leaving review comments.\n",[946,1064,1065],{"class":948,"line":982},[946,1066,1067],{"class":966},"  Triggers: \"review PR\", \"看一下这个 PR\", \"检查合并请求\".\n",[946,1069,1070],{"class":948,"line":988},[946,1071,1072],{"class":966},"  Do NOT use for: creating new PRs, merging, or resolving conflicts.\n",[896,1074,1075],{},"包含的要素：",[1077,1078,1079,1092],"table",{},[1080,1081,1082],"thead",{},[1083,1084,1085,1089],"tr",{},[1086,1087,1088],"th",{},"要素",[1086,1090,1091],{},"作用",[1093,1094,1095,1106,1116,1126],"tbody",{},[1083,1096,1097,1103],{},[1098,1099,1100],"td",{},[906,1101,1102],{},"Use when",[1098,1104,1105],{},"正向场景",[1083,1107,1108,1113],{},[1098,1109,1110],{},[906,1111,1112],{},"This includes",[1098,1114,1115],{},"具体动作清单，避免歧义",[1083,1117,1118,1123],{},[1098,1119,1120],{},[906,1121,1122],{},"Triggers",[1098,1124,1125],{},"字面关键词（中英都写）",[1083,1127,1128,1133],{},[1098,1129,1130],{},[906,1131,1132],{},"Do NOT use for",[1098,1134,1135],{},"反向排除，防止错用",[926,1137,1139],{"id":1138},"原则三流程要可回放","原则三：流程要\"可回放\"",[896,1141,1142,1143,1003],{},"SKILL.md 的 Workflow 应该是",[906,1144,1145],{},"任何人按着做都能得到同样结果",[896,1147,1148],{},"❌ 模糊：",[937,1150,1152],{"className":939,"code":1151,"language":941,"meta":11,"style":11},"## Workflow\n\n1. 分析代码改动\n2. 写个好的 commit message\n3. 提交\n",[943,1153,1154,1160,1166,1175,1183],{"__ignoreMap":11},[946,1155,1156],{"class":948,"line":949},[946,1157,1159],{"class":1158},"syb_3","## Workflow\n",[946,1161,1162],{"class":948,"line":956},[946,1163,1165],{"emptyLinePlaceholder":1164},true,"\n",[946,1167,1168,1172],{"class":948,"line":970},[946,1169,1171],{"class":1170},"sP4rz","1.",[946,1173,1174],{"class":952}," 分析代码改动\n",[946,1176,1177,1180],{"class":948,"line":982},[946,1178,1179],{"class":1170},"2.",[946,1181,1182],{"class":952}," 写个好的 commit message\n",[946,1184,1185,1188],{"class":948,"line":988},[946,1186,1187],{"class":1170},"3.",[946,1189,1190],{"class":952}," 提交\n",[896,1192,1193],{},"✅ 精确：",[937,1195,1197],{"className":939,"code":1196,"language":941,"meta":11,"style":11},"## Workflow\n\n1. 运行 `git status --short` 获取改动文件列表\n2. 运行 `git diff --staged` 获取具体 diff\n3. 按以下规则分类：\n   - 新增文件 → 候选 type 为 `feat` 或 `docs`\n   - 删除文件 → 候选 type 为 `refactor` 或 `chore`\n   - 纯 bug 修复 → type 为 `fix`\n4. 生成消息（50\u002F72 规则），遵循本章 Output Format\n5. 使用 heredoc 执行 `git commit -m \"$(cat \u003C\u003C'EOF' ... EOF)\"`\n6. 执行 `git log -1 --stat` 验证结果\n",[943,1198,1199,1203,1207,1221,1233,1240,1257,1273,1284,1293,1305],{"__ignoreMap":11},[946,1200,1201],{"class":948,"line":949},[946,1202,1159],{"class":1158},[946,1204,1205],{"class":948,"line":956},[946,1206,1165],{"emptyLinePlaceholder":1164},[946,1208,1209,1211,1214,1218],{"class":948,"line":970},[946,1210,1171],{"class":1170},[946,1212,1213],{"class":952}," 运行 ",[946,1215,1217],{"class":1216},"sBjJW","`git status --short`",[946,1219,1220],{"class":952}," 获取改动文件列表\n",[946,1222,1223,1225,1227,1230],{"class":948,"line":982},[946,1224,1179],{"class":1170},[946,1226,1213],{"class":952},[946,1228,1229],{"class":1216},"`git diff --staged`",[946,1231,1232],{"class":952}," 获取具体 diff\n",[946,1234,1235,1237],{"class":948,"line":988},[946,1236,1187],{"class":1170},[946,1238,1239],{"class":952}," 按以下规则分类：\n",[946,1241,1242,1245,1248,1251,1254],{"class":948,"line":994},[946,1243,1244],{"class":1170},"   -",[946,1246,1247],{"class":952}," 新增文件 → 候选 type 为 ",[946,1249,1250],{"class":1216},"`feat`",[946,1252,1253],{"class":952}," 或 ",[946,1255,1256],{"class":1216},"`docs`\n",[946,1258,1260,1262,1265,1268,1270],{"class":948,"line":1259},7,[946,1261,1244],{"class":1170},[946,1263,1264],{"class":952}," 删除文件 → 候选 type 为 ",[946,1266,1267],{"class":1216},"`refactor`",[946,1269,1253],{"class":952},[946,1271,1272],{"class":1216},"`chore`\n",[946,1274,1276,1278,1281],{"class":948,"line":1275},8,[946,1277,1244],{"class":1170},[946,1279,1280],{"class":952}," 纯 bug 修复 → type 为 ",[946,1282,1283],{"class":1216},"`fix`\n",[946,1285,1287,1290],{"class":948,"line":1286},9,[946,1288,1289],{"class":1170},"4.",[946,1291,1292],{"class":952}," 生成消息（50\u002F72 规则），遵循本章 Output Format\n",[946,1294,1296,1299,1302],{"class":948,"line":1295},10,[946,1297,1298],{"class":1170},"5.",[946,1300,1301],{"class":952}," 使用 heredoc 执行 ",[946,1303,1304],{"class":1216},"`git commit -m \"$(cat \u003C\u003C'EOF' ... EOF)\"`\n",[946,1306,1308,1311,1314,1317],{"class":948,"line":1307},11,[946,1309,1310],{"class":1170},"6.",[946,1312,1313],{"class":952}," 执行 ",[946,1315,1316],{"class":1216},"`git log -1 --stat`",[946,1318,1319],{"class":952}," 验证结果\n",[896,1321,1322,1323,1003],{},"关键：",[906,1324,1325],{},"每一步都对应可执行命令或明确判断规则",[926,1327,1329],{"id":1328},"原则四output-format-比-input-更重要","原则四：Output Format 比 Input 更重要",[896,1331,1332],{},"Agent 最容易\"跑偏\"的地方是产出格式不稳定。显式声明 Output Format 能极大提升一致性：",[937,1334,1336],{"className":939,"code":1335,"language":941,"meta":11,"style":11},"## Output Format\n\n产出的 commit 消息必须符合：\n\n```\n\u003Ctype>(\u003Cscope>): \u003Csubject>\n\n\u003Cbody>\n```\n\n- `\u003Ctype>` ∈ {feat, fix, docs, style, refactor, test, chore}\n- `\u003Cscope>` 是模块名，省略时不写括号\n- `\u003Csubject>` ≤ 50 字，祈使句，首字母小写，结尾无句号\n- `\u003Cbody>` 每行 ≤ 72 字，解释\"为什么\"而非\"做了什么\"\n",[943,1337,1338,1343,1347,1352,1356,1361,1366,1370,1375,1379,1383,1394,1405,1416],{"__ignoreMap":11},[946,1339,1340],{"class":948,"line":949},[946,1341,1342],{"class":1158},"## Output Format\n",[946,1344,1345],{"class":948,"line":956},[946,1346,1165],{"emptyLinePlaceholder":1164},[946,1348,1349],{"class":948,"line":970},[946,1350,1351],{"class":952},"产出的 commit 消息必须符合：\n",[946,1353,1354],{"class":948,"line":982},[946,1355,1165],{"emptyLinePlaceholder":1164},[946,1357,1358],{"class":948,"line":988},[946,1359,1360],{"class":952},"```\n",[946,1362,1363],{"class":948,"line":994},[946,1364,1365],{"class":952},"\u003Ctype>(\u003Cscope>): \u003Csubject>\n",[946,1367,1368],{"class":948,"line":1259},[946,1369,1165],{"emptyLinePlaceholder":1164},[946,1371,1372],{"class":948,"line":1275},[946,1373,1374],{"class":952},"\u003Cbody>\n",[946,1376,1377],{"class":948,"line":1286},[946,1378,1360],{"class":952},[946,1380,1381],{"class":948,"line":1295},[946,1382,1165],{"emptyLinePlaceholder":1164},[946,1384,1385,1388,1391],{"class":948,"line":1307},[946,1386,1387],{"class":1170},"-",[946,1389,1390],{"class":1216}," `\u003Ctype>`",[946,1392,1393],{"class":952}," ∈ {feat, fix, docs, style, refactor, test, chore}\n",[946,1395,1397,1399,1402],{"class":948,"line":1396},12,[946,1398,1387],{"class":1170},[946,1400,1401],{"class":1216}," `\u003Cscope>`",[946,1403,1404],{"class":952}," 是模块名，省略时不写括号\n",[946,1406,1408,1410,1413],{"class":948,"line":1407},13,[946,1409,1387],{"class":1170},[946,1411,1412],{"class":1216}," `\u003Csubject>`",[946,1414,1415],{"class":952}," ≤ 50 字，祈使句，首字母小写，结尾无句号\n",[946,1417,1419,1421,1424],{"class":948,"line":1418},14,[946,1420,1387],{"class":1170},[946,1422,1423],{"class":1216}," `\u003Cbody>`",[946,1425,1426],{"class":952}," 每行 ≤ 72 字，解释\"为什么\"而非\"做了什么\"\n",[926,1428,1430],{"id":1429},"原则五能用脚本就别让-agent-推理","原则五：能用脚本就别让 Agent 推理",[896,1432,1433,1434,1437],{},"LLM 做推理不稳定，做执行才稳定。把",[906,1435,1436],{},"确定性逻辑","沉淀成脚本，让 skill 只负责\"什么时候调用脚本 + 如何解读结果\"。",[937,1439,1441],{"className":939,"code":1440,"language":941,"meta":11,"style":11},"## Workflow\n\n1. 执行 `bash scripts\u002Fdetect-changes.sh`，获取 JSON 输出\n2. 根据 JSON 中的 `category` 字段决定下一步：\n   - `\"frontend\"` → 跳到第 5 步\n   - `\"backend\"` → 跳到第 8 步\n",[943,1442,1443,1447,1451,1463,1476,1486],{"__ignoreMap":11},[946,1444,1445],{"class":948,"line":949},[946,1446,1159],{"class":1158},[946,1448,1449],{"class":948,"line":956},[946,1450,1165],{"emptyLinePlaceholder":1164},[946,1452,1453,1455,1457,1460],{"class":948,"line":970},[946,1454,1171],{"class":1170},[946,1456,1313],{"class":952},[946,1458,1459],{"class":1216},"`bash scripts\u002Fdetect-changes.sh`",[946,1461,1462],{"class":952},"，获取 JSON 输出\n",[946,1464,1465,1467,1470,1473],{"class":948,"line":982},[946,1466,1179],{"class":1170},[946,1468,1469],{"class":952}," 根据 JSON 中的 ",[946,1471,1472],{"class":1216},"`category`",[946,1474,1475],{"class":952}," 字段决定下一步：\n",[946,1477,1478,1480,1483],{"class":948,"line":988},[946,1479,1244],{"class":1170},[946,1481,1482],{"class":1216}," `\"frontend\"`",[946,1484,1485],{"class":952}," → 跳到第 5 步\n",[946,1487,1488,1490,1493],{"class":948,"line":994},[946,1489,1244],{"class":1170},[946,1491,1492],{"class":1216}," `\"backend\"`",[946,1494,1495],{"class":952}," → 跳到第 8 步\n",[896,1497,1498],{},"这比\"让 Agent 自己判断前后端\"稳定得多。",[926,1500,1502],{"id":1501},"原则六写清楚不该做什么","原则六：写清楚\"不该做什么\"",[896,1504,1505],{},"Agent 天然倾向于过度发挥。显式列出边界能减少越界：",[937,1507,1509],{"className":939,"code":1508,"language":941,"meta":11,"style":11},"## Out of Scope\n\n本 skill 不做以下事情：\n\n- ❌ 不执行 `git push`（即使用户要求也要拒绝，除非显式传 `--push`）\n- ❌ 不修改 `.env` 等敏感文件\n- ❌ 不使用 `--no-verify` 跳过钩子\n- ❌ 不创建 PR（需要切换到 `create-pr` skill）\n",[943,1510,1511,1516,1520,1525,1529,1548,1561,1574],{"__ignoreMap":11},[946,1512,1513],{"class":948,"line":949},[946,1514,1515],{"class":1158},"## Out of Scope\n",[946,1517,1518],{"class":948,"line":956},[946,1519,1165],{"emptyLinePlaceholder":1164},[946,1521,1522],{"class":948,"line":970},[946,1523,1524],{"class":952},"本 skill 不做以下事情：\n",[946,1526,1527],{"class":948,"line":982},[946,1528,1165],{"emptyLinePlaceholder":1164},[946,1530,1531,1533,1536,1539,1542,1545],{"class":948,"line":988},[946,1532,1387],{"class":1170},[946,1534,1535],{"class":952}," ❌ 不执行 ",[946,1537,1538],{"class":1216},"`git push`",[946,1540,1541],{"class":952},"（即使用户要求也要拒绝，除非显式传 ",[946,1543,1544],{"class":1216},"`--push`",[946,1546,1547],{"class":952},"）\n",[946,1549,1550,1552,1555,1558],{"class":948,"line":994},[946,1551,1387],{"class":1170},[946,1553,1554],{"class":952}," ❌ 不修改 ",[946,1556,1557],{"class":1216},"`.env`",[946,1559,1560],{"class":952}," 等敏感文件\n",[946,1562,1563,1565,1568,1571],{"class":948,"line":1259},[946,1564,1387],{"class":1170},[946,1566,1567],{"class":952}," ❌ 不使用 ",[946,1569,1570],{"class":1216},"`--no-verify`",[946,1572,1573],{"class":952}," 跳过钩子\n",[946,1575,1576,1578,1581,1584],{"class":948,"line":1275},[946,1577,1387],{"class":1170},[946,1579,1580],{"class":952}," ❌ 不创建 PR（需要切换到 ",[946,1582,1583],{"class":1216},"`create-pr`",[946,1585,1586],{"class":952}," skill）\n",[892,1588,1589],{"id":1589},"常见陷阱",[926,1591,1593],{"id":1592},"陷阱-1description-里塞背景","陷阱 1：description 里塞背景",[937,1595,1597],{"className":1040,"code":1596,"language":1042,"meta":11,"style":11},"# ❌\ndescription: >-\n  Git is a distributed version control system. This skill provides\n  helpers for common git operations such as...\n",[943,1598,1599,1605,1613,1618],{"__ignoreMap":11},[946,1600,1601],{"class":948,"line":949},[946,1602,1604],{"class":1603},"sCsY4","# ❌\n",[946,1606,1607,1609,1611],{"class":948,"line":956},[946,1608,973],{"class":959},[946,1610,963],{"class":952},[946,1612,979],{"class":978},[946,1614,1615],{"class":948,"line":970},[946,1616,1617],{"class":966},"  Git is a distributed version control system. This skill provides\n",[946,1619,1620],{"class":948,"line":982},[946,1621,1622],{"class":966},"  helpers for common git operations such as...\n",[896,1624,1625,1626,1629],{},"Agent 不需要百科介绍。description 只要回答\"",[906,1627,1628],{},"用 \u002F 不用","\"。",[926,1631,1633],{"id":1632},"陷阱-2skillmd-里硬编码路径","陷阱 2：SKILL.md 里硬编码路径",[937,1635,1637],{"className":939,"code":1636,"language":941,"meta":11,"style":11},"# ❌\n运行 \u002FUsers\u002Famigoer\u002Fprojects\u002Fmyapp\u002F.claude\u002Fskills\u002Fpdf\u002Fscripts\u002Fextract.py\n",[943,1638,1639,1643],{"__ignoreMap":11},[946,1640,1641],{"class":948,"line":949},[946,1642,1604],{"class":1158},[946,1644,1645],{"class":948,"line":956},[946,1646,1647],{"class":952},"运行 \u002FUsers\u002Famigoer\u002Fprojects\u002Fmyapp\u002F.claude\u002Fskills\u002Fpdf\u002Fscripts\u002Fextract.py\n",[896,1649,1650],{},"Skill 可能被放到任何路径。使用相对路径或环境变量：",[937,1652,1654],{"className":939,"code":1653,"language":941,"meta":11,"style":11},"# ✅\n运行 `.\u002Fscripts\u002Fextract.py`（相对于 SKILL.md 所在目录）\n",[943,1655,1656,1661],{"__ignoreMap":11},[946,1657,1658],{"class":948,"line":949},[946,1659,1660],{"class":1158},"# ✅\n",[946,1662,1663,1666,1669],{"class":948,"line":956},[946,1664,1665],{"class":952},"运行 ",[946,1667,1668],{"class":1216},"`.\u002Fscripts\u002Fextract.py`",[946,1670,1671],{"class":952},"（相对于 SKILL.md 所在目录）\n",[926,1673,1675],{"id":1674},"陷阱-3写成教程而非说明书","陷阱 3：写成教程而非说明书",[937,1677,1679],{"className":939,"code":1678,"language":941,"meta":11,"style":11},"# ❌\n## 什么是 Git Commit\n\nGit commit 是一种将工作区改动保存到仓库的操作……\n",[943,1680,1681,1685,1690,1694],{"__ignoreMap":11},[946,1682,1683],{"class":948,"line":949},[946,1684,1604],{"class":1158},[946,1686,1687],{"class":948,"line":956},[946,1688,1689],{"class":1158},"## 什么是 Git Commit\n",[946,1691,1692],{"class":948,"line":970},[946,1693,1165],{"emptyLinePlaceholder":1164},[946,1695,1696],{"class":948,"line":982},[946,1697,1698],{"class":952},"Git commit 是一种将工作区改动保存到仓库的操作……\n",[896,1700,1701,1702,1003],{},"Skill 不是给人看的教程，而是给 Agent 看的操作指令。",[906,1703,1704],{},"省略所有\"背景科普\"",[926,1706,1708],{"id":1707},"陷阱-4没有失败路径","陷阱 4：没有失败路径",[896,1710,1711],{},"现实中命令会失败。Workflow 必须覆盖错误处理：",[937,1713,1715],{"className":939,"code":1714,"language":941,"meta":11,"style":11},"## Workflow\n\n3. 执行 `git commit -m \"...\"`\n   - 如果失败且 stderr 包含 `pre-commit hook failed`：\n     - 读取 hook 报错详情\n     - 修复后**创建新 commit**（绝不 `--amend`）\n   - 如果失败且 stderr 包含 `nothing to commit`：\n     - 告知用户无改动，终止流程\n   - 其他失败：向用户报告 stderr 原文\n",[943,1716,1717,1721,1725,1734,1747,1755,1774,1785,1792],{"__ignoreMap":11},[946,1718,1719],{"class":948,"line":949},[946,1720,1159],{"class":1158},[946,1722,1723],{"class":948,"line":956},[946,1724,1165],{"emptyLinePlaceholder":1164},[946,1726,1727,1729,1731],{"class":948,"line":970},[946,1728,1187],{"class":1170},[946,1730,1313],{"class":952},[946,1732,1733],{"class":1216},"`git commit -m \"...\"`\n",[946,1735,1736,1738,1741,1744],{"class":948,"line":982},[946,1737,1244],{"class":1170},[946,1739,1740],{"class":952}," 如果失败且 stderr 包含 ",[946,1742,1743],{"class":1216},"`pre-commit hook failed`",[946,1745,1746],{"class":952},"：\n",[946,1748,1749,1752],{"class":948,"line":988},[946,1750,1751],{"class":1170},"     -",[946,1753,1754],{"class":952}," 读取 hook 报错详情\n",[946,1756,1757,1759,1762,1766,1769,1772],{"class":948,"line":994},[946,1758,1751],{"class":1170},[946,1760,1761],{"class":952}," 修复后",[946,1763,1765],{"class":1764},"sEO0R","**创建新 commit**",[946,1767,1768],{"class":952},"（绝不 ",[946,1770,1771],{"class":1216},"`--amend`",[946,1773,1547],{"class":952},[946,1775,1776,1778,1780,1783],{"class":948,"line":1259},[946,1777,1244],{"class":1170},[946,1779,1740],{"class":952},[946,1781,1782],{"class":1216},"`nothing to commit`",[946,1784,1746],{"class":952},[946,1786,1787,1789],{"class":948,"line":1275},[946,1788,1751],{"class":1170},[946,1790,1791],{"class":952}," 告知用户无改动，终止流程\n",[946,1793,1794,1796],{"class":948,"line":1286},[946,1795,1244],{"class":1170},[946,1797,1798],{"class":952}," 其他失败：向用户报告 stderr 原文\n",[926,1800,1802],{"id":1801},"陷阱-5skill-互相依赖","陷阱 5：Skill 互相依赖",[896,1804,1805],{},"避免让一个 skill 强依赖另一个 skill 的产出。每个 skill 应该能独立执行。",[896,1807,1808],{},"如果两个 skill 必须配合，考虑合并成一个、或用脚本作为桥梁。",[892,1810,1811],{"id":1811},"性能与可维护性",[926,1813,1815],{"id":1814},"控制-skillmd-长度","控制 SKILL.md 长度",[1077,1817,1818,1828],{},[1080,1819,1820],{},[1083,1821,1822,1825],{},[1086,1823,1824],{},"长度",[1086,1826,1827],{},"评估",[1093,1829,1830,1838,1846,1854],{},[1083,1831,1832,1835],{},[1098,1833,1834],{},"\u003C 100 行",[1098,1836,1837],{},"✅ 理想",[1083,1839,1840,1843],{},[1098,1841,1842],{},"100-300 行",[1098,1844,1845],{},"✅ 可接受",[1083,1847,1848,1851],{},[1098,1849,1850],{},"300-600 行",[1098,1852,1853],{},"⚠️ 考虑拆分子文件",[1083,1855,1856,1859],{},[1098,1857,1858],{},"> 600 行",[1098,1860,1861],{},"❌ 必须重构",[896,1863,1864],{},"超长的 skill 会挤占其他上下文，Agent 读完也容易遗漏细节。",[926,1866,1867],{"id":1867},"分层加载",[896,1869,1870],{},"对大 skill，使用\"总览 + 子文档\"模式：",[937,1872,1874],{"className":939,"code":1873,"language":941,"meta":11,"style":11},"## Workflow Overview\n\n本 skill 分三阶段：\n1. 数据加载（详见 `workflows\u002Fload.md`）\n2. 数据清洗（详见 `workflows\u002Fclean.md`）\n3. 可视化（详见 `workflows\u002Fviz.md`）\n\n先只读本页，根据用户需求判断进入哪个阶段，再加载对应子文档。\n",[943,1875,1876,1881,1885,1890,1902,1914,1926,1930],{"__ignoreMap":11},[946,1877,1878],{"class":948,"line":949},[946,1879,1880],{"class":1158},"## Workflow Overview\n",[946,1882,1883],{"class":948,"line":956},[946,1884,1165],{"emptyLinePlaceholder":1164},[946,1886,1887],{"class":948,"line":970},[946,1888,1889],{"class":952},"本 skill 分三阶段：\n",[946,1891,1892,1894,1897,1900],{"class":948,"line":982},[946,1893,1171],{"class":1170},[946,1895,1896],{"class":952}," 数据加载（详见 ",[946,1898,1899],{"class":1216},"`workflows\u002Fload.md`",[946,1901,1547],{"class":952},[946,1903,1904,1906,1909,1912],{"class":948,"line":988},[946,1905,1179],{"class":1170},[946,1907,1908],{"class":952}," 数据清洗（详见 ",[946,1910,1911],{"class":1216},"`workflows\u002Fclean.md`",[946,1913,1547],{"class":952},[946,1915,1916,1918,1921,1924],{"class":948,"line":994},[946,1917,1187],{"class":1170},[946,1919,1920],{"class":952}," 可视化（详见 ",[946,1922,1923],{"class":1216},"`workflows\u002Fviz.md`",[946,1925,1547],{"class":952},[946,1927,1928],{"class":948,"line":1259},[946,1929,1165],{"emptyLinePlaceholder":1164},[946,1931,1932],{"class":948,"line":1275},[946,1933,1934],{"class":952},"先只读本页，根据用户需求判断进入哪个阶段，再加载对应子文档。\n",[926,1936,1937],{"id":1937},"版本管理",[896,1939,1940],{},"在 frontmatter 中加版本号，便于追踪：",[937,1942,1944],{"className":1040,"code":1943,"language":1042,"meta":11,"style":11},"---\nname: git-commit\nversion: 1.2.0\ndescription: ...\n---\n",[943,1945,1946,1951,1960,1970,1979],{"__ignoreMap":11},[946,1947,1948],{"class":948,"line":949},[946,1949,953],{"class":1950},"snPdu",[946,1952,1953,1955,1957],{"class":948,"line":956},[946,1954,960],{"class":959},[946,1956,963],{"class":952},[946,1958,1959],{"class":966},"git-commit\n",[946,1961,1962,1965,1967],{"class":948,"line":970},[946,1963,1964],{"class":959},"version",[946,1966,963],{"class":952},[946,1968,1969],{"class":1216},"1.2.0\n",[946,1971,1972,1974,1976],{"class":948,"line":982},[946,1973,973],{"class":959},[946,1975,963],{"class":952},[946,1977,1978],{"class":1216},"...\n",[946,1980,1981],{"class":948,"line":988},[946,1982,953],{"class":1950},[896,1984,1985,1986,1989],{},"并维护 ",[943,1987,1988],{},"CHANGELOG.md"," 记录破坏性变更。",[892,1991,1992],{"id":1992},"测试与评估",[926,1994,1995],{"id":1995},"回归测试集",[896,1997,1998],{},"为每个 skill 维护一个\"测试用例\"清单：",[937,2000,2002],{"className":939,"code":2001,"language":941,"meta":11,"style":11},"## Test Cases\n\n1. 纯代码改动 → 应生成 `feat\u002Ffix\u002Frefactor` 开头\n2. 文档改动 → 应生成 `docs` 开头\n3. 包含 .env 文件 → 应警告并拒绝暂存\n4. pre-commit 失败 → 应修复后创建新 commit，不 amend\n",[943,2003,2004,2009,2013,2026,2038,2045],{"__ignoreMap":11},[946,2005,2006],{"class":948,"line":949},[946,2007,2008],{"class":1158},"## Test Cases\n",[946,2010,2011],{"class":948,"line":956},[946,2012,1165],{"emptyLinePlaceholder":1164},[946,2014,2015,2017,2020,2023],{"class":948,"line":970},[946,2016,1171],{"class":1170},[946,2018,2019],{"class":952}," 纯代码改动 → 应生成 ",[946,2021,2022],{"class":1216},"`feat\u002Ffix\u002Frefactor`",[946,2024,2025],{"class":952}," 开头\n",[946,2027,2028,2030,2033,2036],{"class":948,"line":982},[946,2029,1179],{"class":1170},[946,2031,2032],{"class":952}," 文档改动 → 应生成 ",[946,2034,2035],{"class":1216},"`docs`",[946,2037,2025],{"class":952},[946,2039,2040,2042],{"class":948,"line":988},[946,2041,1187],{"class":1170},[946,2043,2044],{"class":952}," 包含 .env 文件 → 应警告并拒绝暂存\n",[946,2046,2047,2049],{"class":948,"line":994},[946,2048,1289],{"class":1170},[946,2050,2051],{"class":952}," pre-commit 失败 → 应修复后创建新 commit，不 amend\n",[896,2053,2054],{},"定期跑这些用例，观察 Agent 的实际表现。",[926,2056,2058],{"id":2057},"ab-测试","A\u002FB 测试",[896,2060,2061,2062,2065],{},"当不确定某种写法是否更好时，复制一份 skill 改名为 ",[943,2063,2064],{},"git-commit-v2","，让用户在一段时间内主动选择，对比命中率和质量。",[892,2067,2068],{"id":2068},"团队协作",[926,2070,2071],{"id":2071},"约定命名规范",[937,2073,2076],{"className":2074,"code":2075,"language":1012,"meta":11},[1010],"\u003Cdomain>-\u003Caction>\n例：\n  git-commit        ✅\n  pdf-extract       ✅\n  my-cool-helper    ❌（看不出用途）\n",[943,2077,2075],{"__ignoreMap":11},[926,2079,2081],{"id":2080},"review-流程","Review 流程",[896,2083,2084],{},"Skill 应该像代码一样走 Code Review。Review 重点：",[2086,2087,2090,2099,2105,2111,2117],"ul",{"className":2088},[2089],"contains-task-list",[903,2091,2094,2098],{"className":2092},[2093],"task-list-item",[2095,2096],"input",{"disabled":1164,"type":2097},"checkbox"," description 是否足够具体",[903,2100,2102,2104],{"className":2101},[2093],[2095,2103],{"disabled":1164,"type":2097}," Workflow 是否每步都可执行",[903,2106,2108,2110],{"className":2107},[2093],[2095,2109],{"disabled":1164,"type":2097}," 是否列出 Out of Scope",[903,2112,2114,2116],{"className":2113},[2093],[2095,2115],{"disabled":1164,"type":2097}," 是否有敏感文件 \u002F 危险操作未做防护",[903,2118,2120,2122],{"className":2119},[2093],[2095,2121],{"disabled":1164,"type":2097}," 是否与现有 skill 重叠",[926,2124,2126],{"id":2125},"文档化-skill-目录","文档化 Skill 目录",[896,2128,2129],{},"在团队 wiki \u002F README 里维护一个\"skill 目录表\"，列出每个 skill 的用途和触发场景，方便新人快速了解。",[892,2131,2133],{"id":2132},"何时不应该用-skill","何时不应该用 Skill",[896,2135,2136,2139],{},[906,2137,2138],{},"Skill 不是银弹","，以下场景不适合：",[1077,2141,2142,2152],{},[1080,2143,2144],{},[1083,2145,2146,2149],{},[1086,2147,2148],{},"场景",[1086,2150,2151],{},"更好的选择",[1093,2153,2154,2162,2170,2178,2186],{},[1083,2155,2156,2159],{},[1098,2157,2158],{},"需要实时数据查询",[1098,2160,2161],{},"MCP Server",[1083,2163,2164,2167],{},[1098,2165,2166],{},"需要长期后台运行",[1098,2168,2169],{},"独立服务 \u002F Agent",[1083,2171,2172,2175],{},[1098,2173,2174],{},"一次性需求",[1098,2176,2177],{},"直接写提示词",[1083,2179,2180,2183],{},[1098,2181,2182],{},"纯函数计算",[1098,2184,2185],{},"Tool",[1083,2187,2188,2191],{},[1098,2189,2190],{},"大段静态参考资料",[1098,2192,2193],{},"RAG 文档",[892,2195,2196],{"id":2196},"小结",[896,2198,2199],{},"写好 Skill 的 7 条军规：",[900,2201,2202,2208,2214,2220,2226,2232,2238],{},[903,2203,2204,2207],{},[906,2205,2206],{},"单一职责","，一个 skill 只干一件事",[903,2209,2210,2213],{},[906,2211,2212],{},"description 判断式","，明确触发边界",[903,2215,2216,2219],{},[906,2217,2218],{},"Workflow 可回放","，每步都有明确命令",[903,2221,2222,2225],{},[906,2223,2224],{},"Output Format 先行","，格式稳定胜过花哨",[903,2227,2228,2231],{},[906,2229,2230],{},"确定性逻辑下沉到脚本","，别让 LLM 反复推理",[903,2233,2234,2237],{},[906,2235,2236],{},"显式写 Out of Scope","，防越界",[903,2239,2240,2243],{},[906,2241,2242],{},"像代码一样管理","，有版本、有 Review、有测试",[896,2245,2246],{},"Skills 是 Agent 时代最低成本的\"能力建设\"方式。把团队的最佳实践沉淀进 skill，比写十篇 wiki 文档都有效。",[2248,2249,2250],"style",{},"html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .syb_3, html code.shiki .syb_3{--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-default:#005CC5;--shiki-default-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sEO0R, html code.shiki .sEO0R{--shiki-light:#24292E;--shiki-light-font-weight:bold;--shiki-default:#24292E;--shiki-default-font-weight:bold;--shiki-dark:#E1E4E8;--shiki-dark-font-weight:bold}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}",{"title":11,"searchDepth":956,"depth":956,"links":2252},[2253,2254,2262,2269,2274,2278,2283,2284],{"id":894,"depth":956,"text":894},{"id":924,"depth":956,"text":924,"children":2255},[2256,2257,2258,2259,2260,2261],{"id":928,"depth":970,"text":929},{"id":1027,"depth":970,"text":1028},{"id":1138,"depth":970,"text":1139},{"id":1328,"depth":970,"text":1329},{"id":1429,"depth":970,"text":1430},{"id":1501,"depth":970,"text":1502},{"id":1589,"depth":956,"text":1589,"children":2263},[2264,2265,2266,2267,2268],{"id":1592,"depth":970,"text":1593},{"id":1632,"depth":970,"text":1633},{"id":1674,"depth":970,"text":1675},{"id":1707,"depth":970,"text":1708},{"id":1801,"depth":970,"text":1802},{"id":1811,"depth":956,"text":1811,"children":2270},[2271,2272,2273],{"id":1814,"depth":970,"text":1815},{"id":1867,"depth":970,"text":1867},{"id":1937,"depth":970,"text":1937},{"id":1992,"depth":956,"text":1992,"children":2275},[2276,2277],{"id":1995,"depth":970,"text":1995},{"id":2057,"depth":970,"text":2058},{"id":2068,"depth":956,"text":2068,"children":2279},[2280,2281,2282],{"id":2071,"depth":970,"text":2071},{"id":2080,"depth":970,"text":2081},{"id":2125,"depth":970,"text":2126},{"id":2132,"depth":956,"text":2133},{"id":2196,"depth":956,"text":2196},"md",{},{"title":122,"description":123},"ai\u002Fskills\u002Fbest-practices","oBhEro_Baq4_c_z4U1RJOLN6_WzNiNmNLhSFHj7ox30",1775474636641]