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 

Option 2: Shortcut Scripts (Install Dependencies Automatically)

cd docs/plans

# Windows
taskmaster-skill\task.bat  

# Linux/Mac
./taskmaster-skill/task.sh  

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
  }
}

Replace the path with your actual plan directory (absolute path).

Step 3: Verify configuration

# List configured plans
node cli/task.js config list

# Add additional plans if needed
node cli/task.js config add   --description ""

# Set default plan
node cli/task.js config set-default 

---

Documentation Index

Agent Instruction Manuals

| Document | Purpose | When to Use | |----------|---------|-------------| | [COMMANDS.md](./COMMANDS.md) | Complete command specifications | Need detailed syntax for any command | | [WORKFLOWS.md](./WORKFLOWS.md) | Standard operation procedures | User asks to start/complete/audit tasks | | [BESTPRACTICES.md](./BESTPRACTICES.md) | Operational rules and constraints | Need to validate operation against rules |

Reference Data

| Document | Purpose | When to Use | |----------|---------|-------------| | [DATAFORMAT.md](./DATAFORMAT.md) | JSON schema specifications | Need to parse or construct data | | [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) | Error codes and resolution procedures | Command returns error |

Quick Reference

| Document | Purpose | When to Use | |----------|---------|-------------| | [EXAMPLES.md](./EXAMPLES.md) | Scenario-based execution patterns | User intent matches example scenario | | [TEMPLATES.md](./TEMPLATES.md) | Copy-paste command templates | Need ready-to-use command |

---

Quick Decision Map

User Request
    |
    +-- "查看/查询/了解 (View/Query/Understand)..." ──► Read COMMANDS.md "Query Commands" section
    +-- "有哪些任务可以开始 (What tasks can I start)" ──► Read COMMANDS.md "ready" command
    +-- "开始/做...任务 (Start/Do...task)" ──► Read WORKFLOWS.md "Start Task Workflow"
    +-- "完成/做完了 (Complete/Done)..." ──► Read WORKFLOWS.md "Complete Task Workflow"
    +-- "添加/新建 (Add/Create)...task" ──► Read COMMANDS.md "add" + EXAMPLES.md "Adding New Task"
    +-- "归档 (Archive)..." ──► Verify done + verified ──► Read COMMANDS.md "archive"
    +-- "检查/核验 (Check/Verify)..." ──► Read COMMANDS.md "verify"
    +-- "遇到问题/报错 (Encounter problem/error)..." ──► TROUBLESHOOTING.md

---

Command Syntax

All commands follow this pattern:

node cli/task.js  [options]

Or via shortcut scripts:

# Windows
taskmaster-skill\task.bat  

# Linux/Mac
./taskmaster-skill/task.sh  

Execution Rules

ALWAYS:

1. Check dependencies before start (run deps first)
2. Verify before archive (run verify first)
3. Parse command output to determine next action
4. Confirm with user for --force operations

NEVER:

1. Skip verify before archive (unless user explicitly confirms --force)
2. Assume task ID without confirming
3. Ignore error messages in command output

---

File Locations

docs/plans/
├── taskmaster-skill/
│   ├── cli/task.js        # CLI entry point
│   ├── config.json        # Plan configurations
│   ├── logs/              # Operation logs
│   │   ├── operations.log
│   │   └── operations.jsonl
│   └── *.md               # This documentation
│
└── /
    ├── data.json          # Task data (JSON format)
    └── README.md          # Plan description

---

Version

• CLI Version: 1.1.0
• Data Format: 1.0.0
• Last Updated: 2026-03-04

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Dqz00116
• Source: Dqz00116/skill-lib
• License: MIT

Install and usage instructions live in the source repository linked above.