Mô-đun 1: Cơ bản1.6: Quy Tắc Dự Án & Bối Cảnh

Mô-đun 1.6: Quy Tắc & Bối Cảnh Dự Án

Hướng Dẫn Tham Khảo

  • Thời gian hoàn thành: 15-20 phút
  • Điều kiện tiên quyết: Mô-đun 1.5 (Các chế độ Ask, Agent, Plan)

Bắt đầu mô-đun này trong Antigravity: Chạy /start-1-6 để bắt đầu bài học tương tác.

📖 Tổng Quan

Tạo các tệp .agent/rules tự động áp dụng ngữ cảnh cho mỗi cuộc trò chuyện. Thiết lập thuật ngữ sản phẩm, chân dung người dùng và sở thích viết của bạn một lần thay vì lặp lại chúng trong mỗi cuộc trò chuyện.

Bài học chính: Quy tắc dự án cung cấp cho Antigravity bộ nhớ bền vững về sản phẩm của bạn mà không cần @ mentions mỗi lần.

🎯 Quy Tắc Dự Án Là Gì?

Quy tắc dự án là các tệp markdown trong .agent/rules/ mà Antigravity tự động tải vào mỗi phiên trò chuyện trong dự án đó.

Cách Chúng Hoạt Động

  1. Tạo .agent/rules/yourfile.mdc trong dự án của bạn
  2. Thêm ngữ cảnh (thuật ngữ, chân dung người dùng, hướng dẫn văn phong)
  3. Antigravity tự động tải ngữ cảnh này trong mọi cuộc trò chuyện
  4. Không cần @ mention - nó chỉ đơn giản là biết

Quy Tắc Dự Án và Quy Tắc Toàn Cầu

LoạiVị TríÁp Dụng Cho
Project RulesThư mục .agent/rules/ trong dự ánChỉ dự án này
Global RulesAntigravity Settings → RulesMỗi dự án bạn mở

Sử dụng quy tắc dự án cho: Ngữ cảnh cụ thể của công ty/sản phẩm (Thuật ngữ TaskFlow, chân dung người dùng) Sử dụng quy tắc toàn cầu cho: Sở thích cá nhân trên tất cả các công việc (định dạng PRD, văn phong viết)

🔧 Tạo Một Tệp Quy Tắc

Các Bước Nhanh

  1. Tạo thư mục: .agent/rules/ trong thư mục gốc dự án của bạn
  2. Tạo tệp: .agent/rules/yourname.mdc (sử dụng phần mở rộng .mdc)
  3. Thêm ngữ cảnh: Viết ở định dạng markdown
  4. Lưu - Antigravity tự động tải nó ngay lập tức

Cấu Trúc Mẫu Quy Tắc

# Product Terminology
 
Use these terms consistently:
- "Workspace" (not "Project")
- "Task" (not "To-do" or "Item")
- "Member" (not "User" or "Person")
 
# User Personas
 
- **Sarah Chen** - Enterprise Admin at Acme Corp
- **Mike Rodriguez** - IC Engineer on Product team
- **Alex Kim** - Engineering Team Lead
 
# Writing Style
 
- Active voice
- Oxford commas
- No emojis in product docs
- Conversational but professional tone
 
# Output Preferences
 
- Always use persona names in examples (Sarah, Mike, Alex)
- Include specific use cases, not abstract concepts
- Format lists with markdown bullets

📝 Những Gì Nên Bao Gồm Trong Quy Tắc

1. Thuật Ngữ Sản Phẩm

Xác định từ vựng sản phẩm của bạn để tránh đặt tên không nhất quán:

# TaskFlow Terminology
 
**Features:**
- Workspace (not Project, Folder, or Space)
- Task Board (not Kanban or Project Board)
- Quick Actions (not Shortcuts or Commands)
 
**Roles:**
- Admin (full permissions)
- Member (standard user)
- Guest (view-only)

2. Chân Dung Người Dùng

Bao gồm chân dung thực tế mà Antigravity có thể tham chiếu:

# User Personas
 
**Sarah Chen - Enterprise Admin**
- Role: Product lead at 500-person company
- Needs: Team management, security, audit logs
- Pain points: Onboarding new team members
 
**Mike Rodriguez - Individual Contributor**
- Role: Software engineer
- Needs: Personal task tracking, quick entry
- Pain points: Context switching between tools

3. Tùy Chọn Viết & Đầu Ra

Thiết lập tiêu chuẩn tài liệu của bạn:

# Writing Guidelines
 
- Use active voice ("Create a task" not "A task can be created")
- Include Oxford commas in lists
- Write in second person ("you" not "the user")
- Keep paragraphs under 4 sentences
- Use markdown formatting (bold for emphasis, code blocks for UI)

4. Bối Cảnh Sản Phẩm

Giúp Antigravity hiểu công nghệ và tính năng của bạn:

# Product Context
 
**Tech Stack:**
- Frontend: React, TypeScript
- Backend: Node.js, PostgreSQL
- Infrastructure: AWS, Docker
 
**Key Features:**
- Real-time collaboration
- Custom workflows
- Third-party integrations (Slack, GitHub, Figma)

🎯 Khi Nào Quy Tắc Giúp Ích

Hoàn Hảo Cho

  • Thuật ngữ nhất quán - Luôn sử dụng “Workspace” không phải “Project”
  • Ví dụ dựa trên chân dung - Tham chiếu Sarah, Mike, Alex trong đầu ra
  • Giọng điệu thương hiệu - Khớp với phong cách viết của công ty bạn một cách tự động
  • Quy ước nhóm - Cấu trúc PRD, định dạng ghi chú cuộc họp, tiêu chuẩn tài liệu
  • Kiến thức sản phẩm - Ngăn xếp công nghệ, tính năng, định vị cạnh tranh

Khi Nào Cần Bỏ Qua

  • Dự án một lần - Không đáng thời gian thiết lập cho công việc tạm thời
  • Bối cảnh biến đổi cao - Khi mỗi nhiệm vụ cần bối cảnh khác nhau
  • Thử nghiệm cá nhân - Khi bạn chỉ đang thử nghiệm các tính năng của Antigravity

Quy tắc chung: Nếu bạn đặt nó trong tài liệu giới thiệu của đồng đội mới, hãy đặt nó trong quy tắc dự án.

💡 Các Thực Hành Tốt Nhất

Giữ Quy Tắc Tập Trung

❌ Quá rộng:

Make everything good and professional

✅ Cụ thể:

Use active voice and Oxford commas in all product documentation

Cập Nhật Khi Sản Phẩm Phát Triển

  • Thêm các tính năng mới vào phần thuật ngữ
  • Cập nhật chân dung khi người dùng mục tiêu thay đổi
  • Tinh chỉnh phong cách viết dựa trên phản hồi của nhóm

Sử Dụng Nhiều Tệp Để Tổ Chức

.agent/rules/
├── terminology.mdc       # Từ vựng sản phẩm
├── personas.mdc          # Hồ sơ người dùng
├── writing-style.mdc     # Tiêu chuẩn tài liệu
└── tech-context.mdc      # Ngăn xếp công nghệ và kiến trúc

Kiểm Tra Quy Tắc Của Bạn

Tạo cùng một tài liệu hai lần (trước/sau khi thêm quy tắc) để xác minh quy tắc cải thiện chất lượng đầu ra.

🐛 Khắc Phục Sự Cố

”Quy tắc không áp dụng cho cuộc trò chuyện của tôi”

Sửa: Quy tắc tải khi bắt đầu phiên. Đóng và mở lại bảng trò chuyện (Cmd+L) để tải lại với các quy tắc mới.

”Antigravity bỏ qua các quy tắc cụ thể”

Sửa: Quy tắc hướng dẫn hành vi nhưng không đảm bảo nó. Hãy rõ ràng trong lời nhắc: “Tuân theo quy tắc thuật ngữ của chúng tôi, hãy viết…” Nếu liên tục bị bỏ qua, hãy làm cho quy tắc cụ thể hơn.

”Quá nhiều quy tắc - đầu ra cảm thấy bị hạn chế”

Sửa: Quy tắc nên hướng dẫn, không hạn chế. Giữ tối đa 1-2 trang. Loại bỏ các quy tắc quá quy định hạn chế sự hữu ích của Antigravity.

”Không thể tìm thấy thư mục .agent”

Sửa: Thư mục bị ẩn theo mặc định. Trong trình khám phá tệp, hiển thị các tệp bị ẩn hoặc tạo thủ công: Nhấp chuột phải vào gốc dự án → Thư mục mới → .agent/rules/

📚 Tài Nguyên

Chính thức:

Cộng đồng:

🚀 Bước Tiếp Theo?

Mô-đun 1.6 hoàn thành - và toàn bộ Mô-đun 1!

  • ✅ Tạo tệp quy tắc dự án (Rules)
  • ✅ Thiết lập thuật ngữ sản phẩm và chân dung người dùng
  • ✅ Xác định sở thích viết và đầu ra
  • ✅ Hiểu khi nào quy tắc giúp ích so với khi nào nên bỏ qua

Bạn đã hoàn thành Mô-đun 1: Kiến Thức Cơ Bản Antigravity

Bây giờ bạn đã biết cách sử dụng các tính năng cốt lõi của Antigravity:

  • Giao diện và điều hướng
  • @ mentions cho ngữ cảnh
  • Thao tác tệp
  • Mẫu và quy trình làm việc
  • Các chế độ Ask, Agent, và Plan
  • Quy tắc dự án cho bối cảnh bền vững

Tiếp theo: Mô-đun 2.1 - Viết PRD

Bây giờ bạn sẽ áp dụng mọi thứ bạn đã học vào công việc PM thực tế. Bắt đầu với việc viết Tài liệu Yêu cầu Sản phẩm (PRD) bằng cách sử dụng tổng hợp đa tệp của Antigravity.

Đi đến Mô-đun 2.1 →

1.5: Chế Độ Planning2.1: Viết PRD