wcxcw/harness-skills

harness-skills は何をしますか？

ソフトウェアプロジェクト向けに Agent Harness 環境を作成・保守するための Codex Skill Pack です。エージェントが仕様、コンテキスト、ツール、フィードバック、境界、評価のクローズドループで安定して開発タスクを完了できるようにします。

Agent Harness とは

Agent Harness は、AI エージェントが自律的に動作するための構造化された実行環境です。以下の要素を定義・管理します：

• 仕様（Specification）：タスクの明確な目的と成功条件
• コンテキスト（Context）：関連ファイル、アーキテクチャ情報、プロジェクトルール
• ツール（Tools）：エージェントが利用可能なコマンドや API
• フィードバック（Feedback）：人間や自動テストからの反応ループ
• 境界（Boundaries）：権限、リソース、時間的制約
• 評価（Evaluation）：成果物の品質とタスク達成度

主な機能

• プロジェクトの初期化時に Harness 設定ファイルを生成
• エージェント向けのタスク分解と指示書生成
• 環境変数やパスの自動設定
• フィードバックループのテンプレート
• 評価基準の定義と自動チェック

使用方法

Codex エージェント上で以下のようにスキルを呼び出します：

codex skill wcxcw/harness-skills init

プロジェクトのルートに harness/ ディレクトリが作成され、以下のファイルが生成されます：

• harness/spec.md：タスク仕様
• harness/context/：コンテキストファイル
• harness/tools/：利用可能なツール定義
• harness/evaluation.md：評価基準

設定例

# harness/config.yaml
specification:
  name: "API エンドポイント実装"
  success_criteria:
    - すべてのテストが通過
    - エラーハンドリングが実装されている
context:
  includes:
    - "src/**/*.ts"
    - "docs/api.md"
  excludes:
    - "node_modules"
tools:
  - "node"
  - "npm test"
boundaries:
  max_steps: 10
  allowed_commands: ["node", "npm", "git"]

対象プラットフォーム

• Codex (OpenAI)
• その他 AI エージェント（カスタマイズ可能）

注意事項

• 生成された Harness はプロジェクト固有の設定を含むため、バージョン管理することを推奨します
• harness/ ディレクトリは .gitignore に追加しないでください
• セキュリティ上の理由から、許可されるコマンドは最小限に制限してください