Source profileQuality 56/100

affaan-m/ECC/docs/ja-JP/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

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/ja-JP/skills/agent-harness-construction"
    Safe inspection promptEditorial

    Inspect the Agent Skill "agent-harness-construction" from https://github.com/affaan-m/ECC/blob/4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38/docs/ja-JP/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 score56/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/ja-JP/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