taskmaster-skill

TaskMaster Skill

Agent-optimized task management system for AgentFabric.

Overview

A structured task management system for organizing, tracking, and executing multi-phase development plans through agent-optimized CLI workflows.

When to Use

• Managing complex project plans with interdependent tasks
• Tracking multi-phase task progress across milestones or sprints
• Prioritizing development tasks based on dependencies and readiness
• Coordinating sequential work that requires structured start, verify, and archive workflows

Do not use when:

• Simple single-step tasks without dependencies
• Informal tracking where a basic todo list is sufficient
• Projects not requiring configured plan directories or CLI tooling

---

Setup

Prerequisites

• Node.js 22+
• Working directory: docs/plans/

Installation

Option 1: Direct Node.js (Agent Recommended)

cd docs/plans/taskmaster-skill/cli
npm install

Then use CLI via:

node cli/task.js <command>

Option 2: Shortcut Scripts (Install Dependencies Automatically)

cd docs/plans

# Windows
taskmaster-skill\task.bat <plan> <command>

# Linux/Mac
./taskmaster-skill/task.sh <plan> <command>

Quick Start

# View all plans
node cli/task.js plans

# Check progress
node cli/task.js progress mvp_v1

# List tasks
node cli/task.js list mvp_v1

# List ready-to-start tasks (dependencies completed)
node cli/task.js ready mvp_v1
node cli/task.js ready mvp_v1 --limit 20

Configuration (REQUIRED)

Before using TaskMaster, you MUST configure the plan mapping:

Step 1: Copy template

cp config.json.template config.json

Step 2: Edit config.json

{
  "version": "1.0.0",
  "plans": {
    "mvp_v1": {
      "path": "E:\\Agent\\agent-fabric\\docs\\plans\\mvp_v1",
      "description": "AgentFabric MVP v1 实施计划"
    }
  },
  "settings": {
    "defaultPlan": "mvp_v1",
    "autoCreatePlan": false,
    "logRetentionDays": 30
  }
}