Delegate Climpt Agent

Climpt コマンドレジストリを通じた開発タスク委譲。

Input / Output

Input

| Component | Passed via | Why | | ----------- | -------------- | ------------------------------------------------------ | | action | --action arg | 動詞でコマンド種別(create/test/commit等)にマッチさせる | | target | --target arg | 名詞で対象物(file/test/document等)にマッチさせる | | intent | --intent arg | オプション選択のヒント(edition/adaptation等)を与える | | content | stdin pipe | 処理対象の実データ(diff/spec等)を climpt に渡す |

intent vs content の区別:

intent: 「どう処理するか」→ オプション選択用の短い説明
content: 「何を処理するか」→ climpt が処理する実データ

Output

サブエージェント実行結果のサマリー（stdout に出力）

flowchart LR
    subgraph Input
        action[action<br/>動詞]
        target[target<br/>名詞]
        intent[intent<br/>説明]
        content[content<br/>データ]
    end

    subgraph Processing
        search[Command Search]
        resolve[Option Resolution]
        climpt[Climpt Execution]
    end

    action --> search
    target --> search
    intent --> resolve
    content --> climpt
    search --> climpt
    resolve --> climpt
    climpt --> output[Summary]

Usage

Step 1: パラメータ作成

| パラメータ | 形式 | 例 | | ---------- | -------------- | ---------------------------- | | action | 動詞中心 ~6語 | "run execute test verify" | | target | 名詞中心 ~6語 | "specific file unit test" | | intent | 任意言語 1-2文 | "options-prompt.ts をテスト" |

Step 2: 実行

deno run --allow-read --allow-write --allow-net --allow-env --allow-run --allow-sys \
  -- ${CLAUDE_PLUGIN_ROOT}/skills/delegate-climpt-agent/scripts/climpt-agent.ts \
  --action="<verbs>" --target="<nouns>" [--intent="<description>"]

Sandbox: dangerouslyDisableSandbox: true 必須

Step 3: stdin（該当時のみ）

| 使う場面 | 使わない場面 | | ---------------------------------- | ---------------- | | コミット(diff)、生成(spec/context) | テスト実行、検索 |

git diff --staged | deno run ... -- <script.ts> \
  --action="commit save stage" --target="changes semantic" \
  --intent="新機能追加"

When to Use

a. プロジェクト固有の指示で、一般知識では対応が不明な場合。 b. 一般的な指示だが、もっと深いドメイン理解に基づいて処理する場合。

Error Handling

| エラー | 対処 | | ------------------------- | ------------------------------------------------ | | 検索結果なし | クエリを言い換えて再試行 | | スクリプト失敗 | Deno/Claude Agent SDK/権限を確認 | | "Import directory failed" | deno.json に "nodeModulesDir": "auto" を追加 |

Related: Autonomous Agents

Climpt には自律型エージェントシステム（Iterator Agent, Reviewer Agent）があり、長時間の自律開発タスクを実行できる。詳細は以下を参照。

Iterator Agent

GitHub Issue/Project から要件を取得し、完了条件を満たすまで反復実行する自律型エージェント。

# Issue モード: Issue がクローズされるまで実行
deno run -A jsr:@aidevtool/climpt/agents/iterator --issue 123

# Project モード: プロジェクトの全フェーズを完了するまで実行
deno run -A jsr:@aidevtool/climpt/agents/iterator --project 5

# Iterate モード: 指定回数だけ反復実行
deno run -A jsr:@aidevtool/climpt/agents/iterator --iterate-max 10

Reviewer Agent

実装が要件を満たしているかを検証し、不足箇所を Issue として登録する自律型エージェント。

# プロジェクト全体をレビュー（docs/review ラベルを使用）
deno run -A jsr:@aidevtool/climpt/agents/reviewer --project 25

Agent Architecture

agents/
├── common/                # 共有モジュール
│   ├── types.ts           # 型定義
│   ├── logger.ts          # JSONL ロガー
│   ├── worktree.ts        # Git worktree 操作
│   ├── merge.ts           # ブランチマージ
│   └── coordination.ts    # Agent 間連携
├── iterator/              # Iterator Agent
│   ├── config.json        # 設定
│   ├── registry.json      # プロンプトレジストリ
│   └── prompts/           # プロンプトテンプレート
├── reviewer/              # Reviewer Agent
│   └── ...
└── docs/                  # 設計ドキュメント

Key Configuration Files

| ファイル | 用途 | | ---------------------- | ------------------------------------- | | config.json | Agent 設定（ツール、権限、ロギング） | | registry.json | プロンプトレジストリ | | steps_registry.json | ステップ定義（C3L パスマッピング） | | prompts/system.md | システムプロンプト | | prompts/steps/ | フェーズ別プロンプトテンプレート |

Programmatic Usage

import { runIterator, runReviewer } from "jsr:@aidevtool/climpt/agents";

// Iterator Agent
const result = await runIterator({
  issue: 123,
  cwd: Deno.cwd(),
});

// Reviewer Agent
const reviewResult = await runReviewer({
  project: 25,
  cwd: Deno.cwd(),
});

詳細は agents/docs/ 配下のドキュメントを参照。