菜单
用于围绕项目实际使用场景和任务逻辑设计、诊断和改造通用智能体运行框架，判断是否需要额外控制层，并给出最小必要结构或最小修正与验证方案。 当用户需要设计或评审智能体架构、分析长任务失败、判断问题是否属于运行框架层，或提到“harness”“运行框架”“编排”“状态管理”“检查点”“恢复”“评估”“人工接管”“可观测性”时使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | agent-harness-zh |
| description | 用于围绕项目实际使用场景和任务逻辑设计、诊断和改造通用智能体运行框架，判断是否需要额外控制层，并给出最小必要结构或最小修正与验证方案。 当用户需要设计或评审智能体架构、分析长任务失败、判断问题是否属于运行框架层，或提到“harness”“运行框架”“编排”“状态管理”“检查点”“恢复”“评估”“人工接管”“可观测性”时使用。 |
版本: 1.1.0 最后更新: 2026-03-26
本技能用于一件事：
围绕项目的实际使用场景和真实任务逻辑，判断智能体是否需要额外运行框架层；如果需要，确定最小必要结构；如果已有实现存在问题，先定位主要问题，再给出最小修正和验证方案。
它不是为了把系统做复杂，也不是默认要求加规划层、长期记忆、检查点、评估器或人工接管。
运行框架不是直接服务于“抽象任务”，而是服务于任务在真实项目里的使用方式。
同一个任务逻辑，在不同使用场景下，合理架构可能完全不同。
至少先判断这些维度，再做运行框架结论：
如果这些维度还不清楚，就不要直接下运行框架结论。
SKILL.md：主入口。定义目标、模式、流程、输出要求和硬约束。TEMPLATE.md：固定输出模板。设计新项目和审查旧系统都按这里的结构产出。REFERENCE.md：判据库。提供失败模式、可观察信号、反模式、厚薄判断和优先检查顺序。ADVANCED.md：高阶判断。只在存在多假设竞争、是否需要结构性改造不明确、或者需要验证取舍时再读取。SKILL.md。TEMPLATE.md。REFERENCE.md。ADVANCED.md。用于新项目启动、旧系统重构前的结构设计、或者任务升级后的重新定界。
输出重点：
用于现有系统诊断、失败复盘、结构评估、改造优先级排序。
输出重点：
如果输入不全，不要假装已经定位完成；要明确写出当前假设和缺失信息。
无论设计还是审查，都必须满足以下要求：
本技能默认围绕以下闭环工作：
默认使用 TEMPLATE.md 中对应模式的模板输出。
如果用户没有要求长文，保持结论紧凑，但不要省略以下内容：
当一个问题更像下面这些类型时，应先说明它不主要属于运行框架层：
只有当问题出在状态组织、阶段边界、控制点、恢复策略、验证闭环、人工接管、观测与停止条件等层面时，才应优先归到运行框架层。
只有满足以下条件，才可以把结论写成“已形成改进建议”：
只有在真正验证通过后，才可以写成“已确认改进成功”。