promote

Tổng quan về promote skill

promote làm gì

promote skill biến một hành vi Claude đã lặp lại và được chứng minh là hữu ích từ auto-memory thành một quy tắc dự án rõ ràng. Thay vì để một mẫu làm việc hiệu quả nằm khuất trong MEMORY.md, promote giúp chuyển nó vào CLAUDE.md, .claude/rules/<topic>.md, hoặc một file hướng dẫn Claude toàn cục để hành vi đó được áp dụng nhất quán trong các phiên làm việc sau.

Phù hợp nhất với workflow Claude tự cải thiện

Dùng promote khi đội của bạn đã để Claude học từ các lần chỉnh sửa, sở thích làm việc và quy ước dự án lặp lại, nhưng giờ cần biến một bài học trong số đó thành hướng dẫn bền vững. Skill này đặc biệt hữu ích trong các thiết lập Context Engineering, nơi MEMORY.md ghi lại quan sát còn các file rule xác định những gì agent phải tuân thủ một cách đáng tin cậy.

Ví dụ tốt gồm “luôn dùng pnpm trong repo này,” “API handlers phải validate input,” hoặc “tests cho billing code cần các fixtures này.” Ví dụ không phù hợp là sở thích dùng một lần, tranh luận chưa ngã ngũ, hoặc những rule bạn chưa từng thấy hoạt động hiệu quả trong thực tế.

Điều khiến promote skill hữu ích

Skill này không chỉ là một lời nhắc copy-paste. Nó đưa ra một workflow ra quyết định: làm rõ pattern, tìm các mục memory hỗ trợ, chọn đúng file đích, viết rule có thể thực thi trong thực tế, và giữ lại memory gốc kèm ghi chú đã promote. Điều này quan trọng vì phần khó không phải là sửa markdown; phần khó là quyết định liệu một memory có xứng đáng được áp dụng lâu dài hay không, và rule đó nên nằm ở đâu.

Cách sử dụng promote skill

Cài đặt promote và đường đọc repository

Cài skill từ GitHub skill collection bằng:

npx skills add alirezarezvani/claude-skills --skill promote

Sau đó đọc SKILL.md trước. Đường dẫn repository này hiện trình bày workflow promote trong một file duy nhất, nên không có helper scripts, references, hay rule templates để kiểm tra thêm. Điều này giúp việc áp dụng khá đơn giản, nhưng cũng có nghĩa là bạn nên xem kỹ các ví dụ lệnh và bảng chọn target trước khi dùng trên một repo quan trọng.

Cách gọi promote trong thực tế

Trigger dự kiến là /si:promote, theo sau là pattern bạn muốn biến thành quy tắc lâu dài:

• /si:promote use pnpm instead of npm
• /si:promote API handlers need validation --target rules/api.md
• /si:promote tests for auth changes must include session expiry cases --target rules/testing.md --paths "src/auth/**/*.ts"

Trước tiên skill sẽ kiểm tra bạn đang muốn nói đến hành vi nào. Nếu yêu cầu còn mơ hồ, nó nên hỏi một câu làm rõ, chẳng hạn rule này áp dụng toàn cục hay chỉ áp dụng cho một số path nhất định. Sau đó, skill tìm các mục liên quan trong file Claude auto-memory của dự án tại ~/.claude/projects/.../memory/MEMORY.md, hiển thị các kết quả khớp, và xác nhận rằng memory đó đủ cơ sở để promote.

Biến mục tiêu thô thành prompt mạnh

Một prompt yếu sẽ nói: “promote our testing preference.” Cách dùng promote tốt hơn là đưa đủ hành vi, bằng chứng, phạm vi và target nếu đã biết:

/si:promote "When changing billing code, add regression tests for failed payment and retry paths" --target rules/testing.md --paths "src/billing/**/*.ts"

Cách này hiệu quả hơn vì skill có thể viết một rule có thể thực thi, thay vì một sở thích mơ hồ. Hãy cung cấp:

• hành vi chính xác Claude cần làm theo
• rule áp dụng cho toàn dự án, một số loại file được chọn, hay tất cả dự án
• ví dụ path nếu rule có phạm vi giới hạn
• cụm từ memory hoặc sự cố đã chứng minh pattern này hữu ích

Workflow đề xuất trước khi merge rule

Sau khi promote draft hoặc chỉnh sửa rule, hãy review nó như cấu hình production. Kiểm tra xem hướng dẫn có ngắn gọn, kiểm chứng được, và không rộng hơn phần bằng chứng hỗ trợ hay không. Với hành vi áp dụng toàn dự án, CLAUDE.md thường là lựa chọn phù hợp. Với hành vi phạm vi hẹp, nên dùng .claude/rules/<topic>.md kèm path scope. Với một quy ước cá nhân áp dụng qua nhiều repository, chỉ dùng file hướng dẫn Claude toàn cục nếu pattern đó thực sự phổ quát.

FAQ về promote skill

promote dành cho Context Engineering hay prompting nói chung?

Promote có giá trị nhất với Context Engineering vì nó chuẩn hóa con đường từ hành vi đã quan sát được thành hướng dẫn bền vững. Prompt thông thường có thể yêu cầu Claude ghi nhớ điều gì đó cho một phiên làm việc; promote giúp quyết định liệu bài học đó có nên trở thành một phần trong operating context của repo hay không.

Khi nào không nên dùng promote?

Không dùng promote cho ý tưởng chưa được kiểm chứng, workaround tạm thời, sở thích cá nhân mâu thuẫn với chuẩn của đội, hoặc hướng dẫn vốn nên nằm trong application code, tests, linters, hoặc CI. Một rule hữu ích khi nó định hướng hành vi của agent; nó trở nên rủi ro khi thay thế cho cơ chế kiểm tra có thể thực thi.

Khác gì so với việc tự sửa CLAUDE.md?

Sửa thủ công vẫn có thể hiệu quả, nhưng thường bỏ qua bằng chứng và phạm vi. promote skill bổ sung một quy trình có thể lặp lại: tìm memory, xác nhận hành vi mong muốn, chọn đúng nơi đặt rule, và để lại dấu vết rằng memory đã được promote. Điều đó giảm tình trạng rule phình to và giúp người bảo trì sau này hiểu vì sao hướng dẫn đó tồn tại.

promote có thân thiện với người mới không?

Có, nếu người dùng đã hiểu project memory và rule files của Claude nằm ở đâu. Người mới nên bắt đầu với một pattern rõ ràng áp dụng toàn dự án, dùng --target claude.md, và tránh các rule giới hạn theo path cho đến khi quen với quy ước .claude/rules/.

Cách cải thiện promote skill

Cải thiện kết quả promote bằng bằng chứng tốt hơn

promote skill hoạt động tốt nhất khi memory nguồn đủ cụ thể. Trước khi gọi skill, hãy thu thập đúng mục memory, lần chỉnh sửa, hoặc lỗi lặp lại chứng minh rule là cần thiết. “Claude keeps using npm” yếu hơn “In three sessions Claude ran npm commands, but this repo uses pnpm and has no package-lock.json.”

Tránh các lỗi promote thường gặp

Lỗi phổ biến nhất là promote quá tay: biến một quan sát hẹp thành một mệnh lệnh toàn cục. Một lỗi khác là viết rule nghe có vẻ hay nhưng không hành động được, chẳng hạn “write better tests.” Rule tốt hơn cần nêu rõ trigger, hành động bắt buộc và phạm vi: “For src/api/**/*.ts, validate request bodies before calling service functions.”

Lặp lại sau rule đầu tiên được tạo

Sau output promote đầu tiên, hãy hỏi xem rule có quá rộng, quá mơ hồ, hoặc trùng với nơi khác không. Sau đó tinh chỉnh tiếp. Các prompt follow-up hữu ích gồm:

• “Make this rule enforceable in one paragraph.”
• “Narrow this to only API route files.”
• “Add one example and one non-example.”
• “Check whether this belongs in CLAUDE.md or .claude/rules/testing.md.”

Giữ hệ thống rule gọn và khỏe

Một hướng dẫn promote tốt nên bảo vệ tầng rule khỏi bị nhiễu. Hãy định kỳ review các rule đã được promote để phát hiện xung đột, quy ước lỗi thời, và những hướng dẫn nên được chuyển vào tooling. Kết quả promote tốt nhất không phải là có thêm markdown; mà là giảm số lần phải chỉnh đi chỉnh lại vì Claude đã nhận đúng context bền vững ở đúng phạm vi.