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
エージェントの計画、ツール呼び出し、エラーからの回復、完了への収束を改善する場合にこのスキルを使用します。
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
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
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.
npx skills add https://github.com/affaan-m/ECC --skill "docs/ja-JP/skills/agent-harness-construction"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
- 01
コアモデル
エージェントの出力品質は以下によって制約されます: 1. アクション空間の品質 2. 観測の品質 3. 回復の品質 4. コンテキストバジェットの品質
アクション空間の品質観測の品質回復の品質 - 02
アクション空間の設計
1. 安定した明示的なツール名を使用する。 2. 入力スキーマファーストで絞り込んだものにする。 3. 決定論的な出力形状を返す。 4. 分離が不可能な場合を除き、キャッチオールツールは避ける。
安定した明示的なツール名を使用する。入力スキーマファーストで絞り込んだものにする。決定論的な出力形状を返す。 - 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
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 56/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 234,327 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | catalog record | Editorial | Generated 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
エージェントハーネス構築
エージェントの計画、ツール呼び出し、エラーからの回復、完了への収束を改善する場合にこのスキルを使用します。
コアモデル
エージェントの出力品質は以下によって制約されます:
- アクション空間の品質
- 観測の品質
- 回復の品質
- コンテキストバジェットの品質
アクション空間の設計
- 安定した明示的なツール名を使用する。
- 入力スキーマファーストで絞り込んだものにする。
- 決定論的な出力形状を返す。
- 分離が不可能な場合を除き、キャッチオールツールは避ける。
粒度ルール
- 高リスク操作(デプロイ、マイグレーション、権限)にはマイクロツールを使用する。
- 一般的な編集・読み取り・検索ループには中規模ツールを使用する。
- ラウンドトリップのオーバーヘッドが支配的なコストである場合のみマクロツールを使用する。
観測の設計
すべてのツールレスポンスに含めるべき内容:
status: success|warning|errorsummary: 一行の結果next_actions: 実行可能なフォローアップartifacts: ファイルパス / ID
エラー回復コントラクト
すべてのエラーパスに含めるべき内容:
- 根本原因のヒント
- 安全なリトライ指示
- 明示的な停止条件
コンテキストバジェット管理
- システムプロンプトを最小限かつ不変に保つ。
- 大きなガイダンスはオンデマンドで読み込まれるスキルに移動する。
- 長いドキュメントをインラインで挿入するより、ファイルへの参照を優先する。
- 任意のトークン閾値ではなく、フェーズの境界でコンパクト化する。
アーキテクチャパターンガイダンス
- ReAct: 不確実なパスを持つ探索的タスクに最適。
- 関数呼び出し: 構造化された決定論的フローに最適。
- ハイブリッド(推奨): ReAct 計画 + 型付きツール実行。
ベンチマーク
追跡すべき指標:
- 完了率
- タスクあたりのリトライ数
- pass@1 および pass@3
- 成功タスクあたりのコスト
アンチパターン
- セマンティクスが重複するツールが多すぎる。
- 回復ヒントのない不透明なツール出力。
- 次のステップなしのエラーのみの出力。
- 無関係な参照でコンテキストを過負荷にする。
Alternatives
Compare before choosing
affaan-m/ECC
agent-harness-construction
Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates.
affaan-m/ECC
agent-harness-construction
Review agent-harness-construction's use cases, installation, workflow, and original source instructions.