技能介绍

你在读什么

README 能告诉你「怎么用」，但很难让你看清一条调用链或一种设计机制是怎么串起来的。你想搞懂某个库、CLI、Agent 循环或中间件管线，却不想把整个仓库啃一遍，也不想只拿到一段口头总结——你需要的是能跑起来、能对照源码的 teaching artifact。

技能会怎么做

repo-mini-practice 的目标不是复述每个文件，而是选定一个高价值机制（例如路由匹配、重试调度、tool-calling 循环、插件加载），在目标仓库里新建或更新 mini-practice/ 目录，用最小可运行的 demo、测试或命令把这条机制复现出来。

典型流程包括：确认目标路径或 GitHub 地址 → 读 README、manifest、入口与示例 → 用搜索定位核心模块与主调用链 → 说明将复现什么、mock 或省略什么（数据库、模型 API、队列等）→ 编写带函数级注释的实现（注释语言跟随你的提问语言）→ 实际运行验证 → 在 mini-practice/README.md 写中英双语学习指南（默认双语）：核心机制、运行命令、阅读顺序、与源码概念的对应关系、2～3 个小练习。

适用边界

适合：想「通过最小复现学原理」、要 VIP/MVP/迷你克隆/源码学习版等表述时。
不适合：普通 code review、修 bug、做功能，除非你的目标明确是学习向的最小再现。
原则：不动原仓除 mini-practice/ 外的内容；已有 mini-practice/ 会先检查再改，避免覆盖你的作业；一条完整核心循环优于堆很多半吊子特性。

截图预览

使用场景

接手陌生开源 CLI 或 SDK，需要在改业务代码前先跑通一条「入口→核心模块→回调」的最小调用链并对照原文件。
想搞懂某 Agent/编译工具里的单点机制（如 tool-calling 循环、parser 链），要求在目标仓内产出可执行的 `mini-practice/` 而非口头总结。
准备团队内部分享或 onboarding，需从真实仓库抽出中间件管线、路由匹配或重试调度之一，做成带练习题的练手目录。
外部依赖（数据库、模型 API、消息队列）阻断了本地阅读，需要用 mock 保留核心逻辑流并完成运行验证与学习指南。