本技能面向 unix-goto shell 导航系统的开发,提供从架构理解到功能提交的完整开发指导。unix-goto 是一个高性能 Unix 目录导航系统,其设计遵循五项核心原则:简单(单行 source goto.sh 加载)、快速(缓存导航低于 100ms)、精简(无冗余依赖)、可测试(核心功能 100% 测试覆盖)、文档完善。
【用途】 当需要为 unix-goto 开发新功能、实现基于缓存的导航优化、添加书签/历史/导航命令、按标准九步流程新增功能、编写测试套件、优化性能以达成目标、为 shell 模块创建 API 文档,或调试导航与缓存问题时使用本技能。资料明确说明,通用 bash 脚本、非导航类 shell 工具、无性能要求的项目、简单一次性 shell 脚本不适用本技能。
【系统架构】 用户界面层包含 goto、bookmark、recent、back、goto list、goto benchmark 等命令;核心导航层由 goto-function.sh 负责主路由与路径解析;其下分三大子系统:缓存系统(cache-index.sh,O(1) 查找与自动刷新)、书签系统(bookmark-command.sh,增删)、历史系统(history-tracking.sh,记录访问)。模块有严格的加载顺序依赖:先加载无依赖模块(history-tracking.sh、bookmark-command.sh、cache-index.sh 等),back-command.sh 与 recent-command.sh 依赖 history-tracking.sh,list-command.sh 依赖 bookmark-command.sh,benchmark-command.sh 依赖 cache-index.sh,主 goto-function.sh 最后加载并依赖以上全部。
【主要能力】 资料提供了缓存系统、书签系统、历史追踪三大子系统的架构说明。缓存系统实现 O(1) 文件夹查找,包含索引构建、查找、基于 TTL 的有效性校验,缓存文件为自定义格式并记录构建时间、深度等信息;书签存储在 ~/.goto_bookmarks,支持添加、删除、O(1) 检索与跳转,查看 usages 有 bookmark add/remove 与 goto @name;历史存储在 ~/.goto_history,自动裁剪(最多 100 条),支持 recent 查看去重后的近期目录与 back 回退。导航数据流按特殊命令、多级路径、缓存查找、搜索路径直接匹配、递归搜索(最大深度 3)、自然语言解析的顺序逐级处理。
【性能指标】 资料列出的目标与实测值包括:缓存导航目标 <100ms(实测 26ms)、缓存命中率目标 >90%(实测 92-95%)、加速比目标 20-50x(实测 8x,标注为进行中)、测试覆盖 100%(已达成)、缓存构建目标 <5s(实测 3-5s)。这些均为该技能资料中给出的项目数值。
【使用方式:九步功能开发流程】 资料定义的标准流程为:1. 规划功能(回答解决的问题、接口、性能、依赖、测试、文档六问);2. 创建模块(提供模块模板与函数命名/变量/环境变量默认值/返回码约定,返回码 0 成功、1 一般错误、2 多匹配);3. 加入加载器(按依赖顺序 source);4. 在主函数 goto 中做命令路由集成;5. 编写测试(要求 100% 覆盖,包含单元、集成、边界、性能四类,并给出测试模板与计数器写法);6. 在 docs/API.md 中记录 API;7. 更新 README.md 用户文档;8. 性能验证(如 goto benchmark);9. 更新 Linear 议题并按约定格式提交(feat/fix/perf/refactor/test/docs/chore 类型),提交信息中包含性能指标与测试结果,并附 Claude Code 生成署名。资料还给出提交前的功能检查清单。
【适用场景与限制】 技能以 unix-goto 项目为中心,示例包含 CET-77(recent 目录)与 CET-85(benchmark 套件)等功能开发的完整分步演示,可参考其模式新增功能。限制方面:资料明确列出不适用于通用 bash 脚本、非导航 shell 工具、无性能要求项目及一次性脚本;原文引用的 GitHub 仓库链接、URL 等被资料截断(示例代码末尾不完整),实际使用应以完整仓库为准。除上述内容外,本技能的具体安装命令、收费信息、支持平台等事实资料未提供。