让AI给代码写导游词:code-tour 五分钟生成可交互代码导览

刚接手一个 3 万行代码库,README 写得很烂,恨不得把前任拉回来对着干?别急,有了这个 Skill,你可以让 AI 花 5 分钟给你生成一条专业导览路线,比看三个月代码还有用。

是什么

code-tour 来自 AI 技能库 borghei/Claude-Skills(GitHub 762 ⭐),是专门解决”代码考古”难题的技能。它让 AI 根据真实代码结构生成 CodeTour 格式的导览文件,锚定到具体文件和行号,支持 20 种开发者角色视角——新人入职、PR 审查、架构评审、Bug 溯源……各有各的导览模板。

为什么比你自己读代码强

普通人读代码是”看到哪算哪”,code-tour 生成的是结构化叙事——先讲系统要解决什么问题,再按调用链路一步步走下去,告诉你每个模块的职责、为什么这么设计、踩过的坑在哪里。导览文件还能直接在 VS Code 的 CodeTour 插件里打开,走一步看一步,跟导游带队观光一样。

怎么用

安装方式很灵活:

  • Claude Code 用户:直接跑 /plugin marketplace add borghei/Claude-Skills && /plugin install claude-skills@borghei/Claude-Skills
  • CLI 安装:npx @borghei/claude-skills add code-tour
  • 手动安装:clone 整个仓库,把 skills/code-tour 目录拷到你的 .claude/skills/ 下

装完之后,只要说”给我生成一个新人入职导览”,或者”为这个 PR 写一个 code tour”,AI 就会自动分析代码结构,生成带行号锚点的 .tour 文件。

支持哪些场景

  • 新工程师入职,30 分钟搞懂系统架构
  • Code Review 时附上一条导览,让 reviewer 快速定位改动上下文
  • 安全审计,按敏感数据流逐步检查
  • Bug 溯源,按调用链生成 RCA 导览
  • 系统重构前,先导览现有实现再做决策

值不值得装

如果你经常需要向别人解释代码,或者经常接手遗留系统,code-tour 是那种装上就回不去的技能。尤其是团队里有新人入职或者跨团队协作场景,它能把”三个月摸索”压缩到”半小时导览”。免费、开源、支持多 AI 平台(Claude Code、Cursor、Codex 等),值得一试。

GitHub:https://github.com/borghei/Claude-Skills


GitHub: https://github.com/borghei/Claude-Skills

评论区

0 条评论

登录后可评论。

拾遗·Skill精选官 453 阅读