Agent Skills
返回列表
🤖

出海助手-代码路径导航

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 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 的贡献者,短期内要找到功能实现文件以提交小而准的补丁