speccrew 0.1.12 → 0.2.0

package/docs/GETTING-STARTED.th.md

@@ -361,7 +361,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. คำถามที่พบบ่อย (FAQ)
+## 6. การจัดการความคืบหน้าของ Pipeline
+
+ทีมเสมือน SpecCrew ปฏิบัติตามกลไกการควบคุมขั้นตอนที่เข้มงวด แต่ละขั้นตอนต้องได้รับการยืนยันจากผู้ใช้ก่อนจึงจะสามารถดำเนินการต่อไปยังขั้นตอนถัดไป นอกจากนี้ยังรองรับการดำเนินการต่อจากจุดที่หยุด —— เมื่อรีสตาร์ทหลังจากหยุดชะงัก ระบบจะดำเนินการต่อโดยอัตโนมัติจากตำแหน่งที่หยุดไว้ครั้งล่าสุด
+
+### 6.1 ไฟล์ความคืบหน้าสามระดับ
+
+เวิร์กโฟลว์จะบำรุงรักษาไฟล์ความคืบหน้า JSON สามประเภทโดยอัตโนมัติ ตั้งอยู่ในไดเรกทอรีการทำซ้ำ:
+
+| ไฟล์ | ตำแหน่ง | หน้าที่ |
+|------|----------|--------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | บันทึกสถานะของแต่ละขั้นตอนใน Pipeline ทั้งหมด |
+| `.checkpoints.json` | ภายใต้ไดเรกทอรีของแต่ละขั้นตอน | บันทึกสถานะการผ่านจุดยืนยัน (Checkpoint) ของผู้ใช้ |
+| `DISPATCH-PROGRESS.json` | ภายใต้ไดเรกทอรีของแต่ละขั้นตอน | บันทึกความคืบหน้ารายการของงานขนาน (หลายแพลตฟอร์ม/โมดูล) |
+
+### 6.2 การเปลี่ยนสถานะของขั้นตอน
+
+แต่ละขั้นตอนปฏิบัติตามการเปลี่ยนสถานะดังต่อไปนี้:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: ยังไม่เริ่มต้น
+- **in_progress**: กำลังดำเนินการ
+- **completed**: Agent ดำเนินการเสร็จสิ้น รอการยืนยันจากผู้ใช้
+- **confirmed**: ผู้ใช้ยืนยัน Checkpoint สุดท้าย สามารถเริ่มขั้นตอนถัดไปได้
+
+### 6.3 การดำเนินการต่อจากจุดที่หยุด
+
+เมื่อรีสตาร์ท Agent ของขั้นตอนใดขั้นตอนหนึ่ง:
+
+1. **ตรวจสอบ upstream โดยอัตโนมัติ**: ตรวจสอบว่าขั้นตอนก่อนหน้าได้รับการยืนยันแล้วหรือไม่ หากไม่ได้รับการยืนยันจะถูกบล็อกและแจ้งเตือน
+2. **กู้คืน Checkpoint**: อ่าน `.checkpoints.json` ข้ามจุดยืนยันที่ผ่านไปแล้ว และดำเนินการต่อจากจุดที่หยุดครั้งล่าสุด
+3. **กู้คืนงานขนาน**: อ่าน `DISPATCH-PROGRESS.json` รีเอ็กซ์คิวต์เฉพาะงานที่มีสถานะ `pending` หรือ `failed` ข้ามงานที่มีสถานะ `completed` แล้ว
+
+### 6.4 ดูความคืบหน้าปัจจุบัน
+
+ดูสถานะภาพรวมของ Pipeline ผ่าน Team Leader Agent:
+
+```
+@speccrew-team-leader ดูความคืบหน้าของการทำซ้ำปัจจุบัน
+```
+
+Team Leader จะอ่านไฟล์ความคืบหน้าและแสดงสรุปสถานะที่คล้ายกับต่อไปนี้:
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Confirmed
+  02 Feature Design: 🔄 In Progress (Checkpoint A passed)
+  03 System Design:  ⏳ Pending
+  04 Development:    ⏳ Pending
+  05 System Test:    ⏳ Pending
+```
+
+### 6.5 ความเข้ากันได้ย้อนหลัง
+
+กลไกไฟล์ความคืบหน้ามีความเข้ากันได้ย้อนหลังอย่างสมบูรณ์ —— หากไฟล์ความคืบหน้าไม่มีอยู่ (เช่น โครงการเก่าหรือการทำซ้ำใหม่) Agent ทั้งหมดจะดำเนินการตามตรรกะเดิมตามปกติ
+
+---
+
+## 7. คำถามที่พบบ่อย (FAQ)
 
 ### ค1: จะทำอย่างไรหากเอเจนต์ไม่ทำงานตามที่คาดไว้?
 
@@ -389,8 +449,22 @@ iterations/
 
 ### ค4: วิธีอัปเดตเวอร์ชัน SpecCrew?
 
-- **การอัปเดตระดับโลก**: `npm update -g speccrew`
-- **การอัปเดตโปรเจกต์**: รัน `speccrew update` ในไดเรกทอรีโปรเจกต์
+การอัปเดตต้องทำสองขั้นตอน:
+
+```bash
+# ขั้นตอนที่ 1: อัปเดตเครื่องมือ CLI ระดับโลก
+npm install -g speccrew@latest
+
+# ขั้นตอนที่ 2: ซิงค์ Agent และ Skill ในไดเรกทอรีโปรเจกต์ของคุณ
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: อัปเดตเครื่องมือ CLI เอง (เวอร์ชันใหม่อาจมีคำจำกัดความ Agent/Skill ใหม่ การแก้ไขบั๊ก ฯลฯ)
+- `speccrew update`: ซิงค์ไฟล์คำจำกัดความ Agent และ Skill ในโปรเจกต์ของคุณเป็นเวอร์ชันล่าสุด
+- `speccrew update --ide cursor`: อัปเดตการกำหนดค่าสำหรับ IDE เฉพาะเท่านั้น
+
+> **หมายเหตุ**: จำเป็นต้องทำทั้งสองขั้นตอน การรันเฉพาะ `speccrew update` จะไม่อัปเดตเครื่องมือ CLI เอง การรันเฉพาะ `npm install` จะไม่อัปเดตไฟล์โปรเจกต์
 
 ### ค5: วิธีดูการทำซ้ำในอดีต?
 
@@ -405,7 +479,7 @@ iterations/
 
 ---
 
-## 7. ข้อมูลอ้างอิงด่วน
+## 8. ข้อมูลอ้างอิงด่วน
 
 ### ข้อมูลอ้างอิงด่วนการเริ่มเอเจนต์
 
@@ -442,7 +516,7 @@ iterations/
 
 ---
 
-## ขั้นตอนถัดไป
+## 9. ขั้นตอนถัดไป
 
 1. รัน `speccrew init --ide qoder` เพื่อเริ่มต้นโปรเจกต์ของคุณ
 2. ทำขั้นตอนที่ศูนย์: การวินิจฉัยโปรเจกต์และการเริ่มต้นฐานความรู้

package/docs/GETTING-STARTED.tr.md

@@ -361,7 +361,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. Sıkça Sorulan Sorular (SSS)
+## 6. İş Akışı İlerleme Yönetimi
+
+SpecCrew sanal ekibi, bir sonraki aşamaya geçmeden önce her aşamanın kullanıcı tarafından onaylanması gereken katı bir aşama-geçit mekanizması izler. Ayrıca devam ettirilebilir yürütme desteği sunar — kesinti sonrası yeniden başlatıldığında, kaldığı yerden otomatik olarak devam eder.
+
+### 6.1 Üç Katmanlı İlerleme Dosyaları
+
+İş akışı, iterasyon dizininde bulunan üç tür JSON ilerleme dosyasını otomatik olarak yönetir:
+
+| Dosya | Konum | Amaç |
+|-------|-------|------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Her boru hattı aşamasının durumunu kaydeder |
+| `.checkpoints.json` | Her aşama dizini altında | Kullanıcı kontrol noktası onay durumunu kaydeder |
+| `DISPATCH-PROGRESS.json` | Her aşama dizini altında | Paralel görevler için öğe bazında ilerlemeyi kaydeder (çoklu platform/çoklu modül) |
+
+### 6.2 Aşama Durum Akışı
+
+Her aşama bu durum akışını izler:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: Henüz başlamadı
+- **in_progress**: Şu anda yürütülüyor
+- **completed**: Ajan yürütmesi tamamlandı, kullanıcı onayı bekleniyor
+- **confirmed**: Kullanıcı son kontrol noktası üzerinden onayladı, bir sonraki aşama başlayabilir
+
+### 6.3 Devam Ettirilebilir Yürütme
+
+Bir aşama için Ajan yeniden başlatıldığında:
+
+1. **Otomatik yukarı akış kontrolü**: Önceki aşamanın onaylanıp onaylanmadığını doğrular, değilse engeller ve uyarır
+2. **Kontrol noktası kurtarma**: `.checkpoints.json` dosyasını okur, geçilen kontrol noktalarını atlar, son kesinti noktasından devam eder
+3. **Paralel görev kurtarma**: `DISPATCH-PROGRESS.json` dosyasını okur, yalnızca `pending` veya `failed` durumundaki görevleri yeniden yürütür, `completed` görevleri atlar
+
+### 6.4 Mevcut İlerlemeyi Görüntüleme
+
+Takım Lideri Ajanı üzerinden boru hattı panoramik durumunu görüntüleyin:
+
+```
+@speccrew-team-leader mevcut iterasyon ilerlemesini görüntüle
+```
+
+Takım Lideri ilerleme dosyalarını okuyacak ve aşağıdakine benzer bir durum özeti görüntüleyecektir:
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Confirmed
+  02 Feature Design: 🔄 In Progress (Checkpoint A passed)
+  03 System Design:  ⏳ Pending
+  04 Development:    ⏳ Pending
+  05 System Test:    ⏳ Pending
+```
+
+### 6.5 Geriye Dönük Uyumluluk
+
+İlerleme dosyası mekanizması tamamen geriye dönük uyumludur — ilerleme dosyaları mevcut değilse (örneğin, eski projelerde veya yeni iterasyonlarda), tüm Ajanlar orijinal mantığa göre normal şekilde yürütülecektir.
+
+---
+
+## 7. Sıkça Sorulan Sorular (SSS)
 
 ### S1: Ajan beklendiği gibi çalışmazsa ne yapmalıyım?
 
@@ -389,8 +449,22 @@ Her iterasyon tamamen izole edilmiştir ve diğerlerini etkilemez.
 
 ### S4: SpecCrew sürümünü nasıl güncellerim?
 
-- **Genel Güncelleme**: `npm update -g speccrew`
-- **Proje Güncellemesi**: Proje dizininde `speccrew update` çalıştırın
+Güncelleme iki adım gerektirir:
+
+```bash
+# Adım 1: Global CLI aracını güncelle
+npm install -g speccrew@latest
+
+# Adım 2: Proje dizininizdeki Ajan ve Becerileri senkronize et
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: CLI aracının kendisini günceller (yeni sürümler yeni Ajan/Beceri tanımları, hata düzeltmeleri vb. içerebilir)
+- `speccrew update`: Projenizdeki Ajan ve Beceri tanım dosyalarını en son sürüme senkronize eder
+- `speccrew update --ide cursor`: Yalnızca belirli bir IDE için yapılandırmayı günceller
+
+> **Not**: Her iki adım da gereklidir. Yalnızca `speccrew update` çalıştırmak CLI aracının kendisini güncellemez; yalnızca `npm install` çalıştırmak proje dosyalarını güncellemez.
 
 ### S5: Geçmiş iterasyonları nasıl görüntülerim?
 
@@ -405,7 +479,7 @@ Aşağıdaki durumlarda yeniden başlatma gerekir:
 
 ---
 
-## 7. Hızlı Referans
+## 8. Hızlı Referans
 
 ### Ajan Başlatma Hızlı Referansı
 

package/docs/GETTING-STARTED.uk.md

@@ -361,7 +361,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. Часті Запитання (FAQ)
+## 6. Управління Прогресом Робочого Процесу
+
+Віртуальна команда SpecCrew дотримується суворого механізму поетапних воріт, де кожен етап повинен бути підтверджений користувачем перед переходом до наступного. Вона також підтримує відновлюване виконання — при перезапуску після переривання автоматично продовжує з того місця, де зупинилася.
+
+### 6.1 Трирівневі Файли Прогресу
+
+Робочий процес автоматично підтримує три типи JSON файлів прогресу, розташованих в каталозі ітерації:
+
+| Файл | Розташування | Призначення |
+|------|--------------|-------------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Записує статус кожного етапу конвеєра |
+| `.checkpoints.json` | Під кожним каталогом етапу | Записує статус підтвердження контрольної точки користувачем |
+| `DISPATCH-PROGRESS.json` | Під кожним каталогом етапу | Записує поелементний прогрес для паралельних задач (багатоплатформні/багатомодульні) |
+
+### 6.2 Потік Статусу Етапу
+
+Кожен етап дотримується цього потоку статусу:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: Ще не розпочато
+- **in_progress**: Наразі виконується
+- **completed**: Виконання Агента завершено, очікує підтвердження користувача
+- **confirmed**: Користувач підтвердив через фінальну контрольну точку, наступний етап може розпочатися
+
+### 6.3 Відновлюване Виконання
+
+При перезапуску Агента для етапу:
+
+1. **Автоматична перевірка вище за течією**: Перевіряє, чи підтверджено попередній етап, блокує та нагадує, якщо ні
+2. **Відновлення контрольної точки**: Читає `.checkpoints.json`, пропускає пройдені контрольні точки, продовжує з останньої точки переривання
+3. **Відновлення паралельних задач**: Читає `DISPATCH-PROGRESS.json`, повторно виконує лише задачі зі статусом `pending` або `failed`, пропускає `completed` задачі
+
+### 6.4 Перегляд Поточного Прогресу
+
+Перегляд панорамного статусу конвеєра через Агента Лідера Команди:
+
+```
+@speccrew-team-leader перегляд прогресу поточної ітерації
+```
+
+Лідер Команди прочитає файли прогресу і відобразить огляд статусу, подібний до:
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Confirmed
+  02 Feature Design: 🔄 In Progress (Checkpoint A passed)
+  03 System Design:  ⏳ Pending
+  04 Development:    ⏳ Pending
+  05 System Test:    ⏳ Pending
+```
+
+### 6.5 Зворотна Сумісність
+
+Механізм файлів прогресу повністю зворотно сумісний — якщо файли прогресу не існують (наприклад, в старих проектах або нових ітераціях), всі Агенти виконуватимуться нормально згідно з оригінальною логікою.
+
+---
+
+## 7. Часті Запитання (FAQ)
 
 ### П1: Що робити, якщо Агент не працює як очікується?
 
@@ -389,8 +449,22 @@ iterations/
 
 ### П4: Як оновити версію SpecCrew?
 
-- **Глобальне Оновлення**: `npm update -g speccrew`
-- **Оновлення Проекту**: Виконайте `speccrew update` в каталозі проекту
+Оновлення вимагає два етапи:
+
+```bash
+# Етап 1: Оновити глобальний CLI-інструмент
+npm install -g speccrew@latest
+
+# Етап 2: Синхронізувати Агентів та Навички в директорії проекту
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: Оновлює сам CLI-інструмент (нові версії можуть включати нові визначення Агентів/Навичок, виправлення помилок тощо)
+- `speccrew update`: Синхронізує файли визначень Агентів та Навичок у вашому проекті до останньої версії
+- `speccrew update --ide cursor`: Оновлює конфігурацію тільки для конкретної IDE
+
+> **Примітка**: Обидва етапи обов'язкові. Виконання тільки `speccrew update` не оновить сам CLI-інструмент; виконання тільки `npm install` не оновить файли проекту.
 
 ### П5: Як переглянути історичні ітерації?
 
@@ -405,7 +479,7 @@ iterations/
 
 ---
 
-## 7. Швидка Довідка
+## 8. Швидка Довідка
 
 ### Швидка Довідка Запуску Агентів
 

package/docs/GETTING-STARTED.vi.md

@@ -361,7 +361,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. Câu Hỏi Thường Gặp (FAQ)
+## 6. Quản Lý Tiến Độ Pipeline
+
+Nhóm ảo SpecCrew tuân thủ cơ chế kiểm soát pha nghiêm ngặt, mỗi pha phải được xác nhận bởi ngườ dùng trước khi có thể tiến hành sang pha tiếp theo. Đồng thờ hỗ trợ tiếp tục từ điểm dừng —— khi khởi động lại sau khi bị gián đoạn, hệ thống sẽ tự động tiếp tục từ vị trí dừng lần cuối.
+
+### 6.1 Ba Tệp Tiến Độ
+
+Workflow tự động duy trì ba loại tệp tiến độ JSON, nằm trong thư mục iteration:
+
+| Tệp | Vị trí | Vai trò |
+|------|----------|--------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | Ghi lại trạng thái của từng pha trong toàn bộ pipeline |
+| `.checkpoints.json` | Trong thư mục từng pha | Ghi lại trạng thái vượt qua điểm kiểm tra (Checkpoint) của ngườ dùng |
+| `DISPATCH-PROGRESS.json` | Trong thư mục từng pha | Ghi lại tiến độ từng mục của tác vụ song song (đa nền tảng/module) |
+
+### 6.2 Chuyển Đổi Trạng Thái Pha
+
+Mỗi pha tuân thủ chuyển đổi trạng thái sau:
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**: Chưa bắt đầu
+- **in_progress**: Đang thực hiện
+- **completed**: Agent thực hiện xong, chờ xác nhận từ ngườ dùng
+- **confirmed**: Ngườ dùng xác nhận Checkpoint cuối cùng, có thể bắt đầu pha tiếp theo
+
+### 6.3 Tiếp Tục Từ Điểm Dừng
+
+Khi khởi động lại Agent của một pha nào đó:
+
+1. **Tự động kiểm tra upstream**: Xác minh pha trước đã được confirmed chưa, nếu chưa sẽ bị chặn và cảnh báo
+2. **Khôi phục Checkpoint**: Đọc `.checkpoints.json`, bỏ qua các điểm kiểm tra đã vượt qua, và tiếp tục từ điểm dừng lần cuối
+3. **Khôi phục tác vụ song song**: Đọc `DISPATCH-PROGRESS.json`, chỉ thực thi lại các tác vụ có trạng thái `pending` hoặc `failed`, bỏ qua các tác vụ đã `completed`
+
+### 6.4 Xem Tiến Độ Hiện Tại
+
+Xem trạng thái toàn cảnh của pipeline thông qua Team Leader Agent:
+
+```
+@speccrew-team-leader xem tiến độ iteration hiện tại
+```
+
+Team Leader sẽ đọc các tệp tiến độ và hiển thị tóm tắt trạng thái tương tự như sau:
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Confirmed
+  02 Feature Design: 🔄 In Progress (Checkpoint A passed)
+  03 System Design:  ⏳ Pending
+  04 Development:    ⏳ Pending
+  05 System Test:    ⏳ Pending
+```
+
+### 6.5 Tương Thích Ngược
+
+Cơ chế tệp tiến độ hoàn toàn tương thích ngược —— nếu tệp tiến độ không tồn tại (ví dụ: dự án cũ hoặc iteration mới), tất cả các Agent sẽ thực thi theo logic ban đầu như bình thường.
+
+---
+
+## 7. Câu Hỏi Thường Gặp (FAQ)
 
 ### H1: Phải làm gì nếu Agent không hoạt động như mong đợi?
 
@@ -389,8 +449,22 @@ Mỗi iteration được cô lập hoàn toàn và không ảnh hưởng đến
 
 ### H4: Làm thế nào để cập nhật phiên bản SpecCrew?
 
-- **Cập Nhật Toàn Cầu**: `npm update -g speccrew`
-- **Cập Nhật Dự Án**: Chạy `speccrew update` trong thư mục dự án
+Cập nhật yêu cầu hai bước:
+
+```bash
+# Bước 1: Cập nhật công cụ CLI toàn cục
+npm install -g speccrew@latest
+
+# Bước 2: Đồng bộ Agent và Skill trong thư mục dự án của bạn
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`: Cập nhật chính công cụ CLI (phiên bản mới có thể bao gồm định nghĩa Agent/Skill mới, sửa lỗi, v.v.)
+- `speccrew update`: Đồng bộ các tệp định nghĩa Agent và Skill trong dự án của bạn lên phiên bản mới nhất
+- `speccrew update --ide cursor`: Cập nhật cấu hình chỉ cho một IDE cụ thể
+
+> **Lưu ý**: Cả hai bước đều cần thiết. Chỉ chạy `speccrew update` sẽ không cập nhật chính công cụ CLI; chỉ chạy `npm install` sẽ không cập nhật các tệp dự án.
 
 ### H5: Làm thế nào để xem các iteration lịch sử?
 
@@ -405,7 +479,7 @@ Cần khởi tạo lại trong các tình huống sau:
 
 ---
 
-## 7. Tham Khảo Nhanh
+## 8. Tham Khảo Nhanh
 
 ### Tham Khảo Nhanh Khởi Động Agent
 
@@ -442,7 +516,7 @@ Cần khởi tạo lại trong các tình huống sau:
 
 ---
 
-## Bước Tiếp Theo
+## 9. Bước Tiếp Theo
 
 1. Chạy `speccrew init --ide qoder` để khởi tạo dự án của bạn
 2. Thực hiện Bước Không: Chẩn Đoán Dự Án và Khởi Tạo Cơ Sở Kiến Thức

package/docs/GETTING-STARTED.zh-TW.md

@@ -360,7 +360,67 @@ knowledges/techs/{platform-id}/
 
 ---
 
-## 6. 常見問題（FAQ）
+## 6. 流水線進度管理
+
+SpecCrew 虛擬團隊遵循嚴格的階段門控機制，每個階段必須經過用戶確認後才能推進到下一階段。同時支援斷點續傳 —— 中斷後重新啟動時，自動從上次停止的位置繼續。
+
+### 6.1 三層進度文件
+
+工作流自動維護三類 JSON 進度文件，位於迭代目錄下：
+
+| 文件 | 位置 | 作用 |
+|------|------|------|
+| `WORKFLOW-PROGRESS.json` | `iterations/{iter}/` | 記錄整條流水線各階段狀態 |
+| `.checkpoints.json` | 各階段目錄下 | 記錄用戶確認點（Checkpoint）通過狀態 |
+| `DISPATCH-PROGRESS.json` | 各階段目錄下 | 記錄並行任務（多平台/多模組）的逐項進度 |
+
+### 6.2 階段狀態流轉
+
+每個階段遵循以下狀態流轉：
+
+```
+pending → in_progress → completed → confirmed
+```
+
+- **pending**：尚未開始
+- **in_progress**：正在執行中
+- **completed**：Agent 執行完成，等待用戶確認
+- **confirmed**：用戶通過最終 Checkpoint 確認，下一階段可以啟動
+
+### 6.3 斷點續傳
+
+當重新啟動某個階段的 Agent 時：
+
+1. **自動檢查上游**：驗證前一階段是否已 confirmed，未確認則阻塞並提示
+2. **恢復 Checkpoint**：讀取 `.checkpoints.json`，跳過已通過的確認點，從上次中斷處繼續
+3. **恢復並行任務**：讀取 `DISPATCH-PROGRESS.json`，只重新執行 `pending` 或 `failed` 狀態的任務，跳過已 `completed` 的任務
+
+### 6.4 查看當前進度
+
+通過 Team Leader Agent 查看流水線全景狀態：
+
+```
+@speccrew-team-leader 查看當前迭代進度
+```
+
+Team Leader 會讀取進度文件並展示類似以下的狀態概覽：
+
+```
+Pipeline Status: i001-user-management
+  01 PRD:            ✅ Confirmed
+  02 Feature Design: 🔄 In Progress (Checkpoint A passed)
+  03 System Design:  ⏳ Pending
+  04 Development:    ⏳ Pending
+  05 System Test:    ⏳ Pending
+```
+
+### 6.5 向下兼容
+
+進度文件機制完全向下兼容 —— 如果進度文件不存在（如舊項目或全新迭代），所有 Agent 將按照原有邏輯正常執行。
+
+---
+
+## 7. 常見問題（FAQ）
 
 ### Q1: Agent 不按預期工作怎麼辦？
 
@@ -388,8 +448,22 @@ iterations/
 
 ### Q4: 如何更新 SpecCrew 版本？
 
-- **全局更新**：`npm update -g speccrew`
-- **專案更新**：在專案目錄執行 `speccrew update`
+更新需要兩個步驟：
+
+```bash
+# 步驟一：更新全域 CLI 工具
+npm install -g speccrew@latest
+
+# 步驟二：在專案目錄同步 Agent 和 Skill
+cd /path/to/your-project
+speccrew update
+```
+
+- `npm install -g speccrew@latest`：更新 CLI 工具本身（新版本可能包含新的 Agent/Skill 定義、錯誤修復等）
+- `speccrew update`：將專案中的 Agent 和 Skill 定義檔案同步到最新版本
+- `speccrew update --ide cursor`：僅更新特定 IDE 的設定
+
+> **注意**：兩個步驟都需要執行。只執行 `speccrew update` 不會更新 CLI 工具本身；只執行 `npm install` 不會更新專案檔案。
 
 ### Q5: 如何查看歷史迭代？
 
@@ -404,7 +478,7 @@ iterations/
 
 ---
 
-## 7. 快速參考
+## 8. 快速參考
 
 ### Agent 啟動速查表
 
@@ -441,7 +515,7 @@ iterations/
 
 ---
 
-## 下一步
+## 9. 下一步
 
 1. 執行 `speccrew init --ide qoder` 初始化您的專案
 2. 執行第零步：專案診斷與知識庫初始化

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.1.12",
+  "version": "0.2.0",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {

package/.speccrew/skills/speccrew-create-agents/SKILL.md

@@ -1,98 +0,0 @@
----
-name: speccrew-create-agents
-description: Creates or updates tech-stack-specific Agents and project-level Skills based on project diagnosis report. Generates role Agents using predefined templates. Use after project diagnosis completion when setting up or updating the AI collaboration system.
----
-
-# Create Agents and Skills
-
-Based on the diagnosis report in `speccrew-workspace/diagnosis-reports/`, generate or update tech-stack-specific Agents and project-level Skills for the project.
-
-## Prerequisites
-
-**Must complete project diagnosis first**, ensure `speccrew-workspace/diagnosis-reports/diagnosis-report-{date}.md` exists and contains complete information. If not exists, prompt user to execute `speccrew-project-diagnosis` Skill first.
-
-**Read the latest diagnosis report**:
-1. List all diagnosis report files in `speccrew-workspace/diagnosis-reports/` directory
-2. Sort by filename date, select the latest report
-3. Read report content as generation basis
-
-## Attached Resources
-
-This Skill directory contains the following predefined files:
-
-**Agent Templates** (`templates/agents/`, used for creating tech-stack-specific Agents):
-- [templates/agents/designer-agent.md](templates/agents/designer-agent.md): Detailed Design Agent template
-- [templates/agents/dev-agent.md](templates/agents/dev-agent.md): Development Agent template
-- [templates/agents/test-agent.md](templates/agents/test-agent.md): Testing Agent template
-
-**Note**: Use these templates to create Agents by replacing `[techstack]` placeholder with actual technology stack from diagnosis report.
-
-## Preconditions
-
-Before execution, confirm the following has been obtained from the latest diagnosis report:
-- **Project Type** (Web Full-Stack / Frontend Only / Backend Only / Desktop Client / Mobile / CLI / Hybrid)
-- Actual technology stack used (language versions, core frameworks, database)
-- Directory conventions (actual paths where various files are stored)
-- Code standards (lint tools, naming conventions, run commands)
-
-## Execution Steps
-
-### Step 1: Check Existing Files
-
-Scan `agents/` and `skills/` directories, record existing files. For existing Agent files, they will be updated (not overwritten) based on latest diagnosis report in subsequent steps.
-
-### Step 2: Generate Tech-Stack-Specific Agents
-
-Read the **Recommended Agents to Generate** section from diagnosis report, create or update tech-stack-specific Agents in `agents/`:
-
-- `speccrew-designer-[techstack]` (e.g., speccrew-designer-react, speccrew-designer-fastapi) - use `templates/agents/designer-agent.md`
-- `speccrew-dev-[techstack]` (e.g., speccrew-dev-nextjs, speccrew-dev-springboot) - use `templates/agents/dev-agent.md`
-- `speccrew-test-[techstack]` (e.g., speccrew-test-playwright, speccrew-test-junit) - use `templates/agents/test-agent.md`
-
-**Template Usage**:
-- **If Agent does not exist**: Copy template, replace `[techstack]` placeholder with actual technology stack name from diagnosis report, embed project-specific information
-- **If Agent already exists**: Read existing Agent file, update technology stack info, directory paths, commands, and standards based on latest diagnosis report (preserve existing workflow logic)
-
-**Note**: Generic agents (leader-agent,pm-agent, solution-agent) are created during project initialization, not here.
-
-**Each Agent file must embed project actual information:**
-- Actual technology stack name and version (from diagnosis report)
-- Actual directory paths (from diagnosis report, no guessing)
-- Actual run/debug commands (from diagnosis report)
-- Actual code standard requirements (from diagnosis report)
-
-### Step 3: Generate Project-Level Skill Files
-
-Create or update project-level Skill directory structure in `skills/`.
-
-**Note**: Specific Skill content (such as add-page, add-api, etc.) is not generated at this stage, but gradually created by Dev Agent through `speccrew-skill-develop` Skill after identifying repetitive operation patterns during development.
-
-This step only creates necessary directory structure and basic configuration Skills (such as pre-commit-check, if configured). Existing Skill files are preserved.
-
-### Step 4: Output Generation Summary
-
-List:
-- Created files list (path + description)
-- Skipped files list (path + reason)
-- Suggested next steps
-
-## Agent File Content Standards
-
-Each Agent file must:
-1. **Embed project-specific information**, no generalized descriptions
-2. Clarify "context input" (which directory and what type of files to read)
-3. Clarify "output standards" (where to store deliverables)
-4. Include "escalate when ambiguity found" constraint
-
-## Skill File Content Standards
-
-Each Skill file must:
-1. Contain **specific file paths** (e.g., `server/routers/` instead of "router directory")
-2. Contain **verification checklist** (how to confirm operation success after completion)
-3. Keep step count within 10 steps
-
-## Notes
-
-- Check if files already exist before writing, skip if exists (no overwrite)
-- Agent description field must contain clear "when to trigger" explanation
-