企业官网建设流程全解析

导读

本文围绕 Gentle AI 为 Hermes Agent 预置的编排规则 orchestrator.md，系统讲解 Hermes 原生delegate_task委托机制、Organic Driven Development（ODD）默认工作流、无损阻塞提示、Gentle AI Provider 缺陷移交、委托验证门与子代理技能路径解析等核心契约。读完本文，你将掌握如何在 Hermes 上配置多 agent 团队编排、正确设置~/.hermes/config.yaml中的委托调优参数、为每个子代理注入精确的SKILL.md路径，以及如何在上下文中平衡成本与验证强度。

一、文档定位与适用边界

internal/assets/hermes/orchestrator.md是Agent Teams Lite编排规则，它的首要约束非常明确：

仅将此规则绑定到专用的 ODD 编排 agent 或 rule，不要把它应用到被委托的执行 worker 上。

这意味着编排规则描述的是"协调者"的行为边界，而不是"执行者"的权限。被委托出去的 worker 只接收任务指令，不应拿到整套编排权限（否则会出现多个 worker 互相再编排的失控局面）。这一点在源码层面得到印证：Gentle AI 将 Hermes 视为TierFull（全功能支持）的运行时，adapter.go 中Agent()返回model.AgentHermes，并支持 SystemPrompt、MCP、Skills、SubAgents 等全部可选能力。

从 adapter.go 可以看到，Hermes 的全局配置目录是~/.hermes（ConfigPath返回filepath.Join(homeDir, ".hermes")），其关键路径包括：

SystemPromptStrategy()为StrategyMarkdownSections，MCP 策略为StrategyMergeIntoYAML——Hermes 的所有 MCP server 都合并进单一的config.yaml，这与文档中"委托旋钮配置在~/.hermes/config.yaml的delegation键下"的结构一致。

二、Hermes 原生委托原语：delegate_task

Hermes 的原生委托原语是delegate_task：用它生成临时 worker，worker 在全新上下文窗口中运行，只把最终摘要返回给编排者。

2.1 关键行为

• 每个 worker 启动时上下文是全新的，不继承父会话的历史；
• 父编排者只收到 worker 的最终输出，不接收中间步骤；
• Toolset、MCP server、技能不会自动继承；当inherit_mcp_toolsets为 false（默认值）时，必须显式地在 worker mission 中传入；
• worker 默认是临时的，除非用户明确要求持久化 agent，否则不要请求持久化 agent 文件或 profile。

2.2 调优旋钮

委托行为既可以在~/.hermes/config.yaml的delegation键下统一配置，也可以在每次调用时按调用传参：

委托前应加载~/.hermes/skills/hermes-ephemeral-delegation/SKILL.md，那里有完整的委托决策表和 mission 起草协议。

三、编排者身份与角色：ODD 是唯一默认工作流

编排规则通过{{GENTLE_AI_ODD_SECTION:...}}占位符在渲染期注入共享契约，其规范正文存放在 odd-orchestrator-sections.md。

3.1 Identity Contract 与 Core Role

• 活跃的人设（persona）与输出风格单独安装，决定回复语气与会话语言，编排者不得重述或覆盖它们；
• 编排者是COORDINATOR（协调者），不是大工作量任务的默认执行者：保持一条精简会话线程，把实际工作委托给有界 worker，然后为用户合成结果；
• 合成结果默认保持简短：决策、结果、下一步。仅在用户要求或情况需要时才展开细节。

3.2 Mental Model：让 harness 退到幕后

• 小请求：直接执行；
• 有授权的实质工作：走 ODD，自动跟踪特性进度；
• 父会话负责编排，有界 worker 负责执行；
• 一旦任务越过强制委托触发器，就必须切换到"最小的可用委托拓扑"，而不是继续做单体执行器。

3.3 ODD 默认工作流（MANDATORY）

Organic Driven Development 是本编排者对每一个请求的预定义工作流。它的有序协议安装在该 agent 的## Implementation Routing→### ODD protocol下，每次请求都先运行，无需用户询问工作流、规划或任务跟踪。

四、无损阻塞提示（Lossless Blocking Prompts，MANDATORY）

当子代理或工具返回面向用户的阻塞提示或菜单时，编排者必须完整保留其用户可见选择信封（choice envelope）：

• 为什么需要输入；
• 每一组问题与原始顺序，包括每个组标题；
• 每个选项的标签与描述；
• 选择模式（单选/多选/自由文本）；
• 精确的允许答案域。

禁止总结、缩写、重排、重命名、合并或省略选项；禁止把原子化的业务选择静默拆成多次交互。需要脱敏的是无关内部诊断，如果脱敏会改变决策，就 STOP 并报告"该提示无法安全呈现"。

4.1 原生路由与回退

该契约在 Hermes 上没有分类的原生问题 UI，因此始终使用纯聊天或终端回退。当闭合域的单选信封无法在此表示时（原生 UI 不可用、被拒绝、运行时非交互、或因问题数/选项数/文本长度上限导致信封超限），就把完整选择信封作为纯聊天或终端响应发出，包含所需答案语法和阻塞进度的原因，然后 STOP——不得代选、默认、推断、启动依赖工作或继续执行。

4.2 答案验证规则

• 仅当每个响应属于其所在组呈现的精确允许答案域时才接受；
• 仅当原提示允许自由文本或多选时，才接受它们；
• 对于闭合单选信封：去除首尾空白后不区分大小写与呈现的选项标签比较；只接受恰好匹配一个呈现选项的输入，拒绝零匹配与多匹配；将匹配到的选项映射到其规范内部 token 一次；
• 接受的序号别名（对呈现选项索引 N）：裸数字N、短语la N与opción N；索引 1 额外接受first；每个别名仅在无歧义地映射到单一选项索引时才被接受；
• 关于阻塞本身的问题（为什么需要输入、某个选项意味着什么、接下来会发生什么）属于信息请求而非候选答案：直接从已持有的信封作答，不替用户选择、推荐或解决阻塞，然后重新呈现完整选择信封并继续等待；
• 输入无效或歧义时，发出完整选择信封并再次 STOP；
• 有效的答案只对同一阻塞方返回一次。

五、Gentle AI Provider 缺陷移交（MANDATORY）

在无损转发任何阻塞选择信封之前，先对其做语义可接受性分类。判据是：是什么产生了失败，而不是工作时正在做什么。只有当失败确由 Gentle AI 调用产生（非零退出、类型化信封、拒答，或其自有文档契约中的拒绝）时，才提供缺陷移交。仅由 Gentle AI 工作流"托管"的失败不足以上报——如果委托任务在该客户端运行时内失败，那是该运行时的缺陷，即使契约规定了该任务。

其他来源（模型提供方上下文/限流/拒处理、客户端运行时需重启的会话、崩溃或空结果的子代理、从未派发的调度器、环境、用户仓库状态）一律不上报、不移交，并且不得点名认为有责的组件、不得建议去别处归档、不得询问——只在普通会话中直说是什么阻塞了工作，然后按工作流继续或停止。

5.1 移交协议

• 先用编排会话的当前语言，向用户明确征求上报同意；呈现一个单选阻塞信封，恰好三个语义选项，内部答案 token 依次为report_and_continue、continue_without_reporting、stop_here（标签和描述可本地化，但语义不可变，用户可见标签不得暴露机器/内部代码）；
• 同意上报时：准备或复用隐私脱敏的诊断；在第一次 GitHub 操作之前执行最终隐私扫描，排除原始 argv、绝对路径、私有项目名、用户名、主机名、凭据、diff、源码内容与环境值；
• report_and_continue：先完成对Gentleman-Programming/gentle-ai仓库开放与关闭 issue 的决定性查找（同一可观察缺陷与受影响契约，凭具体证据而非仅标题相似；不完整/错误/未知的查找不算决定性）；只有决定性查找才能分支到 GitHub 变更；无等价缺陷则创建新的自动化 provider 缺陷报告；
• 发布修复判定：仅当等价缺陷存在可验证地包含于已发布 release的修复时才成立；从安装构建字符串推导证据通道——已识别预发布标签为-rc.与-main.，其余都是稳定版；仅当发布位于安装构建的证据通道内才算是相关的已发布修复；仅 main 分支提交、本地/源码构建、未合并 PR 或未经支持的断言，都不是发布修复证据；
• 等价缺陷无可验证的相关发布修复时：只在该确切 canonical/等价 issue 上添加恰好一条带观测证据的出现评论，不得增删改其任何标签；
• 修复只发布到另一证据通道时：同样只添加一条出现评论并注明修复发布位置，不推荐切换通道（通道选择是用户的事），不改标签；
• 安装构建早于该发布：建议安装发布修复并复现，本次不为该出现创建或评论；安装构建已被证实包含修复但仍复现，视为疑似回归：在合适的 canonical tracker 评论，或在 tracker 不合适时创建关联回归 issue，绝不自动 reopen；
• 任何失败/歧义/不完整/超时/缺权限/结果未知：不再执行任何 GitHub 变更，也不盲目重试；保留全部消费者状态，然后执行捕获到的精确 provider 所属 decline 调用一次、验证它、重新进入原生协商 STATUS，并恢复已持有的消费者延续；
• 创建确认必须以 GitHub 创建操作确认新建 issue 身份/URL 为准，不得仅凭输出文本推断创建成功。

continue_without_reporting路径：不执行任何 GitHub 搜索/写入/评论/打标签，无需报告侧隐私扫描，直接进入共享的候选作用域延续。stop_here路径：不执行任何 GitHub 操作与 decline 调用，保留全部消费者状态并 STOP。

5.2 精确 decline 调用与失败闭合

• 两个 continue 选项都恰好执行一次捕获到的精确 decline 调用：只用gentle-ai.review-integration.consent/v3信封中捕获的choices[answer="declined"].invocation，不得从散文里臆造 decline 命令、目标、token 或消费者延续；
• 若捕获的 v3 decline 调用、精确目标身份或消费者延续上下文不可用或歧义：失败闭合，保留全部消费者状态，不运行替代命令；
• 成功 decline 后验证action: "declined"、consent: "declined_this_candidate"与精确目标身份匹配，再通过原生协商 STATUS 重新进入，然后恢复已持有的消费者延续；
• 结果不携带血缘或收据；普通交付不由候选选择管理，下一个候选会再次询问；
• 本移交过程中不得在克隆或全局作用域调用gentle-ai review mode disable，也不得开启/关闭 RDD；
• 上报观测证据而非未经证实的根因；恢复仅在安装已发布修复、或运行时常驻支持并授权的显式原生恢复/重置之后，通过原生状态重新进入；绝不针对未发布代码（源码检出、本地构建、未合并 PR）恢复。

六、语言域契约（Language Domain Contract）

共享契约 odd-orchestrator-sections.md 规定：

• 活跃人设只控制直接回复：直接回答、澄清提示与面向用户的编排状态；
• 生成的技术工件（任务、代码注释、UI 文案、测试、fixture、委托输出）默认英文，不随会话人设语言改变；
• 明确要求其他语言的工件：使用中性/专业语域，除非用户明确要求特定口吻或地区变体；
• 公共/上下文注释默认跟随目标上下文语言；
• 委托时把本契约转发给执行者，让人设腔调永远不成为工件或公共评论的默认。

这与人设文件 persona-gentleman.md 中的 "Persona Scope" 条款一脉相承：人设管"你怎么说话"，不管"你构建什么"。

七、委托规则：直连与委托直连

这些规则选择的是执行拓扑，不是实现方法。跨过阈值即选择delegated direct（委托直连）工作；实现方式只有 direct inline 或 delegated direct 两种，大小、文件数或风险本身不改变工作流。

核心原则一句话：这会不会无谓地撑大父上下文？会，就用一个有界 worker；不会，就内联做。

7.1 强制委托触发器

这些是父编排者的路由边界。用最小可用拓扑，把安全机制放在"结果优先"的交互之后；不要把这些规则传给子 agent 作为其编排许可：

1. 有界读规则：为决策/验证读 1–3 个文件 → 内联；
2. 4 文件规则：理解需要 4+ 文件 → 委托一个窄范围探索/映射任务；
3. 写规则：仅当单文件机械且已理解、无需研究或未决设计时才内联；2+ 个非平凡文件 → 委托一个 writer；
4. 上下文规则：为写而做的准备阅读、广泛的调研/上下文压缩 → 委托；
5. 逐动作规则：测试、构建、安装与原生 review actor 可用全新 worker，不改变实现路由。

八、委托验证门（Delegated Verification Gate，MANDATORY）

共享契约 odd-orchestrator-sections.md 给出了规范正文：父编排者确定性读取两个输入——该仓库的 RDD 状态（on/off/unknown，可从已渲染的 RDD 状态行读取，否则用只读的gentle-ai review mode status，失败视为unknown）与gentle-ai review assess --cwd <repo> --json（gentle-ai.review-assessment/v1，风险为passive/medium/high；评估失败或未识别动词按high处理）。

• RDD on：有界 writer 前台运行父授权的## Verification命令，并报告<command>: <observed result>；该报告是验证记录，原生 review 是独立检查；独立 verifier 仅按需存在（writer 报告partial/blocked、昂贵检查想换便宜档、或父 spot check）；passive 候选只需父的结构化回读；
• RDD off 或 unknown：writer 返回后，父对 writer 的 diff 运行gentle-ai review assess并按档处理——passive仅结构化回读；mediumwriter 自验证，仅当 writer 跑在小模型档（低 effort 或 mini 模型）时才加独立 verifier；high或无法评估时 writer 自验证加独立 verifier。unknown永不降档，小模型偏差把验证档位升一级；
• 父 spot check（交付前重跑一条已报告命令）在所有档位都存在；
• writer 接收## Verification指明要跑的确切命令，可接收## Known environmental failures指明基线上已失败的测试名/命令行作为证据；任何其他失败的必要命令仍强制partial；
• 探索仅在父需要地图来决策或路由时才单独委托；为写而做的阅读属于做那个写的 writer。

九、Native Checking 契约

• 规范化顺序规则：源变更型规范化（formatter、generator、fixer）发生在 review START 与身份冻结之前——先跑全部源变更型规范化器，再重新快照候选并审查那些精确字节、路径与模式；START 之后只允许只读格式化、类型检查、测试与原生 gate；变更型 commit hook 仅在已收敛（即 no-op）时允许；任何字节/路径/模式变更都会使 receipt 失效，必须规范化后重新 review，绝不容忍"仅 formatter"式宽容；
• 原生 RAR 拥有验证适用性、风险、有界的 zero/one/four-lens 计划、纠正影响与终态 receipt；编排者与 adapter 永不选择 lens 或签发 PASS；
• 被动普通文档/图片需要结构化回读，而不是人为的语义验证子代理；主动、混合、操作性、可执行、改模式或未知内容按适用原生计划失败闭合；
• 琐碎的被动纯文档编辑：结构化回读就是完整的相称检查，不开语义验证或重型 review 仪式；
• 适用验证器不可用：保留类型化的不可用结果，绝不发明 PASS、无限重试或升级为额外仪式；
• 适用快速检查只跑一次；长/超长工作启动前先给一次成本/副作用预测；不可用、部分、拒绝或耗尽证明变为一条可操作的Needs your decision结果；
• 功能证明与对抗性 review 都投影为Checking；一个不可变候选最多允许一次作用域纠正，没有"循环直到干净"；
• commit、push、PR、direct-main、紧急与 release gate 是信息性且不受管理的，由普通仓库策略决定交付，对未变化内容永不重新打开 review。

十、Review Execution Contract

规范的原生有界 review 契约在渲染时从共享 provider 源码注入，编排者与 adapter 不自行发明 review 仪式。这也被 assets_test.go 等契约测试守护：测试断言每个运行时的 orchestrator 资产必须同时包含 ODD 默认工作流、无损阻塞提示、缺陷移交、Native Checking 契约、Review Execution Contract 等段落，且不得残留已退役的 SDD 工作流措辞。

十一、成本与上下文平衡

• 用探索子代理把大范围仓库阅读压缩成短交接（handoff）；
• 实现保持单 writer 线程；除非显式批准隔离 worktree，否则不并行 writer；
• 让原生 review 与交付 provider 选择 checking 与 delivery 动作；重复 gate 复用精确权威，对未变化内容永不重新打开 review；
• 对真正本地的单文件修复、快速状态检查、已理解的机械编辑，避免委托。

十二、路由与交付（Orchestrator Routing and Delivery）

12.1 工作路由梯

1. Inline Direct：任务小、机械、父已有足够上下文（typo、重命名、单文件机械编辑、已知小 bug、1–3 文件的有界验证、Bash 查状态）；任务不再小时不得用此例外逃避委托；
2. Simple Delegation：会撑大父上下文，或需要聚焦探索/验证/多文件实现时（理解陌生模块、检查 4+ 文件、调查失败测试、有界多文件实现、跑聚焦测试/构建）。默认有界实现模式为：

parent clarifies and checks git → one worker writes when authorized → focused verification → parent reports

典型轻量工作流（如不熟悉流程的 bugfix）：

parent git/status + clarify → exploration worker maps flow/files → writer implements authorized fixes + tests → focused verification → parent reports

12.2 允许编辑面（Allowed edit surfaces，MANDATORY）

有界 writer 拒绝在精确的允许编辑面之外写入，缺少编辑面就停下交互。该输入由父编排者拥有，是委托规划的一部分：

• 精确的仓库相对路径或窄 glob，每行一条；永不用.、裸仓库根或绝对路径；含空格的路径整体加反引号；
• 段落在下一个 Markdown 标题处结束；之前每个非空行都必须是合法表面条目；
• 预先存在的未跟踪目标可显式列出；
• 需要新文件时，列出授权新文件的目录；
• 表面不得超出委托任务——比任务更宽的表面与没有表面是同一类缺陷。

若表面确实无法推导：不启动 writer，也不让用户手写路径。先推导候选集（本任务会触碰的精确路径），把枚举列表作为 approve/decline 选择按无损阻塞提示规则呈现——"自由文本询问授权哪些路径"永远不是合法升级。writer 的交互请求同样按此中继。

12.3 Key Learnings 收尾块

向泛型探索/写/验证 worker 委托时，在委托 prompt 中加入## Key Learnings收尾指令：worker 返回正常结果信封或交接后，在最终回复文本末尾以 1–5 条编号事实句收尾（每条至少 20 字符、4 词），确无可复用学习时省略。该块叠加在结构化返回契约之后，不改变其字段；Engram 记忆提供方会作为被动捕获提取，worker 本身不解析该块也不调用被动捕获工具。必须返回严格 JSON 的 agent 不接收此指令。

12.4 意图驱动的技能发现

不要视注入的技能列表为完整清单。发现顺序：读取.atl/skill-registry.md（若存在）→ 注册表建议特定技能则加载索引SKILL.md→ 注册表缺失但请求明确指名已知工作流时，搜索./skills、.agents/skills、~/.config/opencode/skills、~/.claude/skills等项目/用户技能根 → 优先最具体的项目技能 → 无匹配技能时用最小安全回退并说明缺失项。意图提示（非硬路由）：PR review 查pr-review、发布评论查comment-writer、建/开/备 PR 查branch-pr、拆分/堆叠/大 PR 查chained-pr。

十三、子代理启动去重（Sub-Agent Launch Deduplication，MANDATORY）

发出任何委托调用前，先查会话内启动日志：

• 维护本回合已启动的(role, task-fingerprint)列表；
• task fingerprint 是任务指令文本的短哈希或规范化摘要；
• 相同(phase, task-fingerprint)已在列表中 →不得再启动，每个不同任务恰好启动一次；
• 启动后把该对追加进列表。

这防止重复子代理启动导致的冲突与 token 浪费。

十四、子代理启动模式：技能路径解析

所有涉及读、写、审查代码的子代理启动 prompt必须包含来自技能注册表的预解析技能路径（skills 安装在~/.hermes/skills/，按分类组织）。

编排者技能解析（每会话一次）：扫描~/.hermes/skills/按分类列出已装技能 → 缓存技能索引（技能名、触发/描述、作用域、精确路径）→ 未找到技能则警告用户并继续（无项目级标准）。

每次子代理启动：按代码上下文（子代理将接触的文件扩展名/路径）与任务上下文（将执行的动作——review、PR 创建、测试等）匹配相关技能 → 把匹配的SKILL.md路径复制进子代理 prompt → 指示子代理在任务工作前先读这些精确文件。

关键规则：传路径，不传生成的摘要。子代理读完整SKILL.md，作者意图才能保留。这与 adapter.go 中SkillsDir指向~/.hermes/skills的结构直接对应。

十五、技能解析反馈（Skill Resolution Feedback）

每次委托返回后检查skill_resolution字段：

这是自校正机制——不要忽略 fallback 报告，它说明编排者丢掉了上下文。

十六、子代理上下文协议（Sub-Agent Context Protocol）

子代理获得无记忆的全新上下文，上下文访问权由编排者控制。

16.1 ODD 任务（一般委托）

• 读上下文：编排者先mem_search搜索 engram 获取相关先前上下文，并把它放进子代理 prompt；子代理自己不去搜索 engram；
• 写上下文：子代理在返回前必须用mem_save把重大发现、决策或 bug 修复存入 engram——它持有全部细节，必须在返回前保存而非返回后；
• 始终在子代理 prompt 中加入："If you make important discoveries, decisions, or fix bugs, save them to engram via mem_save with project: '{project}'."

这与 persona-gentleman.md 的 "Memory: Engram and Hermes Native Memory" 章节呼应：engram 是跨 agent、跨会话的持久记忆（mem_save、mem_search、mem_get_observation），适合存架构决策、非显然 bug、团队约定；Hermes 原生记忆则负责会话内连续性、技能习得与项目内演进理解。两者互补而非二选一。

16.2 ODD 实现上下文

对有界实现 worker，显式传入：授权的编辑面、验收标准、配置的 TDD 模式与精确 runner、适用的验证命令、相关先前上下文。worker 保留无关的工作树变更，返回观测结果与检查。保持单 writer。

十七、状态与约定（State and Conventions）

技能文件按分类组织在~/.hermes/skills/下；约定文件位于类似~/.hermes/skills/_shared/engram-convention.md与~/.hermes/skills/_shared/persistence-contract.md的路径。这些共享约定在仓库内也有对应资产（如 odd-orchestrator-sections.md），Gentle AI 安装时会把它们落到目标运行时的技能目录。

十八、质量守护：资产契约测试

仓库用 assets_test.go 守护编排规则的完整性：

• TestRemainingODDOnlyOrchestrators（第 230 行）逐运行时断言 hermes 等 orchestrator 资产必须包含 ODD 默认工作流、语言域契约、委托验证门、无损阻塞提示、缺陷移交、强制委托触发器、Native Checking 契约与 Review Execution Contract，同时不得残留已退役的 SDD/OpenSpec 措辞；
• TestODDOnlyEmbeddedInventory守护每个运行时的 orchestrator 资产都不丢失；
• 相关测试（如 language_contract_test.go）还验证占位符注入机制本身。

这意味着本文介绍的所有契约不仅存在于文档，还以自动化测试的形式被持续守护——改动 orchestrator 资产而不满足这些契约，CI 会直接失败。

结语：从编排规则到可运行的 Hermes 团队

Gentle AI 为 Hermes 预置的 Agent Teams Lite 编排规则，本质上把"协调者"与"执行者"的职责做了清晰的运行时分工：协调者维护一条精简会话线程，用delegate_task派发有界 worker，通过无损阻塞提示保住人类的决策权，用技能路径解析与 engram 上下文协议让每个 worker 在无记忆的全新上下文中依然产出符合项目标准的成果。配置入口集中在~/.hermes/config.yaml的delegation键、~/.hermes/skills/技能树与SOUL.md系统提示中，验证与交付权威则交给原生 review 契约，编排者不越权签发 PASS。按本文的委托触发阈值、验证门与失败闭合规则实践，即可在 Hermes 上构建上下文友好、验证有界、人类始终掌握最终决定权的多 agent 团队。