人工智能AI AgentAgent 框架DeepSeek【免费下载链接】deepseek-harnessDeepSeek Harness: Everything is a Plugin.项目地址https://gitcode.com/gh_mirrors/de/deepseek-harness点击查看免费下载导读DeepSeek Harness 仓库采用英文与简体中文双语文档维护策略每对文档foo.md↔foo.zh.md必须保持内容一致。本 Agent Note 记录了一项已落地Status: implemented的关键流程决策把日常小改动引发的翻译从一套昂贵的多阶段工作流收敛为当前 agent 在同一轮次内直接完成的一次性单遍翻译——加载术语表、翻译改动内容、必要时移动术语首现括注、保留未触及的对侧行文、重新记录配对全程不调用翻译 skill、不生成简报、不委派 subagent。读者读完本文将掌握轻量路径与手动扩展工作流的分界如何划分、两个 AI 产品Claude Code 与 Codex的 skill 调用元数据契约如何通过符号链接与门禁保持对齐、以及一次完整的双语配对更新应该如何操作与验证。问题一次小改动为何要支付工作流级成本在引入轻量化路径之前日常的双语编辑会自动选用完整的翻译 skilldsh-translate-docs。即使此前已经实现了基于简报的最小更新优化见 2026-07-26-briefed-minimal-translation-updates.md一次很小的文档改动仍可能触发以下整套编排加载专用翻译工作流skill生成一份翻译简报briefing把行文翻译委派给 subagent另行执行一轮核验verification pass。该 Agent Note 指出这套编排所耗费的时间、上下文窗口和模型 token比直接翻译改动文本本身还要多同时skill 的自动发现机制还会在普通文档处理轮次中暴露这个重工作流——即便当前任务只是一两行的措辞调整模型上下文里也会被塞入整套工作流的说明。从配套的基准测试看见前序 Agent Note 的 Benchmark 一节一次 164 行的小改动在旧路径上的典型开销中位数是约 59.5 万相对 token 成本单位、32 轮对话而简报路径约为 27.6 万 token 成本单位、14 轮节省约三分之二——这还只是简报路径轻量化路径的成本进一步降为改动源文本 局部对侧上下文 术语表三者之和。核心决策日常翻译一次性完成、只处理一遍本 Agent Note 的第一条决策定义了轻量路径的全部行为可概括为one-shot一次性与 one-pass单遍加载术语表当前 agent 先加载 docs/i18n/terminology.md。术语表是小但具有约束力的输入是防止全仓库术语漂移term drift的关键该决策明确拒绝连术语表也不加载的选项因为那等于用产品语言的不一致换取 token 节省。只翻译改动内容直接翻译本次发生改动的部分不做整篇重译。首现括注随编辑边界移动如果某术语在整个文档中的首次出现位置跨过了编辑边界则把该术语的中文括注如agent智能体从被改动的片段移到新的实际首现处。保留未触及的对侧行文改动之外、已经经过评审的对侧文件措辞保持不变避免重译造成的评审结果丢失。不调用 skill、不生成简报、不启动单独的评审轮次、不委派 subagent全部工作由当前 agent 直接完成。重新记录配对翻译完成后重新记录该文档对的配对一致性状态。这套默认行为被固化在仓库的文档标准中docs/AGENTS.md 第 43 行的常驻指令明确写道Pairs update together: Terminology-guided, single-pass active-agent work repositions first-use annotations, preserves untouched prose, and re-records;dsh-translate-docsremains user-invoked。也就是说轻量默认不是某个 skill 的临时策略而是根级与文档级指令的一部分。扩展工作流仅限手动调用第二条决策把完整的扩展工作流dsh-translate-docs限定为仅手动调用。该 skill 保留的能力包括生成简报briefing行文翻译委派给 subagent整篇文档翻译路径新配对按范围核验scoped verification路径。两个产品的调用元数据契约技能目录 .agents/skills/dsh-translate-docs/SKILL.md 的 YAML frontmatter 中写着name: dsh-translate-docs description: Manually run the extended DeepSeek Harness bilingual-document workflow, including generated briefings, delegated prose translation, whole-document translation, and scoped pairing verification. disable-model-invocation: true user-invocable: trueClaude Code读取SKILL.mdfrontmatter 中的disable-model-invocation: true与user-invocable: true模型不得自动调用但用户仍可显式调用Codex读取同一 skill 目录下agents/openai.yaml中的policy.allow_implicit_invocation: false同样禁止隐式调用。仓库根目录的.claude/skills是指向../.agents/skills的符号链接已验证存在因此两个产品共享同一份提交到仓库的 skill 工作流同时各自执行各自的调用元数据契约——单一来源双份策略。门禁如何保证两份策略不漂移scripts/verify-skill-invocation-metadata.ts 是doc-sync文档同步门禁的组成部分它对.agents/skills下每个带 Codex 产品元数据的 skill 目录做三项检查解析SKILL.mdfrontmatter校验disable-model-invocation与user-invocable必须是布尔值解析agents/openai.yaml校验policy.allow_implicit_invocation必须是布尔值交叉比对Claude Code 侧仅手动disable-model-invocation true与 Codex 侧仅手动allow_implicit_invocation false必须一致且仅手动的 skill 必须保持user-invocable: true。也就是说如果某项 skill 只在一个产品中变成仅手动、或在 Claude Code 中对用户和模型都不可用门禁都会直接报错拒绝如Claude Code manual-onlytrue but Codex manual-onlyfalse。用户如何显式调用扩展工作流仅在用户显式点名时运行Claude Code/dsh-translate-docsCodex$dsh-translate-docs。SKILL.md 的 Invocation boundary 一节对此有硬性约束Run this extended workflow only when the user explicitly invokesdsh-translate-docsby name. Never select or load it for ordinary documentation work, from another skill, or from an inferred translation need并明确日常翻译遵循 docs/AGENTS.md 中的一次性单遍规则。自动工作流不会串联进手动 skill第三条决策处理的是自动机制与手动 skill 的耦合自动工作流不得链式加载仅限手动调用的 skill。轻量默认行为由根级指令仓库根AGENTS.md和文档指令docs/AGENTS.md定义文档、网站同步、行文与代码评审类 skill 会链接这些指令或 i18n 契约docs/i18n/README.md而不是因为推断到了一次双语改动就去加载dsh-translate-docs该决策在 docs/i18n/README.md 的 Division of labor 一节被进一步固化Routine counterparts are updated directly by the working agent in one pass after it loads terminology.md; it does not invoke a translation skill, generate a briefing, run a separate translation-review pass, or delegate to a subagent. The extended dsh-translate-docs workflow retains those heavier mechanisms for explicit user invocation.配对契约与评审契约保持不变第四条决策强调轻量化改变的是执行方式不改变任何既有契约两种语言文件始终一并更新foo.md与foo.zh.md以及一致性记录foo.i18n.yaml组成完整三件套PR 不会只落单侧语言未触及的对侧措辞保持稳定只打补丁不重译术语约束仍然有效翻译必须遵循 docs/i18n/terminology.md 的表格双向绑定确认后才重写一致性记录只有当前 agent 确认配对内容一致后才通过verify-translation-pairing --write pair重写两侧的 blob hash 记录doc-sync继续执行全语料机械检查配对完整性、结构签名标题层级、代码块、表格行列数、列表类型等、语言切换行、链接 locale 等语义翻译质量仍由人工评审负责门禁只能验证两侧在这份精确内容上被确认过一致无法判断措辞是否地道、术语是否准确——这是评审者的一半契约。一次标准的最小更新操作序列综合 docs/i18n/README.md 与 SKILL.md日常轻量路径更新一对文档的完整操作是修改源语言一侧假设为foo.md加载 docs/i18n/terminology.md直接翻译改动内容到foo.zh.md首现括注随编辑边界移动未触及行文保持原样记录配对pnpm run verify-translation-pairing --write pair重新计算并记录两侧 blob hash 到foo.i18n.yaml该命令必须显式点名配对裸--write会被拒绝全量重录必须显式--write --all按范围验证pnpm run verify-translation-pairing pairPR 层面运行pnpm run doc-sync包含全语料配对检查与verify-md-wrap/verify-md-links。当用户显式调用扩展工作流时更新路径则变为简报驱动pnpm run gen-translation-brief pair生成简报无参数时为所有失配配对生成纯机械改动改动全部位于两侧逐字节相同的代码围栏内可直接pnpm run gen-translation-brief --apply pair拼接写入行文改动则把简报作为 subagent 的完整工作集进行委派翻译相关实现见 scripts/gen-translation-brief.ts 与 scripts/translation-brief.ts。曾考虑的替代方案为什么被拒绝该决策记录了四个被评估后否决的替代方案理解它们有助于把握边界替代方案拒绝理由删除扩展 skill 与简报工具整篇文档翻译、棘手的两侧协调、以及有意选择受控工作流的调用方仍需要显式手动路径用自动调用的轻量 skill取代扩展 skill另一项自动 skill 仍会为当前 agent 本可凭术语表与常驻指令直接完成的任务增加发现上下文与调用边界仅对新配对或大规模改动保留自动调用基于规模的推断是另一种隐藏策略可能在意料之外激活高开销工作流何时值得走扩展路径应由用户而非 agent 决定连术语表也一并去掉术语表是体量小但有约束力的输入去掉它将导致全仓库术语漂移等于用产品语言不一致换取 token 节省其中第三条尤其重要该决策刻意把规模判断从自动机制中移除改为用户显式选择——agent 永远不做这次改动够大所以自动用重工作流的推断避免隐藏策略带来的不可预期成本。后果成本结构与责任边界成本结构的变化普通开发的语言维护成本从简报 subagent 上下文降为三者之和发生改动的源文本其局部对侧文件上下文术语表。轻量路径有意放弃扩展工作流提供的三样东西自动生成的对齐信息简报、委派带来的隔离性、以及单独的行文核验轮次。作为交换它获得了最低的 token 与上下文占用——前序简报决策的基准测试表明对简报路径而言小模型与大模型已可同水平完成更新任务轻量路径在此基础上进一步压缩。责任与质量边界当前 agent 在同一轮次内对日常翻译的最终结果负责没有 subagent 的隔离也没有第二遍核验兜底一次性单遍意味着质量责任落在翻译 按句对照验证这一个 pass 里SKILL.md 的 Pass 2 规则fidelity 是在这里检查出来的而不是写出来的门禁的两个独立产品契约Claude Code frontmatter 与 Codex 策略文件彼此独立doc-sync负责在两者间做一致性校验人工评审仍然拥有语义翻译质量的最终裁决权门禁输出绿不意味着措辞优秀只意味着这份精确内容被确认过一致。相关实现与进一步阅读决策正文.agents/notes/implemented/process/2026-08-08-lightweight-routine-documentation-translation.md含中文对侧文件常驻指令docs/AGENTS.md 第 43 行 Pairs update together 条款配对契约与分工docs/i18n/README.md术语真源docs/i18n/terminology.md手动扩展工作流.agents/skills/dsh-translate-docs/SKILL.md.claude/skills符号链接指向同一目录调用元数据门禁实现scripts/verify-skill-invocation-metadata.ts 及其测试 scripts/verify-skill-invocation-metadata.spec.ts简报路径与基准数据.agents/notes/implemented/process/2026-07-26-briefed-minimal-translation-updates.md简报生成与配对校验脚本scripts/gen-translation-brief.ts、scripts/translation-brief.ts、scripts/translation-pairing.spec.ts这一流程设计揭示的核心原则可复用到任何双语或双格式内容需要保持同步的工程场景默认路径要足够便宜让顺手更新对侧成为无痛动作昂贵路径保留但必须由用户显式选择契约术语、配对、评审不因执行路径变轻而放松。赞分享人工智能AI AgentAgent 框架DeepSeek【免费下载链接】deepseek-harnessDeepSeek Harness: Everything is a Plugin.项目地址https://gitcode.com/gh_mirrors/de/deepseek-harness点击查看免费下载相关推荐终极指南如何快速掌握TEB Local Planner - 移动机器人轨迹规划完整教程终极指南如何快速掌握TEB Local Planner 移动机器人轨迹规划完整教程 你是否在为移动机器人寻找一个高效、实时的路径规划解决方案 TEB Loc机器人ROS科研Metallb国际化文档i18n工具与翻译工作流Metallb国际化文档i18n工具与翻译工作流 项目国际化现状分析 Metallb作为Kubernetes网络负载均衡解决方案其国际化支持主要体现在配置翻云原生网络CANN Runtime 仓库中文档翻译工作流详解基于 translation_skill 的规范化 PR 翻译实践CANN Runtime 仓库中文档翻译工作流详解基于 translation_skill 的规范化 PR 翻译实践 导读 本指南完整解析 CANN RuntCANNAscend人工智能任务调度上一篇CANN/asc-devkit分形转换兼容性样例下一篇Stable Diffusion WebUI Forge注意力机制优化提升AI图像生成效率的终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考