Source profileQuality 51/100

affaan-m/ECC/docs/zh-CN/skills/agent-harness-construction/SKILL.md

agent-harness-construction

Review agent-harness-construction's use cases, installation, workflow, and original source instructions.

Source repository stars
234,327
Declared platforms
0
Static risk flags
0
Last source update
2026-07-27
Source checked
2026-07-28
DecisionCompatibilityInstallWorkflowPermissionsEvidenceSource

Decision brief

What it does—and where it fits

当你在改进智能体的规划、调用工具、从错误中恢复以及收敛到完成状态的方式时，使用此技能。

Best for

    Not for

    • Tasks that require unconfirmed production actions or broad system permissions.
    • Environments where the pinned source and install steps cannot be inspected.

    Compatibility matrix

    Platform support, with evidence labels

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeNot declaredNo explicit evidencePortability before use
    CursorNot declaredNo explicit evidencePortability before use
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    Installation

    Inspect first. Install second.

    The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

    Source-detected install commandSource
    npx skills add https://github.com/affaan-m/ECC --skill "docs/zh-CN/skills/agent-harness-construction"
    Safe inspection promptEditorial

    Inspect the Agent Skill "agent-harness-construction" from https://github.com/affaan-m/ECC/blob/4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38/docs/zh-CN/skills/agent-harness-construction/SKILL.md at commit 4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

    Workflow

    What the source asks the agent to do

    1. 01

      核心模型

      1. 行动空间质量 2. 观察质量 3. 恢复质量 4. 上下文预算质量

      行动空间质量观察质量恢复质量
    2. 02

      行动空间设计

      1. 使用稳定、明确的工具名称。 2. 保持输入模式优先且范围狭窄。 3. 返回确定性的输出形状。 4. 除非无法隔离，否则避免使用全能型工具。

      使用稳定、明确的工具名称。保持输入模式优先且范围狭窄。返回确定性的输出形状。
    3. 03

      粒度规则

      对高风险操作（部署、迁移、权限）使用微工具。 对常见的编辑/读取/搜索循环使用中等工具。 仅当往返开销是主要成本时使用宏工具。

      对高风险操作（部署、迁移、权限）使用微工具。对常见的编辑/读取/搜索循环使用中等工具。仅当往返开销是主要成本时使用宏工具。

    Permission review

    Static risk signals and limitations

    No configured static risk pattern was detected

    This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

    Evidence record

    Why each signal appears

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score51/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars234,327SourceRepository attention, not individual Skill quality
    Compatibility0 platformsSourceDeclared in the catalog source record
    Usage guidecatalog recordEditorialGenerated or reviewed according to the visible evidence level

    Pinned source

    Provenance and original SKILL.md

    Repository
    affaan-m/ECC
    Skill path
    docs/zh-CN/skills/agent-harness-construction/SKILL.md
    Commit
    4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38
    License
    MIT
    Collected
    2026-07-28
    Default branch
    main
    View the original SKILL.md

    智能体框架构建

    当你在改进智能体的规划、调用工具、从错误中恢复以及收敛到完成状态的方式时，使用此技能。

    核心模型

    智能体输出质量受限于：

    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
    • 每个成功任务的成本

    反模式

    • 太多语义重叠的工具。
    • 不透明的工具输出，没有恢复提示。
    • 仅输出错误而没有后续步骤。
    • 上下文过载，包含不相关的引用。

    Alternatives

    Compare before choosing

    Computed 73234,327

    affaan-m/ECC

    agent-harness-construction

    Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates.

    2026-07-270 platforms
    Computed 56234,327

    affaan-m/ECC

    agent-harness-construction

    Review agent-harness-construction's use cases, installation, workflow, and original source instructions.

    2026-07-270 platforms