CHƯƠNG 26 / 33

Gói Harness Nâng cao OpenAI

Gói này tập hợp thiết kế harness được mô tả trong bài viết "Harness Engineering" của OpenAI thành một bộ tệp bắt đầu có thể áp dụng và cấu trúc SOP đi kèm.

Cập nhật 10 tháng 7, 20263 phút đọc

English Version → | 中文版本 →

Tại sao Nó Tồn tại

Bài viết harness engineering mô tả các nguyên tắc cấp cao: kho lưu trữ là hệ thống ghi chép, bộ nhớ ngoại hóa, kiểm tra cơ học thay vì ký ức, và các vòng phản hồi phục hồi. Gói này biến các nguyên tắc đó thành:

bộ tài liệu cấu trúc rõ ràng cho một repo thực tế
tính điểm chất lượng theo domain sản phẩm và lớp kiến trúc
thư mục tài liệu tham khảo thân thiện với model
các quy trình vận hành chuẩn cho kiến trúc, thu thập kiến thức, và xác minh runtime

Bố cục Bắt đầu Có sẵn

Gói bắt đầu trong repo-template/ phản ánh cấu trúc dưới đây:

AGENTS.md
ARCHITECTURE.md
docs/
├── design-docs/
│   ├── index.md
│   └── core-beliefs.md
├── exec-plans/
│   ├── active/
│   ├── completed/
│   └── tech-debt-tracker.md
├── generated/
│   └── db-schema.md
├── product-specs/
│   ├── index.md
│   └── new-user-onboarding.md
├── references/
│   ├── design-system-reference-llms.txt
│   ├── nixpacks-llms.txt
│   └── uv-llms.txt
├── DESIGN.md
├── FRONTEND.md
├── PLANS.md
├── PRODUCT_SENSE.md
├── QUALITY_SCORE.md
├── RELIABILITY.md
└── SECURITY.md

Cách Áp dụng Nó

Bắt đầu từ gói tối giản nếu repo của bạn vẫn còn nhỏ.
Sao chép các tệp trong repo-template/ vào kho lưu trữ của bạn khi bạn cần cấu trúc mạnh hơn.
Giữ AGENTS.md ngắn. Coi nó như bộ định tuyến vào các tài liệu sâu hơn, không phải như bách khoa toàn thư.
Cập nhật các tài liệu chất lượng, độ tin cậy và kế hoạch như một phần của công việc thông thường, không phải như một ngày dọn dẹp riêng biệt.
Giữ các artifact được tạo ra và tài liệu tham khảo bên ngoài rõ ràng để agent có thể tìm thấy chúng mà không cần dựa vào lịch sử chat.

Thư viện SOP

Thư mục sops/ biến các sơ đồ của bài viết thành các quy trình vận hành từng bước:

thiết lập kiến trúc domain phân lớp
mã hóa kiến thức ẩn vào kho lưu trữ
stack observability cục bộ và workflow vòng phản hồi
vòng lặp xác minh Chrome DevTools cho công việc UI

Nguyên tắc Thiết kế

Điểm đầu vào ngắn, tài liệu liên kết sâu hơn
Kho lưu trữ là hệ thống ghi chép
Kiểm tra cơ học tốt hơn các quy tắc được nhớ
Kế hoạch và lịch sử chất lượng nằm bên cạnh mã
Dọn dẹp và đơn giản hóa là trách nhiệm hạng nhất

Gói này có chủ ý theo quan điểm, nhưng nó vẫn nên được điều chỉnh cho dự án của bạn thay vì sao chép mù quáng.

Giấy phép nội dung

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.