Bài Học Về Ngữ Cảnh Từ Cha Tôi Và Cách Sử Dụng Jira

Sau khi tốt nghiệp đại học, tôi đã dành một năm làm việc cùng cha tôi tại Labco Welding, nơi ông đã kết thúc sự nghiệp của mình với vai trò là thợ cơ khí kim loại tấm chính xác. Trước đó, ông đã làm việc tại Pratt & Whitney và New Britain Machine — vì vậy khi tôi đến, ông đã có hàng thập kỷ kinh nghiệm trong công việc chính xác.

Điều Tôi Đã Học Được

Dưới đây là những điều tôi đã ghi nhớ:

• Các công cụ của ông luôn ở trong tầm tay.
• Kế hoạch của ông được dán trên bàn, không được cất trong văn phòng.
• Nếu có điều gì không khớp với bản vẽ, ông cập nhật sơ đồ ngay tại chỗ để không ai lặp lại sai lầm đó.

Lúc đó, tôi nghĩ rằng đó chỉ là “kỷ luật trong xưởng”. Nhiều năm sau, khi trở thành một lập trình viên, tôi nhận ra đó là một nguyên tắc mà chúng ta thường xuyên bỏ qua.

Chúng ta để lại “kế hoạch” của mình (vé, nhiệm vụ, quyết định) trong Jira, Trello, hoặc một hệ thống tách biệt nào đó. Mã nguồn sống ở đây, ngữ cảnh sống ở đó — và chúng ta mất đi dòng chảy khi nhảy giữa chúng.

Phát Triển Dựa Trên Ngữ Cảnh (CDD)

Đó là lý do tại sao tôi đã làm việc về điều gì đó mà tôi gọi là Phát Triển Dựa Trên Ngữ Cảnh (CDD).

• Giữ nhiệm vụ cùng với mã nguồn.
• Cập nhật “sơ đồ” (nhiệm vụ, tài liệu hoặc ghi chú) ngay nơi công việc diễn ra.
• Đảm bảo rằng người tiếp theo — dù là đồng đội hay AI như Copilot — có ngữ cảnh thực sự, không chỉ là lý thuyết.

Tôi đã xây dựng Imdone để giúp thực hiện điều này. Nó cho phép bạn đồng bộ các vấn đề Jira vào thư mục dự án của bạn dưới dạng tệp markdown, để các lập trình viên có thể cập nhật chúng ngay trong IDE, cạnh bên mã nguồn. Các bình luận và tệp đính kèm cũng được đồng bộ hóa.

Đối với tôi, điều này giống như việc dán kế hoạch lên bàn như cha tôi đã làm — ngữ cảnh không bao giờ ngoài tầm với.

Thực Tiễn Tốt Nhất

Dưới đây là một số thực tiễn tốt nhất mà bạn có thể áp dụng để giữ ngữ cảnh gần gũi:

• Đặt tài liệu trong hệ thống quản lý mã: Thay vì để tài liệu ở nơi khác, hãy tích hợp chúng vào phiên bản mã.
• Sử dụng công cụ quản lý dự án tích hợp: Điều này giúp giữ cho các nhiệm vụ và mã nguồn ở cùng một nơi.
• Cập nhật tài liệu ngay khi có thay đổi: Đừng chờ đợi, hãy ghi chú ngay khi bạn thực hiện thay đổi trong mã.

Cạm Bẫy Thường Gặp

Một số cạm bẫy mà bạn nên tránh khi làm việc với ngữ cảnh:

• Quá nhiều công cụ: Sử dụng quá nhiều công cụ có thể tạo ra sự phân tán và mất đi ngữ cảnh.
• Không cập nhật thường xuyên: Để tài liệu không được cập nhật sẽ dẫn đến sự nhầm lẫn và sai sót.
• Thiếu sự giao tiếp giữa các thành viên: Đảm bảo mọi người trong nhóm đều hiểu và cập nhật ngữ cảnh.

Mẹo Tối Ưu Hiệu Suất

Để tối ưu hóa quy trình làm việc của bạn, hãy thử những mẹo sau:

• Sử dụng phím tắt: Tận dụng các phím tắt trong IDE để tiết kiệm thời gian.
• Tự động hóa quy trình: Sử dụng các công cụ tự động để đồng bộ hóa Jira với mã nguồn.
• Thực hiện kiểm tra mã thường xuyên: Giúp đảm bảo rằng mọi thay đổi đều được ghi nhận và không có lỗi xảy ra.

Giải Quyết Vấn Đề

Nếu bạn gặp vấn đề trong việc duy trì ngữ cảnh, hãy xem xét những giải pháp sau:

• Xác định nguyên nhân gốc rễ: Tại sao ngữ cảnh bị mất? Là do công cụ hay quy trình?
• Thực hiện các cuộc họp định kỳ: Để đảm bảo mọi người đều nắm bắt được ngữ cảnh và nhiệm vụ.
• Sử dụng bảng điều khiển trực quan: Giúp mọi người dễ dàng theo dõi tiến độ và tình trạng công việc.

Kết Luận

Ngữ cảnh là yếu tố quan trọng trong phát triển phần mềm. Bằng cách giữ ngữ cảnh gần gũi, bạn không chỉ cải thiện quy trình làm việc của mình mà còn giúp đồng đội và các AI như Copilot hiểu rõ hơn về dự án. Hãy thử áp dụng các thực tiễn tốt nhất mà chúng tôi đã đề cập và xem sự khác biệt trong công việc của bạn.

💬 Tôi tò mò: Bạn và nhóm của bạn giữ ngữ cảnh gần gũi như thế nào? Bạn có cập nhật tài liệu/nhiệm vụ trong kho mã hay mọi thứ đều sống trong Jira?