Xây dựng các quy trình tự động cho nhà phát triển bằng cách sử dụng agents.md và skills.md trong Antigravity

1. Giới thiệu

Trong lớp học lập trình này, chúng tôi sẽ hướng dẫn bạn cách thiết lập một Nhóm nhà phát triển AI tự động vui nhộn, sử dụng AI ngay trên máy tính của bạn bằng Antigravity IDE. Bạn sẽ tạo một ứng dụng hoạt động bằng cách hướng dẫn một yêu cầu trong toàn bộ vòng đời của yêu cầu đó, từ quy cách kỹ thuật đến việc triển khai cuối cùng, bằng cách sử dụng một quy trình làm việc mạnh mẽ gồm skills.md và agents.md.

Thay vì bị ràng buộc vào một bộ phần mềm cơ sở cụ thể hoặc viết các tập lệnh điều phối Python phức tạp, chúng ta sẽ sử dụng phương pháp Không cần mã thân thiện, trong đó các yêu cầu của bạn sẽ trải qua một chu kỳ tự động dựa trên 3 nguyên tắc cốt lõi của Antigravity:

  1. agents.md: Để xác định chính xác những người trong nhóm AI của bạn (Quản lý sản phẩm, Giao diện người dùng, Đảm bảo chất lượng, DevOps).
  2. Kỹ năng và skills.md: Một thư mục chuyên dụng nơi bạn xác định các khả năng kỹ thuật mạnh mẽ và quy tắc bàn giao cấu phần phần mềm dưới dạng các tệp .md theo mô-đun.
  3. Quy trình công việc (workflows/): Để xác định các lệnh tuỳ chỉnh có dấu gạch chéo giúp liên kết liền mạch các thành viên AI trong nhóm của bạn thành một quy trình tự động.

Bằng cách kết hợp 3 thành phần này một cách tự nhiên trong Antigravity, bạn sẽ hướng dẫn Gemini tự động hoá hoàn toàn quá trình phát triển một ứng dụng sẵn sàng phát hành từ đầu đến cuối!

Kiến thức bạn sẽ học được

  • Khởi động Workspace: Thiết lập dự án để Antigravity hiểu rõ dự án của bạn.
  • Xác định nhóm: Tạo một tệp agents.md để thiết lập các nhân vật AI chuyên biệt.
  • Lập trình các kỹ năng: Tạo các tệp .md chi tiết trong thư mục skills/ để xác định các quy tắc kỹ thuật nghiêm ngặt và các vòng lặp làm lại lặp đi lặp lại.
  • Xác định quy trình công việc tuỳ chỉnh: Tạo một lệnh dấu gạch chéo /startcycle để tự động hoá quy trình công việc của hãng phim.
  • Bắt đầu Phản ứng dây chuyền: Sử dụng một lệnh duy nhất để tự động thực thi toàn bộ quy trình nhiều tác nhân một cách hiệu quả!

Những điều bạn sẽ thử

  • Cách tách thiết kế câu lệnh AI khỏi mã xử lý ứng dụng.
  • Cách tạo một tác nhân chủ động tạm dừng để diễn giải các bình luận và nội dung chỉnh sửa của người dùng trong các tệp Markdown được tạo.
  • Cách xây dựng các kỹ năng tạo và triển khai mã linh hoạt, độc lập với ngôn ngữ.
  • Cách tạo các lệnh macro tuỳ chỉnh (Quy trình làm việc) trong một IDE dựa trên tác nhân.

Bạn cần có

Trước khi bắt đầu

Đối với Khoản tín dụng Google Cloud: Để giúp bạn sử dụng Antigravity với các dự án trên Google Cloud, hãy đổi khoản tín dụng Google Cloud miễn phí bằng cách sử dụng đường liên kết này. Bạn có thể làm theo hướng dẫn tại đây để kích hoạt khoản tín dụng và tạo một dự án mới.

  1. Đảm bảo bạn đã cài đặt IDE Antigravity (có tại antigravity.google).
  2. Mở Antigravity IDE và đảm bảo bạn đã khởi động một không gian làm việc chuyên dụng mới.
  3. Mở một cửa sổ dòng lệnh trong khi làm việc ở chế độ Trình chỉnh sửa.

2. Khởi chạy Workspace

Vì Antigravity hiểu rõ các tệp quy trình làm việc được đặt trong thư mục .agents, nên việc thiết lập quy trình phát triển tự động của bạn chỉ đơn giản là tạo một vài thư mục tiêu chuẩn.

Bạn có thể thiết lập không gian làm việc:

  1. Mở Antigravity IDE.
  2. Mở Trình quản lý tác nhân Bất cứ lúc nào, bạn cũng có thể chuyển đổi giữa Trình quản lý tác nhân và trình chỉnh sửa bằng cách nhấn tổ hợp phím CMD+E (Mac) hoặc CTRL+E (Windows), hoặc thông qua các nút Mở trình chỉnh sửa và Mở Trình quản lý tác nhân ở trên cùng bên phải của thanh trình đơn. .
  3. Nhấp vào + Mở không gian làm việc.

Để bắt đầu một cuộc trò chuyện mới trong một không gian làm việc, hãy chọn không gian làm việc mong muốn trong thẻ Bắt đầu cuộc trò chuyện hoặc nhấn vào nút Dấu cộng bên cạnh tên không gian làm việc trong thanh bên.

45e7241be5552e42.png

  1. Nhấp vào Open New Workspace (Mở không gian làm việc mới), đặt tên cho không gian làm việc là skills-codelab rồi chọn một thư mục cục bộ. Điều này đảm bảo rằng Agent có một thư mục gốc cụ thể để tạo khung cho các tệp mà không làm lộn xộn các dự án khác. Sau khi hoàn tất, hãy chuyển đến Chế độ xem của trình chỉnh sửa, sau đó thực hiện các bước (5), (6) và (7).

d84ba507939a5efc.png

  1. Nhấp chuột phải rồi tạo thư mục skills-codelab.
  2. Bên trong thư mục này, hãy tạo 2 thư mục: production_artifacts và app_build.
  3. Tạo một thư mục .agents, rồi tạo các thư mục workflows và skills bên trong thư mục đó.

(Ngoài ra) Nếu muốn dùng cửa sổ dòng lệnh, bạn có thể tạo ngay cấu trúc này bằng cách chạy:

mkdir skills-codelab && cd skills-codelab
mkdir -p .agents/workflows .agents/skills
mkdir production_artifacts app_build

Đảm bảo thư mục của bạn có dạng như sau:

7234ea48c2b175a7.png

Những thư mục mới này có tác dụng gì?

  • .agents/: Đây là một thư mục đặc biệt được Antigravity nhận dạng một cách tự nhiên. Bằng cách đặt các tệp tại đây, bạn sẽ mở rộng hành vi AI tích hợp của Antigravity.
  • skills/: Thư mục này dùng để lưu trữ các sổ tay hướng dẫn kỹ thuật cụ thể (tệp .md) cho AI của bạn. Điều này cho phép AI biết cách thực hiện các tác vụ cụ thể như viết mã hoặc triển khai ứng dụng, thay thế một câu lệnh khổng lồ và khó hiểu bằng các bước theo mô-đun!
  • production_artifacts/: Đây là thư mục dùng chung của chúng tôi, nơi các thành viên trong nhóm tự động sẽ cố tình thả tệp để tác nhân tiếp theo đọc!
  • app_build/: Không gian làm việc được chỉ định cho mã xử lý ứng dụng thực tế. Tác nhân Kỹ sư toàn diện sẽ tạo tất cả mã (chẳng hạn như package.json, app.py, các thành phần React) và lưu mã đó trực tiếp vào thư mục này, tách biệt nguồn ứng dụng với hướng dẫn của AI.

3. Xác định Nhóm (agents.md)

Trước tiên, chúng ta cần cho Antigravity biết ai đang làm việc trong dự án này. Thay vì lưu trữ hướng dẫn trong 4 thư mục dự án lồng nhau, chúng tôi tập trung vào bản sắc của nhóm. Tạo tệp tại .agents/agents.md:

Tại sao chúng ta cần nhiều chân dung người dùng?

Khi bạn yêu cầu AI tạo một ứng dụng hoàn chỉnh từ đầu, AI có thể dễ dàng bị quá tải nếu bạn buộc AI phải đảm nhận vai trò kiến trúc sư, lập trình viên, người kiểm thử và trưởng nhóm triển khai cùng một lúc. Bằng cách tập trung các vai trò này vào agents.md, bạn sẽ giúp AI không bị nhầm lẫn. PM chỉ tập trung vào các yêu cầu, Kỹ sư chỉ tập trung vào việc tạo mã và QA chỉ tập trung vào việc sửa lỗi. Bạn sẽ có các chuyên gia chuyên trách cho từng giai đoạn trong quy trình của mình!

Tệp agents.md giải quyết vấn đề này bằng cách tập trung các cá tính khác nhau của nhóm:

  1. Nhà quản lý sản phẩm (@pm): Chỉ tập trung vào bức tranh tổng thể. Họ viết Technical_Specification.md và quản lý quy trình phê duyệt qua lại với bạn (con người).
  2. Kỹ sư Full-Stack (@engineer): Không lo lắng về việc lập kế hoạch; họ chỉ cần lấy thông số kỹ thuật của PM và tập trung hoàn toàn vào việc viết mã chất lượng cao bằng bất kỳ ngôn ngữ nào mà bạn phê duyệt.
  3. Kỹ sư đảm bảo chất lượng (@qa): Đóng vai trò là người xem xét khách quan. Thay vì viết các tính năng mới, trọng tâm duy nhất của họ là tìm các phần phụ thuộc bị thiếu, lỗi cú pháp hoặc lỗi logic trong mã của Kỹ sư.
  4. DevOps Master (@devops): Chỉ tập trung vào môi trường thời gian chạy. Họ biết cách đọc Terminal, cài đặt các gói (npm install, pip install) và khởi động máy chủ cục bộ.
# 🤖 The Autonomous Development Team

## The Product Manager (@pm)
You are a visionary Product Manager and Lead Architect with 15+ years of experience.
**Goal**: Translate vague user ideas into comprehensive, robust, and technology-agnostic Technical Specifications.
**Traits**: Highly analytical, user-centric, and structured. You never write code; you only design systems.
**Constraint**: You MUST always pause for explicit user approval before considering your job done. You are highly receptive to user feedback and will enthusiastically re-write specifications based on inline comments.

## The Full-Stack Engineer (@engineer)
You are a 10x senior polyglot developer capable of adapting to any modern tech stack.
**Goal**: Translate the PM's Technical Specification into a beautiful, perfectly structured, production-ready application.
**Traits**: You write clean, DRY, well-documented code. You care deeply about modern UI/UX and scalable backend logic.
**Constraint**: You strictly follow the approved architecture. You do not make assumptions—if the spec says Python, you use Python. You always save your code into the `app_build/` directory.

## The QA Engineer (@qa)
You are a meticulous Quality Assurance engineer and security auditor.
**Goal**: Scrutinize the Engineer's code to guarantee production-readiness.
**Traits**: Detail-oriented, paranoid about security, and relentless in finding edge cases.
**Focus Areas**: You aggressively hunt for missing dependencies in configurations, unhandled promises, syntax errors, and logic bugs. You proactively fix them.

## The DevOps Master (@devops)
You are the elite deployment lead and infrastructure wizard.
**Goal**: Take the final code in `app_build/` and magically bring it to life on a local server.
**Traits**: You excel at terminal commands and environment configurations.
**Expertise**: You fluently use tools like `npm`, `pip`, or native runners. You install all necessary modules seamlessly and provide the local URL directly to the user so they can see the final product!

Hãy lưu ý cách chúng ta xác định Mục tiêu, Đặc điểm và Hạn chế cho từng nhân vật đại diện.

  • Mục tiêu cho biết trách nhiệm chính xác của tác nhân trong quy trình.
  • Đặc điểm mang đến cho AI một tính cách hành vi, cho biết cách AI hành động (ví dụ: "nhà phát triển cấp cao có năng suất gấp 10 lần" hoặc "luôn lo lắng về tính bảo mật").
  • Các ràng buộc đóng vai trò là hàng rào bảo vệ nghiêm ngặt (ví dụ: "không bao giờ viết mã", "tuân thủ nghiêm ngặt cấu trúc đã được phê duyệt").

Việc cấu trúc câu lệnh theo cách này sẽ giảm đáng kể tình trạng ảo tưởng của AI và đảm bảo tác nhân tuân thủ nghiêm ngặt quy trình làm việc mà bạn yêu cầu!

Đảm bảo thư mục của bạn có dạng như sau:

4. Lập trình các kỹ năng chuyên biệt (skills/)

Kỹ thuật hướng dẫn chi tiết là chìa khoá cho khả năng kỳ diệu của việc không cần mã. Chúng tôi sẽ tạo các tệp văn bản có độ cụ thể cao cho từng kỹ năng, đảm bảo PM chủ động quay lại nếu bạn yêu cầu làm lại.

1. Kỹ năng về quy cách kỹ thuật

Kỹ năng này đóng vai trò là điểm xuất phát. Nhân viên PM sẽ sử dụng thông tin này để phỏng vấn bạn và xây dựng cấu trúc trước khi viết bất kỳ mã nào, giúp bạn không lãng phí hàng giờ lập trình!

Tạo .agents/skills/write_specs.md:

# Skill: Write Specs

## Objective
Your goal as the Product Manager is to turn raw user ideas into rigorous technical specifications and **pause for user approval**.

## Rules of Engagement
- **Artifact Handover**: Save all your final output back to the file system.
- **Save Location**: Always output your final document to `production_artifacts/Technical_Specification.md`.
- **Approval Gate**: You MUST pause and actively ask the user if they approve the architecture before taking any further action.
- **Iterative Rework**: If the user leaves comments directly inside the `Technical_Specification.md` or provides feedback in chat, you must read the document again, apply the requested changes, and ask for approval again!

## Instructions
1. **Analyze Requirements**: Deeply analyze the user's initial idea request.
2. **Draft the Document**: Your specification MUST include:
   - **Executive Summary**: A brief, high-level overview.
   - **Requirements**: Functional and non-functional requirements.
   - **Architecture & Tech Stack**: Suggest the absolute best framework (e.g., Python/Django, Node/Express, React/Next.js) for the job and outline the layout/API structure.

   - **State Management**: Briefly outline how data should flow.
3. Save the document to disk.
4. **Halt Execution**: Explicitly ask the user: "Do you approve of this tech stack and specification? You can safely open `Technical_Specification.md` and add comments or modifications if you want me to rework anything!" Wait for their "Yes" or feedback before the sequence continues!

Lưu ý đến "Cổng phê duyệt" nghiêm ngặt. Thay vì xây dựng toàn bộ ứng dụng trong một lần và hy vọng ứng dụng đó sẽ phù hợp, AI (trí tuệ nhân tạo) được hướng dẫn rõ ràng để tạm dừng, chờ ý kiến cuối cùng của bạn và chủ động đọc lại tài liệu nếu bạn để lại bình luận cùng dòng!

2. Kỹ năng tạo nội dung toàn diện

Kỹ năng này là kỹ năng cốt lõi của nhà phát triển. Tác nhân Kỹ sư đọc chính xác bộ phần mềm cơ sở từ quy cách của PM và tạo giàn giáo linh hoạt cho tất cả các tệp mã giao diện người dùng và phụ trợ cần thiết.

Tạo .agents/skills/generate_code.md:

# Skill: Generate Code

## Objective
Your goal as the Full-Stack Engineer is to write the physical code based entirely on the PM's approved specification.

## Rules of Engagement
- **Dynamic Coding**: You are not limited to HTML/JS. You must write code in the exact language/framework defined in the approved `Technical_Specification.md`.
- **Save Location**: Save all your raw code, accurately retaining necessary folder structures, directly inside `app_build/`.

## Instructions
1. **Read the Spec**: Open and carefully study `production_artifacts/Technical_Specification.md`.
2. **Scaffold Structure**: Generate all core backend and frontend application files.
3. **Output**: Dump your code perfectly into the `app_build/` directory. Do not skip or summarize any code blocks. Ensure all `package.json` or `requirements.txt` files are present.

Kỹ năng này không có ngăn xếp được xác định trước (chẳng hạn như Next.js hoặc Django). Việc này phụ thuộc rõ ràng vào bộ phần mềm cơ sở động do PM chọn. Điều này có nghĩa là kỹ năng tạo mã duy nhất của bạn sẽ hoạt động cho mọi khung hình mà bạn đã phê duyệt trong thông số kỹ thuật!

3. Kỹ năng kiểm tra

Kỹ năng này cung cấp một mạng lưới an toàn. Nhân viên kiểm thử đóng vai trò là người đánh giá độc lập, được hướng dẫn cụ thể để tìm ra các phần phụ thuộc bị thiếu và lỗi logic trong mã mới được tạo.

Tạo .agents/skills/audit_code.md:

# Skill: Audit Code

## Objective
Your goal as the QA Engineer is to ensure the generated code is perfectly functional natively.

## Rules of Engagement
- **Target Context**: Your focus area is the `app_build/` directory.

## Instructions
1. **Assess Alignment**: Compare the raw code against the approved `Technical_Specification.md`.
2. **Bug Hunting**: Find and fix dependency mismatches, unhandled errors, and logic breaks.
3. **Commit Fixes**: Overwrite any flawed files in `app_build/` with your polished revisions.

AI tạo sinh thường mắc phải những lỗi nhỏ về cú pháp khi viết một lượng lớn mã. Bằng cách có một Kỹ năng kiểm tra riêng biệt, công việc duy nhất của kỹ năng này là tìm lỗi, chúng ta sẽ tăng đáng kể tỷ lệ thành công khi chạy ứng dụng cuối cùng.

4. Kỹ năng triển khai linh hoạt

Kỹ năng này giúp ứng dụng trở nên sống động. Tác nhân DevOps xác định loại ứng dụng đã được tạo (Node, Python, v.v.) và chạy an toàn các lệnh trên thiết bị đầu cuối cần thiết để cài đặt các mô-đun và khởi động máy chủ.

Tạo .agents/skills/deploy_app.md:

# Skill: Deploy App

## Objective
Your goal as DevOps is to intelligently package the application and fire up a server based on the chosen stack.

## Instructions
1. **Stack Detection**: Inspect the `Technical_Specification.md` and the files in `app_build/` to figure out what stack is being used.

2. **Install Dependencies**: Use your native terminal to navigate into `app_build/` and run `npm install`, `pip install -r requirements.txt`, or whatever is appropriate!

3. **Host Locally**: Execute the appropriate native terminal command (e.g., `npm run dev`, `python3 app.py`) to start a background server.
4. **Report**: Output the clickable localhost link to the user and celebrate a successful launch!

Chúng tôi tận dụng khả năng chạy các lệnh của thiết bị đầu cuối gốc một cách an toàn của IDE.

Tác nhân này hoạt động như một kỹ sư DevOps thực thụ, tự động tìm ra lệnh cài đặt cần chạy dựa trên các tệp mà tác nhân thực sự thấy trong thư mục app_build/!

(Không bắt buộc) 5. Kỹ năng triển khai Cloud Run

Nếu muốn đưa ứng dụng của mình vào giai đoạn phát hành chính thức thay vì chỉ chạy ứng dụng đó trên máy cục bộ, bạn có thể tạo một kỹ năng triển khai thay thế. Vì Antigravity hoạt động trực tiếp trên máy cục bộ của bạn, nên AI có thể sử dụng liền mạch gcloud CLI được xác thực cục bộ!

Tạo .agents/skills/deploy_cloud_run.md:

# Skill: Deploy to Cloud Run

## Objective
Your goal as DevOps is to package the application into a container and deploy it to Google Cloud Run.

## Instructions
1. **Verify Environment**: Ensure the necessary files for the chosen tech stack are in `app_build/`.
2. **Containerize**: Use the IDE terminal to navigate to `app_build/` and run `gcloud run deploy --source .`. 
3. **Configure**: If prompted by the CLI tool, automatically select the default region and allow unauthenticated invocations so the web app is public.
4. **Report**: Output the live production Google Cloud Run URL to the user!

5. Xác định lệnh gạch chéo tuỳ chỉnh

Lệnh dấu gạch chéo tuỳ chỉnh có chức năng gì?

Bằng cách lưu tệp văn bản này vào .agents/workflows/ , bạn đang đăng ký một lệnh hoàn toàn mới ngay trong giao diện trò chuyện của Antigravity!

Thay vì nhắc AI từng bước theo cách thủ công ("Đóng vai trò là người quản lý sản phẩm và viết một bản đặc tả..." rồi "Được rồi, bây giờ hãy đóng vai trò là kỹ sư và viết mã..."), lệnh /startcycle sẽ đóng vai trò là một trình điều phối tự động. Nó liên kết liền mạch các chân dung người dùng mà bạn xác định và các kỹ năng cụ thể của họ với nhau thành một chuỗi liên tục, tự động! Chúng tôi sẽ tạo một macro duy nhất để xử lý việc chuyển giao giữa các nhân viên hỗ trợ, quản lý rõ ràng vòng lặp làm lại cho giai đoạn PM.

Tạo .agents/workflows/startcycle.md:

---
description: Start the Autonomous AI Developer Pipeline sequence with a new idea
---

When the user types `/startcycle <idea>`, orchestrate the development process strictly using `.agents/agents.md` and `.agents/skills/`.

### Execution Sequence:
1. Act as the **Product Manager** and execute the `write_specs.md` skill using the `<idea>`.
   *(Wait for the user to explicitly approve the spec. If the user provides feedback or adds comments directly to the Markdown file, act as the PM again to re-read and revise the document. Loop this step until they type "Approved").*
2. Shift context, act as the **Full-Stack Engineer**, and execute the `generate_code.md` skill.
3. Shift context, act as the **QA Engineer**, and execute the `audit_code.md` skill.
4. Shift context, act as the **DevOps Master**, and execute the `deploy_app.md` skill.

Đảm bảo thư mục của bạn có dạng như sau:

de21eeb6012ddbcd.png

6. Bắt đầu Phản ứng dây chuyền!

Khi đã xác định chính thức nhóm và quy tắc trong Antigravity, bạn có thể kích hoạt toàn bộ quy trình làm việc một cách dễ dàng!

Câu lệnh Antigravity:

  1. Trong hộp trò chuyện của Agent Manager, hãy nhập / để mở trình đơn lệnh tuỳ chỉnh. Chọn hoặc nhập startcycle.
  2. Đưa ra ý tưởng của bạn:
/startcycle "I need a fast, real-time chat application for customer support on my ecommerce website."

Ngồi xuống và cộng tác:

  1. Gemini sẽ trở thành người quản lý sản phẩm, soạn thảo một bản đặc tả chi tiết và yêu cầu bạn phê duyệt.
  2. Mở Technical_Specification.md trong trình chỉnh sửa IDE, thêm một vài ghi chú (chẳng hạn như "Hãy dùng Python thay vì Node") và yêu cầu tác nhân chỉnh sửa lại. Công cụ này sẽ tự động sửa đổi tệp!
  3. Sau khi bạn phê duyệt, Gemini sẽ chuyển ngữ cảnh một cách tự nhiên sang Kỹ sư, sử dụng quy cách đã phê duyệt để viết mã phụ trợ/giao diện người dùng.
  4. Sau đó, QA Engineer sẽ sửa mọi lỗi và lưu mã cuối cùng.
  5. Cuối cùng, DevOps Master sẽ tự động cài đặt các mô-đun và phân phát ứng dụng cho trình duyệt của bạn!

Một lần chạy mẫu Technical_Specification.md và chờ phê duyệt hoặc nhận xét

11defe4c48e874cc.png

Sau khi người dùng phê duyệt lời nhắc, toàn bộ quy trình sẽ bắt đầu.

b9af07291806ae60.png

7. Tổng kết và các bước tiếp theo

Xin chúc mừng! Bạn đã học được cách chèn Vòng lặp lặp lại cộng tác và thế hệ ứng dụng động, toàn diện vào một quy trình dựa trên tác nhân!

Trong lớp học lập trình này, chúng ta đã tìm hiểu những nội dung sau:

  • Cách lập bản đồ các nhân cách AI bằng cách sử dụng .agents/agents.md.
  • Tạo các vòng lặp chỉnh sửa cộng tác bên trong .agents/skills/write_specs.md để tác nhân đọc các nhận xét markdown nội dòng của bạn.
  • Xây dựng các kỹ năng .md linh hoạt để viết mã trong mọi khung hình (Python, React) tuỳ thuộc vào quy cách đã được phê duyệt!