Tối ưu hóa quy trình viết code bằng AI với Oh My Codex

Tối ưu hóa quy trình viết code bằng AI với Oh My Codex

Nếu bạn đã sử dụng OpenAI Codex CLI được một thời gian, có lẽ bạn đã nhận ra một điều: nó cực kỳ mạnh mẽ, nhưng cảm giác như đang lái một chiếc xe đua không có vô lăng. Bạn có sức mạnh thô sơ, nhưng quy trình làm việc hoàn toàn phụ thuộc vào bạn tự xoay xở.

Đó chính là lúc Oh My Codex xuất hiện. Với gần 3.000 sao (stars) chỉ trong một ngày và hơn 12.000 sao tổng cộng, lớp công cụ nâng cao quy trình này đang giải quyết một trong những vấn đề đau đầu nhất đối với các lập trình viên sử dụng tác nhân AI: các quy trình làm việc hỗn loạn, thiếu nhất quán khiến bạn khó đoán được tác nhân thực sự đã làm gì.

Tại sao công cụ này lại quan trọng

Vấn đề không phải là các trợ lý lập trình AI thiếu khả năng. Vấn đề nằm ở việc điều phối (orchestration). Bạn bắt đầu một phiên làm việc, làm rõ yêu cầu, lặp lại các giải pháp, và ở giữa chừng, bạn bị mất ngữ cảnh. Tác nhân có hiểu đầy đủ phạm vi không? Nó có tuân thủ các phương pháp hay nhất không? Bạn có đang giải quyết đúng vấn đề không?

Oh My Codex giải quyết trực tiếp vấn đề này bằng cách cung cấp:

• Quy trình có cấu trúc hướng dẫn bạn từ bước làm rõ yêu cầu đến khi hoàn thành
• Đội ngũ tác nhân cho các tác vụ đa bước phức tạp
• Quản lý trạng thái liên tục để bạn có thể tiếp tục công việc từ nơi bạn đã dừng lại
• Các kỹ năng chuẩn (canonical skills) thực thi các mẫu thực thi nhất quán

Nó giữ Codex làm động cơ thực thi nhưng bọc nó trong các "rào chắn" mà phần lớn chúng ta không nhận ra mình cần đến.

Bắt đầu nhanh

Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo bạn có:

• OpenAI Codex CLI đã được cài đặt và cấu hình
• Node.js phiên bản 18 trở lên
• Hiểu biết cơ bản về cách các trợ lý lập trình AI hoạt động

Cài đặt

# Clone kho lưu trữ
git clone https://github.com/Yeachan-Heo/oh-my-codex.git

# Di chuyển vào thư mục
cd oh-my-codex

# Cài đặt các dependencies
npm install

# Link toàn cục (tùy chọn, để truy cập dễ dàng hơn)
npm link

Cấu hình

Oh My Codex sử dụng tệp cấu hình để xác định quy trình làm việc và hành vi của tác nhân. Hãy tạo tệp .codex-workflow.yml trong thư mục gốc dự án của bạn:

workflows:
  default: $deep-interview

skills:
  $deep-interview:
    description: "Làm rõ yêu cầu trước khi viết code"
    steps:
      - analyze_request
      - ask_clarifying_questions
      - confirm_understanding
      - propose_approach
      - execute

  $ralplan:
    description: "Lập kế hoạch trước khi triển khai"
    steps:
      - decompose_problem
      - identify_dependencies
      - create_task_list
      - estimate_effort
      - present_plan

Các kỹ năng chuẩn (Canonical Skills)

Sức mạnh thực sự của Oh My Codex đến từ các kỹ năng có sẵn (pre-built). Hãy cùng tìm hiểu những cái hữu ích nhất.

$deep-interview: Ngừng đoán mò, bắt đầu làm rõ

Kỹ năng $deep-interview có lẽ là cái hữu ích ngay lập tức. Thay vì để Codex lao thẳng vào viết code, nó ép buộc một giai đoạn làm rõ yêu cầu trước.

Cách hoạt động:

1. Bạn mô tả yêu cầu của mình
2. Tác nhân phân tích và xác định các điểm mơ hồ
3. Nó đặt các câu hỏi làm rõ targeted
4. Chỉ sau khi được xác nhận, nó mới tiến hành

Ví dụ phiên làm việc:

Bạn: Thêm xác thực người dùng vào ứng dụng Express của tôi

Tác nhân: Tôi muốn làm rõ một vài điều trước khi chúng ta tiếp tục:

1. Đây có nên là xác thực email/mật khẩu, hay bạn muốn nhà cung cấp OAuth?
2. Bạn cần quản lý phiên (session) hay token JWT?
3. Đã có cơ sở dữ liệu người dùng nào chưa, hay tôi nên tạo cái mới?
4. Bạn có muốn chức năng đặt lại mật khẩu không?

Vui lòng xác nhận hoặc làm rõ các điểm này.

Mô hình đơn giản này ngăn chặn hội chứng "tôi xây dựng sai thứ" gây lãng phí hàng giờ phát triển.

$ralplan: Phân rã trước khi bạn code

Kỹ năng $ralplan (được đặt tên theo phương pháp luận RALPH) chia nhỏ các tác vụ phức tạp thành các phần có thể quản lý được. Nó đặc biệt hữu ích cho các tính năng chạm đến nhiều phần của cơ sở mã (codebase) của bạn.

Cách sử dụng:

codex-workflow run $ralplan "Thêm thông báo thời gian thực vào bảng điều khiển"

Kết quả đầu ra:

Phân rã tác vụ: Thêm thông báo thời gian thực

Giai đoạn 1: Cơ sở hạ tầng Backend
  - Thiết lập máy chủ WebSocket (ước tính: 2h)
  - Tạo mô hình thông báo (ước tính: 30p)
  - Thêm endpoints thông báo (ước tính: 1h)

Giai đoạn 2: Tích hợp Frontend
  - Tạo thành phần thông báo (ước tính: 1.5h)
  - Triển khai kết nối thời gian thực (ước tính: 1h)
  - Thêm huy hiệu thông báo (ước tính: 30p)

Giai đoạn 3: Hoàn thiện
  - Thêm hiệu ứng âm thanh (ước tính: 30p)
  - Xử lý tình huống ngoại tuyến (ước tính: 1h)

Tổng ước tính: 7.5 giờ

Tiếp tục với kế hoạch này? [y/n/edit]

$team: Nhiều tác nhân, Một mục tiêu

Đối với các tác vụ phức tạp, kỹ năng $team tạo ra nhiều tác nhân chuyên biệt làm việc cùng nhau. Hãy tưởng tượng nó giống như việc có một dev junior, một kiến trúc sư senior và một kỹ sư QA đều làm việc trên tính năng của bạn cùng một lúc.

Khi nào nên sử dụng:

• Các lần tái cấu trúc (refactor) lớn cần lập kế hoạch cẩn thận
• Tính năng yêu cầu thay đổi cả frontend và backend
• Các tác vụ có yêu cầu kiểm thử đáng kể

teams:
  fullstack-feature:
    agents:
      - role: architect
        focus: "Thiết kế và cấu trúc"
      - role: implementer
        focus: "Viết code"
      - role: reviewer
        focus: "Chất lượng và các phương pháp hay nhất"

$ralph: Quy trình hoàn chỉnh

Kỹ năng $ralph kết hợp mọi thứ thành một quy trình làm việc toàn diện:

1. Requirements gathering (thu thập yêu cầu - deep-interview)
2. Analysis and planning (phân tích và lập kế hoạch - ralplan)
3. Layout the implementation (bố cục triển khai)
4. Proceed with coding (tiếp tục viết code)
5. Handle edge cases (xử lý các trường hợp ngoại lệ)

Đây là cách tiếp cận "tất cả trong một" và hoạt động tốt nhất cho các tính năng quan trọng hoặc các dự án mới.

Các tình huống thực tế

Tình huống 1: Yêu cầu tính năng mơ hồ

Quản lý sản phẩm (PM) của bạn gửi tin nhắn Slack: "Thêm tìm kiếm vào bảng quản trị."

Không có Oh My Codex, một tác nhân AI có thể:

• Lập tức bắt đầu triển khai một tìm kiếm cơ bản
• Sử dụng công nghệ tìm kiếm sai
• Bỏ lỡ các yêu cầu quan trọng như bộ lọc hoặc phân trang

Với $deep-interview:

Tác nhân: Tôi cần làm rõ các yêu cầu tìm kiếm:

1. Các thực thể nào nên có thể tìm kiếm? (người dùng, đơn hàng, sản phẩm, tất cả?)
2. Bạn cần khớp mờ (fuzzy matching) hay khớp chính xác?
3. Kết quả có nên được phân trang không? Nếu có, bao nhiêu mỗi trang?
4. Bạn có cần các bộ lọc nâng cao (theo ngày, trạng thái, v.v.) không?
5. Có ưu tiên nào về công nghệ tìm kiếm không? (database LIKE, Elasticsearch, Meilisearch?)

PM làm rõ, và bạn xây dựng chính xác những gì cần thiết - ngay lần đầu tiên.

Tình huống 2: Cuộc tái cấu trúc khổng lồ

Bạn cần di chuyển từ REST sang GraphQL trên toàn bộ codebase gồm 50 tệp.

Sử dụng $team:

codex-workflow run $team --config refactor-team.yml "Chuyển đổi endpoints REST sang GraphQL"

Cấu hình đội của bạn:

refactor-team:
  agents:
    - role: architect
      prompt: "Phân tích các endpoints REST và thiết kế lược đồ GraphQL"
    - role: implementer
      prompt: "Tạo các resolvers và cập nhật mã client"
    - role: reviewer
      prompt: "Kiểm tra các endpoints bị bỏ sót và phạm vi kiểm thử"

Mỗi tác nhân xử lý chuyên môn của họ và bạn nhận được một cuộc tái cấu trúc được phối hợp thay vì sự hỗn loạn.

Tình huống 3: Dự án dang dở

Bạn quay lại dự án sau một tuần vắng mặt. Bạn đang làm cái gì nhỉ?

Với trạng thái liên tục của Oh My Codex:

codex-workflow status

Current session: user-auth-feature
Last activity: 6 days ago
Status: In progress - Phase 2 of 3
Next step: Implement password reset flow
Context: Using JWT tokens, bcrypt for hashing, email service configured

Bạn bắt kịp tiến độ trong vài giây chứ không phải hàng giờ.

Câu hỏi thường gặp

Câu hỏi: Điều này có thay thế Codex CLI không?

Không, nó nâng cấp Codex. Codex vẫn là động cơ thực thi. Oh My Codex thêm lớp quy trình lên trên.

Câu hỏi: Điều này có làm chậm các tác vụ đơn giản không?

Đối với các tác vụ tầm thường (sửa lỗi chính tả, thêm một hàm đơn giản), bạn có thể bỏ qua quy trình. Nhưng đối với bất kỳ thứ gì cần suy nghĩ, việc làm rõ trước sẽ tiết kiệm thời gian tổng thể.

Câu hỏi: Tôi có thể tạo quy trình tùy chỉnh không?

Có. Xác định quy trình của riêng bạn trong tệp cấu hình. Hệ thống kỹ năng được thiết kế để mở rộng.

Câu hỏi: Thế còn việc sử dụng token thì sao?

Các giai đoạn làm rõ sử dụng thêm token. Tuy nhiên, hãy xem xét việc này: việc làm rõ trước sẽ rẻ hơn là tạo ra code sai, gỡ lỗi và tạo lại.

Câu hỏi: Công cụ này đã sẵn sàng cho môi trường sản xuất không?

Với hơn 12.000 sao và sự phát triển tích cực, nó đang được nhiều lập trình viên sử dụng. Như mọi công cụ, hãy xem xét những gì nó tạo ra trước khi commit.

Xử lý sự cố

Lỗi "Skill not found"

Hãy đảm bảo bạn đã liên kết gói toàn cục hoặc đang chạy từ thư mục cài đặt:

# Liên kết toàn cục
npm link

# Hoặc sử dụng đường dẫn đầy đủ
./node_modules/.bin/codex-workflow run $deep-interview

Quy trình có vẻ bị kẹt

Kiểm tra xem tác nhân có đang chờ đầu vào của bạn không. Quy trình làm việc của Oh My Codex được thiết kế để tương tác — chúng tạm dừng để xác nhận của bạn tại các điểm ra quyết định chính.

Kết quả không nhất quán

Xem lại tệp cấu hình của bạn. Các kỹ năng có thể được tùy chỉnh và bạn có thể có cài đặt xung đột. Bắt đầu với mặc định và điều chỉnh tăng dần.

Kết luận

Các trợ lý lập trình AI chỉ tốt bằng các quy trình làm việc xung quanh chúng. Oh My Codex nhận ra sự thật cơ bản này và cung cấp cấu trúc mà phần lớn chúng ta đã tự tay ghépép một cách vụng về.

Các kỹ năng chuẩn — $deep-interview, $ralplan, $team, và $ralph — cung cấp cho bạn vốn từ vựng để mô tả cách bạn muốn công việc tiến triển. Thay vì một nút "bắt đầu" duy nhất, bạn có một bảng điều khiển với các tùy chọn có ý nghĩa.

Quan trọng nhất, nó giữ Codex làm động cơ thực thi. Đây không phải là sự thay thế; nó là sự nâng cấp làm cho sức mạnh cơ bản trở nên dễ tiếp cận và dễ dự đoán hơn.

Nếu bạn từng cảm thấy các phiên lập trình AI của mình hỗn loạn hoặc bạn dành nhiều thời gian sửa lỗi tác nhân hơn là viết code, Oh My Codex đáng để bạn cân nhắc nghiêm túc. Việc cài đặt chỉ mất vài phút, và lợi suất tăng lên theo cấp số nhân với mỗi phiên làm việc.

Liên kết:

• Oh My Codex trên GitHub
• Tài liệu Codex CLI