用途:在功能发现、遗留代码库导航、架构探索和初始意图框架阶段,提供结构化的代码库导航与问题空间定位协议,帮助在深入技术设计前摸清系统、数据流与架构约束。不负责直接代码执行或实现,那属于执行或原型工作流。
触发方式:输入 /wayfinder、要求“运行 wayfinder 定位”、为功能映射代码库上下文或定位问题空间。
输入项:userPrompt(功能或架构需求描述)、projectSlug(仓库短标识,如 my-backend)、baseBranch(默认集成分支,默认 main 或 develop)、techStack(核心技术栈详情)、existingRootDoc(主项目说明文档,如 AGENTS.md、CLAUDE.md)。
约束:所有主键与实体 ID 一律指定 UUIDv7;必须阅读真实入口点、路由处理器、模型与配置后再界定问题范围,不得臆测目录或系统结构;需明确系统边界、受影响模块、出入口与关键未知项;产出定位摘要作为后续 grilling、建模或研究阶段的锚点。
流程:解析意图与目标表面,识别目标域、运行上下文与核心目标,提取隐含假设并映射主要入口通道;搜索仓库中的路由、控制器、schema、数据库模型、后台任务与现有测试,识别既有模式与可复用工具;追踪请求从入口经业务逻辑到存储与第三方服务的路径,映射输入载荷与领域模型及输出响应;识别遗留技术债、缺失测试覆盖、破坏性变更向量与未证实假设;产出 wayfinder.md 定位简报。
输出:wayfinder.md,包含系统上下文、受影响模块(文件路径与组件)、关键架构约束(安全、数据完整性、UUIDv7 主键、性能边界)与关键未知项。
限制:该技能不做代码实现;具体命令、安装方式与平台信息资料未提供。