🔧 技術調査 - CLI-Anything

agent-harness/
├── setup.py                          # 名前空間パッケージ設定
├── cli_anything/
│   └── <software>/                   # 名前空間パッケージ
│       ├── __init__.py
│       ├── __main__.py               # python -m エントリーポイント
│       ├── <software>_cli.py         # Click コマンドグループ定義
│       ├── README.md
│       ├── core/
│       │   ├── project.py            # create/open/save 操作
│       │   ├── session.py            # undo/redo 状態管理
│       │   └── <domain>.py           # ドメイン固有ロジック
│       ├── utils/
│       │   ├── <software>_backend.py # subprocess/REST/API 統合
│       │   └── repl_skin.py          # REPL スタイリング
│       ├── skills/
│       │   └── SKILL.md              # AI エージェント向けメタデータ
│       └── tests/
│           ├── test_core.py          # ユニットテスト
│           ├── test_full_e2e.py      # E2E テスト
│           └── test_<software>_backend.py  # バックエンドテスト

import click
import json as json_module
from .core.session import Session

@click.group()
@click.option('--json', 'json_output', is_flag=True, help='JSON output')
@click.option('--project', default=None, help='Project file path')
@click.pass_context
def cli(ctx, json_output, project):
    """Main entry point"""
    ctx.obj = {'json': json_output, 'session': Session(project)}

@cli.group()
def project():
    """プロジェクト管理コマンド群"""
    pass

@project.command()
@click.option('--name', required=True)
@click.pass_context
def create(ctx, name):
    """新規プロジェクト作成"""
    ctx.obj['session'].snapshot('create project')
    result = {"project_name": name, "created": True}
    if ctx.obj['json']:
        click.echo(json_module.dumps({"status": "ok", "data": result}))
    else:
        click.echo(f"Project '{name}' created.")

import copy

class Session:
    def __init__(self, project_path=None):
        self._undo_stack = []       # 最大50スナップショット
        self._redo_stack = []
        self.project = {}           # インメモリ状態
        self.modified = False

    def snapshot(self, description):
        """変更前の状態をキャプチャ"""
        self._undo_stack.append(copy.deepcopy(self.project))
        self._redo_stack.clear()
        if len(self._undo_stack) > 50:
            self._undo_stack.pop(0)

    def undo(self):
        """直前の操作を取り消す"""
        if self._undo_stack:
            self._redo_stack.append(self.project)
            self.project = self._undo_stack.pop()
            self.modified = True
            return "Undone"
        return "Nothing to undo"

import shutil
import subprocess

def find_software():
    path = shutil.which('blender')
    if not path:
        raise RuntimeError("Blender not found in PATH")
    return path

def render(project_file, output_path):
    result = subprocess.run(
        [find_software(), '--background', project_file,
         '--python-expr', 'import bpy; bpy.ops.render.render(write_still=True)'],
        capture_output=True
    )
    return result.returncode == 0

import requests

class OllamaClient:
    def __init__(self, host='localhost', port=11434):
        self.base_url = f"http://{host}:{port}"

    def generate(self, model, prompt):
        response = requests.post(
            f"{self.base_url}/api/generate",
            json={"model": model, "prompt": prompt}
        )
        return response.json()

import xml.etree.ElementTree as ET

def add_track(project_path, track_name):
    tree = ET.parse(project_path)
    root = tree.getroot()
    tracks = root.find('.//tracks')
    new_track = ET.SubElement(tracks, 'track')
    new_track.set('name', track_name)
    tree.write(project_path)

{
  "status": "success",
  "data": {
    "project_id": "proj_123",
    "modified": true,
    "undo_depth": 3,
    "redo_depth": 1
  },
  "errors": [],
  "meta": {
    "timestamp": "2026-03-26T10:30:00Z",
    "command": "project create"
  }
}

pip install click pytest

/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything

cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/

mkdir -p ~/.openclaw/skills/cli-anything
cp CLI-Anything/openclaw-skill/SKILL.md ~/.openclaw/skills/cli-anything/

# ローカルパスを指定
/cli-anything ./gimp

# GitHub URL を指定（自動クローン）
/cli-anything https://github.com/blender/blender

# 全体的なギャップ分析
/cli-anything:refine ./gimp

# フォーカスエリアを指定して絞り込み
/cli-anything:refine ./shotcut "batch processing and filters"

/cli-anything:test ./inkscape

/cli-anything:validate ./audacity

# 対話モード（REPL 起動）
cli-anything-gimp

# ワンショットモード
cli-anything-gimp image create --width 1920 --json

cd gimp/agent-harness
pip install -e .

# 1. GIMP の CLI ハーネスを生成
/cli-anything https://github.com/GNOME/gimp

# 2. 生成されたハーネスをローカルにインストール
cd gimp/agent-harness
pip install -e .

# 3. ワンショットモードで画像を開いて JSON 出力を確認
cli-anything-gimp image load --path ./photo.jpg --json
# => {"status": "success", "data": {"image_id": 1, "width": 3024, "height": 4032}, ...}

# 4. 画像をリサイズ
cli-anything-gimp image scale --image-id 1 --width 1920 --json
# => {"status": "success", "data": {"image_id": 1, "width": 1920, "height": 2560}, ...}

# 5. REPL モードで対話的に操作
cli-anything-gimp
> project open --path ./photo.xcf
> layer list --json
> undo
> exit

cd gimp/agent-harness
pip install build twine
python -m build
twine upload dist/*

test_core.py
├── ユニットテスト（合成データのみ、外部依存なし）
└── 各モジュールの関数単体を検証

test_full_e2e.py
├── E2E ネイティブテスト（プロジェクトファイル生成パイプライン検証）
└── XML 構造・フォーマット整合性を検証

test_<software>_backend.py
├── E2E バックエンドテスト（実ソフトウェアを呼び出す）
└── マジックバイト検証で出力形式の正当性を確認

test_cli_installed.py
└── CLI サブプロセステスト（インストール済みコマンドを実行）

1. main からフィーチャーブランチを作成
2. コーディング規約（PEP 8・型ヒント・全コマンドに --json フラグ）を遵守
3. すべてのテストの合格を確認
4. PR テンプレートを完全記入して main へ PR を作成

# 例
feat: Krita CLI ハーネス追加
fix: LibreOffice export マジックバイト検証を修正

cd <software>/agent-harness
pip install -e .
python3 -m pytest cli_anything/<software>/tests/ -v