Meshery 的 GNHF 技能如何编排、引导与审查一次无人值守的 AI 编码运行【免费下载链接】mesheryMeshery, the cloud native manager项目地址: https://gitcode.com/GitHub_Trending/me/meshery本文基于 Meshery 仓库中的 GNHF 技能文档讲解一个完整的宿主代理 GNHF 执行器协同工作模型GNHF 是一个智能体编排器agent orchestrator它会反复调用另一个编码智能体直到满足用自然语言描述的停止条件为止。读完本文你能掌握如何在 Meshery 这类大型代码库中准备一次可持久化的 GNHF 运行在 Hands-Off 与 Companion 两种模式下正确委托、引导steer和审查review一次 AI 编码运行以及如何在用户缺席一整夜后无损地重建运行状态并给出可信报告。GNHF 是什么宿主代理与执行器的职责分离GNHF技能文档 frontmatter 中注册名为gnhf的定位非常清晰宿主代理host agent负责编排GNHF 负责执行。文档中的触发描述frontmatter 的description字段说明了宿主的加载时机——当用户要求运行 GNHF、表示要离开/睡觉并希望进行智能体托管的编码运行、要求监督或引导一个活跃 GNHF 运行、或者对 GNHF 结果给出反馈时该技能应被激活。文档确立了三条核心规则这是理解整个技能设计的关键职责不重叠当 GNHF 工作器worker已对某个范围负责时宿主代理不得在同一范围内手动实现代码除非用户明确改变委托。这避免了两个智能体在同一工作区抢方向盘。停止条件满足不等于用户验收在 Companion 模式下GNHF 完成仅代表工作器停止了宿主仍需将结果与用户的最新要求、以及一次全新的独立验证进行比对。提示词必须是结果导向、证据导向的停止条件必须是可观测的完成条件。文档给出的好坏对比非常具体——坏的looks good好的目标工作流成功、相关检查通过、没有无关文件被改动。在 Meshery 仓库中这个技能并不是孤立存在的。从源码结构看整个仓库采用了一个 LLM 无关的智能体配置布局.agents/README.md 声明.agents/skills/是仓库中所有打包技能的唯一事实来源每个技能一个目录、每个目录一个SKILL.md。Codex 与 OpenCode 原生扫描.agents/skillsClaude Code 则通过一个指向../.agents/skills的相对符号链接.claude/skills发现技能。GNHF 技能正是这套布局下的一个成员与find-skills、iterate-pr、reducing-entropy等技能并列存放。需要注意的是GNHF 并不在 skills-lock.json 所追踪的四个 AXI 安装器管理的技能chrome-devtools-axi、gh-axi、lavish、quota-axi之中它是随仓库源码一同维护的本仓库技能。两种运行模式Hands-Off 与 Companion技能文档要求每次运行恰好选择一种模式选择依据是任务性质而非个人偏好。Hands-Off 模式适用于任务边界清晰、验证方式明确、用户希望配置一次就让它跑完、不干预的场景。工作方式是四步闭环准备精确的提示词——必须包含约束constraints、非目标non-goals、验证方式verification和停止条件stop condition四要素启动 GNHF 并等待完成仅在硬故障时提前干预——且仅限四种情况硬性失败hard failure、范围失控runaway scope、破坏性行为destructive behavior、不可能满足的前置条件impossible prerequisites退出后报告 GNHF 的最终状态。文档给出的典型触发语是我上床睡觉了。用 GNHF 加 Copilot 继续在这个分支上工作当测试套件通过时停止。Companion 模式适用于任务不确定、探索性强、设计密集、研究密集或大概率需要中途修正航向的场景。文档列出了应当默认回落到 Companion 模式的五种信号用户要求迭代到满意为止、要求多轮工作、提供评审发现review findings、要求改进设计/技能/文档、或要求监督。Companion 模式的运行纪律包括维护一份记录原始意图original intent、分支名branch、会话 idsession id、最后已知结果last known result持续轮询poll活跃的 GNHF 进程直到退出或出现干预点在以下五种情况下干预工作器在优化错误的东西、重复无效的修复、跳过要求的研究、范围漂移scope drift、无证据宣称成功把评审发现直接当作下一轮的验收标准优先用一个新的、有边界约束的 GNHF 提示词继续而不是接手手动实现——这与宿主只编排不执行的核心规则一致。典型触发语用 GNHF 在这个 onboarding 流程上跑几轮。在轮次之间检查 diff如果它开始打磨错误的东西就收紧下一轮提示词。启动 GNHFCLI 形态、前置检查与提示词骨架先验证 CLI再依赖参数文档明确警告不要凭空发明不支持的 flag。第一步永远是gnhf --help文档标注的已知形态Known shape为gnhf \ --agent agent \ --max-iterations n \ --stop-when observable completion condition \ --prevent-sleep on \ worker prompt参数要点--agent指定执行智能体--max-iterations限制迭代上限--stop-when接收一条可观测的自然语言完成条件--prevent-sleep on防止宿主机在长运行期间进入睡眠这是过夜运行场景的关键参数。文档特别提示如果当前安装的 GNHF没有--modelflag就把模型要求写进 worker 提示词或后端配置里而不要假设该 flag 存在。启动前的仓库状态快照在启动之前先采集三份基线信息作为事后 diff 和审查的参照git status --short git branch --show-current git log --oneline --max-count5提示词骨架文档提供了一个可直接套用的 worker 提示词模板其设计要点是先勘察、再编码、每片验证、不造虚假成功Objective: one concrete outcome. Use agent/model requirement. Work in this repo. Treat this as a long-running GNHF task. Before coding, inspect the current repo, relevant docs, and recent commits. Preserve user changes. Do not make unrelated refactors. After each meaningful slice, run relevant verification. If blocked, commit no fake success; leave notes with the blocker and evidence. Stop only when: observable completion condition.这个骨架里有两个值得强调的约束Preserve user changes保留用户已有改动与 commit no fake success受阻时不得提交虚假成功只留下带阻塞证据的笔记——它们共同保证了工作器在无人监督时也不会污染仓库状态。Steer用信号表驱动中途干预Companion 模式的核心操作是在每次迭代或每块有意义的输出后做评估并按一张信号-行动对照表执行。这是整个技能中最具操作性的部分观测信号行动工作器遇到真实阻塞real blocker停止或带着针对该阻塞的具体指令重启产出了良好的部分切片good partial slice让它继续或收紧下一轮停止条件跳过了要求的研究重启并把研究作为明确的第一交付物工作器改动了无关文件停止先审查再继续工作器未经验证就宣称成功立即审查只有在带证据停止条件的前提下才重启评审者发现阻塞性问题或用户表示不满意重启且把该发现作为唯一的有边界修正任务与信号表配套的是一个引导提示词steering prompt模板它的结构与启动提示词一脉相承但增加了承认已有进展、禁止重做已完成工作的语义Continue from the current repo state. The previous run partially succeeded: evidence. Do not redo completed work. Focus only on bounded correction. The issue to fix now is specific observed issue. Verify with commands/checks. Stop only when observable condition.这种部分成功 证据 唯一修正焦点的写法本质上是在每一轮都把任务熵降低到一个可验证的最小修正范围。Companion Review五步审查与三态裁决审查流程只在 Companion 模式下使用当宿主在监督质量、或决定是否再跑一轮有边界的 GNHF 时执行。五个步骤是检查 git 侧状态分支、状态、提交、变更文件与 diff把 GNHF 的笔记/日志当作声明而非证据claims, not evidence——这一条是整个审查方法论的哲学核心运行独立验证测试、lint、构建、类型检查、手工 QA 或领域专项检查双向比对把结果与停止条件、以及用户最新反馈分别比对做出三态裁决Mergeable可合并、Needs follow-up GNHF run需要后续 GNHF 运行、Do not merge不可合并。文档对需要后续运行的情形给出了明确的行为要求继续留在 Companion 模式里处理不要把这次运行呈现为已完成并且除非获得明确授权否则不得合并。Findings 循环把用户反馈转化为有边界的修正当用户带着 not preserved改动没被保留、scope drift范围漂移、missing requirement缺失需求、why did you stop为什么停了这类发现回来时技能要求按六个步骤闭环把该次运行转入 Companion 模式处理把每条发现翻译成一条可观测的修正项同时保留三个信息严重程度severity、文件/行号范围file/line scope、用户的原话措辞wording若可挽救salvageable在同一个候选分支上重启而不是另起炉灶提示 worker只修这个有边界的发现保留已完成的正确工作验证且只有在该发现不再成立时才停止后续运行结束后再次审查重复以上过程直到没有阻塞性发现、验证通过、或碰到一个真实阻塞为止。这套循环与前面 Steer 信号表最后一行把评审发现作为唯一的有边界修正首尾呼应构成了 GNHF 多轮迭代的收敛机制。Morning Review无人值守一夜后的状态重建这是该技能最贴近过夜运行使用场景的一节。当用户以 good morning、昨晚跑的情况如何之类的话回来时文档要求宿主不要询问先审查什么而是主动重建状态。重建的第一组命令是git status --short git branch --show-current git log --oneline --decorate --max-count20 pgrep -fl gnhf|claude|codex|copilot|opencode|rovodev || true四条命令各有一个职责前两条恢复在哪、改动多少第三条恢复做了什么--decorate显示分支与标签引用第四条检查是否还有 GNHF 或编码智能体进程在运行——如果进程还活着必须优先报告这一点。之后检查可能的 GNHF 分支、笔记、日志、终端会话和变更文件并按固定清单输出报告运行模式、所用 agent、分支、状态、变更内容、验证情况、停止条件达成情况、质量评估、建议的下一步行动。文档同时划出一条硬边界绝不凭记忆总结一次过夜运行never summarize an overnight run from memory——一切结论必须来自 git 状态与日志证据这与 Companion Review 中日志是声明、验证才是证据的原则完全一致。Agent 选择与不支持 flag 的处理技能对--agent的选择给出三条原则且刻意不硬编码智能体名单完整名单以gnhf --help输出为准各 agent 的前置要求以 GNHF 自身的 README 中的 Agents 表为准该文件位于 GNHF 工具仓库中不在本仓库内默认使用用户明确指定的 agent或本地已配置并已完成认证的 agentcodex适合仓库感知的代码工作或评审密集型任务claude适合推理密集的实现或行文密集的方案规划前提是已完成配置acp:target当用户希望通过 GNHF 驱动一个自定义的 ACP 兼容 agent 时使用。再结合若没有--modelflag 就把模型要求写进提示词的规则可以看出该技能对版本漂移不同 GNHF 安装的 flag 集合不同保持了防御性设计。Safety安全不变量汇总技能末尾列出的安全原则可以视为一次 GNHF 运行的不变量清单保留用户改动绝不用破坏性 git 命令去清理 GNHF 分支Companion 模式下不信任 worker 的成功总结一律以新鲜验证为准提示词保持结果导向与证据导向使用具体的停止条件前文 looks good 反例用户缺席时产出物应当是分支 状态报告而不是不可逆的变更除非获得明确授权。最后一条正是该技能面向我上床睡觉了这类场景的根本设计GNHF 过夜运行被严格约束为可审查、可回退、可续跑的形态——分支可以被 diff、可以被审查、可以按 Findings 循环继续修正而不是把仓库推进到一个无法解释的状态。小结在 Meshery 中的落地形态把上述各节拼起来Meshery 仓库中的 GNHF 技能实际上定义了一条完整的人机协同流水线模式选择Hands-Off/Companion→ 启动前 git 基线 提示词骨架 → 按信号表中途引导 → 五步审查三态裁决 → 把用户发现转化为有边界修正 → 次日早晨凭 git 与进程证据重建状态。它同时是 .agents/ 布局下一个普通技能目录通过 frontmatter 声明触发条件、由各编码工具按各自的发现机制加载不依赖任何特定 LLM 供应商。对于任何需要让编码智能体在人类缺席期间长时间工作的代码库这套编排者-执行者分离 证据驱动审查的模式都可以从 SKILL.md 中直接取用为模板。【免费下载链接】mesheryMeshery, the cloud native manager项目地址: https://gitcode.com/GitHub_Trending/me/meshery创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考