Việc áp dụng một công cụ phát triển mới hiếm khi xảy ra chỉ vì một thông báo triển khai. Nó xảy ra vì ai đó trong nhóm bắt đầu sử dụng công cụ hiệu quả, nói về nó một cách cởi mở và làm cho người khác dễ dàng theo dõi. Bộ công cụ này được thiết kế để hỗ trợ nỗ lực đó mà không biến nó thành một công việc thứ hai. Nó định hình những việc mà bạn có khả năng đã làm và cung cấp tài liệu mà bạn có thể trực tiếp đưa cho đồng nghiệp.
Công việc bạn làm với tư cách là người dẫn đầu có tác động không cân xứng. Mỗi ví dụ bạn chia sẻ rút ngắn đường học hỏi cho những kỹ sư đến sau bạn, và mỗi câu hỏi bạn trả lời công khai biến kinh nghiệm của một người thành thứ mà cả nhóm có thể xây dựng. Bạn đang đóng vai trò như một nhân tố nhân đôi cho nhóm của mình, chứ không phải là một bàn trợ giúp, và hướng dẫn này được cấu trúc để giữ vai trò đó bền vững theo những điều kiện ấy.
Cách sử dụng hướng dẫn này
Vai trò nhà vô địch bao gồm ba hành vi bổ trợ lẫn nhau: chia sẻ những gì bạn khám phá, trở thành người mà mọi người hỏi ý kiến, và mở rộng vòng tròn người dùng tích cực. Các phần dưới đây sẽ lần lượt đề cập đến từng hành vi, tiếp theo là một sổ tay 30 ngày, hướng dẫn phản hồi các mối quan tâm phổ biến, và một bảng tham khảo nhanh mà bạn có thể đưa cho bất kỳ ai.
Sử dụng những gì phù hợp với đội ngũ của bạn và gác lại những gì không phù hợp. Không có gì ở đây là một danh sách kiểm tra mà bạn được kỳ vọng phải hoàn thành; đây là một tập hợp các mô hình đã từng hoạt động hiệu quả trong nhiều tổ chức kỹ thuật.
Giai đoạn 1: Vai trò của nhà vô địch
Những gì một nhà vô địch làm
|
Hành vi |
Nó trông như thế nào trong thực tế |
Tại sao điều đó quan trọng |
|
Chia sẻ những gì bạn khám phá |
Đăng các lệnh nhắc, ảnh chụp màn hình và những thành tựu nhỏ từ công việc của bạn tại những nơi mà nhóm của bạn đã đọc, chẳng hạn như kênh kỹ thuật, chuỗi hội thoại standup hoặc phần mô tả pull-request. |
Các ví dụ lấy từ cơ sở mã của chính bạn thuyết phục hơn bất kỳ tài liệu bên ngoài nào, vì các đồng nghiệp có thể thấy chính xác cách công cụ áp dụng cho các vấn đề mà họ chia sẻ với bạn. |
|
Hãy là người mà mọi người tìm đến |
Khi một đồng nghiệp hỏi bạn cách bạn đã hoàn thành điều gì đó, hãy trả lời bằng lời nhắc thực tế mà bạn đã sử dụng để họ có thể áp dụng trực tiếp vào nhiệm vụ của chính họ. |
Một ví dụ cụ thể, có thể chạy được sẽ xóa bỏ khoảng cách giữa sự tò mò và lần sử dụng thành công đầu tiên, nơi mà hầu hết các nỗ lực áp dụng bị đình trệ. |
|
Mở rộng vòng tròn |
Thiết lập một số thói quen nhẹ nhàng, lặp đi lặp lại—chẳng hạn như một kênh riêng biệt hoặc một chủ đề hàng tuần—để động lực tiếp tục ngay cả khi sự chú ý của bạn đang hướng sang nơi khác. |
Sự chấp nhận dựa vào một người duy nhất thì mong manh. Sự chấp nhận được duy trì bởi những thói quen chung sẽ tự tiếp tục phát triển. |
Hầu hết điều này tự nhiên phù hợp với công việc bạn đang làm. Sự khác biệt là một lượng nhỏ ý định bổ sung về nơi bạn đăng các phát hiện của mình và cách câu trả lời của bạn được truyền đi.
Tại sao điều này quan trọng
Các công cụ lan rộng trong tổ chức khi có người được tin tưởng chứng minh rằng họ xứng đáng với nỗ lực đó. Tài liệu có thể mô tả những gì có thể thực hiện, nhưng ví dụ từ một đồng nghiệp—lấy từ cùng cơ sở mã, cùng quy trình làm việc và cùng giới hạn—là điều thúc đẩy mọi người chuyển từ sự tò mò sang thử nghiệm lần đầu tiên. Bằng cách làm cho trải nghiệm của chính bạn trở nên dễ thấy, bạn loại bỏ lý do phổ biến nhất khiến việc áp dụng bị trì trệ: không biết bắt đầu từ đâu.
Điều này sẽ tốn bạn bao nhiêu
Đáng để bạn đặt kỳ vọng với bản thân và với người dẫn dắt của mình. Các hoạt động dưới đây được thiết kế để phù hợp với một tuần làm việc bình thường, và vai trò này nên là một nhân tố nhân lên công việc hiện tại của bạn thay vì trở thành một trách nhiệm hỗ trợ thêm.
|
Hoạt động |
Thời gian mỗi tuần |
Hướng dẫn |
|
Đăng các chiến thắng và lời nhắc |
Khoảng 15 phút |
Bắt trọn những khoảnh khắc này bằng một bức ảnh chụp màn hình và một hoặc hai câu; tránh biến chúng thành những bài viết chính thức. |
|
Trả lời câu hỏi trong một kênh chung |
Khoảng 20 phút |
Trả lời công khai một lần, sau đó liên kết lại với câu trả lời đó khi câu hỏi xuất hiện lại. |
|
Tổ chức một chủ đề trình bày và chia sẻ hàng tuần |
Khoảng 5 phút |
Bạn đăng câu hỏi mở đầu; nhóm sẽ cung cấp nội dung. |
|
Ghép đôi hoặc hướng dẫn tùy chọn |
0–30 phút |
Dành điều này cho những đồng nghiệp thực sự bị tắc nghẽn, và đề nghịBắt đầu nhanhliên kết trước khi lên lịch. |
Giai đoạn 2: Chia sẻ những gì bạn khám phá
Kinh nghiệm của chính bạn là tài liệu thuyết phục nhất mà đồng nghiệp của bạn sẽ gặp phải, vì nó cụ thể đối với cơ sở mã, quy trình làm việc và các vấn đề mà tất cả các bạn cùng chia sẻ. Tài liệu hướng dẫn cho mọi người biết những gì có thể thực hiện; các bài đăng của bạn cho họ thấy những gì thực sự đang hoạt động trong môi trường của bạn.
Những gì đáng chia sẻ
Những bài đăng hữu ích nhất mô tả một kỹ thuật mà đồng nghiệp có thể tái sử dụng vào ngày mai hơn là một kết quả đã hoàn thành. Các kỹ thuật phát triển theo cấp số nhân khi chúng lan truyền trong một nhóm; các bản cập nhật trạng thái thì không.
|
Đáng chia sẻ (một kỹ thuật mà người khác có thể tái sử dụng) |
Ít hữu ích hơn (một bản cập nhật trạng thái) |
|
“Tôi đã học được rằng việc @-mention một thư mục hoạt động — hướng nó vào |
“Tôi đã di cư dịch vụ thanh toán cùng với Claude.” |
|
“Chế độ lập kế hoạch (Shift+Tab) hiển thị chính xác những tệp nào sẽ bị ảnh hưởng trước khi bất kỳ chỉnh sửa nào được thực hiện, đó là lý do tại sao tôi cảm thấy thoải mái khi sử dụng nó trên mã chia sẻ.” |
“Claude đã giúp tôi tiết kiệm rất nhiều thời gian trong đợt sprint này.” |
|
“Tôi đã cấu hình một Stop hook để nhận thông báo trên màn hình khi một tác vụ dài hoàn thành; cấu hình nằm trong luồng.” |
“Tuần này tôi đã đóng tám vé.” |
|
Chạy |
“Claude thật sự giỏi; bạn nên thử nó.” |
Chia sẻ ở đâu
Đăng ở đâu mà đội của bạn đã thường đọc. Mục tiêu là đặt các ví dụ vào con đường công việc bình thường thay vì tạo ra một điểm đến mới.
|
Vị trí |
Phù hợp nhất cho |
Định dạng được đề xuất |
|
A |
Những khám phá, gợi ý và những khoảnh khắc “hôm nay tôi đã học được” |
Một ảnh chụp màn hình kèm theo một hoặc hai câu ngữ cảnh |
|
Mô tả pull-request |
Minh họa phương pháp trên mã thực tế mà người đánh giá đang đọc |
Một dòng duy nhất như “Claude và tôi đã thực hiện việc tái cấu trúc này; vui lòng đi qua cách tiếp cận.” |
|
Các cuộc họp đứng hoặc cập nhật bằng văn bản hàng tuần |
Chuẩn hóa việc sử dụng với các trưởng nhóm và quản lý cấp bỏ qua |
Một câu mô tả một kết quả cụ thể |
|
Wiki nhóm hoặc tài liệu nội bộ |
Các mẫu bền, kỹ năng tùy chỉnh, và |
Một trang ngắn, được liên kết từ chủ đề kênh để nó vẫn có thể được tìm thấy |
Định dạng hoạt động
Một ảnh chụp màn hình kèm theo một dòng ngữ cảnh, hoặc một mô tả ngắn trước và sau, thường là mức chi tiết phù hợp. Giữ mỗi bài đăng đủ ngắn để người lướt qua vẫn nắm được ý chính. Một bài viết dài thường được lưu lại để đọc sau và rồi quên, trong khi một bài đăng ngắn kèm ảnh chụp màn hình có xu hướng được sao chép và thử nghiệm.
Bài viết mẫu
Những điều sau đây là minh họa về giọng điệu và độ dài chứ không phải là các bản mẫu để sao chép nguyên văn.
Hôm nay tôi đã biết rằng việc @-mention một thư mục hoạt động. Tôi đã chỉ nó vào@src/components/và hỏi những thành phần nào chưa có kiểm tra, và nó đã hiển thị hai thành phần mà tôi đã quên.
Tôi đã cấu hình một Stop hook để nhận thông báo trên màn hình khi một tác vụ dài hoàn tất. Tôi đã bắt đầu một lần tái cấu trúc, rời đi, và đã nhận thông báo khi nó hoàn thành. Cấu hình nằm trong luồng.
Chế độ lập kế hoạch là lý do tôi cảm thấy thoải mái khi sử dụng điều này trên mã quan trọng. Nhấn Shift+Tab cho đến khi bạn thấy “plan”; nó sẽ trình bày chính xác những tệp nào nó dự định tác động trước khi thay đổi bất cứ điều gì.
Giai đoạn 3: Hãy là người mà mọi người tìm đến
Khi bạn đã chia sẻ một vài ví dụ, sẽ có các câu hỏi tiếp theo. Đây là lúc vai trò nhà vô địch có sức ảnh hưởng lớn nhất, bởi vì một câu trả lời tốt cho một người thường giúp mở đường cho nhiều người khác đang theo dõi cùng kênh.
Trả lời bằng một gợi ý thay vì giải thích
Khi một đồng nghiệp hỏi bạn đã hoàn thành việc gì đó như thế nào, phản hồi hữu ích nhất là cung cấp lệnh mà bạn thực sự đã sử dụng. Họ sẽ học được nhiều hơn khi chạy lệnh đó với vấn đề của chính họ thay vì từ bất kỳ mô tả nào bạn có thể viết, và nó cung cấp cho họ điều gì đó có thể thực hiện ngay lập tức.
Đồng nghiệp:Làm thế nào bạn khiến nó phát hiện ra điều kiện tranh chấp đó?
Nhà vô địch:Tôi đã hỏi, “Bài kiểm tra trong @tests/scheduler.test.ts không ổn định — tìm hiểu tại sao,” và nó đã theo dõi hai promise chưa được nối trong scheduler. Hãy thử cách diễn đạt tương tự trên bài kiểm tra của bạn.
Chỉ vào tính năng thay vì tài liệu
Một phản hồi như “Hãy thử chế độ lập kế hoạch—nhấn Shift+Tab cho đến khi bạn thấy nó” hữu ích hơn trong lúc này so với một liên kết đến tài liệu. Nếu người đó cần tìm hiểu sâu hơn sau, họ sẽ tự tìm; ngay bây giờ họ cần một thứ duy nhất giúp họ vượt qua trở ngại.
Các câu hỏi mà bạn có khả năng nghe
Bảng dưới đây bao gồm các câu hỏi mà các nhà vô địch thường được hỏi nhất, cùng với câu trả lời gợi ý và nguồn tài nguyên để cung cấp khi người đó sẵn sàng tìm hiểu sâu hơn.
|
Câu hỏi mà bạn có khả năng nghe |
Phản hồi gợi ý |
Tài nguyên theo dõi |
|
“Tôi nên thử nó trên cái gì trước tiên?” |
Đề xuất một nhiệm vụ thực tế nhưng có phạm vi giới hạn — lý tưởng là một lỗi hoặc công việc mà người đó đã trì hoãn vì nó nhàm chán hơn là khó khăn. |
|
|
“Làm sao tôi có thể tin tưởng nó với mã của mình?” |
Giới thiệu chế độ lập kế hoạch: nhấn Shift+Tab để chuyển sang chế độ này, Claude đề xuất chính xác những gì nó dự định thay đổi, và không có gì được chỉnh sửa cho đến khi người dùng phê duyệt. |
|
|
“Việc thiết lập có đáng công sức không?” |
Việc cài đặt mất khoảng hai phút, chạy trong terminal, và không yêu cầu phần mở rộng IDE. Đang chạy |
|
|
Nó đã tạo ra một kết quả không chính xác. |
Khuyến khích họ gửi lại lỗi cho Claude — dán thông báo lỗi hoặc bài kiểm tra thất bại hiệu quả hơn nhiều so với việc diễn đạt lại yêu cầu ban đầu. |
|
|
“Nó không hiểu các quy ước trong mã nguồn của chúng ta.” |
Gợi ý chạy |
|
|
“Đây chỉ là tự động hoàn thành sao?” |
Đưa ra một minh họa ngắn gọn trong đó Claude giải thích một tệp không quen thuộc, theo dõi một lỗi qua các dịch vụ, hoặc soạn thảo kế hoạch di cư — những nhiệm vụ đòi hỏi suy luận trên toàn bộ kho lưu trữ thay vì chỉ hoàn thành một dòng đơn lẻ. |
Một buổi trình diễn trực tiếp hai phút |
|
“Còn vấn đề bảo mật và xử lý dữ liệu thì sao?” |
Chuyển câu hỏi này cho quản trị viên của bạn. Chính sách triển khai và xử lý dữ liệu của tổ chức bạn đã được cấu hình, và những người phụ trách không nên ứng biến câu trả lời này. |
Giai đoạn 4: Mở rộng vòng tròn
Mục tiêu không phải là xây dựng một chương trình hay sở hữu việc triển khai. Mục tiêu là thiết lập một số thói quen nhẹ nhàng giúp duy trì động lực ngay cả sau khi bạn đã ngừng thúc đẩy nó một cách chủ động. Khi các câu hỏi trong kênh được trả lời bởi những người khác ngoài bạn, vai trò đó đã hoàn thành công việc của mình.
Những mẫu có xu hướng hiệu quả
|
Mẫu |
Làm thế nào để chạy nó |
Cần nỗ lực |
|
Một kênh chuyên dụng |
Tạo một |
Khoảng năm phút để thiết lập, sau đó là không gian xung quanh |
|
Một chủ đề kể và khoe hàng tuần |
Mỗi thứ Sáu, đăng “Claude đã giúp bạn những gì trong tuần này?” Không cần chuẩn bị, slide hay họp; chỉ cần ảnh chụp màn hình và mô tả ngắn là đủ. |
Khoảng hai phút mỗi tuần |
|
Chia sẻ một kỹ năng tùy chỉnh |
Đăng bài hữu ích nhất của bạn |
Khoảng năm phút cho mỗi kỹ năng |
|
Ghép đôi cho nhiệm vụ đầu tiên |
Cung cấp một buổi ghép đôi kéo dài mười lăm phút cho bất kỳ ai mới bắt đầu. Một kết quả thành công trên mã của chính họ thuyết phục hơn bất kỳ bài thuyết trình nào. |
Khoảng mười lăm phút mỗi người |
|
Xác định nhà vô địch tiếp theo |
Đồng nghiệp hỏi bạn nhiều câu hỏi nhất thường sẵn sàng đảm nhận vai trò này. Chuyển cho họ bộ kit này và phân chia các trách nhiệm kênh giữa các bạn. |
Không đáng kể |
Một cuốn sổ tay ba mươi ngày
Nếu một kế hoạch linh hoạt là hữu ích, trình tự dưới đây phản ánh những gì thường có hiệu quả đối với hầu hết các đội. Điều chỉnh tự do để phù hợp với bối cảnh của bạn.
|
Tuần |
Hoạt động được đề xuất |
Phát tín hiệu rằng nó đang hoạt động |
|
Tuần 1 |
Tạo kênh, ghimBắt đầu nhanh, và đăng hai hoặc ba ví dụ của riêng bạn với các lời nhắc đi kèm. |
Một vài đồng nghiệp phản ứng hoặc trả lời, và ít nhất một câu hỏi được đặt ra trong kênh. |
|
Tuần 2 |
Bắt đầu chủ đề chia sẻ hàng tuần, trả lời mọi câu hỏi công khai, và chia sẻ một kỹ năng tùy chỉnh hoặc |
Một người khác ngoài bạn đăng một ví dụ của riêng họ. |
|
Tuần 3 |
Cung cấp hai hoặc ba buổi kết đôi ngắn và tổng hợp các câu hỏi và câu trả lời phổ biến nhất vào một tin nhắn FAQ được ghim. |
Bạn thấy việc sử dụng lặp lại — những đồng nghiệp cùng quay lại thay vì thử một lần rồi dừng lại. |
|
Tuần 4 |
Xác định một nhà vô địch thứ hai và chia sẻ một bản tóm tắt ngắn gọn về những gì đang hiệu quả và những gì không hiệu quả với người dẫn dắt hoặc quản trị viên của bạn. |
Các câu hỏi trong kênh đang được trả lời bởi những người khác không phải bạn. |
Khi ai đó muốn đi sâu hơn
Bạn là sự giới thiệu ấm áp hơn là chương trình định hướng. Khi một đồng nghiệp vượt qua giai đoạn “tôi có nên thử cái này không” sang “làm thế nào để tôi trở nên hiệu quả với nó,” hãy hướng họ đến tài liệu chính thứcBắt đầu nhanhvàCác quy trình làm việc phổ biếnTrang. Chúng chứa các phần ngắn đề cập đến những tính năng thực sự hữu ích nhưng khó tự khám phá.
Giai đoạn 5: Đáp lại các mối quan ngại thường gặp
Sự hoài nghi lành mạnh là điều có thể dự đoán được; các kỹ sư nên thận trọng với các công cụ mới. Phản ứng hiệu quả nhất hiếm khi là tranh luận về trường hợp chung. Thay vào đó, hãy thừa nhận mối quan ngại, đưa ra một diễn giải ngắn gọn và đề xuất một minh chứng cụ thể trên chính mã của người đó. Hầu hết các mối quan ngại được giải quyết bằng một trải nghiệm thành công duy nhất.
|
Mối quan tâm |
Phản hồi gợi ý |
Bằng chứng để cung cấp |
|
“Tôi nhanh hơn khi không có nó.” |
Điều đó có khả năng đúng với mã mà người đó viết thường xuyên. Gợi ý thử áp dụng nó vào công việc mà họ thường tránh — các tệp kế thừa, dịch vụ chưa quen thuộc, hoặc bộ khung kiểm thử — nơi tác động là cao nhất. |
Đo thời gian hoàn thành một nhiệm vụ tẻ nhạt theo cả hai cách và so sánh. |
|
Tôi không tin tưởng AI để chỉnh sửa mã sản xuất. |
Đồng ý rằng không có thay đổi nào nên được áp dụng mà chưa được đọc. Chế độ lập kế hoạch kết hợp với việc xem xét khác biệt thông thường có nghĩa là không có gì được áp dụng mà kỹ sư chưa kiểm tra — cùng tiêu chuẩn như bất kỳ yêu cầu kéo nào. |
Trình bày chế độ lập kế hoạch trên một tệp thực. |
|
“Nó sẽ làm các kỹ sư cấp dưới yếu đi.” |
Nếu sử dụng đúng cách, nó là một công cụ giải thích hiệu quả. Khuyến khích các kỹ sư cấp dưới yêu cầu Claude giải thích một tập tin và các vị trí gọi của nó trước khi yêu cầu thay đổi bất cứ điều gì. |
Chạy “Giải thích @file và nơi nó được gọi từ” cùng nhau. |
|
“Tôi đã thử một lần và nó bị ảo giác.” |
Điều này thường là vấn đề về ngữ cảnh hơn là vấn đề về mô hình. @-đề cập các tệp liên quan, chạy |
Chạy lại câu lệnh gốc của họ với @-context đúng. |
|
“Chúng tôi không có thời gian để học một công cụ khác.” |
Claude Code là một lệnh terminal hơn là một nền tảng. Nếu nó không trả về giá trị trong phiên đầu tiên, thì việc đặt nó sang một bên là hợp lý. |
Cài đặt hai phút theo sau bởi một lỗi thật. |
Phụ lục: Bảng tham khảo nhanh
Các kỹ thuật dưới đây là những kỹ thuật đáng tin cậy nhất để đưa ai đó từ lần thử đầu tiên đến việc sử dụng hàng ngày. Bảng này được thiết kế để ghim trong một kênh hoặc chia sẻ riêng lẻ.
|
Kỹ thuật |
Cách áp dụng nó |
|
Cung cấp bối cảnh phù hợp |
Sử dụng |
|
Xem lại kế hoạch trước khi chỉnh sửa |
NhấnShift+Tabđể vào chế độ lập kế hoạch. Claude sẽ mô tả các thay đổi dự kiến để bạn phê duyệt trước khi thực hiện chúng. |
|
Dạy nó kho lưu trữ của bạn |
Chạy |
|
Tái sử dụng một quy trình công việc |
Lưu một |
|
Luôn cập nhật thông tin trong suốt các nhiệm vụ dài |
Cấu hình một Stop hook để nhận thông báo trên máy tính khi một tác vụ chạy lâu hoàn tất. |
|
Phục hồi từ kết quả sai |
Thay vì diễn đạt lại yêu cầu, hãy dán bản kiểm tra không thành công hoặc ngăn xếp lỗi trở lại cho Claude và yêu cầu nó giải quyết lỗi cụ thể đó. |
|
Giữ các chỉnh sửa mang tính chính xác |
Yêu cầu một bản diff, hoặc chỉ định “chỉ thay đổi X.” Claude tôn trọng phạm vi khi phạm vi được nêu rõ. |
Phụ lục: Thư mục tài nguyên
|
Tài nguyên |
Liên kết |
|
Bắt đầu nhanh |
|
|
Các quy trình làm việc phổ biến |
|
|
Kỹ năng |
|
|
Học viện Anthropic |
|
|
Tài liệu đầy đủ về mã Claude |
Cảm ơn bạn đã đảm nhận vai trò này. Mọi người sử dụng công cụ mới vì có người mà họ tin tưởng cho họ thấy rằng nó đáng để bỏ công sức, và đó là đóng góp mà bạn đang thực hiện. Claude Code được cập nhật thường xuyên; vui lòng xác minh các chi tiết theo phiên bản đối chiếu vớicode.claude.com/docstrước khi phân phối tài liệu này nội bộ.
Hỗ trợ tư vấn, đào tạo và chuyển giao giải pháp AI cho cá nhân, doanh nghiệp và tổ chức.
Liên hệ qua Zalo
