こんにちは。現場の最前線で開発とナレッジの設計に携わっているエンジニアです。
皆さんのチームでは、こんな光景が日常茶飯事になっていませんか？
「あの仕様書、どこだっけ？ Figmaにある？ それともGoogleドライブ？ いや、GitHubのPRの中かも…」
情報を探すという行為は、開発者の集中力を削ぐ最大の敵です。「情報を探しに行く」のではなく「情報がここに集まっている」状態を作る。 それを実現する最強の武器が、Confluenceの「Smart Links（スマートリンク）」です。
今回は、この機能を単なる「リンク集」から「動的なハブ」へと進化させる極意を伝授します。
—
1. Smart Linksとは何か？：ただのリンクとの決定的な違い
従来のリンクは、単なる「テキストの住所」でした。クリックするまで中身が分からず、別タブを開いて確認し、元のページに戻ってくる……この往復だけで脳のメモリは無駄に消費されます。
Smart Linksは、外部ツールとConfluenceの間に「動的な窓」を作る技術です。
単なるURLのペーストが、自動的にプレビューやインタラクティブなUIに変換されます。これにより、Confluenceを離れることなく、情報の核心に触れることができるのです。
—
2. 主要ツールの埋め込み：現場で「差がつく」3つの表示形式
Smart Linksの真骨頂は、表示形式を自由自在に操れる点にあります。以下の3つを使い分けるのがプロの流儀です。
① インライン（Inline）
文章中に自然に溶け込ませる形式です。
- 用途: 関連するGitHubのIssueやチケットへの参照など、文脈を補足したい場合。
- 手順: URLを貼り付けた後、ツールバーから「インライン」を選択（または`Ctrl/Cmd + Shift + 1`）。
② カード（Card）
視認性の高いリッチなカード形式です。
- 用途: GoogleドライブのドキュメントやFigmaのリンクなど、中身のタイトルやサムネイルを一目で把握したい場合。
- 手順: URLを貼り付けた後、ツールバーから「カード」を選択。
③ 埋め込み（Embed）
ここが最重要です。 外部ツールをConfluence内で直接操作可能にします。
- 用途: Figmaのデザイン画面、Googleスプレッドシートの編集、Jiraのボードなど。
- 手順: URL貼り付け後にツールバーから「埋め込み」を選択。
- Figmaの例: 埋め込むことで、Confluence上で直接デザインのズームやスクロールが可能になります。
—
3. 「情報のハブ」として機能させる実務活用テクニック
ただ貼り付けるだけでは、結局「リンクの墓場」になってしまいます。チームのベロシティを劇的に高めるための、現場で使える「設計思想」を共有します。
テクニックA：仕様書とFigmaの「完全同期」
開発者がFigmaを探し回る時間をゼロにします。
1. 「仕様・要件定義ページ」の上部にFigmaのプロトタイプを「埋め込み」で配置する。
2. その下に、GitHubのプルリクエストを「インライン」で配置する。
3. 効果: 「要件を見ながら、デザインを確認し、実装コードに飛ぶ」というフローが1ページで完結します。
テクニックB：動的な状態管理（GitHub / Jira連携）
Smart Linksは、ツール側のステータスを追従します。
- GitHubのPRを貼り付けると…：マージ済みか、レビュー中かが自動でカードに表示されます。
- 活用法: 「現在の進捗」をわざわざテキストで更新する必要はありません。Smart Linksを貼っておけば、誰が見てもそのPRの最新状況がわかります。
テクニックC：情報の「賞味期限」を管理する
情報が散逸する原因は「古い情報が残っていること」です。
- 極意: Smart Linksで埋め込んだツールは、基本的に「ソース・オブ・トゥルース（信頼できる唯一の情報源）」であるはずです。もしツール側を更新したら、Confluence側も自動的に最新になる。この仕組みをチームで合意してください。「資料は常に最新のSaaSへのリンクにする」というルールを徹底するだけで、ドキュメントのメンテナンスコストは劇的に下がります。
—
今すぐ試せる：HelloWorld的セットアップ
まずは、皆さんが今日触っている「最も頻繁に開くツール」のURLを、適当なテストページに貼り付けてみてください。
1. URLをペースト: (例: `https://www.figma.com/file/…`)
2. 変換を待つ: 自動的にリンクに変換されるはずです。
3. クリックして「埋め込み」へ: ツールバーで表示形式を「埋め込み」に変更し、実際に操作できるか確認してください。
これだけで、明日からの皆さんの作業画面は驚くほどスッキリするはずです。
—
最後に：エンジニアへのメッセージ
ツールは「使う」ものではなく、「チームの思考を加速させるために飼いならす」ものです。
Smart Linksを活用して、「探す時間」を「創造する時間」に変えていきましょう。
Confluenceはただのwikiではありません。チームの脳の拡張パーツです。 ぜひ、今日から自分のページを「情報のハブ」へと作り変えてみてください。
何か詰まったら、いつでも聞いてくださいね。現場からは以上です！