ascii-table-renderer

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

重要なトリガールール

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

トリガーとなるフレーズの例：

• "ascii-table-renderer"
• "use ascii-table-renderer"
• "用 ascii-table-renderer 把列表打印成表格"
• "使用 ascii-table-renderer 生成 ASCII 表格（对齐/列宽）"

範囲

• データ（DB/API）は取得しないでください。出力のレンダリングと書式設定のみを行います。
• デフォルトの境界線は ASCII 文字のみです：+ - |。
• 対象外：セルの結合、複数行ヘッダー、複雑なセル結合レイアウト。

このスキルの使用方法

入力

• headers（必須）
• rows（必須）
• maxWidth（デフォルト：80）
• maxColWidth（デフォルト：20）
• borderStyle（light | minimal、デフォルト：light）
• overflow（ellipsis | wrap、デフォルト：ellipsis）
• align（left | right | center、デフォルト：left）

出力（必須）

• tableCompact（ログ向け）
• tableReadable（対話操作向け）
• rules（幅／切り詰め／null／配置のルール）

手順

1. 列ごとの幅を計算します：min(maxColWidth, max(contentWidth))
2. はみ出しを処理します：
   • ellipsis：一貫して ... を使用します
   • wrap：行の配置を保ちながら、列幅内で折り返します
3. 2 種類の出力を生成します：
   • compact：区切り線を最小限にするか、少なくします
   • readable：境界線をより明確にします

スクリプト

• scripts/render_table.py：JSON stdin からテーブルをレンダリングします（compact/readable）

例

• examples/basic.md

品質チェックリスト

1. 列の位置が一貫して揃っており、各行が maxWidth を超えないこと
2. Null 値が - として表示されること
3. コピー＆ペーストに適していること（末尾に空白がないこと）

キーワード

英語： ascii-table-renderer, ASCII テーブル, 配置, 列, 行, 切り詰め, 折り返し, ターミナル, ログ 中国語： ascii-table-renderer, ASCII テーブル, 配置, 列幅, 切り詰め, 改行, ターミナル, ログ, チケット

よくある落とし穴（Gotchas）

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

使用手順

Step 1: 環境の準備

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

Step 2: 設定の初期化

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

Step 3: コア機能の使用

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

Step 4: テストと検証

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

Step 5: デプロイ

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