agent-harness-construction
- Repo stars 188,749
- Author repo ECC
智能体框架构建
当你在改进智能体的规划、调用工具、从错误中恢复以及收敛到完成状态的方式时,使用此技能。
核心模型
智能体输出质量受限于:
- 行动空间质量
- 观察质量
- 恢复质量
- 上下文预算质量
行动空间设计
- 使用稳定、明确的工具名称。
- 保持输入模式优先且范围狭窄。
- 返回确定性的输出形状。
- 除非无法隔离,否则避免使用全能型工具。
粒度规则
- 对高风险操作(部署、迁移、权限)使用微工具。
- 对常见的编辑/读取/搜索循环使用中等工具。
- 仅当往返开销是主要成本时使用宏工具。
观察设计
每个工具响应都应包括:
status: success|warning|errorsummary: 一行结果next_actions: 可执行的后续步骤artifacts: 文件路径 / ID
错误恢复契约
对于每个错误路径,应包括:
- 根本原因提示
- 安全重试指令
- 明确的停止条件
上下文预算管理
- 保持系统提示词最少且不变。
- 将大量指导信息移至按需加载的技能中。
- 优先引用文件,而不是内联长文档。
- 在阶段边界处进行压缩,而不是任意的令牌阈值。
架构模式指导
- ReAct:最适合路径不确定的探索性任务。
- 函数调用:最适合结构化的确定性流程。
- 混合模式(推荐):ReAct 规划 + 类型化工具执行。
基准测试
跟踪:
- 完成率
- 每项任务的重试次数
- pass@1 和 pass@3
- 每个成功任务的成本
反模式
- 太多语义重叠的工具。
- 不透明的工具输出,没有恢复提示。
- 仅输出错误而没有后续步骤。
- 上下文过载,包含不相关的引用。
- Fluxly category
- Documentation
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Author / version / license
- @affaan-m · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Plug-and-play
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. 核心模型
智能体输出质量受限于: 行动空间质量 观察质量
行动空间设计
使用稳定、明确的工具名称。 保持输入模式优先且范围狭窄。 返回确定性的输出形状。
粒度规则
对高风险操作(部署、迁移、权限)使用微工具。 对常见的编辑/读取/搜索循环使用中等工具。 仅当往返开销是主要成本时使用宏工具。
观察设计
每个工具响应都应包括: status: success|warning|error summary: 一行结果
错误恢复契约
对于每个错误路径,应包括: 根本原因提示 安全重试指令
上下文预算管理
保持系统提示词最少且不变。 将大量指导信息移至按需加载的技能中。 优先引用文件,而不是内联长文档。
# 智能体框架构建
当你在改进智能体的规划、调用工具、从错误中恢复以及收敛到完成状态的方式时,使用此技能。
## 核心模型
智能体输出质量受限于:
1. 行动空间质量
2. 观察质量
3. 恢复质量
4. 上下文预算质量
## 行动空间设计
1. 使用稳定、明确的工具名称。
2. 保持输入模式优先且范围狭窄。
3. 返回确定性的输出形状。
4. 除非无法隔离,否则避免使用全能型工具。
## 粒度规则
* 对高风险操作(部署、迁移、权限)使用微工具。
* 对常见的编辑/读取/搜索循环使用中等工具。
* 仅当往返开销是主要成本时使用宏工具。
## 观察设计
每个工具响应都应包括:
* `status`: success|warning|error
* `summary`: 一行结果
* `next_actions`: 可执行的后续步骤
* `artifacts`: 文件路径 / ID
## 错误恢复契约
对于每个错误路径,应包括:
* 根本原因提示
* 安全重试指令
* 明确的停止条件
## 上下文预算管理
1. 保持系统提示词最少且不变。
2. 将大量指导信息移至按需加载的技能中。
3. 优先引用文件,而不是内联长文档。
4. 在阶段边界处进行压缩,而不是任意的令牌阈值。
## 架构模式指导
* ReAct:最适合路径不确定的探索性任务。
* 函数调用:最适合结构化的确定性流程。
* 混合模式(推荐):ReAct 规划 + 类型化工具执行。
## 基准测试
跟踪:
* 完成率
* 每项任务的重试次数
* pass@1 和 pass@3
* 每个成功任务的成本
## 反模式
* 太多语义重叠的工具。
* 不透明的工具输出,没有恢复提示。
* 仅输出错误而没有后续步骤。
* 上下文过载,包含不相关的引用。 Evidence boundary and execution chain
Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> 核心模型 → 行动空间设计 → 粒度规则 → 观察设计 → 错误恢复契约 → 上下文预算管理
terms -> 当你在改进智能体的规划、调用工具、从错误中恢复以及收敛到完成状态的方式时,使用此技能。 · 1. 行动空间质量 2. · 1. 使用稳定、明确的工具名称。 · 对高风险操作(部署、迁移、权限)使用微工具。 · 1. 保持系统提示词最少且不变。 · ReAct:最适合路径不确定的探索性任务。 · 太多语义重叠的工具。
files/cmd -> status · summary · nextactions · artifacts
body sha256 -> dadccef5e823
Decide Fit First
Design Intent
How To Use It
Boundaries And Review