Skip to content

Latest commit

 

History

History
67 lines (48 loc) · 2.23 KB

File metadata and controls

67 lines (48 loc) · 2.23 KB

AGENTS.md - Protocol Vận Hành Session

Thư mục này là workspace của agent github-io. Mọi session phải tuân thủ tuyệt đối.


1. Boot Sequence (Bắt buộc mỗi session)

Trước khi làm bất kỳ việc gì:

  1. Đọc SOUL.md - xác định bản sắc và nguyên tắc làm việc.
  2. Đọc IDENTITY.md - xác định vai trò của mình.
  3. Đọc USER.md - xác định đối tượng đang phục vụ.
  4. Đọc:
    • memory/YYYY-MM-DD.md (hôm nay)
    • memory/YYYY-MM-DD.md (hôm qua)
  5. Nếu task liên quan crawl/OCR/review/sửa văn bản pháp luật trong van-ban/:
    • Đọc bắt buộc documents/OCR_QUALITY_GATE.md trước khi xử lý file
  6. Nếu là MAIN SESSION (github-io workspace):
    • Đọc thêm MEMORY.md (long-term memory)

Chi tiết đầy đủ: Tham chiếu BOOTSTRAP.md


2. Cấu trúc Memory

Loại File Mục đích
Daily memory/YYYY-MM-DD.md Log thô theo ngày
Long-term local-only / ignored Thông tin chiến lược, quyết định quan trọng

Quy tắc:

  • Daily: Ghi log, không chỉnh sửa lịch sử.
  • Long-term: Chỉ lưu thông tin đã chọn lọc, có giá trị chiến lược; không commit file memory local vào repo.

3. Vai trò của Workspace

Workspace chứa:

  • Persona (SOUL.md)
  • User profile (USER.md)
  • Tool definitions (TOOLS.md)
  • Identity mapping (IDENTITY.md)
  • Memory system
  • Jekyll content (pages, posts, documents)

Mọi quyết định phải thống nhất với SOUL.md.


4. Kỷ luật

  • Không bỏ qua boot sequence.
  • Không hành động khi chưa nắm đủ context.
  • Không phá vỡ Git Workflow rule trong SOUL.md.
  • Mỗi task phải rõ ràng trước khi thực thi.
  • Nếu Sếp giao việc cần review qua PR, Bot phải tạo PR sau khi đã commit và kiểm tra thay đổi.
  • Heartbeat tự động không được chỉ tạo branch local rồi dừng; thay đổi có giá trị phải được đưa thành PR để Sếp review.
  • PR chỉ là điểm dừng review; không tự merge/close nếu chưa có lệnh rõ.

Workspace này không phải chỗ thử nghiệm. Đây là hệ điều hành tư duy của Bot.