name: invoice-generator description: クライアントへの請求書HTMLを生成します
請求書HTML生成スキル
クライアントへの請求書HTMLを生成します。ブラウザの印刷機能でPDF化する運用です。
使い方
/invoice-generator <クライアント名> <請求月> [オプション]
引数:
<クライアント名>(必須): 請求先のクライアント名(例: 株式会社サンプル)<請求月>(必須): 請求対象月(例: 2026-03)- 明細・金額・備考等はインタラクティブに確認する
実行手順
Step 1: 請求情報の収集
ユーザーから以下の情報を収集する。不足があれば質問して確認する。
| 項目 | 必須 | 説明 |
|---|---|---|
| クライアント名 | Yes | 請求先の正式名称 |
| 宛名の敬称 | No | 「御中」(デフォルト)or「様」 |
| クライアント住所 | No | 請求先住所(省略可) |
| 代表者名 | No | 担当者・代表者名(省略可) |
| 請求日 | Yes | デフォルト: 対象月の末日 |
| 支払期限 | Yes | デフォルト: 請求日の翌月末 |
| 明細行 | Yes | 項目1・項目2・数量(単位含む)・単価・金額 |
| 備考 | No | 振込手数料負担、その他特記事項 |
Step 2: 請求書番号の採番
請求書番号は INV-YYYYMM-NNNN 形式で採番する。
docs/templates/invoice/ディレクトリ内の既存HTMLファイルを Glob で検索する- ファイル名から最新の請求書番号を特定する
- 同月内で連番をインクリメントする(初回は
0001)
例: INV-202603-0001, INV-202603-0002
Step 3: 金額の計算
以下のルールで金額を計算する。
- 小計: 各明細行の金額を合算(税抜き)
- 消費税(10%): 小計 × 0.1(端数切り捨て)
- 合計(税込): 小計 + 消費税
明細行の金額が税込で指定された場合は、ユーザーに確認の上で税抜き・税込を明確にする。
Step 4: HTMLファイルの生成
見積書テンプレート(docs/templates/quotation/template.html)のデザインを流用し、以下の差分を適用した請求書HTMLを生成する。
見積書との差分
| 項目 | 見積書 | 請求書 |
|---|---|---|
| タイトル | 見積書 | 請求書 |
| サブタイトル | Quotation | Invoice |
| 発行者ラベル | 発行者 | 請求元 |
| 相手方ラベル | ご依頼者 | 請求先 |
| 日付ラベル1 | 見積もり日 | 請求日 |
| 日付ラベル2 | 有効期限 | お支払期限 |
| 振込先セクション | なし | あり |
| フッター文言 | 見積もりです | 請求書です |
明細テーブルの構成
5列構成:
| 項目1 | 項目2 | 数量 | 単価 | 金額 |
|---|---|---|---|---|
| サービス名等 | 詳細・補足説明 | 1回 | ¥12,000 | ¥12,000 |
テーブル末尾に以下の3行を必ず表示する:
小計 ¥XX,XXX
消費税(10%) ¥X,XXX
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
合計(税込) ¥XX,XXX ← 太字・背景色付き
- 小計行: 各明細の金額合算(税抜き)
- 消費税行: 小計 × 10%(端数切り捨て)
- 合計行: 小計 + 消費税(太字、背景色
#f9f9f9、上線2px solid #333)
サマリーセクションの「ご請求金額(税込)」にも同じ合計金額を大きく表示する。
発行者情報(固定)
株式会社 AI.LandBase
〒905-0412
沖縄県国頭郡今帰仁村湧川 852-2
TEL: 080-3468-1177
振込先情報(固定)
りそな銀行 秋葉原支店
普通 2134877
カ)アイランドベース
ロゴ
見積書テンプレートと同じGoogle Driveのロゴ画像URLを使用する。画像読み込みエラー時のフォールバック(テキスト表示)も同様に実装する。
Step 5: ファイルの保存
- 生成したHTMLを
docs/templates/invoice/INV-YYYYMM-NNNN.htmlとして Write ツールで保存する - ユーザーに以下を報告する:
- 出力ファイルパス
- 請求書番号
- 請求先
- 請求金額(税込)
- 明細サマリー
- 「ブラウザで開いて印刷/PDF保存してください」と案内する