cdhtools

Giới thiệu

cdhtools là công cụ CLI hỗ trợ migrate (chuyển đổi) các task từ file TaskMaster sang GitLab Epic/Issue, tự động tạo liên kết phụ thuộc và ghi lại kết quả.

Cài đặt & Sử dụng nhanh với NPX

Bạn không cần cài đặt toàn cục, chỉ cần chạy trực tiếp với npx:

npx cdhtools migrate epic --path=./taskmaster/tasks/tasks.json

• Tham số --path là đường dẫn tới file TaskMaster JSON (mặc định: ./taskmaster/tasks/tasks.json).
• Thêm --dryRun nếu muốn chạy thử mà không tạo dữ liệu trên GitLab.

Ví dụ:

npx cdhtools migrate epic --path=./taskmaster/tasks/tasks.json --dryRun

Cài đặt toàn cục (tuỳ chọn)

Nếu muốn sử dụng thường xuyên:

npm install -g cdhtools

Sau đó sử dụng:

cdhtools migrate epic --path=./taskmaster/tasks/tasks.json

Các lệnh CLI

cdhtools <command> <subcommand> [options]

Lệnh chính

• migrate epic: Chuyển đổi các task dạng Epic và Issue từ file TaskMaster sang GitLab.

Tuỳ chọn

• --path=<path>: Đường dẫn tới file TaskMaster JSON.
• --dryRun: Chạy thử, không tạo dữ liệu thật trên GitLab.

Xem hướng dẫn

cdhtools

Định dạng file TaskMaster (input)

File JSON đầu vào cần có cấu trúc như sau:

{
  "master": {
    "tasks": [
      {
        "id": 1,
        "title": "Tên Epic",
        "description": "Mô tả",
        "dependencies": [],
        "details": "",
        "status": "pending",
        "testStrategy": "",
        "subtasks": [
          {
            "id": 2,
            "title": "Tên Issue",
            "description": "Mô tả",
            "dependencies": [],
            "details": "",
            "status": "pending",
            "stack": "BACKEND",
            "testStrategy": ""
          }
        ]
      }
    ]
  }
}

Yêu cầu môi trường

• Node.js >= 16
• Cấu hình biến môi trường GitLab trong file .env:
  • GITLAB_API_URL
  • GITLAB_TOKEN
  • BACKEND_REPO_ID
  • FRONTEND_REPO_ID
  • GROUP_ID

Kết quả

• Sau khi chạy, tool sẽ tạo file kết quả (ví dụ: tasks-completed.json) chứa thông tin đã cập nhật (bao gồm các ID từ GitLab).