SuperAPI AI 工具集

justfile-author

编程与开发

查看项目

更新于 10-16 01:37

技能介绍

用途:在缺乏 justfile 的仓库中生成 justfile,或为已有 justfile 补齐 svc-* 服务族、Makefile 包装器与标准质量配方;也可新增服务窗口(如 svc-worker)或将 justfile 重构得更 DRY。第三方/开源 justfile,或项目已明确选用 make、npm scripts 等运行器时跳过。

主要能力:生成 justfile、匹配的 Makefile 与 tx-start 辅助脚本,遵循固定约定——zsh shell、DRY 参数化辅助、通过 cortex tmux 接线的 svc-* tmux 服务族,以及标准配方(build、lint、dev、test、typecheck、ci、clean)。

使用方式:先检查项目,确定 slug、技术栈与包管理器、服务目录、已有工具链和运行时激活需求;再按 Node、Rust、Python、Go 参考选择配方块(多语言项目可组合;未列出的栈参照最接近结构并替换原生命令);然后选择服务目录,依据 service-patterns 为每个服务生成前台与 svc- 成对配方及 tx-start-<role>.sh 包装器;最后用 assets 中的模板结构写出实际文件并替换占位符。验证步骤包括 just --list、make help、逐个核对 svc-<role> 对应的 tx-start-<role>.sh 存在且可执行、just ci 依赖可解析、确认存在 set shell := ["zsh", "-c"] 且无 bash 专有语法。

风格规则:头部注释含项目名、安装提示与用法提示;设置 set dotenv-load := false 与 zsh shell;用 project 变量保存规范化 slug,用于推导 svc_session 与各 tmux 窗口变量,不硬编码会话名;默认配方 default: @just --list;svc- 配方统一委托 _svc-start、svc-stop- 委托 _svc-stop;ci 组合 typecheck、lint、test(Rust/Go 加 fmt-check)。

限制:不要将 nvm/asdf 激活写入 justfile,应放在 tx-start 脚本;不要直接调用 tmux capture-pane 或 kill-window,需经 cortex tmux;项目无 linter 时省略 lint 配方;Makefile 不用 %: 兜底规则。资料未提供具体收费、平台与效果信息。