Harness engineering beginner tutorial, from 0 to 1
TypeScript agentagenticagentic-aiaiai-agentai-agentsdshdsh-pluginharnessharness-engineeringharness-frameworkllm
Merge branch 'main' into main
Sanbu 散步781db8912ced
diff --cc docs/.vitepress/config.mtsindex 6d1eff5,d1b4185..46749c8--- a/docs/.vitepress/config.mts+++ b/docs/.vitepress/config.mts@@@ -80,41 -80,41 +80,76 @@@ const enSkillItems ={ text: "Skills Overview", link: "/en/skills/" }];+const viLectureItems = [+ { text: "Chào mừng", link: "/vi/" },+ { text: "Tại sao các Agent mạnh vẫn thất bại", link: "/vi/lectures/lecture-01-why-capable-agents-still-fail/" },+ { text: "Harness thực sự là gì", link: "/vi/lectures/lecture-02-what-a-harness-actually-is/" },+ { text: "Tại sao Repository phải trở thành Nguồn sự thật", link: "/vi/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/" },+ { text: "Tại sao một file hướng dẫn khổng lồ lại thất bại", link: "/vi/lectures/lecture-04-why-one-giant-instruction-file-fails/" },+ { text: "Tại sao các tác vụ dài hạn lại mất tính liên tục", link: "/vi/lectures/lecture-05-why-long-running-tasks-lose-continuity/" },+ { text: "Tại sao quá trình khởi tạo cần một giai đoạn riêng", link: "/vi/lectures/lecture-06-why-initialization-needs-its-own-phase/" },+ { text: "Tại sao Agent làm quá giới hạn và chưa hoàn thành", link: "/vi/lectures/lecture-07-why-agents-overreach-and-under-finish/" },+ { text: "Tại sao Feature List là nguyên lý cốt lõi của Harness", link: "/vi/lectures/lecture-08-why-feature-lists-are-harness-primitives/" },+ { text: "Tại sao Agent tuyên bố thành công quá sớm", link: "/vi/lectures/lecture-09-why-agents-declare-victory-too-early/" },+ { text: "Tại sao kiểm thử End-to-End thay đổi kết quả", link: "/vi/lectures/lecture-10-why-end-to-end-testing-changes-results/" },+ { text: "Tại sao tính quan sát thuộc về bên trong Harness", link: "/vi/lectures/lecture-11-why-observability-belongs-inside-the-harness/" },+ { text: "Tại sao mỗi phiên làm việc phải để lại trạng thái sạch", link: "/vi/lectures/lecture-12-why-every-session-must-leave-a-clean-state/" }+];++const viProjectItems = [+ { text: "Chào mừng", link: "/vi/projects/" },+ { text: "Chỉ Prompt vs. Ưu tiên Quy tắc", link: "/vi/projects/project-01-baseline-vs-minimal-harness/" },+ { text: "Không gian làm việc Agent đọc được", link: "/vi/projects/project-02-agent-readable-workspace/" },+ { text: "Tính liên tục đa phiên", link: "/vi/projects/project-03-multi-session-continuity/" },+ { text: "Phản hồi Runtime và Kiểm soát Phạm vi", link: "/vi/projects/project-04-incremental-indexing/" },+ { text: "Tự xác minh và Phân tách Vai trò", link: "/vi/projects/project-05-grounded-qa-verification/" },+ { text: "Harness Hoàn chỉnh", link: "/vi/projects/project-06-runtime-observability-and-debugging/" }+];++const viResourceItems = [+ { text: "Tổng quan", link: "/vi/resources/" },+ { text: "Mẫu tiếng Anh", link: "/vi/resources/templates/" },+ { text: "Tài liệu tham khảo tiếng Anh", link: "/vi/resources/reference/" },+ { text: "Gói Nâng cao", link: "/vi/resources/openai-advanced/" }+];++const viSkillItems = [+ { text: "Tổng quan về Kỹ năng", link: "/vi/skills/" }+ const ruLectureItems = [+ { text: "Добро пожаловать", link: "/ru/" },+ { text: "Сильная модель ≠ надёжное исполнение", link: "/ru/lectures/lecture-01-why-capable-agents-still-fail/" },+ { text: "Что такое harness на самом деле", link: "/ru/lectures/lecture-02-what-a-harness-actually-is/" },+ { text: "Репозиторий как единый источник правды", link: "/ru/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/" },+ { text: "Почему один большой файл инструкций не работает", link: "/ru/lectures/lecture-04-why-one-giant-instruction-file-fails/" },+ { text: "Как сохранять контекст между сессиями", link: "/ru/lectures/lecture-05-why-long-running-tasks-lose-continuity/" },+ { text: "Зачем инициализация — отдельная фаза", link: "/ru/lectures/lecture-06-why-initialization-needs-its-own-phase/" },+ { text: "Почему агенты делают слишком много или слишком мало", link: "/ru/lectures/lecture-07-why-agents-overreach-and-under-finish/" },+ { text: "Списки фич как примитивы harness", link: "/ru/lectures/lecture-08-why-feature-lists-are-harness-primitives/" },+ { text: "Почему агенты слишком рано объявляют успех", link: "/ru/lectures/lecture-09-why-agents-declare-victory-too-early/" },+ { text: "Только сквозной прогон — настоящая проверка", link: "/ru/lectures/lecture-10-why-end-to-end-testing-changes-results/" },+ { text: "Наблюдаемость — часть harness", link: "/ru/lectures/lecture-11-why-observability-belongs-inside-the-harness/" },+ { text: "Каждая сессия должна оставлять чистое состояние", link: "/ru/lectures/lecture-12-why-every-session-must-leave-a-clean-state/" }+ ];++ const ruProjectItems = [+ { text: "Добро пожаловать", link: "/ru/projects/" },+ { text: "Только промпты vs правила", link: "/ru/projects/project-01-baseline-vs-minimal-harness/" },+ { text: "Рабочее пространство для агента", link: "/ru/projects/project-02-agent-readable-workspace/" },+ { text: "Непрерывность между сессиями", link: "/ru/projects/project-03-multi-session-continuity/" },+ { text: "Обратная связь и контроль скоупа", link: "/ru/projects/project-04-incremental-indexing/" },+ { text: "Самопроверка и обоснованные ответы", link: "/ru/projects/project-05-grounded-qa-verification/" },+ { text: "Полный harness (капстоун)", link: "/ru/projects/project-06-runtime-observability-and-debugging/" }+ ];++ const ruResourceItems = [+ { text: "Обзор", link: "/ru/resources/" },+ { text: "Шаблоны", link: "/ru/resources/templates/" },+ { text: "Справочник", link: "/ru/resources/reference/" },+ { text: "Расширенный пакет", link: "/ru/resources/openai-advanced/" }+ ];++ const ruSkillItems = [+ { text: "Обзор скиллов", link: "/ru/skills/" }];export default withMermaid(@@@ -221,39 -221,40 +256,73 @@@socialLinks: [{ icon: "github", link: githubRepoTreeLink }]}},+ vi: {+ label: "Tiếng Việt",+ lang: "vi-VN",+ link: "/vi/",+ themeConfig: {+ nav: [+ { text: "Bài giảng", link: viLectureItems[1].link, activeMatch: '^/vi/(lectures/.*)?$' },+ { text: "Dự án", link: viProjectItems[0].link, activeMatch: '^/vi/projects/' },+ { text: "Tài nguyên", link: "/vi/resources/", activeMatch: '^/vi/resources/' },+ { text: "Kỹ năng", link: "/vi/skills/", activeMatch: '^/vi/skills/' },+ { text: "Try Harness ↗", link: "https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/vi/resources/templates/index.md", target: "_blank", rel: "noopener noreferrer" }+ ],+ sidebar: {+ '/vi/projects/': [{ text: "Dự án", items: viProjectItems }],+ '/vi/resources/': [{ text: "Thư viện Tài nguyên", items: viResourceItems }],+ '/vi/skills/': [{ text: "Kỹ năng", items: viSkillItems }],+ '/vi/': [{ text: "Bài giảng", items: viLectureItems }]+ },+ outline: {+ level: [2, 3]+ },+ docFooter: {+ prev: "Trang trước",+ next: "Trang sau"+ },+ lastUpdated: {+ text: "Cập nhật lần cuối"+ },+ returnToTopLabel: "Trở lên trên cùng",+ sidebarMenuLabel: "Menu",+ darkModeSwitchLabel: "Giao diện",+ lightModeSwitchTitle: "Chuyển sang chế độ sáng",+ darkModeSwitchTitle: "Chuyển sang chế độ tối",+ ru: {+ label: "Русский",+ lang: "ru",+ link: "/ru/",+ themeConfig: {+ nav: [+ { text: "Лекции", link: ruLectureItems[1].link, activeMatch: '^/ru/(lectures/.*)?$' },+ { text: "Проекты", link: ruProjectItems[0].link, activeMatch: '^/ru/projects/' },+ { text: "Материалы", link: "/ru/resources/", activeMatch: '^/ru/resources/' },+ { text: "Скиллы", link: "/ru/skills/", activeMatch: '^/ru/skills/' },+ { text: "Try Harness ↗", link: "https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/ru/resources/templates/index.md", target: "_blank", rel: "noopener noreferrer" }+ ],+ sidebar: {+ '/ru/projects/': [{ text: "Проекты", items: ruProjectItems }],+ '/ru/resources/': [{ text: "Материалы", items: ruResourceItems }],+ '/ru/skills/': [{ text: "Скиллы", items: ruSkillItems }],+ '/ru/': [{ text: "Лекции", items: ruLectureItems }]+ },+ outline: {+ level: [2, 3],+ label: "На этой странице"+ },+ docFooter: {+ prev: "Предыдущая",+ next: "Следующая"+ },+ lastUpdated: {+ text: "Последнее обновление"+ },+ returnToTopLabel: "Наверх",+ sidebarMenuLabel: "Меню",+ darkModeSwitchLabel: "Тема",+ lightModeSwitchTitle: "Включить светлую тему",+ darkModeSwitchTitle: "Включить тёмную тему",socialLinks: [{ icon: "github", link: githubRepoTreeLink }]}}