affaan-m/agent-harness-construction
docs/ja-JP/skills/agent-harness-construction/SKILL.md
AI エージェントのアクション空間、ツール定義、観測フォーマットを設計・最適化して完了率を向上させます。
$ install --global
skillsauthnpx skillsauth add affaan-m/everything-claude-code agent-harness-constructionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 18, 2026, 4:01 AM181.6s1 file scanned
SKILL.md
- name:
- agent-harness-construction
- description:
- AI エージェントのアクション空間、ツール定義、観測フォーマットを設計・最適化して完了率を向上させます。
- origin:
- ECC
エージェントハーネス構築
エージェントの計画、ツール呼び出し、エラーからの回復、完了への収束を改善する場合にこのスキルを使用します。
コアモデル
エージェントの出力品質は以下によって制約されます：
- アクション空間の品質
- 観測の品質
- 回復の品質
- コンテキストバジェットの品質
アクション空間の設計
- 安定した明示的なツール名を使用する。
- 入力スキーマファーストで絞り込んだものにする。
- 決定論的な出力形状を返す。
- 分離が不可能な場合を除き、キャッチオールツールは避ける。
粒度ルール
- 高リスク操作（デプロイ、マイグレーション、権限）にはマイクロツールを使用する。
- 一般的な編集・読み取り・検索ループには中規模ツールを使用する。
- ラウンドトリップのオーバーヘッドが支配的なコストである場合のみマクロツールを使用する。
観測の設計
すべてのツールレスポンスに含めるべき内容：
status: success|warning|errorsummary: 一行の結果next_actions: 実行可能なフォローアップartifacts: ファイルパス / ID
エラー回復コントラクト
すべてのエラーパスに含めるべき内容：
- 根本原因のヒント
- 安全なリトライ指示
- 明示的な停止条件
コンテキストバジェット管理
- システムプロンプトを最小限かつ不変に保つ。
- 大きなガイダンスはオンデマンドで読み込まれるスキルに移動する。
- 長いドキュメントをインラインで挿入するより、ファイルへの参照を優先する。
- 任意のトークン閾値ではなく、フェーズの境界でコンパクト化する。
アーキテクチャパターンガイダンス
- ReAct: 不確実なパスを持つ探索的タスクに最適。
- 関数呼び出し: 構造化された決定論的フローに最適。
- ハイブリッド（推奨）: ReAct 計画 + 型付きツール実行。
ベンチマーク
追跡すべき指標：
- 完了率
- タスクあたりのリトライ数
- pass@1 および pass@3
- 成功タスクあたりのコスト
アンチパターン
- セマンティクスが重複するツールが多すぎる。
- 回復ヒントのない不透明なツール出力。
- 次のステップなしのエラーのみの出力。
- 無関係な参照でコンテキストを過負荷にする。
Related Skills
affaan-m/ito-compute
tools
VerifiedTrustedCommunity
Query live GPU inventory, submit an authenticated Itô fixed-rate RFQ, inspect RFQ or procurement status, revoke device credentials, and run explicitly gated node qualification through the separately installed canonical CLI. Use when a user asks to find H100/H200 capacity, request a fixed compute rate, check Itô compute status, validate GPU nodes, revoke Itô access, or rent or purchase GPU compute and needs the supported boundary explained.
247,258SKILL.mdUpdated Jul 24, 2026
affaan-m/social-publisher
testing
VerifiedTrustedCommunity
Agent-driven scheduling and publishing of social media posts across 13 platforms via SocialClaw. Use when the user wants to publish to X, LinkedIn, Instagram, Facebook Pages, TikTok, Discord, Telegram, YouTube, Reddit, WordPress, or Pinterest — or when managing campaigns, uploading media, or monitoring post delivery status.
247,258SKILL.mdUpdated May 26, 2026
affaan-m/cost-aware-llm-pipeline
development
VerifiedTrustedCommunity
LLM APIの使用量のコスト最適化パターン — タスクの複雑さによるモデルルーティング、予算追跡、リトライロジック、プロンプトキャッシング。
247,258SKILL.mdUpdated May 18, 2026
affaan-m/jira-integration
tools
VerifiedTrustedCommunity
Use this skill when retrieving Jira tickets, analyzing requirements, updating ticket status, adding comments, or transitioning issues. Provides Jira API patterns via MCP or direct REST calls.
247,258SKILL.mdUpdated Apr 10, 2026