SuperAPI AI 工具集

cofounder-pre-flight-check

通用与其它

查看项目

更新于 10-16 00:01

技能介绍

用途:这是每次会话开始时最先调用的技能,用于验证当前环境是否适合项目工作,也可在用户要求“检查我的环境”“运行预检”“验证配置”时使用。

主要能力:技能内置 scripts/preflight.sh,需从技能自身所在目录解析路径并执行:bash <this-skill-dir>/scripts/preflight.sh。成功时退出码 0 并输出 PREFLIGHT_PASSED;失败时退出码 1,输出 PREFLIGHT_FAILED 及错误行。

检查条件:一、不得在用户主目录运行;失败时建议先创建并进入项目子目录,例如 mkdir ~/my-project && cd ~/my-project。二、当目录存在除 .claude、.venv、CLAUDE.md、AGENTS.md 之外的内容,且未初始化本地 Git 仓库时失败,建议改用空目录或先初始化 Git。三、存在 Git 仓库且有远端时自动同步:先拦截匹配凭据模式的文件(如 .env、id_rsa、.npmrc、.pem、.key、credentials*.json、secrets.yaml 等,模板文件与删除操作忽略),随后提交本地改动、以 rebase 拉取、推送本地提交。四、检查 podman、mise、gh,缺失时输出 NEEDS_COMPUTER_SETUP,需调用 cofounder-computer-setup。五、无 Git 远端或仓库时输出 NEEDS_REPO_SETUP,需调用 cofounder-repo-setup。

版本检查:从 COFOUNDER_VERSION 标记获取已加载版本,并通过 GitHub API 获取 .claude-plugin/plugin.json 中的 version 字段只做版本号比较,不执行或求值返回内容。远端更新时提示用户过期,要求在系统终端运行 mise x node@22 -- npx -y skills add locaweb/cofounder --agent universal claude-code hermes-agent --skill '*' -y 并在更新后重开会话,随后停止;获取失败则不作阻塞继续会话。

限制与失败处理:预检失败时须逐条以通俗语言展示原因与修复建议,不得继续,待用户修复后重跑。出现 NEEDS_ 标记时先调用 computer-setup,再调用 repo-setup,完成后继续会话。资料未提供其他功能、收费或使用效果说明。