让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
评论区
0 条评论
登录后可评论。