AgentSkillsCN

use-taskfile

使用 Taskfile 执行常见的项目操作。适用于构建、测试、启动服务、运行迁移,或任何项目操作。运行 `task` 命令即可查看可用的任务列表。

SKILL.md
--- frontmatter
name: use-taskfile
description: Run common project operations using the Taskfile. Use when building, testing, starting services, running migrations, or any project operation. Run `task` to discover available tasks.

Use Taskfile Skill

Use this skill when running project operations. Prefer Taskfile tasks over manual commands.


Discover Available Tasks

bash
task

This lists all available tasks with descriptions.

Common Task Categories

CategoryExample TasksPurpose
api:*api:build, api:start, api:start:dockerBuild and run the API
compose:*compose:up, compose:downManage Docker services
evaluator:*evaluator:start, evaluator:start:test-modeRun the evaluator
importer:*importer:start, importer:start:use-cacheImport data from tarkov.dev
migrate:*migrate:up, migrate:up:docker, migrate:down, migrate:createDatabase migrations
test:*test, test:unit, test:integration, test:integration:dockerRun tests
tarkovdev:*tarkovdev:get-schema, tarkovdev:regenerateUpdate GraphQL schema

Running Tasks

bash
# Run a specific task
task <task-name>

# Example: apply migrations (local/devcontainer)
task migrate:up

# Example: apply migrations (with docker)
task migrate:up:docker

Key Tasks

  • task init - Set up development environment
  • task init:go-only - Set up Go-only development environment
  • task test:unit - Run tests without database
  • task migrate:up - Apply database migrations (local/devcontainer)
  • task importer:start - Repopulate weapons/items from tarkov.dev API

Repopulating the Database

If the database has been wiped or migrations rolled back, repopulate data with:

bash
task compose:up        # Ensure database is running
task migrate:up        # Apply migrations
task importer:start    # Fetch and import all weapons/items from tarkov.dev

Use task importer:start:use-cache to import from local cache instead of fetching from the API.