task-runner

只需一条命令即可运行项目任务。在项目根目录中查找 justfile 文件，列出可用任务，并执行常见的测试、构建、代码风格检查等操作。适用场景包括：运行测试、构建项目、列出任务、查看可用命令、执行脚本、运行项目命令等。

name: task-runner description: "Run project commands with just. Check for justfile in project root, list available tasks, execute common operations like test, build, lint. Triggers on: run tests, build project, list tasks, check available commands, run script, project commands." compatibility: "Requires just CLI tool. Install: brew install just (macOS) or cargo install just (cross-platform)." allowed-tools: "Bash Glob"

Task Runner

Purpose

Execute project-specific commands using just, a modern command runner that's simpler than make and works cross-platform.

Tools

Tool	Command	Use For
just	`just`	List available recipes
just	`just test`	Run specific recipe

Usage Examples

Basic Usage

bash

# List all available recipes
just

# Run a recipe
just test
just build
just lint

# Run recipe with arguments
just deploy production

# Run specific recipe from subdirectory
just --justfile backend/justfile test

Common justfile Recipes

just

# Example justfile

# Run tests
test:
    pytest tests/

# Build project
build:
    npm run build

# Lint code
lint:
    ruff check .
    eslint src/

# Start development server
dev:
    npm run dev

# Clean build artifacts
clean:
    rm -rf dist/ build/ *.egg-info/

# Deploy to environment
deploy env:
    ./scripts/deploy.sh {{env}}

Discovery

bash

# Check if justfile exists
just --summary

# Show recipe details
just --show test

# List recipes with descriptions
just --list

When to Use

•First check: just to see available project commands
•Running tests: just test
•Building: just build
•Any project-specific task
•Cross-platform command running

Best Practice

Always check for a justfile when entering a new project:

bash

just --list

This shows what commands are available without reading documentation.