
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Trợ lý AI không có "trí nhớ kém". Chúng có  . quản trị kém Bạn đã thấy nó: 
 
 
 
 Bạn đã viết một hướng dẫn kiến trúc tỉ mỉ. Mô hình phớt lờ nó. Bạn nói “kiến trúc 4 lớp”. Nó xuất ra 3 lớp. Bạn nói “không có  ”. Nó bỏ qua   như thể đang làm ơn cho bạn. el-input <el-input v-model="value" /> Đây không phải là về trí thông minh. Đây là về các ưu đãi. Trong Claude Code,  , không phải là một ràng buộc cứng. Nếu Claude “cảm thấy” nó có thể trả lời mà không cần gọi Kỹ năng, nó sẽ làm vậy. Và  . Kỹ năng là ngữ cảnh có sẵn sổ tay dự án của bạn trở thành vật trang trí Trong nhóm của chúng tôi, xây dựng một cơ sở mã RuoYi-Plus với Claude Code, chúng tôi đã theo dõi nó: 
 
 Nếu không có sự can thiệp, Claude chủ động kích hoạt Kỹ năng dự án chỉ ~25% thời gian. Vì vậy, 3 trong số 4 lần, “quy tắc” của bạn không phải là quy tắc. Chúng là một gợi ý. Chúng tôi muốn một thứ gì đó nghiêm ngặt hơn: một cơ chế làm cho Claude hành xử ít giống một thực tập sinh thông minh và giống một kỹ sư chính thức đọc trước playbook trước khi viết mã. Giải pháp không phải là thêm nhiều lời nhắc hơn. Giải pháp là  . Hooks Sau khoảng 1 tháng lặp lại, chúng tôi đã phát hành một ngăn xếp cấu hình  : .claude 
 
 
 
 
  (quản trị) 4 hooks vòng đời  (kiến thức) 26 Kỹ năng lĩnh vực  (điều phối quy trình) lệnh gạch chéo  (chuyên gia song song) agents Kết quả: 
 
  Ít mã vi phạm quy tắc hơn, ít chu kỳ “vui lòng làm lại” hơn và ít hành động công cụ rủi ro hơn nhiều. Kích hoạt Kỹ năng cho các tác vụ phát triển: ~25% → 90%+ Bài viết này phân tích kiến trúc để bạn có thể sao chép nó vào kho lưu trữ của riêng mình. 1) Tại sao Claude Code “quên”: Kỹ năng được chọn tham gia theo mặc định Luồng mặc định của Claude Code trông như thế này: Lời nhắc người dùng → Claude trả lời (có thể gọi Kỹ năng, có thể không)
 Cái “có thể” đó là vấn đề. Heuristics quyết định nội bộ của Claude thường là: 
 
 
 “Tôi có thể trả lời nhanh chóng mà không cần ngữ cảnh bổ sung không?” không phải “Tôi   tuân thủ các quy tắc kho lưu trữ không?” phải Vì vậy, hệ thống có xu hướng thuận tiện. Những gì bạn muốn là  : một “mặt phẳng điều khiển” nhẹ chạy   Claude bắt đầu suy luận và định hình công việc mỗi lần. ma sát thể chế trước khi 2) Bước đột phá: một hook đánh giá Kỹ năng bắt buộc Chúng tôi đã triển khai một hook được kích hoạt sớm nhất có thể:  . UserPromptSubmit Nó in ra một khối chính sách ngắn mà Claude nhìn thấy   làm bất cứ điều gì khác: trước khi 
 
 
 
 Đánh giá từng Kỹ năng: có/không + lý do Nếu bất kỳ “có” nào: gọi Kỹ năng ngay lập tức Chỉ sau đó: tiếp tục triển khai Hook “đánh giá bắt buộc” (logic cốt lõi) Chúng tôi giữ cho nó đặc biệt ngớ ngẩn và xác định: 
 
 
 phát hiện các lệnh gạch chéo (cửa thoát hiểm) nếu không thì in giao thức đánh giá // .claude/hooks/skill-forced-eval.js (ý tưởng cốt lõi, đơn giản hóa)
const prompt = process.env.CLAUDE_USER_PROMPT ?? "";
​
// Cửa thoát hiểm: nếu người dùng gọi lệnh gạch chéo, hãy bỏ qua đánh giá bắt buộc
const isSlash = /^\/[^\s/]+/.test(prompt.trim());
if (isSlash) process.exit(0);
​
const skills = [
  "crud-development",
  "api-development",
  "database-ops",
  "ui-pc",
  "ui-mobile",
  // ... tiếp tục (chúng tôi có 26)
];
​
const instructions = [
  "## Giao thức Kích hoạt Kỹ năng Bắt buộc (PHẢI TUÂN THEO)",
  "",
  "### Bước 1 — Đánh giá",
  "Đối với MỖI kỹ năng, xuất ra: [kỹ năng] — Có/Không — Lý do",
  "",
  "### Bước 2 — Kích hoạt",
  "Nếu BẤT KỲ kỹ năng nào là Có → gọi Kỹ năng(<tên>) ngay lập tức.",
  "Nếu TẤT CẢ đều là Không → ghi 'Không cần kỹ năng' và tiếp tục.",
  "",
  "### Bước 3 — Triển khai",
  "Chỉ sau khi Bước 2 hoàn tất, hãy bắt đầu giải pháp thực tế.",
  "",
  "Các kỹ năng khả dụng:",
  ...skills.map(s => `- ${s}`)
].join("\n");
​
console.log(instructions);
 Thay đổi trong thực tế như thế nào Trước đây (không có hook): 
 
 “Xây dựng quản lý phiếu giảm giá.” Claude bắt đầu viết mã… và phớt lờ kiến trúc 4 lớp hoặc các thành phần bị cấm của bạn. Sau đó (hook đánh giá bắt buộc): Claude trước tiên phải tạo ra một bảng quyết định rõ ràng, sau đó kích hoạt Kỹ năng, sau đó mới triển khai. Sự thay đổi hành vi rất ấn tượng vì bạn đang loại bỏ “sự tuân thủ tùy chọn”. 3) Tại sao là 90% chứ không phải 100%? Vì chúng tôi đã cố tình thêm một  . lối tắt Khi người dùng biết họ muốn gì, gõ một lệnh như: 
 
 
 
 /dev build coupon management /crud b_coupon /check nên tức thời. Vì vậy, hook bỏ qua việc đánh giá cho các lệnh gạch chéo và cho phép quy trình lệnh tiếp quản. Đó là sự đánh đổi: 
 
 
 Quản trị cho các lời nhắc tự do Tốc độ cho các lệnh có cấu trúc 4) Hooks như một mặt phẳng điều khiển vòng đời (ngăn xếp 4 hook) Hãy coi hooks như một quy trình CI cho một phiên agent — ngoại trừ việc nó chạy trực tiếp, trong thiết bị đầu cuối của bạn. Chúng tôi sử dụng bốn điểm chính: 4.1 SessionStart: “nhìn vào kho lưu trữ trước khi bạn nói” Khi một phiên bắt đầu, chúng tôi hiển thị: 
 
 
 
 
 nhánh git hiện tại các thay đổi chưa được cam kết TODO đang mở / trạng thái các lệnh phổ biến Ví dụ đầu ra: 🚀 Phiên bắt đầu: RuoYi-Plus-Uniapp
Thời gian: 2026-02-16 21:14
Nhánh: master
​
⚠️ Thay đổi chưa được cam kết: 5 tệp
📋 TODO: 3 mở / 12 hoàn thành
​
Phím tắt:
  /dev    build feature
  /crud   generate module
  /check  verify conventions
  Claude ngừng hành động như thể nó đang bước vào một căn phòng trống. Tại sao nó quan trọng: 4.2 UserPromptSubmit: đánh giá Kỹ năng bắt buộc (kỷ luật) Đây là cổng “phải đọc sổ tay”. 4.3 PreToolUse: lớp bảo mật (quản trị công cụ) Claude Code rất mạnh mẽ vì nó có thể chạy các công cụ: Bash, viết tệp, chỉnh sửa mã. Đó cũng là cách tai nạn xảy ra. PreToolUse là tuyến phòng thủ cuối cùng của bạn trước khi điều gì đó không thể khắc phục xảy ra. Chúng tôi chặn một danh sách đen nhỏ (và cảnh báo trên danh sách xám rộng hơn): // .claude/hooks/pre-tool-use.js (khái niệm)
const cmd = process.env.CLAUDE_TOOL_INPUT ?? "";
​
const hardBlock = [
  /rm\s+(-rf|--recursive).*\s+\//i,
  /drop\s+(database|table)\b/i,
  />\s*\/dev\/sd[a-z]\b/i,
];
​
if (hardBlock.some(p => p.test(cmd))) {
  console.log(JSON.stringify({
    decision: "block",
    reason: "Dangerous command pattern detected"
  }));
  process.exit(0);
}
​
// Tùy chọn: cảnh báo/xác nhận về các hành động nhạy cảm (xóa hàng loạt, chmod -R, v.v.)
 Đây không phải là sự hoang tưởng. Chúng tôi đã thấy các mô hình “dọn dẹp các tệp tạm thời” bằng   ở sai thư mục. Bạn muốn có một thanh dẫn hướng không dựa vào việc mô hình cẩn thận. rm -rf 4.4 Stop: “đóng vòng lặp” với hướng dẫn bước tiếp theo Khi Claude hoàn thành, chúng tôi: 
 
 
 
 tóm tắt các thay đổi tệp (mới so với đã sửa đổi) đề xuất các hành động tiếp theo (chạy bài kiểm tra, cập nhật tài liệu, cam kết) tùy chọn kích hoạt agents (đánh giá mã) Ví dụ: ✅ Hoàn thành — 8 tệp đã thay đổi
​
Các bước tiếp theo:
- @code-reviewer để kiểm tra quy ước backend
- SQL đã thay đổi: đồng bộ hóa các tập lệnh di chuyển
- Xem xét: git commit -m "feat: module phiếu giảm giá"
 Mục tiêu: loại bỏ khoảng cách “nó hoạt động trong cuộc trò chuyện”. 5) Kỹ năng: lớp kiến thức mà bạn thực sự có thể thực thi Khi việc kích hoạt trở nên xác định, Kỹ năng sẽ trở thành những gì chúng được cho là: một  . cơ sở kiến thức chuyên ngành Chúng tôi đã xây dựng 26 Kỹ năng trên: 
 
 
 
 
 
 
 backend (CRUD, API, DB, chú thích, xử lý lỗi) frontend (chính sách thành phần PC, quản lý trạng thái) mobile (bộ công cụ UI, các ràng buộc nền tảng uniapp) tích hợp (thanh toán, WeChat, OSS) chất lượng (hiệu suất, bảo mật, thám tử lỗi) quản lý kỹ thuật (kiến trúc, quy trình làm việc git, quyết định công nghệ) Cấu trúc tệp Kỹ năng có thể mở rộng Mỗi   tuân theo cùng một bộ xương: SKILL.md # Tên Kỹ năng
​
## Khi nào cần kích hoạt
- Từ khóa:
- Kịch bản:
​
## Quy tắc cốt lõi
### Quy tắc 1
Giải thích + ví dụ
​
### Quy tắc 2
Giải thích + ví dụ
​
## Bị cấm
- ❌ ...
​
## Mã tham chiếu
- path/to/file
​
## Danh sách kiểm tra
- [ ] ...
 Sự nhất quán này rất quan trọng vì mô hình học cách   Kỹ năng. tiêu thụ 6) Lệnh: quy trình làm việc, không phải gợi ý Kỹ năng giải quyết “điều gì là đúng”. Lệnh giải quyết “quy trình là gì”. 6.1  : một quy trình phát triển 7 bước /dev Chúng tôi đã thiết kế   như một quy trình làm việc có quan điểm: /dev 
 
 
 
 
 
 
 
 làm rõ yêu cầu thiết kế (API + mô-đun + quyền) thiết kế DB (SQL + từ điển + menu) backend (đầu ra 4 lớp) frontend (chính sách thành phần + định tuyến) kiểm tra / xác minh cập nhật tài liệu / tiến độ Về cơ bản đó là: “cách các kỹ sư cấp cao muốn các kỹ sư cấp dưới làm việc” được mã hóa thành một tập lệnh có thể chạy. 6.2  : tạo một mô-đun đầy đủ từ một bảng /crud Đầu vào: /crud b_coupon
 Đầu ra (tập hợp ví dụ): 
 
 
 
 
 
 Thực thể / BO / VO Các quy tắc DAO + Query wrapper Service + Controller (không có mẫu bị cấm) Mapper API Frontend + khung trang Nỗ lực thủ công:     Điều khiển bằng lệnh:   (cộng với xem xét) 2–4 giờ 5–10 phút 6.3  : kiểm tra quy ước toàn bộ ngăn xếp (dễ đọc) /check Đây là nơi chúng tôi biến Kỹ năng thành một trình xác minh: 
 
 
 
 backend: quy tắc phân lớp, kế thừa bị cấm, chính sách sử dụng wrapper truy vấn frontend: thành phần bị cấm, sử dụng wrapper mobile: bộ công cụ thành phần, đơn vị, nhập khẩu 7) Agents: chuyên gia song song (không làm quá tải luồng chính) Một số tác vụ nên được xử lý bởi một agent phụ chuyên dụng: 
 
 
 : kiểm tra quy ước với danh sách kiểm tra nghiêm ngặt @code-reviewer : cập nhật tài liệu trạng thái, TODO, số liệu tiến độ @project-manager Ưu điểm không phải là “trí thông minh hơn”. Đó là   và giảm ô nhiễm ngữ cảnh trong phiên chính. phân tách trách nhiệm Một mẫu thực tế: 
 
 
 
 
 agent chính tạo mã hook Stop đề xuất xem xét bạn gọi  @code-reviewer reviewer trả về một bản diff có cấu trúc + danh sách sửa lỗi 8) Toàn bộ hệ thống: quản trị + kiến thức + quy trình + phân công lao động Đây là kiến trúc trong một câu: 
 
 Hooks thực thi hành vi, Kỹ năng cung cấp tiêu chuẩn, Lệnh mã hóa quy trình làm việc, Agents xử lý chuyên môn song song. Và có — đây là cách bạn biến một “trợ lý AI tổng quát” thành một “đồng nghiệp gốc kho lưu trữ”. 9) Thiết lập tối thiểu có thể tái tạo (thân thiện với sao chép-dán) Nếu bạn muốn phiên bản nhỏ nhất vẫn hoạt động, hãy xây dựng cái này: .claude/
  settings.json
  hooks/
    skill-forced-eval.js
    pre-tool-use.js
  skills/
    crud-development/
      SKILL.md
  tối thiểu (hook UserPromptSubmit) settings.json {
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/skill-forced-eval.js"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/pre-tool-use.js"
          }
        ]
      }
    ]
  }
}
 Sau đó lặp lại: 
 
 
 
 
 
 thêm SessionStart thêm Stop mở rộng Kỹ năng chỉ khi bạn bắt gặp “hành vi sai” lặp đi lặp lại mã hóa các quy trình làm việc lặp lại dưới dạng lệnh chuyển giao các nhiệm vụ xem xét / PM cho agents Kết luận: “khả năng” không phải là nút thắt cổ chai —   mới là vậy sự kích hoạt Mô hình của bạn đã có khả năng. Điều còn thiếu là một  . hệ thống làm cho hành vi đúng trở nên tự động Một nhân viên mới thông minh không có sổ tay sẽ tự do hành động. Một nhân viên mới thông minh với: 
 
 
 
 
 danh sách kiểm tra bắt buộc các mẫu bị cấm rõ ràng quy trình làm việc có thể lặp lại các chuyên gia cho việc xem xét và quản lý dự án …sẽ trở nên nhất quán nhanh chóng. Claude cũng vậy.

This story contains AI-generated text. The author has used AI either for research, to generate outlines, or write the text itself. 

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

Branch

Read My Stories

Nghe bài viết này bằng Tiếng Anh, đọc bởi robot thông minh của HackerNoon

Cách xây dựng lớp quản trị cho Mã Claude với Hooks, Kỹ năng và Tác nhân

About Author

BÌNH LUẬN

chuyên mục

BÀI VIẾT NÀY CŨNG CÓ MẶT TẠI

Related Stories

128 Stories To Learn About Charles Dickens

147 Stories To Learn About Reading Books Online

72 Stories To Learn About The Essays Of Adam Smith

61 Stories To Learn About Polotical Philosophy

128 Stories To Learn About Charles Dickens

147 Stories To Learn About Reading Books Online

72 Stories To Learn About The Essays Of Adam Smith

61 Stories To Learn About Polotical Philosophy

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps