Trang chủ / Tính năng

Tính năng

Luật lõi, 32 skill, 13 agent, bộ mẫu tài liệu và ba công cụ kiểm — cài được trên Claude Code, Codex và Antigravity.

Lợi ích

Dành cho cả người không chuyên

Nói lời thường

Bạn mô tả việc muốn làm. Agent tự viết “làm gì” (SPEC) và “làm thế nào” (PLAN), rồi trình bản tóm tắt ngắn để bạn duyệt.

Một lượt chốt, hai cổng duyệt

Agent gom câu hỏi và khuyến nghị bậc trong một tin trước khi mở sprint. Cổng 1 duyệt kế hoạch; Cổng 2 nghiệm thu kết quả. Hỏi lẻ giữa chừng là lỗi quy trình.

Người làm không tự chấm

Agent viết code không được tự kết luận “xong”. Một agent khác kiểm và ghi bằng chứng: lệnh đã chạy, kết quả thật.

Mọi việc đều có dấu vết

Mỗi yêu cầu, sprint, quyết định có mã và nằm trong tài liệu tra được.

Việc nhỏ đi đường nhẹ

Sửa một dòng chữ không cần bốn tài liệu. Bậc việc quyết độ dày hồ sơ.

Các khối chính

Bên trong repo có gì

Quy trình sáu bước, hai cổng người

Một sprint = một mục tiêu. Agent chỉ dừng hỏi ở bốn điều kiện; chỗ kế hoạch chưa nói tới thì tự quyết và ghi lại.

Xem cách hoạt động

Kiểm định độc lập · vai và tier

Đạt chỉ đến từ bằng chứng mới chạy do agent khác ghi. Sáu vai, ba tier — giao theo năng lực, không theo tên model.

Xem vai, tier và kiểm định

32 skill và 13 agent

Skill là năng lực thường trực: agent rà danh mục trước mỗi hành động và tự gọi skill khớp tình huống.

6Quy trình 15Kỹ thuật 6Kiểm định 3Giao tiếp và tối ưu 2Meta
  • 19 skill kỷ luật có luật sắt, thử áp lực. 13 skill tham chiếu là bảng tra, thử truy xuất. Cả 32 đều có tệp thử đã chạy.
  • 12 agent chỉ đọc (reviewer theo ngôn ngữ, bảo mật, CSDL, săn lỗi bị nuốt…). build-fixer là agent duy nhất được sửa file — chỉ chỗ lỗi build đòi.
  • Skill quy trình trước, kỹ thuật sau. “Làm X” → định hình spec trước; “sửa lỗi” → debug trước.

Máy kiểm: init · check · index

Ba công cụ Python chỉ dùng thư viện chuẩn (3.9+), chạy trên Windows và macOS, không cần cài gói nào.

  • init dựng .agile.json, ba sổ gốc, khung sprint. Mặc định chạy thử, không bao giờ ghi đè.
  • check kiểm hồ sơ bằng 32 luật. Thoát 0 = Đạt, 1 = Không đạt, 2 = lỗi đầu vào.
  • check --self kiểm chính repo: lõi sạch, AGENTS.md ≤120 dòng và ≤10 KB, luật chống rò.
  • index sinh lại khối “Đang mở” ở đầu ba sổ gốc.

Sổ tập trung

  • Sổ Markdown ngoài repo, xem nhiều dự án ở một chỗ.
  • Bật bằng khoá ledger.project; đường kho sổ qua biến AGENT_AGILE_LEDGER.
  • Ghi ở năm thời điểm: mở sprint, qua Cổng 1, quay lại thực thi, Cổng 2, đóng sprint.
  • check bắt sổ lệch hồ sơ.

Chuẩn code

  • 7 chuẩn chung: phong cách, test, bảo mật, git, code review, quy trình phát triển, giao việc agent.
  • 4 chuẩn ngôn ngữ: python, typescript, react, web.
  • Không nạp vào luật lõi. Coverage mặc định 80 % cho code mới và code được sửa.

Quy tắc phiên bản

  • MAJOR.MINOR.PATCH, mỗi đợt tăng đúng một phần.
  • Dưới 1.0.0: thay đổi gãy chỉ tăng MINOR; chưa phát hành mang hậu tố -dev.
  • Agent đề xuất ở Cổng 2, bạn quyết. Không tự tăng version, không ghi đè CHANGELOG.

Nguồn gốc và giấy phép

  • Chưng cất từ các bộ skill mã nguồn mở (MIT): Superpowers, Everything Claude Code, gstack, superpowers-lab, Supabase Agent Skills; lấy ý từ GitHub Spec Kit, OpenSpec, BMAD-METHOD, Kiro/EARS.
  • Mọi skill và agent ghi source, source_sha, license; UPSTREAM.md chốt SHA từng đợt.
  • Phần từng lấy từ nguồn private đã viết lại phòng sạch; không còn file nào chờ viết lại.
  • Giấy phép của repo chưa chọn. Nội dung bên thứ ba giữ giấy phép gốc (NOTICE, THIRD_PARTY.md).
Bậc việc

Việc đơn giản đi đường nhẹ

Việc 1–2 thao tác có kết quả rõ có thể làm thẳng nếu không chạm vùng rủi ro, file luật hay hành động không đảo ngược. Việc có sprint dùng bốn cỡ để quyết độ dày hồ sơ và độ sâu kiểm định; rủi ro chỉ nâng cỡ.

CỡDấu hiệuHồ sơKiểm định
Làm thẳng1–2 thao tác, kết quả rõ; không chạm vùng rủi ro, file luật hay hành động không đảo ngượckhông mở sprint hay ghi sổ; mọi cổng xin phép khác vẫn áp dụngtự kiểm bằng kết quả mới chạy và báo ngay
Rất nhỏđổi chữ hoặc một chỗ, không đổi hành vi, lời giao đã nêu rõ kết quảmột SPRINT.md hai phần (Kế hoạch · Kết quả)tự kiểm ghi “chưa độc lập”, hoặc agent khác kiểm nhanh
Nhỏsửa cục bộ một luồng có sẵn, một yêu cầu chức năng, không đổi hợp đồngmột SPRINT.md bốn phầnmột reviewer khác người làm
Vừatính năng hay luồng mới, hoặc nhiều yêu cầu chức năngbốn file SPEC · PLAN · PROGRESS · REPORTBusiness Reviewer và Tech Reviewer
Lớnnhiều phần, đổi hợp đồng / schema, hoặc rủi ro caobốn file + kế hoạch hoàn tác; ADR khi có quyết định kiến trúcBusiness và Tech Reviewer + chuyên đề theo rủi ro

Chạm secret, xác thực, đầu vào từ ngoài, API công khai, hạ tầng, migration dữ liệu hay file luật → nhãn risk_tags, cỡ tối thiểu là lớn, dù diff chỉ một dòng. init --tiny và init --size small dựng đúng hình hồ sơ; check báo khi hồ sơ không khớp cỡ.