SuperAPI AI 工具集

global-projects

通用与其它

查看项目

更新于 10-15 23:59

技能介绍

用途:当需要查看当前代码库之外的源码,或用户给出 <owner-name>/<repo-name> 形式的 GitHub 仓库标识时,使用该技能按统一目录标准管理项目。项目 CLI 可能装为 moi(优先)或 mo,下文以 mo 为例,实际按解析器选择结果替换。

标准布局:<rootPath>/<github-owner-or-org>/<repo>,例如 ~/code/vuejs/core、~/code/vitejs/vite、~/code/liangmiQwQ/mo。

第一步:技能加载不会自动执行命令。需要项目根路径时,先选择 CLI 并运行其配套解析器:若存在 moi-get-root 则用它,否则用 mo-get-root,两者都没有则提示先安装 @liangmi/moi 或 @liangmi/mo。解析器只读取 ~/.config/morc.json 并输出含 rootPath 的 JSON;若缺少 rootPath,应先询问用户,可能需要运行 moi setup 或 mo setup。后续任务使用与解析器配对的命令,不能仅凭 mo 命令判断 CLI,因为该名称可能被其他工具占用。

路径推断:GitHub 标识 owner/repo 直接拼接为 <rootPath>/owner/repo;GitHub URL 如 https://github.com/vitejs/vite 转为 <rootPath>/vitejs/vite,git@github.com:vuejs/core.git 转为 <rootPath>/vuejs/core;裸项目名或模糊查询时,运行所选 CLI 的列表命令或查看 rootPath 下一层,优先精确匹配 repo 名,用户给了 owner 时优先精确匹配 owner/repo,多个 owner 匹配则询问用户。

CLI 用法:mo list 发现已管理仓库;mo clone <owner>/<repo> 在尚未存在于 <rootPath>/<owner>/<repo> 时克隆并保留 owner/repo 布局;mo init 仅在用户明确要求创建或初始化项目时使用,需提供 --public 或 --private 之一,它会改变远端 GitHub 状态,属危险命令;mo fork 仅在用户明确要求 fork 时使用,如 mo fork vitejs/vite 或加 --org、--name,同样改变远端状态,不要为检查、编辑、测试、克隆或便利而 fork,且含需回答的提示。

工作规范:先在 rootPath 下搜索再大范围扫描文件系统;克隆时保留 <owner>/<repo> 结构;除非用户要求,不在 rootPath 外创建项目目录;跨项目状态更新中同时给出 owner 与 repo;已知本地路径后,普通文件读取、编辑、构建和测试使用常规 shell 与编辑器工具。限制:代码库可能不是最新甚至不在主分支,需自行设法确认。