Task Planner

Tong quan

Skill nay giup phan tach yeu cau hoac tai lieu nghien cuu thanh bo tai lieu task planning co cau truc, bao gom:

• •Phase: Cac giai doan lon cua du an/tinh nang
• •Task: Cac cong viec cu the trong moi phase
• •Subtask: Cac buoc nho trong moi task

Nguyen tac cot loi: Tai lieu output KHONG CHUA CODE MAU. Chi tap trung mo ta logic, nghiep vu, va cac buoc can thuc hien.

Workflow

Buoc 1: Thu thap Context

Khi skill duoc goi, thuc hien thu thap thong tin:

1.1 Xac dinh nguon input

1.2 Hoi thong tin can thiet

Su dung AskUserQuestion de hoi:

1. •Thu muc output - Noi luu cac file tai lieu plan
2. •Ten du an/tinh nang - De dat ten cho bo tai lieu
3. •Pham vi - Xac dinh ranh gioi cua yeu cau

1.3 Nghien cuu codebase

Su dung Task tool voi subagent_type=Explore de:

• •Tim hieu cau truc du an hien tai
• •Xac dinh cac file/module lien quan
• •Hieu cac pattern dang duoc su dung

Buoc 2: Phan tich va Phan chia

2.1 Phan tich yeu cau

Doc ky input va xac dinh:

• •Muc tieu chinh can dat duoc
• •Cac thanh phan/module can xay dung
• •Cac phu thuoc va rang buoc

2.2 Chia thanh Phase

Moi phase nen:

• •Co muc tieu ro rang
• •Co the demo/kiem tra doc lap
• •Thoi gian hop ly (khong qua lon/nho)

Quy tac chia phase:

Phase 1: Nen tang (setup, config, schema)
Phase 2: Core logic (business logic chinh)
Phase 3: Integration (ket noi cac phan)
Phase 4: Polish (UI, UX, optimization)
Phase 5: Testing & Documentation

2.3 Chia thanh Task trong moi Phase

Moi task nen:

• •Hoan thanh duoc trong 1 session lam viec
• •Co input/output ro rang
• •Co tieu chi hoan thanh cu the

2.4 Chia thanh Subtask

Moi subtask nen:

• •La 1 don vi cong viec nho nhat
• •Mo ta duoc logic can thuc hien
• •Co the verify ket qua

Buoc 3: Hoi Clarification

Truoc khi tao tai lieu final, su dung AskUserQuestion de:

1. •Xac nhan pham vi - "Toi da xac dinh {N} phase, {M} task. Day co phu hop khong?"
2. •Lam ro mo ho - Hoi ve cac diem chua ro trong yeu cau
3. •Xac nhan uu tien - "Phase nao can uu tien truoc?"
4. •Kiem tra rang buoc - "Co rang buoc nao ve tech stack/pattern khong?"

Buoc 4: Tao Bo Tai lieu

4.1 Doc format guidelines

Tham khao file references/document-format.md de dam bao format dung chuan.

4.2 Tao cau truc thu muc

{output-path}/
├── INDEX.md
├── phase-01-{slug}/
│   ├── PHASE.md
│   ├── task-01-{slug}.md
│   └── task-02-{slug}.md
└── phase-02-{slug}/
    ├── PHASE.md
    └── ...

4.3 Viet noi dung

Thu tu viet:

1. •Viet INDEX.md truoc (tong quan)
2. •Viet PHASE.md cho tung phase
3. •Viet task-{so}-{slug}.md cho tung task

Noi dung moi file:

• •INDEX.md: Tong quan, muc tieu, danh sach phase
• •PHASE.md: Muc tieu phase, danh sach task, phu thuoc
• •task-*.md: Logic xu ly, subtasks, edge cases, DoD

4.4 Tich hop TodoWrite

Sau khi tao tai lieu, su dung TodoWrite de tao todo list tu cac task:

- Phase 1: {ten}
  - Task 1.1: {ten}
  - Task 1.2: {ten}
- Phase 2: {ten}
  - Task 2.1: {ten}
  ...

Nguyen tac Viet Tai lieu

KHONG lam

1. •KHONG chen code mau - Khong snippet, khong example code
2. •KHONG copy syntax - Khong dan syntax tu docs
3. •KHONG qua chi tiet implementation - Khong mo ta tung dong code
4. •KHONG gia dinh - Hoi neu chua ro

NEN lam

1. •Mo ta logic ro rang - "Kiem tra dieu kien A, neu thoa thi thuc hien B"
2. •Liet ke edge cases - "Truong hop input rong, xu ly bang cach..."
3. •Chi ro phu thuoc - "Can hoan thanh Task 1 truoc khi bat dau"
4. •Dinh nghia DoD - "Task hoan thanh khi: checklist..."

Vi du Mo ta Logic (KHONG code)

SAI (co code):

// Tao function validate email
function validateEmail(email) {
  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)
}

DUNG (mo ta logic):

## Logic validate email

1. Kiem tra input khong rong
2. Kiem tra format co dang: {text}@{domain}.{extension}
3. Kiem tra domain hop le (khong chua ky tu dac biet)
4. Tra ve true neu hop le, false neu khong

### Edge cases
- Email rong -> tra ve false
- Email khong co @ -> tra ve false
- Email co nhieu @ -> tra ve false

Resources

references/

• •document-format.md - Huong dan chi tiet ve format cac file tai lieu

assets/templates/

• •INDEX.template.md - Template cho file INDEX.md
• •PHASE.template.md - Template cho file PHASE.md
• •TASK.template.md - Template cho file task

Checklist Hoan thanh

Truoc khi ket thuc, dam bao:

• • Da tao INDEX.md voi day du thong tin
• • Da tao PHASE.md cho moi phase
• • Da tao task-*.md cho moi task
• • Tat ca file khong chua code mau
• • Moi task co Definition of Done
• • Da tao TodoWrite list tu cac task
• • Da thong bao nguoi dung ve vi tri thu muc output