# Viết từ dữ liệu của bạn

Giữ các đầu vào phân tích, script, bảng và kết quả của bản thảo luôn kết nối với nhau.

Một đoạn văn kết quả dễ tạo niềm tin hơn khi phép tính đứng sau nó nằm ngay gần đó. Hãy dùng một dự án nghiên cứu để giữ quy trình phân tích cùng các kết quả của nó bên cạnh bản thảo.

## Thiết lập dự án

Chọn starter **Reproducible analysis**. [Liên kết thư mục dữ liệu](/docs/linked-folders/) để các công cụ nghiên cứu đọc được các phép đo gốc mà không phải di chuyển chúng vào bài viết.

Ghi lại ý nghĩa của từng cột, đơn vị của chúng và mọi lần loại bỏ dữ liệu trước khi yêu cầu một phân tích.

## Giao cho trợ lý một công việc có giới hạn

Dùng `/oleafly-data-analysis` hoặc một [nhiệm vụ nghiên cứu](/docs/research-tasks/) loại **Analysis**:

> Hãy đọc các phép đo trong thư mục Data đã liên kết. So sánh hai điều kiện bằng phương pháp trong analysis-plan.md. Lưu script, một bảng kèm đơn vị và một ghi chú mô tả các lần loại bỏ dữ liệu. Giữ nguyên dữ liệu đầu vào.

Các script phân tích cần runtime và thư viện cục bộ phù hợp. Hãy để trợ lý kiểm tra các yêu cầu đó và lưu lại cách chạy lại công việc.

## Kiểm tra các kết quả đầu ra

Đọc script và xác nhận rằng dữ liệu cùng phương pháp được chọn khớp với câu hỏi. Kiểm tra đơn vị, số lượng mẫu, giá trị bị thiếu và độ không chắc chắn trước khi chấp nhận một kết quả.

Giữ các bảng và hình cùng script tạo ra chúng. [Skill figure-prep](/docs/skills/) có thể giúp biến một kết quả đã kiểm tra thành một hình cho bản thảo.

Với một [CLI agent](/docs/cli-agents/#research-starting-points), điểm khởi đầu **Reproducibility audit** hỏi từng kết quả còn cần gì để tái lập được: mã, dữ liệu, phiên bản phần mềm, seed ngẫu nhiên và hướng dẫn dựng. **Figure audit** kiểm tra chú thích, nhãn, đơn vị trục và độ dễ đọc. Cả hai đều yêu cầu agent viết báo cáo trong `research/` và không đụng vào bản thảo.

## Chạy mã ngay trong tài liệu

Để các con số trong PDF đến thẳng từ mã, hãy viết báo cáo bằng [Quarto hoặc Calepin](/docs/engines/#quarto). Quarto chạy các chunk R, Python hoặc Julia trong một tệp `.qmd` hoặc `.Rmd`, còn Calepin chạy các chunk trong một tài liệu Typst.

- Mã luôn tắt trong từng dự án cho đến khi bạn chọn **Allow code in this project**. Khi mã tắt, Quarto hiển thị mã của từng chunk mà không có kết quả, còn Calepin hiển thị các kết quả nó đã lưu ở lần mã chạy gần nhất. Bộ lọc, shortcode, thư mục `_extensions`, script render và mã R nội tuyến vẫn chạy mã ngay cả khi đó, nên một dự án dùng bất kỳ thứ nào trong số này sẽ không biên dịch được cho đến khi bạn cho phép mã.
- Khi mã tắt và máy tính không có R, một tệp `.qmd` có front matter vẫn xem trước được, trừ khi front matter của nó có khóa `knitr:`. Mọi tài liệu khác có mã R, kể cả tệp `.Rmd`, đều cần R ngay cả khi mã tắt. Cài R từ [cloud.r-project.org](https://cloud.r-project.org/), rồi biên dịch lại.
- Oleafly cần Quarto 1.5 trở lên. Nếu bản của bạn cũ hơn, Oleafly dùng bản của chính nó, hoặc yêu cầu bạn tải một bản từ **Settings → Engines → Quarto**. Khi chưa tải bản nào, một tài liệu trong dự án `_quarto.yml` được dựng bằng Quarto cũ hơn của bạn.
- Mã Python chạy trong môi trường riêng của dự án khi dự án có thư mục `.venv`, `venv` hoặc `env` đã cài Jupyter, và Calepin dùng thư mục `.venv` khi dự án có. Nếu không, mã chạy trong Python được liệt kê dưới **Languages** trong **Settings → Engines → Quarto**.
- Một tài liệu `pdf` hoặc `beamer` cần LaTeX. Khi chưa cài TeX, hãy cài TinyTeX khi Oleafly đề xuất, chuyển tài liệu sang `format: typst`, hoặc thêm `pdf-engine: tectonic` vào front matter để dùng engine tích hợp sẵn khi mã đã được cho phép.
- Quarto ghi một tệp làm việc mang tên tài liệu bên cạnh nó: `report.tex` cho PDF, hoặc `report.typ` cho Typst. Nếu một tệp của bạn đã có tên đó, lần biên dịch dừng lại và nêu tên nó thay vì ghi đè. Hãy đổi tên hoặc di chuyển tệp của bạn, rồi biên dịch lại.
- Nếu các ký tự tiếng Hàn, tiếng Trung hoặc tiếng Nhật bị thiếu trong PDF, cảnh báo nêu tên một phông chữ và đưa ra hai dòng để thêm vào front matter: `CJKmainfont:` với phông đó, và `pdf-engine: tectonic`. Hãy thêm cả hai, vì phông chữ đi kèm engine tích hợp sẵn. `pdf-engine: tectonic` chỉ hoạt động khi mã đã được cho phép cho dự án.
- Một notebook có thể chạy tới một giờ. Quá mức đó, Oleafly dừng nó, và nhật ký hiển thị cell mà nó đã tới. Hãy rút ngắn hoặc lưu đệm cell đó, rồi biên dịch lại.

## Viết kết quả

Hãy nhờ trợ lý soạn một đoạn kết quả chỉ dùng các đầu ra đã xem lại. Đối chiếu từng con số với bảng và giữ phương pháp tách biệt khỏi phần diễn giải.

Biên dịch tài liệu và xem lại bảng hoặc hình hoàn chỉnh trong PDF, kể cả nhãn và chú thích.
