name: environment-execution description: "Scripting constraints and coding standards for executing local analysis tools, specifying Python environment handling and logging standards."

Environment Execution Skill

Sử dụng kỹ năng này khi viết mã lập trình, chạy các công cụ phân tích hoặc thiết lập môi trường thực thi tính toán kinh tế lượng trên máy tính của User.

1. Quản lý Môi trường Thực thi (Environment Guardrails)

• Kiểm soát thư mục (Blast Radius): Tất cả các file chạy thử, script cào dữ liệu, dữ liệu trung gian bắt buộc phải được tạo trong thư mục con .agents/scripts/ hoặc scratch/ của không gian làm việc hiện tại (/Users/keira/Documents/GitHub). Không được tạo hoặc chỉnh sửa tệp tin bên ngoài phạm vi này.
• Không tự tiện tạo môi trường ảo: Không tự ý khởi chạy conda create hoặc tạo môi trường venv mới trừ khi được người dùng yêu cầu rõ ràng. Hãy sử dụng trực tiếp trình thông dịch python3 của hệ thống.
• Dependencies Installation: Nếu script yêu cầu các thư viện bên ngoài (ví dụ: pypdf, requests, tidyverse cho R), Agent phải propose rõ ràng lệnh cài đặt dạng non-interactive (ví dụ: pip3 install --quiet pypdf requests) trước khi chạy, không chạy ẩn ngầm.

2. Tiêu chuẩn viết Code phân tích & Ghi Log (Coding & Logging Standards)

• Visualizations: Khi viết code trực quan hóa số liệu hoặc chạy mô hình hồi quy, tuân thủ nghiêm ngặt:
• Nếu phân tích số liệu thống kê vĩ mô chuyên sâu: Sử dụng R và thư viện tidyverse (ggplot2) làm tiêu chuẩn ưu tiên.
• Mã nguồn R/Python phải sạch, có chú thích chi tiết bằng tiếng Anh hoặc tiếng Việt về ý nghĩa của các dòng lệnh và các hệ số hồi quy.
• Structured Logs: Các script Python chạy ngầm để thu thập dữ liệu bắt buộc phải ghi log ra file scratch/research_process.log theo định dạng chuẩn: [YYYY-MM-DD HH:MM:SS] [AGENT_NAME] [LEVEL] Message Điều này giúp reporting_agent (Master Conductor) có thể đọc log để phát hiện lỗi khi một subagent cào dữ liệu bị treo hoặc gặp lỗi kết nối.
• Không nhúng Secrets: Tuyệt đối cấm ghi đè hoặc nhúng các API key, password trực tiếp vào mã nguồn. Phải đọc qua biến môi trường (Environment Variables) sử dụng os.environ hoặc nạp từ file cấu hình bảo mật được bỏ qua trong .gitignore.