tsubaiso ti-report — 帳票カスタマイズ
ベータとして先行提供している機能です。 記述が変わることがあります。扱いは ti-core の
references/beta-status.mdを参照してください。
PSA/IMA を使う顧客の帳票を、自社のレイアウト・項目に合わせてカスタマイズする作業を支援する能力スキル。持つのは帳票固有の中身（テンプレの差込DSL・データの流し込み・意味定義マッピング・押印/DRAFT判定・「どの権限/配置/項目/資産が要るか」のauthor・反復調整・帳票設計書/仕様書の継続修正サイクル・美観の原則）。メタデータを届ける機構は持たず、配備は ti-metadata の機構へ渡す。
本書は薄い索引に徹する（詳細は必要な reference だけを読む方式）。手順の実体は各 reference にある。
このスキルが持つもの・持たないもの
| 持つ（帳票の中身） | 持たない（機構＝委譲先） |
|---|---|
| テンプレの差込DSL・流し込み・意味定義マッピング | メタデータ配備の実行（取得→差分→検証→反映）＝ ti-metadata |
| 押印/DRAFT判定・共通の出力ボタンのシェル規約（実体＋IFはローカル） | 文書→レコードの取込・入力支援＝ ti-update |
| 配置に要る権限・項目・資産・レイアウトの author | 参照先の有効条件チェック・作れない工程の検出＝ ti-reference |
| 反復調整・帳票設計書/仕様書の継続修正サイクル・美観の原則 | 導入プロジェクトの工程進行＝ ti-onboarding |
中身は本スキル、機構は能力スキル。この主従を崩さない。押印/DRAFT判定と共通の出力ボタン規約は現状の利用者が帳票のみのため本スキルローカルに置き、2つ目の利用者が現れた時点で ti-core へ昇格する（それまで非昇格）。
発火点（いつ・どの reference を読むか）
| チェックポイント | 読む／呼ぶ | 渡す・確認するもの |
|---|---|---|
| そのセッションで最初に TI のスキルを使う瞬間（依頼の内容を問わず・1 セッション 1 回） | ti-core references/version-freshness.md |
同梱 .claude-plugin/plugin.json の版 |
| テンプレを作る・差込点を調整する・データを流し込む・意味定義を対応づける・押印/DRAFT分岐を組む | references/template-and-mapping.md |
帳票種別・源データの有無・承認状態の判定項目 |
| 帳票をorgのレコードページに載せる・帳票に出す項目を増やす・反復調整して確定版を配備する | references/deploy-and-fields.md |
配置先・追加項目・配備する束 |
| 帳票を作った後に設計書を出す・カスタマイズ仕様書を提示する・指示を反映して回す | references/report-design-cycle.md |
対象帳票の版・現状マッピング・変更指示 |
| 帳票の体裁・美観を仕上げる・日本向け/海外向けの様式を選ぶ | references/report-aesthetics.md |
対象国・帳票種別・出力経路（画面印刷/サーバPDF） |
| 現状仕様を往復で詰める瞬間（設計書→仕様書→指示→反映の往復） | ti-core references/spec-roundtrip.md |
変更の選択肢・前提 |
| 製品の操作手順・可否・理由を書こうとした瞬間／製品そのもの（コード・フロー・項目ヘルプ・パッケージのメタデータ）を読もうとした瞬間／実測と期待の食い違いを不具合と書こうとした瞬間／作業の対象範囲を自分で数え上げようとした瞬間 | ti-core references/knowledge-lookup.md |
引きたい製品・機能と、利用者の言い方 |
| org へ書き込む直前（項目追加・デプロイ・生成PDFの添付） | ti-core references/safety-gate.md |
対象・承認ドラフト |
| 帳票機構の不足・ナレッジギャップに気づいた瞬間 | ti-core references/feedback.md |
不足の内容 |
| 一次解決で解けず利用者が未解決のまま／繰り返し詰まると判定した瞬間 | ti-core references/support-escalation.md |
本人の許可・再現手順（PII・業務データ本体・認証情報は載せない） |
本文中の能力スキル名（ti-metadata・ti-reference・ti-update 等）は配置済みで、フォルダ名＝正準名として辿れる。配備の機構（ti-metadata）は SKILL.md（共通の規律）＋
references/metadata-type-recipes.md（種別ごとの手順）の構成のため、deploy-and-fields.mdからは ti-metadata の SKILL.md を入口として案内する。
reference 索引
| reference | 何を定義するか |
|---|---|
references/template-and-mapping.md |
テンプレの差込DSL＋流し込み（プレビュー経路とorg描画経路の記法差・落とし穴）／意味定義マッピング／押印・DRAFT判定と定型帳票との棲み分け |
references/deploy-and-fields.md |
帳票をレコードページに載せる中身の author（配備の実行は ti-metadata へ委譲）／カスタム項目追加の副フロー／反復調整／安全ゲート |
references/report-design-cycle.md |
帳票項目マッピング設計書・カスタマイズ仕様書の出力フォーマットと継続修正サイクル（カスタマイズのブラックボックス化解消） |
references/report-aesthetics.md |
美しい帳票の原則／サーバPDFとの両立／日本向け・海外向けの様式差／道具と型は標準・あてはめは顧客ごと |
原則
- 中身はここ、機構は能力スキル。テンプレ・マッピング・押印判定・authorは本スキルが持ち、メタデータ配備の実行は ti-metadata へ委ねる。
- 本書は薄く保つ。手順・チェックリストは reference に置き、SKILL.md は索引に徹する。
- 道具と型は標準・あてはめは顧客ごと。美の原則・DSL・設計書/仕様書のフォーマットは全顧客共通、ブランド具体値・各帳票の項目/指示の中身は都度あてはめる。
- 利用者向け出力に内部識別子（API名・SOQL・レコードID）を出さない（ti-core
references/output-discipline.mdに従う）。項目マッピング設計書は管理者・コンサル向けの技術ドキュメントとしてのみ源データ項目のAPI名を扱う。