arrow_back Trở về Hướng dẫn
Architecture Level 13

Para-Kit — Kỹ Năng Cấu Trúc cho Agent

Para-Kit là kỹ năng đi kèm giúp AI agent truy cập ngay lập tức cấu trúc workspace, schema project.md, quy tắc kernel, và phân luồng CLI/Workflow — không cần quét toàn bộ kernel.

Para-Kit — Kỹ Năng Cấu Trúc cho Agent (v1.6.4)

Para-Kit là một kỹ năng (skill) đi kèm được giới thiệu trong PARA Workspace v1.6.4, cung cấp cho AI agent quyền truy cập ngay lập tức vào kiến thức cấu trúc của workspace — mà không cần đọc toàn bộ Governing Kernel.

Tại sao cần Para-Kit?

Trước v1.6.4, agent cần đọc nhiều file kernel (invariants.md, heuristics.md, schema/*.md) để hiểu quy tắc workspace. Việc này tiêu tốn ~2000+ token và gây suy giảm chú ý trong các cuộc hội thoại dài.

Para-Kit giải quyết bài toán này bằng cách đóng gói các tham chiếu thường dùng nhất vào một file SKILL.md duy nhất (~140 dòng, ~600 token) mà agent tải theo yêu cầu thông qua hệ thống trigger.

Khi nào Para-Kit được tải?

Điều kiện triggerVí dụ
Câu hỏi về cấu trúc PARA”Session logs lưu ở đâu?”
Truy vấn schema project.md”project.md có những trường nào?”
Phân luồng CLI vs Workflow”Nên dùng ./para install hay /install?”
Tham chiếu nhanh kernel”Các invariant là gì?”

Nội dung bên trong

SKILL.md của Para-Kit chứa 5 phần:

Phần 1: Cấu trúc PARA Workspace

Bố cục thư mục Bốn Trụ Cột và Bố cục Dự án Chuẩn với tất cả thư mục con được giải thích:

Projects/    — Công việc đang hoạt động với deadline hoặc sản phẩm
Areas/       — Kiến thức ổn định, SOP, trách nhiệm liên tục
Resources/   — Tài liệu tham khảo, công cụ, templates (CHỈ ĐỌC cho ai-agents/)
Archive/     — Kho lạnh cho các mục đã hoàn thành/huỷ bỏ

Phần này cũng đề cập Dự án Hệ sinh thái (v1.6.0+) — các loại dự án standard và ecosystem cùng tham chiếu chéo @prefix.

Phần 2: Schema project.md (v1.6.3)

Bảng đầy đủ các trường trong YAML frontmatter contract:

TrườngKiểuBắt buộcMô tả
goalstring✅Mục tiêu dự án
statusenum✅active / paused / done / archived
strategystring/~✅Đường dẫn tới tài liệu chiến lược
roadmappath✅Đường dẫn tới roadmap
active_planstring❌Kế hoạch triển khai hiện tại
agent.rulesbool✅Có rules riêng cho dự án?
agent.skillsbool✅Có skills riêng cho dự án?
………+ 10 trường khác

Đi kèm là templates và test vector cho việc kiểm tra schema.

Phần 3: Thẻ Tham Chiếu Nhanh — Quản trị Kernel

Phần quan trọng nhất — tóm tắt một dòng cho tất cả 11 Invariant và 9 Heuristic:

Invariant (PHẢI TUÂN THỦ — vi phạm = bump MAJOR):

IDRàng buộc chính
I1Chỉ có 4 thư mục gốc (PascalCase)
I2backlog.md = nguồn chính thức, sprint = hot lane
I3Đặt tên chỉ dùng kebab-case
I9Resources/ai-agents/ = CHỈ ĐỌC
I10Repo không chứa dữ liệu người dùng
I11Xuất ra theo preferences.language

Heuristic (NÊN TUÂN THỦ — vi phạm = MINOR/PATCH):

IDHướng dẫn chính
H2Ưu tiên tải context: project.md → rules → artifacts → areas
H6Git chỉ trong repo/, không ở root workspace
H9catalog.yml bắt buộc cho thư viện được quản trị

Phần 4: Chiến lược Lựa chọn

Ma trận quyết định khi nào dùng CLI (./para <cmd>) và khi nào dùng Workflows (/<cmd>):

  • CLI: Thao tác xác định (install, update, status, archive)
  • Workflows: Cộng tác & phân tích (/brainstorm, /plan, /retro)

Phần 5: Tham chiếu Bổ sung

Trỏ tới các file đi kèm cho chi tiết sâu hơn:

FileNội dung
templates/project-md.mdTemplate project.md đầy đủ
examples/project-schema-vectors.mdTest vector cho validation

Kiến trúc Skill

Para-Kit tuân theo mô hình skill đi kèm (colocated skill) được giới thiệu trong v1.6.4:

.agent/skills/para-kit/
├── SKILL.md              # File hướng dẫn chính (~140 dòng)
├── templates/            # Template project.md
└── examples/             # Test vector schema

Tất cả file hỗ trợ nằm bên trong thư mục skill, cho phép đồng bộ đệ quy khi cập nhật workspace — agent luôn nhận phiên bản mới nhất tự động.

Quyết định Thiết kế Chính

  1. English-first: SKILL.md viết bằng tiếng Anh để tương thích tối đa với LLM, bất kể preferences.language.
  2. Tóm tắt một dòng: Mỗi invariant/heuristic nén còn ~10 từ. Chi tiết đầy đủ vẫn trong Resources/ai-agents/kernel/.
  3. Không trùng lặp: Para-Kit tham chiếu tới file kernel thay vì sao chép. Khi invariant thay đổi, chỉ cần cập nhật nguồn kernel.
  4. Tải theo trigger: Agent không đọc Para-Kit khi bắt đầu phiên — chỉ tải khi trigger tương ứng được kích hoạt.

Liên quan