Chuyển tới nội dung chính

Second brain: thư mục Brain

Brain là một thư mục thường trên máy bạn, nơi BimSpeed AI lưu quy tắc chung, skill của bạn, tài liệu tra cứu và ghi nhớ theo từng dự án. Trợ lý đọc thư mục này ở đầu mỗi cuộc chat, nên bạn chỉ cần dặn một lần.

Tính năng đang thử nghiệm

BimSpeed AI đang trong giai đoạn thử nghiệm. Cấu trúc thư mục có thể thay đổi trước khi phát hành chính thức.

Vị trí mặc định​

Documents\BimSpeed AI

Thư mục được tạo tự động khi bạn dùng khung lần đầu. BimSpeed chỉ tạo tệp khi chưa có và không bao giờ ghi đè tệp bạn đã sửa.

Mở thư mục: bấm nút Brain ở đầu khung rồi Mở thư mục, hoặc gõ /brain.

Bên trong có gì​

BimSpeed AI\
├─ AGENTS.md                 quy tắc chung cho trợ lý (bạn sửa được)
├─ CLAUDE.md                 bản sao quy tắc cho Claude Code
├─ .claude\skills\           skill của bạn
│   ├─ README.md
│   └─ vi-du\SKILL.md        skill mẫu
├─ knowledge\                tài liệu tra cứu dùng chung mọi dự án
│   └─ README.md
├─ templates\                mẫu của bạn
└─ projects\
    └─ <tên model>-<mã>\     mỗi model một thư mục
        ├─ PROJECT.md        thông tin model
        ├─ memory.md         thông số đã chốt
        ├─ chats\            các cuộc chat đã lưu
        └─ outputs\          báo cáo trợ lý tạo ra
MụcDùng để làm gì
AGENTS.mdQuy tắc chung cho trợ lý (cách trả lời, cách xử lý tình huống, ghi nhớ). Thêm quy ước riêng của công ty vào cuối tệp này; trợ lý đọc ở mọi cuộc chat
CLAUDE.mdBản sao quy tắc cho Claude Code. Quy ước của bạn nên viết ở AGENTS.md
.claude\skillsSkill bạn tự viết, xem bên dưới
knowledgeTài liệu căn cứ: TCVN, quy định công ty, bảng tra thép, quy ước đặt tên...
projects\...\PROJECT.mdTạo tự động lần đầu mở model: tên, đường dẫn, phiên bản Revit, số trục, các tầng. Bạn có thể bổ sung chủ đầu tư, tiêu chuẩn áp dụng, quy ước
projects\...\memory.mdTrợ lý ghi các thông số và quyết định bạn đã chốt (kèm ngày). Bạn có thể sửa tay
projects\...\chatsNội dung các cuộc chat của model này, dùng cho /resume
projects\...\outputsBáo cáo, bảng thống kê do trợ lý tạo (ví dụ báo cáo kiểm tra model)

Mỗi model có thư mục dự án riêng, tạo từ tên model. Model chưa lưu dùng chung một thư mục tạm, hãy lưu model sớm để có thư mục riêng.

Trợ lý dùng Brain như thế nào​

  • Đầu cuộc chat, trợ lý đọc PROJECT.md và memory.md của model đang mở.
  • Trước khi hỏi lại bạn một thông số, trợ lý tra memory.md rồi tra thư mục knowledge.
  • Khi dùng thông số lấy từ tài liệu, trợ lý nêu tên tệp nguồn để bạn kiểm chứng. Không có căn cứ thì trợ lý hỏi bạn, không tự suy diễn thép chịu lực.
  • Khi bạn chốt một thông số (lớp bảo vệ, loại thép mặc định, quy ước đặt tên...), trợ lý ghi ngắn gọn vào memory.md.
  • Tệp kết quả được ghi vào outputs.

Thêm tài liệu của bạn​

  1. Chép tài liệu vào thư mục knowledge.
  2. Nên dùng định dạng .md hoặc .txt (UTF-8). PDF đọc được nhưng chậm và dễ sai bảng; nên kèm một bản .md trích phần cần dùng.
  3. Đặt tên tệp có nghĩa, ví dụ TCVN-5574-2018-lop-bao-ve.md, quy-dinh-cong-ty-thep-dam.md.
  4. Tạo tệp INDEX.md liệt kê từng tệp kèm một dòng mô tả để trợ lý tìm nhanh.
Quy ước chung của công ty

Quy ước áp dụng cho mọi dự án (ví dụ "luôn hỏi lớp bảo vệ trước khi đặt thép") hãy viết vào AGENTS.md ở thư mục gốc Brain.

Thêm skill của bạn​

Mỗi skill là một thư mục con chứa tệp SKILL.md:

Documents\BimSpeed AI\.claude\skills\<tên-skill>\SKILL.md

  1. Tạo thư mục mới trong .claude\skills, tên không dấu, không dấu cách (ví dụ kiem-tra-tag).

  2. Tạo tệp SKILL.md trong đó, bắt đầu bằng phần khai báo giữa hai dòng ---:

    ---
    name: kiem-tra-tag
    description: "Kiểm tra tag dầm đã đủ chưa. / Check that beams are tagged. Dùng khi người dùng nói kiểm tra tag."
    ---

    # Kiểm tra tag dầm

    Yêu cầu của người dùng: $ARGUMENTS

    1. Đọc PROJECT.md và memory.md của dự án.
    2. Liệt kê các dầm trong model.
    3. Hỏi người dùng nếu thiếu thông tin, không tự đoán.
    4. Báo kết quả ngắn gọn, ghi điều đã chốt vào memory.md.

  3. name phải trùng tên thư mục. description nói rõ khi nào nên dùng skill; nên viết cả tiếng Việt và tiếng Anh, ngăn cách bằng dấu / (khung sẽ hiện vế đúng ngôn ngữ giao diện).

  4. Phần bên dưới là hướng dẫn từng bước cho trợ lý. $ARGUMENTS được thay bằng phần bạn gõ sau tên skill. Liệt kê các bước theo thứ tự, ghi rõ thông số nào phải hỏi người dùng và việc cần ghi vào memory.md.

  5. Lưu tệp bằng UTF-8 không BOM (Notepad và VS Code đều làm được).

  6. Trong khung, bấm Mới hoặc gõ /new. Skill hiện ở nhóm Skill của bạn; gọi bằng /kiem-tra-tag.

Xem skill mẫu vi-du trong cùng thư mục.

Chỉ dùng skill bạn tin cậy

Skill chỉ là hướng dẫn bằng chữ cho trợ lý; mọi lệnh ghi vào model vẫn phải qua thẻ xin phép và tuân theo mức Quyền. Dù vậy, hãy đọc nội dung skill trước khi dùng, nhất là skill nhận từ người khác.

Đổi thư mục Brain​

Muốn đặt Brain ở ổ khác hoặc thư mục dùng chung của nhóm:

  1. Bấm nút Brain ở đầu khung. Phần Thư mục second brain mở ra (cũng có thể gõ /brain config).
  2. Nhập đường dẫn đầy đủ, ví dụ D:\BimSpeed AI. Phải là một thư mục con, không dùng gốc ổ đĩa.
  3. Bấm Áp dụng.
  4. Gõ /new để cuộc chat mới dùng thư mục này. Thư mục mới chỉ áp dụng cho các cuộc chat mới.

Các nút khác trong phần này:

NútTác dụng
Mặc địnhVề Documents\BimSpeed AI (hoặc gõ /brain reset)
Mở thư mụcMở thư mục hiện tại trong Explorer
ẨnThu gọn phần cài đặt

Bạn cũng có thể gõ /brain set D:\BimSpeed AI.

Đổi thư mục không chuyển dữ liệu cũ

BimSpeed không tự chép skill, tài liệu và ghi nhớ từ thư mục cũ sang thư mục mới. Muốn giữ lại, hãy tự chép nội dung sang thư mục mới trước khi dùng.

Phần Thư mục second brain: nút Áp dụng, Mặc định, Mở thư mục và Ẩn

Sao lưu và chia sẻ​

Brain là thư mục bình thường nên bạn có thể sao lưu, đồng bộ hay chép sang máy khác. Thư mục projects chứa nội dung các cuộc chat, hãy cân nhắc trước khi chia sẻ. Xem An toàn và riêng tư.