ascii-image-to-ascii

このスキルを使用するタイミング

重要なトリガールール

• ユーザーがスキル名 ascii-image-to-ascii を明示的に指定した場合にのみ、このスキルを使用してください。

トリガーフレーズの例：

• "ascii-image-to-ascii"
• "use ascii-image-to-ascii"
• "用 ascii-image-to-ascii 把图片转字符画"
• "使用 ascii-image-to-ascii 生成可读优先/细节优先两版"

境界

• デフォルトの出力は ASCII のみです。ANSI カラーは任意です。
• 同梱スクリプトはローカルでの変換と検証にのみ使用します。ユーザーに代わって画像を取得またはアップロードしないでください。
• 最終的な ASCII アートを生成する前に、必ず前処理のアドバイス（被写体のトリミング、コントラストの向上、背景の簡略化）を伝えてください。

このスキルの使用方法

入力

• imagePath（ローカルパス、必須）
• width（デフォルトは 100。一般的な値：80/100/120）
• charset（デフォルトは .:-=+*#%@。明るいものから暗いものの順）
• mode（readable | detail。両方を出力する場合は無視できます）
• background（light | dark | unknown。デフォルトは unknown）
• colorMode（none | ansi256。デフォルトは none）

出力（必須）

• asciiReadable：読みやすさ優先（ノイズが少なく、シルエットが明瞭）
• asciiDetail：ディテール優先（階調が多く、テクスチャが豊か）
• paramsGuide：推奨する width/charset と前処理のヒント
• pitfalls：よくある失敗例 3～5 件と対処方法

手順

1. 前処理のアドバイス（必須）：
   • 被写体をトリミングし、不要な背景を取り除く
   • コントラストを上げてグラデーションノイズを減らす
   • 幅は通常 80～120 列を目安にする
2. 文字セットとマッピングの方向：
   • スペースが最も明るく、@ が最も暗くなります（または一貫して反転させます）
3. 2 つのバリエーションを生成する：
   • readable：階調を少なくする（ノイズを抑える）
   • detail：階調を多くする（テクスチャを豊かにする）
4. ANSI（任意）：
   • 色は補助としてのみ使用し、シルエットを読みやすく保つ
   • 必ずカラーなしの代替版も用意する

スクリプト

• scripts/image_to_ascii.py
  • Python + Pillow が必要です（pip install pillow）
  • 対応機能：readable/detail バリエーション、任意の --ansi256

例

• examples/readable-vs-detail.md

品質チェックリスト

1. 各行の長さが一定で、<= width である
2. readable バリエーションでは、主要なシルエットを維持する
3. 行末にスペースがない（コピー＆ペーストに安全）

キーワード

英語： ascii-image-to-ascii, image to ascii, ascii art, terminal preview, charset, grayscale, dithering, ansi 中国語： ascii-image-to-ascii, 画像から文字絵への変換, ASCII 文字絵, ターミナルプレビュー, 文字セット, グレースケールマッピング, ノイズ低減, ANSI カラー

よくある落とし穴

1. バージョンの互換性：フレームワークのバージョンと依存ライブラリの互換性に注意してください。バージョンによって API が異なる場合があります。
2. 設定ファイルの形式：設定ファイルの形式の誤りは最もよくある問題です。エディターの構文チェックを使用することをおすすめします。
3. 環境変数：必要な環境変数がすべて正しく設定されていることを確認し、機密情報をハードコードしないでください。
4. 依存関係の競合：複数のバージョンを共存させる場合は依存関係の競合に注意し、lock ファイルでバージョンを固定してください。
5. パフォーマンス上の落とし穴：大量のデータを扱う場合はパフォーマンスの最適化に注意し、N+1 クエリなどのよくある問題を避けてください。

使用手順

Step 1: 環境の準備

開発環境に必要な依存関係とツールがインストールされていることを確認します。

Step 2: 初期設定

プロジェクトの要件に応じて基本設定を行います。

Step 3: コア機能の使用

サンプルコードに従ってコア機能を実装します。

Step 4: テストと検証

テストを実行して、機能が正常に動作することを確認します。

Step 5: デプロイ

開発が完了したら、デプロイと監視を行います。