跳到正文
cccskills
免费在 GitHub 公开

utility

Scores agent actions by expected gain, cost, uncertainty, and redundancy. Use when deciding whether to dispatch an agent or invoke a tool.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(8)

  • SKILL.md4.6 KB
  • modules/action-selector.md2.8 KB
  • modules/gain.md2.0 KB
  • modules/integration.md4.5 KB
  • modules/redundancy.md1.6 KB
  • modules/state-builder.md3.4 KB
  • modules/step-cost.md1.8 KB
  • modules/uncertainty.md2.2 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Utility Skill

Overview

A decision framework for agent orchestration based on Liu et al., "Utility-Guided Agent Orchestration for Efficient LLM Tool Use" (arXiv:2603.19896). Each candidate action is scored by subtracting weighted costs from expected gain, producing a single utility value that guides action selection. The framework prevents over-calling tools and premature stopping by making both errors costly. Utility range is [-2.3, 1.0].

When To Use

  • Deciding whether to dispatch another agent or tool call
  • Gating expensive tool calls (search, code execution, delegation)
  • Selecting the right model tier for a sub-task
  • Continuation decisions after receiving partial results
  • Verification gating before writing or committing output

When NOT to Use

  • Single-step operations with one obvious action
  • Trivial tasks where cost of scoring exceeds benefit
  • Already-committed actions that cannot be undone

Action Space

A = {respond, retrieve, tool_call, verify, delegate, stop}

ActionDescription
respondEmit a final answer from current context
retrieveFetch additional information (search, read, lookup)
tool_callExecute a tool (code runner, API, file write)
verifyCheck a prior result for correctness or completeness
delegateSpawn a sub-agent or hand off to a specialist
stopTerminate the loop and return current state

Utility Function

U(a | s_t) = Gain(a | s_t)
           - λ₁ · StepCost(a | s_t)
           - λ₂ · Uncertainty(a | s_t)
           - λ₃ · Redundancy(a | s_t)
ParameterDefaultRationale
λ₁1.0Cost baseline; all other weights relative to this
λ₂0.5Weak empirical correlation with outcome (r=0.0131)
λ₃0.8Redundancy pruning yields ~10% token savings

Utility range: [-2.3, 1.0]. Positive values indicate the action is worth taking. Values below the floor (-0.5 default) indicate the action should be skipped.

Termination Conditions

Stop the loop when any of the following is true:

  • (a) Selected action is stop
  • (b) Step budget exhausted (default: 10 steps)
  • (c) All non-stop actions score below the floor (default: -0.5)

High-gain override: If Gain >= 0.7 for any action, condition (c) may be overridden. Document the override and the gain value in your reasoning trace.

Quick Start

Minimal 4-step advisory pattern:

  1. Construct state: gather task context per modules/state-builder.md
  2. Score candidates: evaluate each action in A per modules/action-selector.md
  3. Prefer highest utility: select the action with the maximum U(a | s_t), subject to termination conditions
  4. Log score and decision: record the winning action, its utility value, and step count before executing

Detailed Resources

  • State Builder: modules/state-builder.md, how to populate s_t from task context
  • Gain: modules/gain.md, estimating expected information or progress gain
  • Step Cost: modules/step-cost.md, token, latency, and monetary cost tables
  • Uncertainty: modules/uncertainty.md, confidence estimation and calibration
  • Redundancy: modules/redundancy.md, detecting duplicate or low-delta actions
  • Action Selector: modules/action-selector.md, scoring loop and tie-breaking rules
  • Integration: modules/integration.md, wiring utility scoring into existing orchestration loops

Exit Criteria

  • State constructed with task goal and prior steps
  • All six actions scored before selecting one
  • Termination condition checked after each step
  • Score and decision logged for each step taken
  • High-gain overrides documented with gain value

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Shapes turns action-first: action leads, steps numbered, state restated. Use for ADHD-friendly output. Do not use to trim tokens; use response-compression.

中文简介正在准备中。当前显示原文说明。

athola/claude-night-market3432026年10月17日 更新

Inverts burden of proof for code additions. Use when reviewing PRs, planning refactors, or running unbloat to challenge every addition's necessity.

中文简介正在准备中。当前显示原文说明。

athola/claude-night-market3432026年10月17日 更新

Tracks per-agent token usage and flags waste in parallel dispatch. Use when evaluating parallel agent efficiency or after a multi-agent run.

中文简介正在准备中。当前显示原文说明。

athola/claude-night-market3432026年10月17日 更新

Coordinates Claude agent teams via filesystem protocol. Use when orchestrating parallel agents with task dependencies. Do not use for single-agent tasks.

中文简介正在准备中。当前显示原文说明。

athola/claude-night-market3432026年10月17日 更新

Evaluates API surface design, consistency, and exemplar alignment. Use when reviewing public API changes or before releasing a new API surface.

中文简介正在准备中。当前显示原文说明。

athola/claude-night-market3432026年10月17日 更新

Selects architecture paradigm via research before scaffolding. Use when architecture is undecided and the choice needs justification and documentation.

中文简介正在准备中。当前显示原文说明。

athola/claude-night-market3432026年10月17日 更新

查看 athola 的全部技能

报告此技能的问题