arrow_back Trở về Hướng dẫn
Workflows Level 09

Workflows Reference

Tài liệu tra cứu và bảng phiên bản cho tất cả các luồng làm việc (workflows) của AI Agent trong PARA Workspace.

PARA Workspace — Workflows Reference

Version: 1.6.2 | Last reviewed: 2026-03-24

Tổng quan

Workflows là các luồng thao tác chuẩn hóa (dưới dạng Document Instructions) dành riêng cho AI Agent. Các luồng này định nghĩa rõ ràng từng bước (step-by-step) cách thức mà AI Agent phải tương tác với người dùng và hệ thống gốc để hoàn thành một nhiệm vụ cụ thể mà không phá vỡ cấu trúc Kernel đề ra.

Bảng Phiên bản (Version Table)

Source of truth: repo/templates/common/agent/workflows/catalog.yml

WorkflowSlash CommandVersionKernel MinGhi chú
Session Open/open1.5.01.6.2Unified Agent Index, skills loading (v1.6.2)
Session End/end1.5.11.6.2Pre-flight re-read rules+skills (v1.6.2)
Plan Controller/plan1.5.01.6.2Pre-flight, D3 skills check (v1.6.2)
Documentation Manager/docs1.1.11.6.2Pre-flight (v1.6.2)
Brainstorm/brainstorm1.0.01.5.3
Backlog Controller/backlog1.3.11.6.2Pre-flight (v1.6.2)
New Project/new-project1.1.01.6.0Ecosystem type support
Verify Task/verify1.0.01.4.0
Push/push1.0.11.6.2Pre-flight (v1.6.2)
Release Gate/release1.0.11.6.2Pre-flight (v1.6.2)
Semantic Merge/merge1.0.01.4.0
Project Retrospective/retro1.0.11.6.2Pre-flight (v1.6.2)
Install / Sync/install1.0.01.4.0
Safe Update/update1.1.01.4.0
Macro Assessor Audit/para-audit1.3.01.6.2Agent Index Consistency (v1.6.2)
PARA Master Controller/para1.0.01.4.0
Config Manager/config1.0.01.4.0
Backup/backup1.0.01.4.0
Inbox Categorizer/inbox1.0.01.4.0
Learn & Capture/learn1.1.01.4.0
Workflow Manager/para-workflow1.0.01.4.0
Rule Manager/para-rule1.0.01.4.0

Các Workflow chính (Core Workflows)

Các file cấu hình cho workflow (/slash-commands) được lưu hệ thống tại repo/templates/common/agent/workflows/ dưới định dạng .md.

1. Quản lý Phiên làm việc (Session Management)

  • /open <project-name>: Khởi động bối cảnh (context) đầu phiên làm việc mới, phân tích cấu trúc, đọc log phiên làm việc cũ và list các thay đổi chờ đồng bộ tại SYNC Queue.
  • /end: Luồng kết luận cuối ngày. Agent báo cáo công việc, tự động phân loại kết quả (classifications) theo kiến trúc PARA và lưu log vào sessions/.

2. Quản lý Vòng đời Dự án (Planning & Development)

  • /brainstorm: Phiên động脑 có cấu trúc, ghi nhận quyết định và đề xuất bước tiếp theo.
  • /docs <action>: Quy trình phân tích codebase tự động và trích xuất thành tài liệu (docs/) với version kiểm duyệt rõ ràng. (v1.6.1) Đã bổ sung Strategy docs detection (Step 3.5).
  • /plan: Tạo implementation plan chuẩn form. (v1.6.1) Hỗ trợ chọn loại: 🗺️ Roadmap hoặc 📐 Detail Plan (Step 2.8).
  • /verify: Gọi Walkthrough documentation để đối chiếu và kiểm tra QA, xác nhận task fulfillment.

3. Mô hình lập chiến lược và kế hoạch (v1.6.1)

Xem chi tiết tại Strategy Plan Flow Guide.

Mô hình 3 tầng bổ sung vào 4 workflows: /docs, /plan, /open, /end:

Tầng 1: docs/strategy/        WHY + WHAT    ← /docs tạo, /open load, /end detect
Tầng 2: plans/*-roadmap.md    HOW tổng      ← /plan tạo, /open load, /end sync
Tầng 3: plans/*.md (detail)   HOW chi tiết  ← /plan tạo, active_plan, archive khi xong

Workflow impacts:

WorkflowThay đổi v1.6.1
/docsStep 3.5 — Strategy docs discovery, gợi ý tạo strategy cho ecosystem
/planStep 2.8 — Plan Type Selection (Roadmap vs Detail), strategy context load
/openStep 2 ext — Strategy summary (~30 tokens), Step 5.5 — Roadmap + cascade
/endStep 3.2 — Strategy/roadmap change detection, Step 4.5 — Roadmap sync

4. Vận hành Nâng cao & Maintenance

  • /update: Workflow quản trị agent hỗ trợ thực thi tiến trình rà soát an toàn (Safe Update) nhằm nâng cấp version của chính các công cụ thư viện / Agent Workflow.
  • /retro, /release, /push: Gói công cụ hỗ trợ nghiệm thu sản phẩm, ghi chú phát hành, và lưu trữ dự án (Archive).

Sự tương tác với Profile

  • Định tuyến vai trò: Một file workflow có thể tương thích linh hoạt dựa trên cấu hình Profile (được khai báo tại tệp YAML). Dựa trên thông tin preferences.language, toàn bộ quá trình tương tác workflow sẽ được nội địa hóa (Ví dụ: Dịch response trả về sang ngôn ngữ địa phương bằng vi).
  • Thực thi bằng cờ // turbo: Workflow Workspace đặc biệt tối ưu hoá AI Tokens bằng các đánh dấu turbo. Các mã bash lệnh đơn thuần chỉ đọc dữ liệu không mang tính hủy diệt (e.g., grep, head, ls) sẽ được Agent tự động hóa hoàn toàn mà không làm gián đoạn (chờ duyệt) quy trình giao tiếp với user.

Last updated: 2026-03-24