「kintoneアプリの健康チェック」をワンクリックで可視化するツールを作りました

背景

クライアント様から「kintone から Salesforce への移行を検討しているが、前任者が不在でドキュメントがない」という相談を受け、まずはフィールドの棚卸しから着手しました。

ところが、アプリは長年の拡張で巨大化。画面を見ながら手作業でnotionに転記していくやり方では、全体像が掴めず、抜け漏れのリスクが高い――そんな状況でした。

課題（移行検討中ゆえの制約）

• いずれ Salesforce へ移行する可能性がある

• だから kintone 側に大規模な調査システムを作り込むのは現実的ではない

• でも、今すぐ仕様を可視化して合意形成しないと、移行要件が固められない

解決策（個別実行できるユーザースクリプト）

そこで選んだのが Tampermonkey のユーザースクリプト。

各担当者のブラウザで個別に実行でき、サーバ側に手を入れる必要がありません。
kintone の REST API（GETのみ） を使ってフォーム定義とレイアウトを読み取り、ワンクリックでMarkdownの仕様表を出力します。

• フォーム定義（/form/fields）：ラベル、コード、必須、初期値、型

• レイアウト（/form/layout）：実際の配置順と グループ／サブテの所属

主な機能

🩺 Health（ヘルスチェック）

アプリのフィールド数・状態数・アクション数などを自動解析。
「多すぎて設計が重くなっていないか？」を一目で判定します。

📋 Fields（フィールド一覧）

フォームの全フィールドを実際のレイアウト順で一覧化。
さらに Markdown・CSV・JSON 形式で出力できます。

技術的なポイント

• kintone REST API（form/fields + form/layout）で定義情報と配置情報を取得

• レイアウト順にソートして実際の画面構成と一致

• ルックアップ検知：SINGLE_LINE_TEXT + lookup設定 → LOOKUP として出力

• GET専用：データは一切変更せず、閲覧権限に応じて情報を取得

導入方法（3分で完了）

1️⃣ Tampermonkey をブラウザに入れる
2️⃣ 以下のスクリプトURLを開いて「インストール」
3️⃣ kintone のアプリを開くと、右下に黒いパネルが出ます。

• 🔗 GitHub（ソース公開）
  https://github.com/youtotto/kintone-app-toolkit

• 🔗 Rawスクリプト（インストール用）
  👉 インストールはこちら（GitHub Raw）

使い方イメージ

• Healthタブ → アプリの構成サマリをチェック

• Fieldsタブ → Markdownコピー → Notionやドキュメントへペースト
  → そのまま仕様書やレビュー資料として活用できます。

ライセンス

MIT License
自由に使って、改変・再配布できます。
ご利用時は GitHub のリンクを残していただけると嬉しいです。

さいごに

本ツールは “受託の最初の30分”を短縮する共通道具 を目指しています。
使ってみて「ここが足りない」「この出力が欲しい」などあればぜひ教えてください。
みんなの“最初の一歩”を速くするために、軽い改善を続けていきます。

次はこの記事を読みませんか？

AppInsight AI Review機能をリリースしました