agent-agile-team
Câu hỏi thường gặp
Tôi không phải lập trình viên, dùng được không?
Được ở vai người giao việc và nghiệm thu: bạn nói lời thường, đọc bản tóm tắt vài dòng ở hai cổng, và được quyền hỏi “FR3 là gì?”. Phần kỹ thuật agent làm và tự ghi.
Agent có tự push code hay deploy không?
Không. Push, PR, gộp nhánh chính, deploy là tác động ra ngoài — chỉ sau Cổng 2 và khi bạn gật. Agent cũng không bỏ hook, không force-push, không hạ ngưỡng test để qua kiểm.
Việc nhỏ có phải viết đủ bốn tài liệu?
Không. Việc 1–2 thao tác rõ ràng, không chạm vùng rủi ro, file luật hay hành động không đảo ngược, có thể làm thẳng, tự kiểm và báo kết quả. Nếu cần sprint: rất nhỏ dùng một SPRINT.md hai phần, nhỏ dùng một SPRINT.md bốn phần; từ cỡ vừa mới dùng bốn file.
Repo có chứa bảng model, giá tiền hay tài khoản nào không?
Không chứa bảng tier → model vận hành, giá tiền hay tài khoản. Bảng thực tế, danh sách từ cấm và nơi lưu bài học nằm ngoài repo, cắm vào qua biến môi trường. Bộ kiểm chỉ nhận dạng tên model đã ghi trong bằng chứng; check --self rà dấu riêng của máy.
Có cần Node, Docker hay dịch vụ ngoài không?
Không. Chỉ Git và Python 3.9+. Hai công cụ đo token (ccusage, repomix) trong skill token-economy gọi qua npx khi bạn muốn, không bắt buộc.
Chạy trên Windows được không?
Được. Bộ test chạy trên Ubuntu, Windows, macOS × Python 3.9 và 3.13 ở CI. Lưu ý duy nhất: Windows PowerShell 5.1 không mở ~ cho chương trình ngoài.
Hồ sơ sprint có bắt buộc nằm trong repo dự án không?
Không. Repo công khai thì đặt visibility: public và artifact_root trỏ ra ngoài trong .agile.json; check chặn nếu hồ sơ nội bộ lại nằm trong repo công khai.
Dùng cho việc không phải viết code được không?
Phương pháp và luật lõi viết cho phát triển phần mềm (code, test, review, nhánh git); bộ mẫu tài liệu và ba công cụ không đòi code, nhưng phần lớn skill kỹ thuật và agent reviewer là cho phần mềm.
Giới hạn hiện tại
Trung thực về chỗ chưa tới.
Chưa tới đâu
- Repo private, giấy phép chưa chọn. Người ngoài chưa clone được; chưa có bản phát hành, version đứng ở
0.3.0. - 12/13 skill tham chiếu chưa đạt ngưỡng truy xuất (chỉ
adrđạt): agent tìm đúng chỗ nhưng nội dung còn thiếu để trả lời hẳn; đang bổ sung và sẽ đổi cách đo trước khi vá tiếp. Trong 91 câu thử chỉ 1 câu Không đạt. - Tệp thử skill chạy trên một dòng model (tier T3); kết quả có thể khác trên model khác.
- Claude Desktop tab chat chưa hỗ trợ; Codex và Antigravity không nạp
agents/như agent riêng — đọc như thẻ vai. checkchứng minh hồ sơ nhất quán, không chứng minh nội dung đúng: bằng chứng vẫn do agent khác chạy;checkkhông mở link, không đọc kết quả thật trong ô bằng chứng.- Sổ tập trung:
initvàindexchưa tự ghi dòng sổ; so ngày theo ngày nên hai lần đổi trạng thái trong cùng ngày chỉ bắt được qua trạng thái. - Luật chống rò chỉ chạy khi có danh sách từ cấm (biến
AGENT_AGILE_DENYLIST); ở CI không có danh sách nên luật báoNOT_CONFIGUREDvà một test skip có lý do — không tính là Đạt. - Chưa có bản tiếng Anh của skill, phương pháp và trang giới thiệu; frontmatter và
README.mdlà tiếng Anh.