出海助手-代码路径导航
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9c953624/yimubiao-wayfinder。
技能介绍
要解决什么问题
接手别人的仓库、赶在一次 PR 里改对地方,最常见的卡点不是「不会写代码」,而是不知道能力落在哪些文件、调用从哪条链路过、改一行会牵动哪一层。全库 grep 能搜到字符串,却很难回答「这个功能是从哪里被触发的」或「这次重构该从哪个入口下刀」。
本技能面向这类路径不清的场景:你手里只有一个模糊目标(要改的行为、要找的实现),需要一份可执行的导航,而不是直接替你改完业务代码。
技能如何工作
技能脱胎于开源 wayfinder(Matt Pocock),在仓库侧以决策与探路为主:先澄清你要抵达的「目的地」(规格、决策或具体改动),再逐步把未知收成可讨论的问题,而不是默认进入大面积实现。
对你来说,使用方式很直接:
- 用自然语言说明想找的能力或想改的行为(例如某接口的鉴权、某配置项的读取链)。
- 技能结合仓库上下文,给出相关文件、路径级指引,并帮助你串起调用关系与改动入口。
- 若任务体量超出单次对话,会按 wayfinder 的思路把剩余未知留在「待细化」侧,优先处理当前能下定论的决策点(与 issue 地图、子工单类型如 research / prototype / grilling / task 等机制一致,具体取决于当前环境的 tracker 配置)。
核心取向是 Plan, don't do:默认产出的是「下一步该弄清什么、改从哪里进」,只有把范围收敛到可交付时,才适合交给实现会话接手。
适用边界与注意点
- 依赖外部服务或凭证的能力,需先完成授权与配置,否则探路会卡在事实缺失上。
- 本文为中文出海使用说明的本地化版本,术语上可能保留
Shopify、GA4等英文专名;专业含义以原文档为准。 - 技能擅长导航与决策切片,不替代你本地的构建、测试与上线流程;若仓库未提供 issue tracker,行为会回退到文档中描述的 local-markdown 等默认方式。
使用场景
- 刚接手跨境或出海业务仓库,需要在不改业务的前提下弄清支付回调写在哪些目录
- 产品要求调整某一用户可见行为,你要先找出 UI、接口与服务层的改动入口再评估影响
- 线上问题怀疑配置读取链有误,需要沿着配置加载与引用路径定位具体文件
- 准备做一次局部重构,想确认某能力从路由到数据层的完整调用链再下 PR
适合人员
- 负责出海/跨境代码交付的后端工程师,常要在陌生单体或微服务仓库里快速摸清改动面
- 牵头一次需求改动的 Tech Lead,需要在排期前把「改哪里、会牵多少模块」说清楚
- 维护多仓库 SRE 或平台同学,排查异常时要沿配置与调用链定位责任代码而非盲目搜关键字
- 接手开源或内源 fork 的贡献者,短期内要找到功能实现文件以提交小而准的补丁