Một phương pháp luận 4 giai đoạn có cấu trúc để lập trình với các trợ lý AI.
🌍 Languages:
English |
Tiếng Việt |
Português |
Español |
Русский
🎥 Watch the PUDO Code System overview video
---
## Vấn đề
Bạn mở trình soạn thảo. Bạn gõ một yêu cầu mơ hồ cho trợ lý AI. Nó tạo ra thứ gì đó. Bạn dán vào. Nó chạy được một nửa. Bạn yêu cầu sửa lỗi. Nó làm hỏng thứ khác. Lặp lại quá trình này trong 3 giờ.
**Đây là lập trình hỗn loạn.** Cảm giác thì có vẻ năng suất, nhưng thực tế thì không.
Vấn đề không phải là AI — mà là **sự thiếu cấu trúc**. Không có phương pháp rõ ràng, việc lập trình với sự hỗ trợ của AI trở thành một cuộc dạo chơi ngẫu nhiên trong codebase của bạn.
## Giải pháp: PUDO
**PUDO** mang đến một chu kỳ 4 giai đoạn có thể lặp lại, biến AI từ một cỗ máy quay thưởng thành một công cụ chính xác.
| Giai đoạn | Mục tiêu | Bạn làm | AI làm |
|:---:|---|---|---|
| **(P) Plan (Lên Kế Hoạch)** | Định nghĩa *cái gì* và *tại sao* | Thiết lập phạm vi, ràng buộc, tiêu chí thành công | Lập bản nháp kế hoạch, xác định rủi ro |
| **(U) Understand (Hiểu)** | Biết *ở đâu* và *như thế nào* | Chỉ đến đoạn code liên quan, giải thích ngữ cảnh | Phân tích codebase, lập bản đồ phụ thuộc, tìm kiếm mẫu (pattern) |
| **(D) Develop (Phát Triển)** | Xây dựng *nó* | Xem xét, phê duyệt, kiểm thử | Viết code, chạy kiểm thử, theo dõi tiến độ |
| **(O) Optimize (Tối Ưu Hóa)** | Làm cho *nó tốt hơn* | Xác nhận các cải tiến, hợp nhất (merge) | Tái cấu trúc, benchmark, ghi chép thay đổi |
> **Điểm cốt lõi:** PUDO là một **chu kỳ**, không phải là một quy trình một chiều (pipeline). Bạn quay lại các giai đoạn khi bạn hiểu thêm. Một phát hiện mới trong giai đoạn Develop có thể đưa bạn trở lại Plan. Điều đó là hoàn toàn bình thường.
## Cổng Chất Lượng
Mỗi giai đoạn kết thúc bằng một cổng kiểm tra. Không chuyển sang bước tiếp theo cho đến khi cổng đó đạt, hoặc rủi ro đã được chấp nhận một cách tường minh.
| Cổng | Chạy trước khi | Phải chứng minh |
|---|---|---|
| **Plan Gate** | Understand | Phạm vi, tiêu chí thành công, ràng buộc và phần ngoài phạm vi đã rõ ràng |
| **Understand Gate** | Develop | File liên quan, kiến trúc, API và pattern đã được xác minh |
| **Develop Gate** | Optimize | Việc triển khai giữ đúng phạm vi, có test, và xử lý các edge case chính |
| **Optimize Gate** | Release | Refactor không đổi hành vi; hiệu năng, bảo mật, tài liệu và rủi ro đã được rà soát |
| **Release Gate** | Merge/deploy | Changelog, migration, rollback, monitoring và phê duyệt của owner đã được xử lý |
Hãy bắt đầu với [Quality Gates](quality/quality-gates.md), dùng [QC checklists](quality/qc-checklists.md), rà soát thay đổi do AI tạo ra bằng [AI Output Review](quality/ai-output-review.md), và lấy failure modes từ [general edge case catalogue](quality/edge-cases/general.md).
## Tác Động Kỳ Vọng
Các con số này là ước lượng thực tế theo hướng tham chiếu, không phải cam kết tuyệt đối. Hiệu quả phụ thuộc vào độ lớn của task, chất lượng repo, và mức độ team thực sự tuân thủ PUDO.
| Loại task | Giảm token rác | Giảm thời gian dev |
|---|---:|---:|
| One-line fix / script nhỏ | 0-8% | -5% đến +5% |
| Feature nhỏ/trung bình | 25-38% | 12-20% |
| Debug bug khó / production issue | 22-35% | 10-18% |
| Feature nhiều file / có test / handoff team | 35-48% | 18-28% |
| Trung bình thực tế nên claim | **34%** | **18%** |
## Bắt đầu nhanh
### 1. Bắt đầu với Plan
Trước khi viết bất kỳ dòng code nào, hãy xác định bạn đang xây dựng cái gì:
```
Tôi cần xây dựng [TÍNH_NĂNG].
Tiêu chí thành công là [TIÊU_CHÍ].
Các ràng buộc là [RÀNG_BUỘC].
Hãy tạo một kế hoạch thực hiện trước khi viết bất kỳ đoạn code nào.
```
### 2. Chuyển sang Understand
Nghiên cứu trước khi xây dựng:
```
Trước khi thực hiện, hãy phân tích codebase hiện tại:
- Những mẫu (pattern) nào đã được thiết lập?
- Những phụ thuộc (dependencies) nào có liên quan?
- Những phần nào có thể bị hỏng?
```
### 3. Thực thi trong Develop
Xây dựng có cấu trúc:
```
Thực hiện theo kế hoạch. Theo dõi tiến độ bằng danh sách công việc (task checklist).
Viết các bài kiểm thử song song với việc thực hiện.
Báo cáo bất kỳ sự sai lệch nào so với kế hoạch.
```
### 4. Đóng chu kỳ với Optimize
Đừng vội phát hành phiên bản nháp đầu tiên:
```
Xem xét việc thực hiện:
- Có những cải tiến nào về hiệu suất không?
- Code có nhất quán với các mẫu hiện có không?
- Viết một bản tóm tắt (walkthrough) những gì đã thay đổi và tại sao.
```
### 5. Lặp lại
Mọi tác vụ, mọi tính năng, mọi lỗi cần sửa. **Plan → Understand → Develop → Optimize.**
## Thư viện Prompt
PUDO đi kèm với một [thư viện prompt sẵn sàng sử dụng](prompts/) — **21 prompts** xuyên suốt 4 giai đoạn và các kỹ năng chuyên môn mà bạn có thể sao chép-dán vào bất kỳ trợ lý AI nào. Mỗi thư mục của các giai đoạn đều bao gồm một `README.md` chi tiết giải thích cách sửa đổi và mở rộng các prompts cho phù hợp với nhu cầu của nhóm bạn.
| Giai đoạn | Prompts |
|---|---|
| **(P)** Plan | [Định Nghĩa Phạm Vi](prompts/plan/scope-definition.md) · [Bản Nháp Kiến Trúc](prompts/plan/architecture-draft.md) · [Đánh Giá Rủi Ro](prompts/plan/risk-assessment.md) · [Lược Đồ Cơ Sở Dữ Liệu](prompts/plan/database-schema-design.md) · [Hợp Đồng API](prompts/plan/api-contract-design.md) · [Mô Hình Mối Đe Dọa An Ninh](prompts/plan/security-threat-model.md) |
| **(U)** Understand | [Phân Tích Codebase](prompts/understand/codebase-analysis.md) · [Kiểm Toán Phụ Thuộc](prompts/understand/dependency-audit.md) · [Nhận Diện Mẫu](prompts/understand/pattern-recognition.md) · [Phân Tích Nhật Ký Lỗi (Crash Log)](prompts/understand/crash-log-analysis.md) |
| **(D)** Develop | [Thực Hiện Tính Năng](prompts/develop/feature-implementation.md) · [Phát Triển Hướng Kiểm Thử (TDD)](prompts/develop/test-driven-dev.md) · [Dàn Giáo Component](prompts/develop/component-scaffold.md) · [Bộ Kiểm Thử Tích Hợp](prompts/develop/integration-test-suite.md) · [Bộ Kiểm Thử E2E](prompts/develop/e2e-test-suite.md) |
| **(O)** Optimize | [Đánh Giá Hiệu Suất](prompts/optimize/performance-review.md) · [Danh Sách Kiểm Tra Khi Review Code](prompts/optimize/code-review-checklist.md) · [Cơ Hội Tái Cấu Trúc](prompts/optimize/refactor-opportunities.md) · [Cấu Hình Bộ Nhớ](prompts/optimize/memory-profiling.md) · [Khắc Phục Sự Cố Mạng](prompts/optimize/network-troubleshooting.md) |
| **Skills** | [Kiến trúc & Kế hoạch](skills/plan/SKILL.md) · [Kỹ Thuật Phần mềm](skills/code/SKILL.md) · [Xử lý Sự Cố & Gỡ Lỗi](skills/debug/SKILL.md) · [Kỹ Sư DevOps](skills/devops/SKILL.md) · [Kỹ Sư Kiểm Thử (Test)](skills/test/SKILL.md) |
| **Công cụ DevOps** | [GitHub Actions](skills/devops/github-actions/SKILL.md) · [GitLab CI](skills/devops/gitlab-ci/SKILL.md) · [Argo CD](skills/devops/argo-cd/SKILL.md) · [Jenkins](skills/devops/jenkins/SKILL.md) · [Terraform](skills/devops/terraform/SKILL.md) · [Docker](skills/devops/docker/SKILL.md) · [Kubernetes](skills/devops/kubernetes/SKILL.md) |
## Tích hợp AI
PUDO được thiết kế để trở thành hệ điều hành mặc định cho các agent lập trình AI. Hãy ưu tiên định dạng cấu hình hiện hành của từng công cụ, đồng thời giữ file legacy khi chúng còn hữu ích cho các workspace cũ.
| Công cụ | File hiện có | Cấu hình khuyến nghị | Trạng thái |
|---|---|---|---|
| **Codex** | [AGENTS.md](AGENTS.md), [codex/AGENTS.md](codex/AGENTS.md) | Giữ `AGENTS.md` ở root; sao chép `codex/AGENTS.md` vào repo đích khi cần mẫu Codex đầy đủ hơn | OK |
| **Claude Code / Projects** | [CLAUDE.md](CLAUDE.md), [claude/CLAUDE.md](claude/CLAUDE.md), [.claude/settings.json](.claude/settings.json) | Dùng `CLAUDE.md` ở root làm file bridge; giữ workflow chi tiết cho Claude trong `claude/CLAUDE.md` | Đã cập nhật |
| **Cursor** | [Project Rules](cursor/.cursor/rules/pudo-core.mdc), [legacy .cursorrules](cursor/.cursorrules) | Ưu tiên `.cursor/rules/*.mdc`; giữ `.cursorrules` cho các bản Cursor cũ | Đã migrate |
| **GitHub Copilot** | [.github/copilot-instructions.md](.github/copilot-instructions.md), [.github/instructions/](.github/instructions/) | Dùng repo-wide instructions cùng các file `.instructions.md` theo path | Đã thêm |
| **OpenCode** | [opencode/opencode.md](opencode/opencode.md) | Thêm vào system prompts hoặc workspace instructions của OpenCode | OK |
| **Antigravity / Gemini-style** | [antigravity/instructions.xml](antigravity/instructions.xml) | Sao chép vào `.gemini/antigravity/instructions.xml` trong workspace đích | OK |
| **Kiro** | [kiro/system-prompt.md](kiro/system-prompt.md) | Đặt làm Kiro system prompt | OK |
## Triết lý
PUDO không chỉ là một danh sách kiểm tra — đó là một tư duy. Hãy đọc [toàn bộ triết lý](docs/philosophy.md) để hiểu các nguyên tắc đằng sau phương pháp này.
**Tóm tắt (TL;DR):**
- **Chống lại sự hỗn loạn** — Cấu trúc đánh bại sự ngẫu hứng ở quy mô lớn
- **Tính lặp lại** — Nó là một chu kỳ, không phải là thác nước (waterfall)
- **Tương thích AI** — Được thiết kế cho lập trình đôi giữa con người và AI
- **Tính toàn vẹn của giai đoạn** — Mỗi giai đoạn đều có tiêu chí đầu vào và đầu ra rõ ràng
## Khi Nào Không Nên Dùng PUDO
PUDO có thể là quá mức cần thiết cho các sửa lỗi một dòng, prototype dùng rồi bỏ, giai đoạn khám phá thuần túy, hoặc các script không quan trọng. Hãy dùng đầy đủ chu kỳ khi tính đúng đắn, khả năng bảo trì, bảo mật hoặc handoff trong nhóm là quan trọng.
## Giới Hạn Hiện Tại
- PUDO không đảm bảo output của AI là đúng.
- Review bởi con người vẫn là bắt buộc.
- Các thay đổi nhạy cảm về bảo mật vẫn cần security review riêng.
- Các ví dụ mang tính minh họa, không phải khuôn mẫu phổ quát.
- Phương pháp này đòi hỏi kỷ luật; bỏ qua quality gates sẽ đưa bạn quay lại kiểu prompting ad hoc.
## Dành Cho Ai?
- **Các lập trình viên sử dụng trợ lý AI** (ChatGPT, Claude, Gemini, Copilot, v.v.) muốn có kết quả tốt hơn
- **Các trưởng nhóm (Team leads)** đang tìm kiếm một phương pháp luận chung để phát triển phần mềm được hỗ trợ bởi AI
- **Sinh viên** đang học lập trình với AI đúng cách ngay từ ngày đầu tiên
## Đóng góp
PUDO phát triển cùng cộng đồng. Hãy xem [CONTRIBUTING.md](CONTRIBUTING.md) để biết cách:
- Thêm prompts mới vào thư viện
- Gửi các walkthrough thực tế làm ví dụ
- Cải thiện tài liệu
## Hỗ trợ & Tài trợ
Nếu bạn thấy PUDO hữu ích, hãy cân nhắc tài trợ cho dự án:
- [GitHub Sponsors](https://github.com/sponsors/DongDuong2001)
- [Patreon](https://patreon.com/DongDuong2001)
- [Ko-fi](https://ko-fi.com/dongphuduong)
- [Buy Me a Coffee](https://buymeacoffee.com/lab68dev)
- **PayPal:** dongduong840@gmail.com
## Giấy phép
[MIT](LICENSE) — Sử dụng, fork, biến nó thành của bạn.
---
Ngừng ngẫu hứng. Hãy bắt đầu PUDO.
Plan → Understand → Develop → Optimize