Vòng lặp lõi

DWP định nghĩa một tập hợp các thao tác đưa một kế hoạch từ mục tiêu tới hoàn tất: create → execute → refine → resume → status → verify, được hỗ trợ bởi các trình trợ giúp vòng đời onboard và upgrade cùng sub-skill author (tổng cộng chín sub-skill). Cùng nhau, chúng tạo thành vòng lặp mà agent tuân theo suốt vòng đời của một kế hoạch. Các agent thực thi từng tác vụ một, kiểm chứng mỗi bước trước khi đi tiếp.

Vòng lặp này là hình thức vận hành của phát triển dựa trên đặc tả. Kế hoạch là đặc tả mà agent thực thi dựa vào, mỗi tác vụ mang tiêu chí chấp nhận rõ ràng, và bước kiểm chứng là cổng biến một tuyên bố hoàn tất thành bằng chứng của nó. Vì kế hoạch và nhật ký tiến độ của nó sống trong repository, vòng lặp có thể tiếp tục qua các phiên và các agent.

Các thao tác

Vòng lặp lõi của DWP: năm thao tác đưa kế hoạch từ mục tiêu đến công việc hoàn thành, với Xác minh là cổng kiểm tra sự phù hợp.

create — Sinh ra một kế hoạch mới từ một mục tiêu. Agent phân tích mục tiêu, phân rã nó thành các tác vụ tuần tự và viết các tệp kế hoạch. Nó nên đặt câu hỏi làm rõ trước khi viết khi mục tiêu còn mập mờ. Ở chế độ guided, agent vật liệu hóa trực tiếp một kế hoạch Lite — một đề xuất gọn nhẹ và đã có thể thực thi — và người phát triển chọn giữ nguyên, nâng cấp lên kế hoạch Full theo tệp tác vụ, chỉnh sửa, hoặc dừng lại; ở chế độ trust, agent vật liệu hóa trực tiếp biểu diễn đã chọn (Lite hoặc Full) mà không có bước rà soát. Xem đặc tả để biết cả hai biểu diễn. Việc phân tích yêu cầu và kiểm tra chất lượng kế hoạch đều chạy trong cả hai trường hợp.
execute — Chạy kế hoạch từng tác vụ một. Agent cập nhật nhật ký tiến độ sau mỗi tác vụ và đánh dấu trạng thái hoàn tất của tác vụ. Nó không được bỏ qua tác vụ mà không ghi lại lý do.
refine — Sửa đổi một kế hoạch hiện có. Agent có thể thêm, bớt hoặc sắp xếp lại các tác vụ, nhưng phải giữ nguyên công việc đã hoàn tất và cập nhật bảng tác vụ.
resume — Tiếp tục một kế hoạch bị gián đoạn. Agent đọc nhật ký tiến độ và các tệp tác vụ để tái dựng trạng thái, rồi tiếp tục từ tác vụ chưa hoàn tất đầu tiên.
status — Báo cáo tiến độ mà không thực thi. Agent tóm tắt các tác vụ đã xong, đang làm và đang chờ, và không thay đổi gì.
verify — Kiểm tra tuân thủ mà không thay đổi gì. Agent báo cáo liệu repository có đạt tiêu chuẩn hay không và liệu một kế hoạch có chỉnh dạng hay không — mỗi tác vụ mang tiêu chí chấp nhận và một cổng kiểm chứng. Xem tài liệu Tuân thủ của đặc tả.
onboard — Hướng dẫn agent tiếp cận repository dựa trên lập luận, thiết lập AGENTS.md, tài liệu hướng dẫn trong docs/ và cấu trúc .agents/.
upgrade — Nâng cấp harness repository hoặc các kế hoạch hiện có lên các phiên bản tiêu chuẩn DWP mới hơn.
author — Soạn thảo các skill, agent hoặc lệnh mới phù hợp với quy ước của repository, giữ cho danh mục tài liệu luôn đồng bộ.

Thư mục đầu ra `.dwp/`

Tất cả thành phần DWP sống dưới một thư mục .dwp/ được gitignore tại gốc repository. Giữ không gian làm việc ngoài hệ kiểm soát phiên bản nghĩa là trạng thái làm việc của một kế hoạch không bao giờ làm vẩn đục lịch sử dự án.

.dwp/
├── plans/
│   └── PLAN_001_<slug>/
│       ├── manifest.json
│       ├── contract.json
│       ├── journal.ndjson
│       ├── state.json
│       ├── README.md
│       ├── PROGRESS.md
│       ├── 1.task_<slug>.md
│       ├── 2.task_<slug>.md
│       └── analysis_results/
└── config.json

Cấu trúc tác vụ mười phần

Tệp tác vụ

01 Tiêu đề
02 Bối cảnh
03 Đọc trước khi bắt đầu
04 Mục tiêu
05 Bề mặt tác động
06 Hướng dẫn
07 Tiêu chí nghiệm thu
08 Đầu ra
09 Kiểm chứng
10 Danh sách kiểm tra thực thi và Nhật ký hoàn thành

Mỗi tệp tác vụ tuân theo mười phần có thứ tự giống nhau được định nghĩa bởi skill đã cài đặt, đảm bảo mỗi đơn vị công việc đều khép kín và có thể rà soát.

Mười phần trong sơ đồ trên định nghĩa cấu trúc giải phẫu của mỗi tệp tác vụ trong một kế hoạch Full. Trình tự này bảo đảm rằng mỗi đơn vị công việc hoàn toàn khép kín, rõ ràng và có thể kiểm toán độc lập:

Mục tiêu — một đoạn nêu rõ tác vụ đạt được điều gì.
Bối cảnh — bối cảnh, liên kết và lý do tác vụ này tồn tại.
Bề mặt chạm tới — những gì tác vụ thay đổi và lớp rủi ro lựa chọn bước kiểm chứng.
Các bước — các hành động cụ thể, có thứ tự cần thực hiện.
Tiêu chí chấp nhận — danh sách kiểm tra các điều kiện định nghĩa thế nào là hoàn tất.
Kiểm chứng — các lệnh hoặc kiểm thử cần chạy để xác minh công việc.
Tệp — các đường dẫn dự kiến được tạo hoặc sửa đổi.
Phụ thuộc — các tác vụ khác hoặc điều kiện tiên quyết bên ngoài.
Rủi ro — điều gì có thể xảy ra sai sót và biện pháp giảm thiểu.
Hoàn tất và nhật ký — một dấu trạng thái cùng các ghi chú theo trình tự thời gian.

Kiểm chứng, hoàn tất và tiếp tục

Kiểm chứng là một phần của tác vụ, không phải điều nghĩ thêm sau: mỗi tác vụ nêu tên các lệnh hoặc test chứng minh nó đã xong, và agent chạy chúng trước khi đánh dấu hoàn tất. Test ở đây là hạng nhất — một tác vụ thêm chức năng mới hoặc thay đổi hành vi phải thêm hoặc cập nhật các test tự động cho hành vi đó và chạy kiểm tra chất lượng mã đầy đủ của repository (test cùng lint và kiểm tra kiểu), không chỉ xác nhận rằng bước build thành công; các test hiện có phải tiếp tục xanh, được cập nhật theo hành vi dự kiến thay vì bị bỏ qua. Bảo mật là hạng nhất theo cùng cách đó — bất kỳ tác vụ nào chạm đến xác thực, xử lý đầu vào, bí mật, bề mặt mạng, hoặc các phụ thuộc đều mang các kỳ vọng bảo mật của thay đổi đó trong tiêu chí chấp nhận của nó và giữ mọi commit không chứa bí mật, và mọi kế hoạch khép lại bằng Final Review — bước rà soát bảo mật trên toàn bộ tập thay đổi, việc kiểm chứng đầy đủ trên trạng thái cuối cùng, và sự đối chiếu các quyết định về skill. Việc hoàn tất được ghi lại bằng một dấu trạng thái rõ ràng ([ ] chưa bắt đầu, [~] đang làm, [x] đã xong, [!] bị chặn) trong phần Completion & Log. Việc tiếp tục dựa vào các dấu này và nhật ký tiến độ — một agent có thể tái dựng chính xác nơi kế hoạch dừng lại và tiếp tục từ tác vụ chưa hoàn tất đầu tiên mà không làm lại công việc đã xong.

v6 và v7: cùng phương pháp, cấu trúc chặt chẽ hơn

Tiêu chuẩn DWP hiện tại là 7.0.0, được triển khai bởi dòng skill 7.x. Gói này mặc định dùng v7 cho mọi kế hoạch mới; một yêu cầu v6 rõ ràng vẫn tạo ra kế hoạch v6. Các kế hoạch v1, v2, v5 và v6 hiện có giữ nguyên thế hệ đã ghi nhận và không bao giờ bị di chuyển âm thầm; chuyển một kế hoạch v5 sang v6 cần yêu cầu di chuyển rõ ràng.

v6 giữ nguyên phương pháp kế hoạch → tác vụ → cổng xác thực → hoàn tất, các lệnh slash và vị trí .dwp/plans/. Cấu trúc kỹ thuật chặt chẽ hơn nhờ hợp đồng, nhật ký, manifest ngữ cảnh theo tác vụ, bộ lập lịch và việc từ chối danh sách cho phép rỗng. v7 giữ nguyên lớp bản ghi đó và bổ sung dấu đánh tác vụ parallel_safe tùy chọn, sự kiện nhật ký delegation cho công việc có giới hạn được giao cho một agent khác, và sổ đăng ký addon .dwp/config.json; khi không bật addon ủy quyền nào, mọi kế hoạch vẫn chạy tuần tự trong phiên hiện tại. Quyết định kiến trúc là GO; tính không kém hơn theo thực nghiệm của kết quả agent chưa được đo lường.