【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载本文以 Learn Harness Engineering 开源课程仓库中的韩国语术语表docs/ko/resources/reference/glossary.md为核心系统拆解这份单一声源Single Source of Truth术语表的设计动机、标注规则、九大分类的全部条目并结合仓库内AGENTS.md模板、feature_list.json、method-map.md等真实产物说明每个术语在 Harness 工程实践中对应的落地载体。读完本文你将掌握一套可用于任何多语种技术文档项目的术语治理方案如何定义术语、如何统一翻译、哪些令牌必须保留原文、以及术语表如何与源码级产物互相印证。为什么 Harness 工程需要一份术语表Learn Harness Engineering 是一个以让 AI 编码代理coding agent稳定可靠地完成真实工程任务为核心目标的开源课程全站覆盖 14 讲课程Lectures、8 个实战项目Projects与一套可直接复制的资源库Resource Library并同步提供了包括英语、简体中文、日本語、한국어 在内的 15 种语言版本。多语种带来的第一个难题不是翻译质量而是术语一致性。同一篇课程里如果 harness 在第一次出现时译为하네스第二次出现时却写成하니스读者就会误以为是两个概念如果 Handoff 与 Session Handoff 被翻译成同一个词那么会话交接与交接之间的层级关系就会丢失。因此韩国语版单独维护了一份术语表并在文档开头明确了它的地位이 문서는 한국어판 전체에서 일관된 번역어를 보장하기 위한 단일 진실 원천(Single Source of Truth)입니다.本文档是保证韩国语版全站一致翻译用语的单一事实来源。这与课程本身的核心理念同构——课程主张仓库即系统记录Repository as System of Record把工作结果、决策与依据全部持久化到 git 仓库作为可信的单一事实来源见 README.md 对五个子系统框架的描述术语表则是这套理念在文档治理层面的延伸先有单一事实来源再有面向多个消费方的一致输出。韩国语版首页docs/ko/index.md也明确引导读者初次遇到陌生术语时查阅术语表中的韩英对照表。标注规则术语如何在正文中首次登场术语表第一部分定义了全书统一的标注约定Convention这是保证读者看到术语即知道如何理解的关键共五条规则规则说明示例首次出现格式专业术语首次出现在正文时必须以한국어(English)形式双语并排하네스(harness)、에이전트(agent)第二次及以后仅使用韩语若语境有歧义可再次附上英文에이전트가 다음 행동을 결정할 때...专有名词与工具名Claude Code、Codex、VitePress、GitHub Actions等保持英文原样不翻译、不音译系统令牌BLOCKING、HARD、[CP]、plan-writer、Skill(...)等具有代码/提示词语义意义的令牌不翻译翻译会破坏其在提示词中的可执行含义命令与文件路径npm run docs:build、docs/.vitepress/config.mts等保持英文翻译会导致命令无法复制执行这套规则背后的工程判断是可执行的、机器可读的内容与人类可读的解释性内容必须分层处理。术语表本身作为人类阅读的翻译规范只约束解释性词汇而对代理agent与工具链有实际语义的字符串一律保留原文避免翻译后造成提示词失效、命令不可运行或路径无法解析。在仓库中可以看到这套规则的实际应用docs/ko/resources/templates/AGENTS.md 作为韩语版模板正文中 harness 首次出现写作하네스(harness)而claude-progress.md、feature_list.json、init.sh、git log --oneline -5等文件名与命令则全部保留英文——这与术语表的标注规则完全一致。术语分类详解一核心概念Core Concepts术语表第二部分给出了全书最核心的 8 个概念它们是理解整个课程的基石English한국어定义Harness하네스为让 AI 编码代理稳定运行而将环境、状态、验证与控制捆绑提供的外骨骼脚手架系统。本课程的中心概念Harness Engineering하네스 엔지니어링设计、构建与维护 harness 的工程实践学科Agent에이전트自主执行任务的 AI 软件单元本课程中主要指编码代理coding agentCoding Agent코딩 에이전트执行代码编写、重构、测试等开发任务的 AI 代理State상태代理决定下一步行动时参考的持久化数据工作进度日志、功能列表、git 历史、检查清单等Context컨텍스트代理单次推理所使用的输入信息集合即模型上下文窗口context window中的内容Context Window컨텍스트 윈도LLM 单次能处理的最大 token 长度Repository as System of Record시스템 오브 레코드(SoR)로서의 저장소将工作结果、决策与依据全部持久化到 git 仓库、以其为可信单一来源的原则其中状态State与仓库即系统记录SoR直接对应仓库中的具体产物State →feature_list.jsonprojects/project-01/solution/feature_list.json 展示了功能列表的真实结构——每个功能包含id、name、description、status、evidence、testedAt六个字段status的取值如pass与evidence可运行证据正是状态作为持久化数据的实现形态Repository as System of Record → 存储库结构README.md 描述的五子系统Instructions、State、Verification、Scope、Session Lifecycle中State 子系统明确要求持久化到磁盘让下一个会话恰好从上次结束处继续而claude-progress.md、feature_list.json、git log 就是承载这套状态的文件实体。从术语到文件一条清晰的对应链就此建立术语表中的抽象概念在仓库中都有可指认的物证。术语分类详解二工作与产出Work and Deliverables这一分类描述 agent 会话过程中产生的各类工作单元与 git 协作单元English한국어定义Deliverable산출물工作成果中可验证的实体如文件、文档、代码Specification명세明确定义工作输入、行为与输出的文档常缩写为specPlan계획为满足规格说明而制定的分步工作顺序与责任分配文档TODO ChecklistTODO 체크리스트将计划拆解为可执行单元任务的复选框列表Commit커밋git 中持久化变更的单位Branch브랜치为保持独立工作流而建立的 git 分支Worktree워크트리在同一仓库中并行推进多个工作流的独立工作目录Pull Request (PR)풀 리퀘스트(PR)将一个分支的变更合并到另一分支的 GitHub 协作单元从规格说明 → 计划 → TODO 检查清单 → 交付物这一链条可以完整映射课程推荐的会话工作流docs/ko/resources/templates/AGENTS.md 中定义的完成定义Definition Of Done要求目标行为已实现 必要验证已实际执行 证据已记录在feature_list.json或claude-progress.md这恰好就是 Specification目标行为、Verification验证执行、Deliverable证据记录三个术语的闭环应用。而 Worktree 的概念在课程第 13 讲Loop Engineering与第 14 讲Graph Engineering中作为并行化原语被反复引用README 中 Codex harness 拆解也提到了 worktree 隔离docs/en/harness-designs/codex/index.md 描述了 the repository as source of truth ... and worktree isolation。术语分类详解三验证与质量Verification and Quality验证体系是 harness 区别于纯提示词工程的分水岭术语表给出了 10 个相关概念English한국어定义Verification검증用客观证据确认交付物满足规格说明的流程Validation유효성 검사确认输入值满足约束的流程含义比验证更窄Critique비평(크리틱)为提前发现计划、设计、交付物弱点而进行的对抗性adversarial审查Review리뷰同事或代理阅读代码、文档并留下反馈的流程Test테스트自动确认代码行为的验证手段单元、集成、E2E 等TDD테스트 주도 개발按 RED→GREEN→IMPROVE 顺序先写测试再实现的开发方式Acceptance Criteria인수 기준工作被认定为完成所必须满足的客观条件Quality Gate품질 게이트进入下一阶段前必须通过的自动/手动检查集合Lint린트通过静态分析检测风格与潜在错误的工具如ruff、eslintType Check타입 검사用静态类型系统预先检测类型错误如pyright、tsc --noEmit这里的核心区分是Verification验证与 Validation有效性检查验证回答交付物是否满足规格有效性检查回答输入是否合法——前者对应课程第 10 讲只有跑通全流水线才算真正的验证docs/en/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md后者则对应编码中的参数校验。另外几个概念在仓库中都有直接载体Quality Gateinit.sh启动时执行的基线验证就是一道质量门——docs/ko/resources/templates/AGENTS.md 明确要求若基线验证已失败先修复它不要在损坏的启动状态上堆叠新功能Critique / Review课程资源库中提供了 docs/ko/resources/templates/clean-state-checklist.md 与 evaluator-rubric评分量表模板后者正是为了让 Review 从主观偏好变成固定类目打分——这一意图在 docs/ko/resources/reference/method-map.md 的主观评论Subjective review失败模式中明确写出审查质量依赖于口味或记忆 → 用固定类目给交付物评分 → 辅助产物evaluator-rubric.mdLint / Type Check本仓库的 TypeScript 项目通过tsconfig.json与 Vite 构建链执行类型检查见各项目的 projects/project-01/solution/tsconfig.json。术语分类详解四Harness 组成部件Harness Components这是与课程五子系统框架衔接最紧密的分类包含 9 个部件级术语English한국어定义Skill스킬描述特定工作流的可复用提示词模块代理按需加载Hook훅在代理生命周期时点如工具调用前/后、会话开始执行的自定义脚本Rule규칙汇总代理必须始终遵守的策略与约束的 Markdown 文档Subagent / Agent (role)서브에이전트 / 역할 에이전트主会话可委派专业角色的代理如api-implement、code-reviewOrchestration오케스트레이션将多个代理、工具与检查按固定顺序编排执行的上层流程控制Permission권한控制代理能否使用特定工具、文件、命令的配置Preflight사전 점검(프리플라이트)正式开始工作前确认环境与前置条件是否就绪的步骤Guardrail가드레일阻止代理做出危险行为的策略与验证装置Telemetry텔레메트리代理运行期间收集的度量指标事件日志、延迟、失败率等这些术语在仓库中的物证清晰可循Skill仓库根目录提供 skills/harness-creator/SKILL.md是一份可被代理按需加载的创建生产级 harness技能包含 AGENTS.md、feature_list.json、init.sh 等模板与校验脚本与术语定义特定工作流 按需加载完全吻合Hook / Rule / GuardrailClaude Code 的 hooks 机制、AGENTS.md 中的工作规则Working Rules段落一次只做一个功能不要静默更改验证规则分别对应 Hook 与 Rule这些禁止项本身就是 Guardrail 的实例PreflightAGENTS.md 启动工作流中的写代码前先执行 6 步检查pwd → 读进度 → 读功能列表 → 看 git log → 运行 init.sh → 跑冒烟/E2E 验证正是 Preflight 的标准实现Telemetry / Observability课程第 11 讲专门论述可观测性应内置于 harnessdocs/en/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md项目 06 则实战构建运行时可观测与调试能力docs/en/projects/project-06-runtime-observability-and-debugging/index.mdSubagent / Role术语表中plan-writer、code-review等agent-name标识符直接出现在保留令牌列表中说明这类角色代理标识在正文中必须原样保留。术语分类详解五失败与恢复Failure and Recovery术语表用 7 个词刻画 agent 长任务中最危险的失败模式与应对手段English한국어定义Fail-loud실패-크게(fail-loud)出错时立即显著告警的策略是静默失败的相反面Silent Failure무음(無音) 실패出错却无任何信号、直接进入下一步的现象Continuity연속성长时工作中上下文与状态得以保持、不中断的性质Handoff핸드오프从一个会话或代理向下一个会话/代理移交工作的行为Session Handoff세션 핸드오프在上下文可能被截断时持久化状态供下一会话接续的模式Checkpoint체크포인트在可恢复的进度点持久化状态的时刻Rollback롤백将状态回退到某个特定时点的行为静默失败Silent Failure与 Fail-loud是课程第 9 讲的核心命题代理过早宣布胜利docs/en/lectures/lecture-09-why-agents-declare-victory-too-early/index.md的本质就是验证缺失下的静默失败而 Fail-loud 的工程实现是只有通过的测试套件才算证据——README.md 的对比图明确写道没有 harness 时第 9 步变成代理说看起来没问题有 harness 时第 9 步是测试通过、lint 干净、类型检查通过。Session Handoff 与 Checkpoint在仓库中有模板级的落地docs/ko/resources/templates/session-handoff.md会话交接模板与 docs/ko/resources/templates/claude-progress.md会话进度日志就是持久化状态供下一会话接续的标准化产物。Method Mapdocs/ko/resources/reference/method-map.md更将弱交接Weak handoff列为独立失败模式对应修复手段是以明确的交接handoff结束会话辅助产物为session-handoff.md——术语、失败模式、修复策略、产物四者一一对应。术语分类详解六初始化与约定Initialization and Conventions这一分类聚焦会话如何开始与团队如何达成一致English한국어定义Initialization초기화在新项目或新工作环境中配置 harness 的阶段Onboarding온보딩帮助新成员人或代理学习并应用项目约定的流程Convention컨벤션团队一致同意的命名、结构、工作方式标准Bootstrap부트스트랩从空状态搭建出可运行的最小环境Scaffold스캐폴딩预先生成可作为起点的目录与文件结构的工具/模式Initialization 与 Bootstrap对应课程第 6 讲初始化必须拥有独立阶段docs/en/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md以及各项目的 init.sh 脚本——它把安装依赖 验证 启动固化为一键路径Scaffold对应 skills/harness-creator 技能README 称其可在几分钟内为你的项目脚手架出一套生产级 harnessAGENTS.md、feature lists、init.sh、verification workflowsOnboarding则对应 AGENTS.md 本身的作用——它是代理每次会话开始时的入门手册代理通过阅读它来学习项目约定。工具与生态术语保持原文的处理策略术语表对工具与生态类术语采取保留原文策略并单独给出备注English한국어(또는 그대로)备注Claude CodeClaude Code原样使用。Anthropic 的编码代理 CLICodexCodex原样使用。OpenAI 的编码代理 CLICursorCursor原样使用。AI 代码编辑器VitePressVitePress原样使用。基于 Markdown 的静态站点生成器MCPMCP(모델 컨텍스트 프로토콜)代理发现并调用外部工具/资源的标准协议LSPLSP(언어 서버 프로토콜)编辑器与语言工具交换代码信息的标准协议GitHub ActionsGitHub Actions原样使用。GitHub 的 CI/CD 系统LangGraphLangGraph原样使用。基于状态图的代理框架这里存在一个精细的分层产品名与框架名不译但协议缩写首次出现时给出全称。MCP 和 LSP 属于可解释的缩写因此首次出现附带韩语全称모델 컨텍스트 프로토콜 / 언어 서버 프로토콜Claude Code、Codex、Cursor、VitePress 等则是商标/产品专名翻译反而会阻碍用户搜索与检索。这一策略对多语种技术文档有普适价值保证可检索性优先于可读性——读者在韩国语语境下仍能用英文原名在搜索引擎中找到对应工具。仓库本身即是该策略的践行者VitePress 用于构建本仓库的文档站npm run docs:build等命令见 package.json 与 README.md 的 Local Preview 一节GitHub Actions 用于 PDF 构建发布流水线.github/workflows/release-course-pdfs.ymlClaude Code 与 Codex 则分别是仓库 CLAUDE.md 与 harness-designs 拆解的主角docs/en/harness-designs/codex/index.md。保留令牌清单哪些字符串绝对不翻译术语表最后给出了一份永不翻译的令牌清单这是多语种文档最容易踩坑、也最需要固化下来的一部分系统语义令牌BLOCKING、HARD、[CP]、RED、GREEN、IMPROVE、DONE、RETRY、BLOCKEDRED/GREEN/IMPROVE是 TDD 工作流的三个阶段标记对应术语表中 TDD 的定义翻译后代理在提示词中无法识别阶段转换BLOCKING、HARD、[CP]、DONE、RETRY、BLOCKED出现在根指令或检查清单中时具有控制流语义必须保留原值才能被代理正确解析。代理标识符plan-writer、code-review、doc-writer、ui-implement等所有agent-name形式这类标识符在 Claude Code 等工具中会被解析为角色子代理subagent的引用翻译后触发失效。技能调用Skill(omb-doc)、Skill(omb-tdd)等所有Skill(...)形式技能调用是代理运行时按名加载技能模块的指令参数必须与技能定义完全一致。文件路径与命令docs/.vitepress/config.mts、npm run docs:build、git commit -m ...等路径与命令一旦翻译即不可执行属于机器可读内容优先级高于本地化需求。frontmatter 键title、description、layout等---代码块内部的英文键名这些键名被 VitePress 等构建工具解析翻译会破坏文档构建。从仓库实证看这套保留策略贯穿始终各语言版文档均保持AGENTS.md、feature_list.json、init.sh等文件名原文参见 docs/ko/resources/templates/ 目录下的文件命名提示词令牌如BLOCKING在 docs/en/lectures 各讲代码示例中直接出现README 中claude-progress.md的说明也特意强调它不是 Claude Code 专属、任何编码代理都可在根指令中要求读取该文件——文件名即协议翻译即破坏协议。术语表的维护机制随翻译持续演进术语表并非一次性产物其维护机制写得很明确강의 번역 중 새 용어가 발견되면 본 문서에 즉시 추가하고, 후속 강의 번역 시 갱신본을 입력으로 사용합니다.翻译课程过程中若发现新术语立即添加到本文档后续课程翻译时以更新版作为输入。对应计划 Task #16b。这揭示了一个务实的演进闭环触发条件每翻译一篇新课程/项目文档时遇到术语表中未收录的术语动作立即将其按分类加入对应表格或创建新分类同时按标注规则确定其首次出现的韩英并排写法消费方式后续所有文档的翻译都以最新版术语表为输入保证新增术语从下一个文档起就获得统一译法。这一机制与 docs/ko/resources/reference/method-map.md 的操作原则形成呼应——方法图要求针对观察到的失败模式添加最小化的产物而不是往全局指令文件里堆砌文本术语表同样遵循增量、最小化、单一入口的治理哲学。术语表、方法图、初始代理剧本、编码代理启动流程、提示词校准docs/ko/resources/reference/index.md 列出的五份参考笔记共同构成了韩国语版资源的完整治理体系建议按 index 给出的顺序阅读。结语术语表作为多语种 Harness 工程的治理基座把这份术语表放回 Learn Harness Engineering 的语境中审视它的价值不止于翻译对照表对读者任何初次接触 harness 概念的韩国语读者都可以从术语表快速建立韩语概念 ↔ 英语原词的映射避免因译名不一致而误解核心概念如 Verification 与 Validation 的宽窄之分、Handoff 与 Session Handoff 的层级之分对翻译维护者标注规则、保留令牌清单与增量更新机制将一致性从个人自觉变成可执行、可审计的工程规范对代理与检索保留令牌策略保证了提示词、命令、文件路径、frontmatter 键在翻译后依然机器可读、可执行、可被搜索引擎与 LLM 正确解析——这正是让文档既服务于人、又服务于机器的 Harness 工程精神在文档层的体现。如果你正在维护多语种的技术文档或面向 agent 的指令库可以直接复用这套模式定义单一术语源 → 固化标注规则 → 明确永不翻译令牌清单 → 建立增量更新流程并始终用仓库内的真实产物配置文件、模板、脚本校验术语定义的准确性。赞分享【免费下载链接】learn-harness-engineeringHarness engineering beginner tutorial, from 0 to 1项目地址https://gitcode.com/gh_mirrors/le/learn-harness-engineering点击查看免费下载相关推荐DeepSeek Harness 术语表全解中英双语文档的统一译法约定与核心架构词汇DeepSeek Harness 术语表全解中英双语文档的统一译法约定与核心架构词汇 DeepSeek Harness 仓库内所有文档均以中英双语维护 术语人工智能AI AgentAgent 框架DeepSeeklm-evaluation-harness 中的 CLIcK 任务面向韩语文化与语言智能的多选题基准评测指南lm evaluation harness 中的 CLIcK 任务面向韩语文化与语言智能的多选题基准评测指南 本文是 lm evaluation harnes人工智能模型评测AI 评测用 Feature List 约束 Agent 行为learn-harness-engineering 中的 Harness 原语与状态机实践用 Feature List 约束 Agent 行为learn harness engineering 中的 Harness 原语与状态机实践 本文以 lea上一篇不改游戏文件也能改段位显示免费工具 LeaguePrank 的 5 步上手指南下一篇Laf 平台 MinIO Helm Chart 部署指南基于 Kubernetes 的高性能 S3 对象存储实践创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
