work-with-justfiles

此技能为使用 Justfiles 管理仓库 CLI 约定提供了结构化框架。专为需要简化复杂命令行流程、减少隐性知识并改善开发者入门体验的软件工程师与开发人员所设计。通过将 justfile 作为唯一的真实来源，团队可以摆脱零散的 README 指示、复杂的 npm 脚本或缺乏记录的 Shell hacks，转而使用声明式、可发现且可预测的指令执行环境。

• 将开发、构建、测试与部署流程标准化为统一且简洁的接口。

• 实现以仓库根目录为基准的执行模式，确保指令在用户处于任何目录下都能保持确定性。

• 支持指令的逻辑分组，让新进贡献者能更轻易地通过 just --list 发现可用的任务。

• 支持高级功能，如位置参数、通过 .env 加载环境变量、破坏性动作的确认提示以及内部辅助脚本隐藏。

• 提供项目组织的最佳实践，包括将简单的指令别名与应存放在 scripts/ 目录中的复杂多行 Shell 脚本分开。

• 防止范畴蔓延，保持构建工具配置（如 Vite、Webpack）与高阶开发流程之间的清晰区隔。

• 非常适合管理 CI/CD 管线触发、本地开发环境设置、数据库迁移与测试套件。

• 核心原则是指令别名：将繁琐、重复或隐藏的旗标对应到直观、具描述性的指令名称。

• 输入通常是项目根目录中的 Justfile；输出是为项目维护者与协作者准备的结构化、可读的 API。

• 严格限制在执行阶段使用 cd 指令，以防止副作用并确保相对于仓库根目录的路径解析准确性。

• 可在代码审查、架构讨论或为工程团队记录新的入职流程时，作为发现与标准化的工具。