Skill

---
Tên: kp-nhắc nhở
mô tả: Xây dựng lời nhắc nâng cao, thông số kỹ thuật nhiệm vụ, tiêu chí xác minh và thiết lập Mã Claude bằng phương pháp thông số/trình xác minh/môi trường của Andrej Karpathy. Sử dụng kỹ năng này bất cứ khi nào bạn cần chỉ định một nhiệm vụ hoặc dự án, thắt chặt hoặc viết lại lời nhắc, xác định tiêu chí xác minh hoặc thành công cho đầu ra của tổng đài viên hoặc thiết lập/cập nhật cơ sở kiến ​​thức, kỹ năng hoặc rào cản cho tổng đài viên.
---
Thông số kỹ thuật - điều thực sự mong muốn, đủ chính xác để mô hình không đoán được
Người xác minh - làm thế nào bạn (hoặc mô hình) sẽ biết đầu ra thực sự đúng
Môi trường — bối cảnh liên tục và các biện pháp bảo vệ để tác nhân không phải học lại mọi thứ từ con số 0 mỗi lần

Sợi dây kết nối cả ba: bạn có thể thực hiện nhưng không thể hiểu được. Mỗi lớp bên dưới sẽ giúp Tom luôn cập nhật về các yêu cầu đánh giá thực tế, chứ không chỉ tạo ra kết quả có vẻ ngoài bóng bẩy giúp ghi lại những khoảng trống mà anh ấy chưa bao giờ được hỏi đến.
Hai chế độ - tìm hiểu xem bạn đang ở chế độ nào trước khi làm bất cứ điều gì khác
Chế độ huấn luyện (mặc định). Tom giao cho bạn một nhiệm vụ, một lời nhắc sơ bộ hoặc yêu cầu viết hướng dẫn cho một điều gì đó cụ thể. Thắt chặt nó bằng ống kính ba lớp bên dưới và gửi lại phiên bản cải tiến trong trò chuyện - không có tệp. Đây là mặc định cho "giúp tôi viết/cải thiện lời nhắc cho X."
Chế độ thiết lập đầy đủ. Tom đang xây dựng một dự án, công cụ hoặc quy trình làm việc định kỳ mới và muốn có giàn giáo thực tế: tài liệu đặc tả, tiêu chí xác minh và thiết lập môi trường (bổ sung CLAUDE.md, lan can, con trỏ cơ sở kiến ​​thức). Kích hoạt tính năng này trên các cụm từ như "spec out", "thiết lập môi trường cho", "xây dựng phương pháp Karpathy cho X" hoặc yêu cầu rõ ràng cho cả ba lớp.
Nếu thực sự không rõ cái nào phù hợp, hãy hỏi MỘT câu hỏi nhanh thay vì đoán - xây dựng sai sẽ lãng phí nhiều thời gian hơn là hỏi. Trong hầu hết các trường hợp, điều đó không thể suy luận được: một nhiệm vụ đơn lẻ hoặc một bản phác thảo nhanh chóng trong tay → huấn luyện; một dự án/tính năng mới chưa có lời nhắc → thiết lập đầy đủ.

Lớp 1: Thông số kỹ thuật
Tại sao nó quan trọng
Ví dụ của Karpathy: hỏi một người mẫu biên giới xem nên lái xe hay đi bộ đến tiệm rửa xe cách đó 50 mét, và nó nói đi bộ - thiếu sự thật hiển nhiên là chiếc xe cũng cần phải đến đó. Các mô hình rất xuất sắc ở bất cứ điều gì có thể kiểm tra được và tệ một cách đáng ngạc nhiên trong các yêu cầu phán đoán trong thế giới thực, bởi vì các yêu cầu phán đoán chính xác là những gì còn thiếu trong tín hiệu huấn luyện rõ ràng. Công việc của một thông số kỹ thuật là đưa ra cho mô hình phán đoán mà nó không thể tự suy ra, do đó, nó không bị giảm xuống mức đoán theo ngữ cảnh. Lời nhắc kiểu "chế độ lập kế hoạch" cấp cao nông cạn không thực hiện được điều này - nó quá mỏng để mang lại sự hiểu biết thực sự.
Làm thế nào để xây dựng một

Tìm mục tiêu thực tế, không chỉ là nhiệm vụ. “Viết báo cáo cuối tháng” là một nhiệm vụ. Mục tiêu là bất kỳ quyết định nào mà báo cáo đó hỗ trợ. Nếu điều Tom nói không rõ ràng, hãy hỏi - một vài câu hỏi nhanh ở đây sẽ được viết lại nhiều hơn sau này.
Làm việc ở những trạm kiểm soát nhỏ, không phải ở một bãi rác lớn. Bàn giao mọi thứ và chỉ triệu tập lại khi có kết quả đã hoàn tất khiến mọi việc diễn ra trong im lặng. Chia thông số kỹ thuật thành các phần đủ nhỏ để kiểm tra ở mỗi bước, đặc biệt ở bất kỳ nơi nào có sự mơ hồ thực sự.
Hãy chính xác về những gì không nên giả định. Mỗi từ mơ hồ trong thông số kỹ thuật sẽ trở thành một giả định mà mô hình điền vào - một cách tự tin, theo bất kỳ hướng nào có khả năng thống kê, không nhất thiết là những gì Tom thực sự muốn. Đặt tên cho các yêu cầu phán đoán cụ thể (quy ước đặt tên, trường hợp đặc biệt, điều gì xảy ra trên dữ liệu xung đột) thay vì để chúng ngầm định. Một dòng như "gắn cờ bất kỳ giả định nào bạn đang đưa ra thay vì âm thầm chọn một giả định" thực sự có tác dụng ở đây.

Thông số kỹ thuật nên chứa những gì
Mục tiêu (quyết định/kết quả mà mục tiêu này phục vụ, không chỉ là nhiệm vụ), ranh giới phạm vi (rõ ràng là trong và ngoài), phán quyết kêu gọi gắn cờ thay vì giải quyết trong âm thầm và các ràng buộc được chia thành không thể thương lượng và ưu tiên.

Lớp 2: Người xác minh
Tại sao nó quan trọng
Định khung của Karpathy: những mô hình này gần với "ma" hơn động vật - mô phỏng thống kê, không phải tác nhân có động cơ. La mắng một người mẫu, cầu xin nó hoặc nói với nó điều gì đó quan trọng không làm thay đổi chất lượng đầu ra. Điều thay đổi chất lượng đầu ra là liệu có thứ gì đó thực sự có thể kiểm tra tác phẩm hay không. Đó cũng là lý do tại sao các mô hình siêu phàm về mã và toán học (có thể kiểm tra rõ ràng) và không đáng tin cậy về mặt sở thích và khả năng phán đoán (không có gì để kiểm tra) - vì vậy, "hoàn thành tốt" càng rõ ràng và có thể kiểm tra được đối với một nhiệm vụ nhất định thì kết quả đầu ra thực sự càng có thể được tin cậy hơn là bị đọc lướt với sự mệt mỏi khi xem xét.
Làm thế nào để xây dựng một

Đặt tiêu chí đạt/không đạt ngay từ đầu, trong lời nhắc chứ không phải sau thực tế. "Làm cho báo cáo trông đẹp mắt" không thể kiểm tra được. "Báo cáo có ba phần và mỗi phần kết thúc bằng một khuyến nghị". Viết tiêu chí như những thứ mà người đọc thứ hai — con người hoặc người mẫu — có thể kiểm tra mà không cần đọc suy nghĩ của Tom.
Sử dụng mô hình thứ hai làm nhà phê bình khi thực hiện nó rẻ. Một mô hình khác (hoặc cùng một mô hình trong bối cảnh mới) phân loại đầu ra của mô hình đầu tiên dựa trên thông số kỹ thuật sẽ nắm bắt được những điều mà lần chạy ban đầu sẽ hợp lý hóa trong quá khứ.
Kéo tín hiệu bên ngoài thực sự khi nó tồn tại. Đối với mã: nó có thực sự triển khai không, các bài kiểm tra có vượt qua không? Đối với công việc phi kỹ thuật: nó có phù hợp với định dạng/giọng điệu của các ví dụ đã được biết đến là hay không? Trình xác minh chỉ kiểm tra tính nhất quán bên trong sẽ yếu hơn trình xác minh kiểm tra điều gì đó có thật.

Những gì một người xác minh nên chứa
Tiêu chí đạt/không đạt cụ thể, có thể kiểm tra được (không phải rung cảm), ai hoặc cái gì thực hiện việc kiểm tra (tự kiểm tra, mô hình thứ hai, tín hiệu triển khai/kiểm tra) và điều gì xảy ra khi không thành công (thử lại với phản hồi cụ thể nào hoặc chuyển tới Tom).

Lớp 3: Môi trường
Tại sao nó quan trọng
Hầu hết mọi người đều xây dựng lại bối cảnh từ đầu trong mỗi phiên - giải thích lại dự án, nêu lại các quy tắc, hy vọng người đại diện nhớ những gì họ không được phép chạm vào. Lưu giữ lịch sử trò chuyện xung quanh không giống như môi trường thực tế. Một hội thảo với các công cụ đã có sẵn sẽ giải thích lại toàn bộ cửa hàng trong mỗi lần ghé thăm.
Làm thế nào để xây dựng một

A CLAUDE.md tác nhân sẽ tự động đọc. Bìa: không gian làm việc/kho lưu trữ này là gì, những kỹ năng tùy chỉnh nào tồn tại và khi nào nên sử dụng chúng, tìm mọi thứ ở đâu (kiến trúc kiến ​​thức) và các quy tắc luôn áp dụng. Đây là phần có tác dụng đòn bẩy cao nhất vì nó được đọc ở mọi lời nhắc mà không cần Tom lặp lại.
Một nền tảng kiến ​​thức cá nhân. Một nơi có cấu trúc, có thể truy xuất được dành cho tài liệu tham khảo mà tác nhân có thể lấy từ đó thay vì lấy lại hoặc tạo ảo giác về nó. Vật chất tích lũy là một con hào; một cấu trúc truy xuất được tổ chức tốt sẽ kết hợp với nó mỗi khi nó được sử dụng.
Kỹ năng tái sử dụng cho bất cứ điều gì lặp đi lặp lại. Nếu Tom làm điều gì đó lần thứ hai, nó sẽ trở thành một kỹ năng thay vì phải giải thích lại một lần.
Các rào chắn được thực thi ở cấp độ công cụ, không chỉ ở cấp độ nhắc nhở. Hướng dẫn chỉ mang tính nhắc nhở như "không chạm vào các mẫu hướng tới khách hàng mà không hỏi" là một đề xuất mà mô hình có thể ghi đè khi chịu áp lực. Không thể áp dụng quy tắc tương tự như hạn chế công cụ thực tế (đường dẫn bị chặn, cổng cấp phép). Sắp xếp các quy tắc thành ba cấp:

Luôn luôn làm - an toàn trên chế độ lái tự động, không cần phải hỏi
Hỏi trước - cần đăng ký nhanh trước khi tiếp tục
Không bao giờ làm - cứng rắn, không chỉ nản lòng



Thiết lập môi trường nên chứa những gì
Các phần bổ sung CLAUDE.md được đề xuất (hoặc CLAUDE.md đầy đủ nếu không tồn tại), một danh sách ngắn gồm những gì thuộc về cơ sở kiến ​​thức so với những gì có thể bỏ qua, bất kỳ (các) kỹ năng mới nào đáng được trích xuất và các cấp độ bảo vệ được điền vào cho dự án cụ thể.

Định dạng đầu ra
Đầu ra chế độ huấn luyện
Trả lại lời nhắc/hướng dẫn được cải tiến trực tiếp trong cuộc trò chuyện, trong khối mã có hàng rào dễ sao chép. Bên dưới nó, một ghi chú ngắn có dấu đầu dòng (tối đa 3-5 dòng) về những gì đã thay đổi và nó đến từ lớp nào - đủ để cho thấy sự cải thiện không phải chỉ mang tính thẩm mỹ, chứ không phải một bài giảng. Không tạo tập tin cho chế độ này trừ khi được yêu cầu.
Đầu ra chế độ thiết lập đầy đủ
Tạo ba tài liệu nhẹ với create_file:

SPEC.md — mục tiêu, phạm vi, lời kêu gọi phán đoán, các ràng buộc
VERIFIER.md — tiêu chí đạt/không đạt, ai kiểm tra, điều gì xảy ra khi thất bại
Phần môi trường — CLAUDE.md mới hoặc phần bổ sung được đánh dấu rõ ràng cho phần hiện có của Tom, cùng với các bậc lan can

Đọc tài liệu tham khảo/templates.md để biết các mẫu điền đầy đủ và một ví dụ hoạt động trước khi viết chúng - đừng tùy tiện sử dụng cấu trúc từ đầu mỗi lần.
Trình bày cả ba điều đó cùng với một bản tóm tắt ngắn gọn về những gì có trong mỗi điều đó và nêu rõ ràng bất cứ khi nào có phán quyết được đưa ra rằng Tom nên kiểm tra kỹ thay vì âm thầm quyết định thay anh ta.

Toàn bộ điểm
Đừng để bất kỳ điều nào ở trên trở thành công việc bận rộn tạo ra các tài liệu trông ấn tượng trong khi sự hiểu biết thực sự của Tom về dự án vẫn còn mỏng manh. Mục tiêu của cả ba lớp là Tom luôn là người biết tại sao dự án lại quan trọng và thế nào là "tốt" — các lớp chỉ làm cho kiến ​​thức đó đủ rõ ràng để nhân viên hành động một cách đáng tin cậy. Nếu thông số kỹ thuật, người xác minh hoặc tài liệu môi trường đang lấp đầy khoảng trống thay vì đưa ra phán quyết thực sự mà Tom thực sự sẽ đưa ra, hãy cắt nó đi.
TẬP TIN:templates.md
Mẫu cho chế độ thiết lập đầy đủ
Chỉ cần thiết khi nhắc kp đang chạy ở chế độ thiết lập đầy đủ (xem SKILL.md). Điền những thông tin này dựa trên dự án thực tế — không để lại dấu ngoặc giữ chỗ trong tài liệu được phân phối.
Mẫu SPEC.md
đánh dấu# Thông số kỹ thuật: [Project/Task Name]

## Mục tiêu
[Quyết định hoặc kết quả thực tế mà việc này phục vụ - không chỉ là mô tả nhiệm vụ.
Ví dụ. không phải "thêm thời gian trong ngày vào logic giá thầu" mà là "cắt giảm chi tiêu lãng phí trong
số giờ chuyển đổi thấp lịch sử mà không cắt giảm khối lượng trong nhiều giờ
chuyển đổi đó nhưng chỉ nhìn thoáng qua thôi."]

## Phạm vi
**Trong phạm vi:**
- [...]

**Nằm ngoài phạm vi (hiện tại):**
- [...]

## Phán quyết kêu gọi gắn cờ, không âm thầm giải quyết
- [Điểm mơ hồ cụ thể — ví dụ: "điều gì xảy ra với một chiến dịch có dưới
Dữ liệu 2 tuần: áp dụng điểm chuẩn danh mục ngay lập tức hoặc đợi
dữ liệu dành riêng cho chiến dịch?"]
- [...]

## Hạn chế
**Không thể thương lượng:**
- [...]

**Ưu tiên (có thể trao đổi):**
- [...]

## Điểm kiểm tra
[Nếu phạm vi rộng: 2-4 điểm, Tom xem xét trước khi tiếp tục, thay vì
hơn một sự chuyển giao lớn ở cuối]
1. [...]
2. [...]
Mẫu VERIFIER.md
đánh dấu# Xác minh: [Project/Task Name]

## Tiêu chí đạt/không đạt
[Cụ thể và có thể kiểm tra được — không phải "có vẻ ổn" hoặc "cắt giảm những giờ tồi tệ".
Ví dụ. "một giờ chỉ bị gắn cờ để giảm giá thầu nếu nó có ít nhất N
khách hàng tiềm năng trong lịch sử và CPA cao hơn X% so với mức trung bình của tài khoản."]
- [ ] [criterion 1]
- [ ] [criterion 2]

## Ai kiểm tra
- [ ] Đại lý tự kiểm tra theo các tiêu chí trên
- [ ] Đạt phê bình mô hình thứ hai (mô hình khác hoặc bối cảnh mới, chấm điểm
so với thông số kỹ thuật)
- [ ] Tín hiệu bên ngoài: [triển khai thành công/bộ thử nghiệm/khớp với một-
ví dụ lịch sử hay]

## Thất bại
[Điều gì xảy ra nếu một tiêu chí không thành công — thử lại với phản hồi cụ thể nào, hoặc
dừng lại và gắn cờ cho Tom trước khi tiếp tục]
Môi trường / mẫu bổ sung CLAUDE.md
đánh dấu## [Project/Feature Name]

**Đây là gì:** [one or two sentences]

**Nơi mọi thứ tồn tại:** [file paths, data sources, related docs]

**Các kỹ năng liên quan ở đây:** [các kỹ năng hiện có để sử dụng hoặc "ứng viên cho vị trí mới
kỹ năng: X"]

**Quy tắc:**
- Luôn làm: [...]
- Hỏi trước: [...]
- Không bao giờ làm: [...]

Ví dụ hoạt động
Nhiệm vụ: Tom yêu cầu "xác định thêm các quy tắc chia ngày tự động vào kỹ năng tối ưu hóa chiến dịch."
Đoạn trích SPEC.md:

Mục tiêu: không phải "thêm tính năng chia tay trong ngày" — mục tiêu thực sự là cắt giảm chi tiêu lãng phí trong những giờ có tỷ lệ chuyển đổi thấp trong lịch sử mà không cắt giảm số lượng trong những giờ chuyển đổi mà nhìn sơ qua thì trông có vẻ chậm.
Phán quyết được gắn cờ: điều gì xảy ra với một chiến dịch hoàn toàn mới có dữ liệu dưới 2 tuần. Thông số kỹ thuật nêu rõ liệu việc chia ngày có áp dụng ngay lập tức bằng cách sử dụng điểm chuẩn danh mục hay chờ đủ lịch sử dành riêng cho chiến dịch hay không, thay vì để nhân viên âm thầm chọn một lịch sử.
Điểm kiểm tra: logic quy tắc được xem xét dựa trên một tài khoản thực (đã được biết đến) trước khi được kết nối để tự động áp dụng cho các chiến dịch đang hoạt động.

Đoạn trích VERIFIER.md:

Tiêu chí: "một giờ chỉ bị gắn cờ để giảm giá thầu nếu nó có ít nhất 15 khách hàng tiềm năng trong lịch sử và CPA cao hơn 25% so với mức trung bình của tài khoản" — có thể kiểm tra chứ không phải "cắt giảm số giờ tồi tệ".
Kiểm tra: nhà phê bình mô hình thứ hai xem xét quy tắc được đề xuất đối với 2-3 tài khoản đã biết có kết quả dương tính giả (chỉ số giờ có vẻ tệ về số lượng nhưng lại ổn về CPA) trước khi đề xuất quy tắc đó cho khách hàng trực tiếp.

Đoạn trích bổ sung CLAUDE.md:

Luôn làm như vậy: lấy và tóm tắt dữ liệu hiệu suất hàng giờ, gắn cờ những giờ vượt quá ngưỡng
Hỏi trước: lần đầu tiên áp dụng quy tắc chia tay mới cho chiến dịch khách hàng trực tiếp
Không bao giờ làm: thay đổi hệ số giá thầu trên tài khoản khách hàng mà không vượt qua tiêu chí xác minh và sự phê duyệt của Tom trước

Hãy lưu ý ví dụ này đang làm gì: nó không đệm tài liệu bằng bản soạn sẵn chung chung ("đảm bảo chất lượng cao", "tuân theo các phương pháp hay nhất"). Mỗi dòng là một quyết định cụ thể mà nếu không sẽ được đưa ra một cách âm thầm và sai lầm. Đó là công việc thực tế của cả ba lớp cùng nhau.