archimate

archimate skill の概要

archimate は何のためのものか

archimate skill は、!include <archimate/Archimate> の stdlib と型付きマクロを使って、PlantUML で ArchiMate 図を生成するのに役立ちます。ビジネス、アプリケーション、テクノロジー、モチベーション、実装ロードマップといったレイヤー分けされたエンタープライズアーキテクチャの視点で archimate skill を必要とするときに最適です。単なる箱と矢印が欲しいのではなく、ラフなアーキテクチャ案を構造化された図に落とし込みたい作業で使うのが向いています。

最適なユースケース

この skill は、ケイパビリティマップ、アプリケーション連携図、セキュリティアーキテクチャ、移行計画など、エンタープライズアーキテクチャの成果物を作る人に特に適しています。レイヤー間のトレーサビリティと、要素・関係の意味を明確にしたい場合にとくに有効です。TOGAF 系の各ビューで archimate for Diagramming が必要なら、自由形式のプロンプトよりも、より規律ある出発点を与えてくれます。

使わないほうがよいケース

クラウド参照図、Kubernetes の配置図、ネットワークトポロジーマップが主目的なら、ArchiMate としてその領域を表す意図が明確な場合を除き、archimate は選ばないでください。リポジトリ自体もその点を明確に分けており、インフラ寄りのクラウド図は cloud skill、トポロジーは network skill を使うよう案内しています。この境界は重要です。ここでのマクロは一般的な図解表現ではなく、エンタープライズアーキテクチャの概念をモデル化するためのものだからです。

archimate skill の使い方

インストールしてワークフローを確認する

npx skills add markdown-viewer/skills --skill archimate でインストールします。インストール後は、まず SKILL.md を読んで必要な PlantUML 構成を把握し、そのあと examples/ のサンプルファイルでレイヤー別のパターンを確認してください。最初に目を通すと役立つのは examples/enterprise-landscape.md, examples/application-integration.md, examples/business-capability.md, examples/data-architecture.md, examples/migration-planning.md です。

skill に正しい入力を与える

良い archimate usage は、明確なアーキテクチャの意図、対象ビュー、そしてすでに分かっている要素から始まります。弱い依頼は「アーキテクチャ図を作って」です。より強い依頼は、「小売業向けの ArchiMate business-capability view を作成し、customer engagement、supply chain、finance の capability を 8〜10 個の名前付き要素とその関係で示してほしい」のように具体的です。レイヤー、想定読者、スコープ、さらに motivation 要素か implementation 要素を含めたいかどうかも指定してください。

PlantUML の約束事に従う

この skill が期待しているのは、説明文ではなく本物の PlantUML 図です。基本パターンは、@startuml で始め、!include <archimate/Archimate> を読み込み、Business_Actor(...) や Application_Component(...) のような型付きマクロで要素を宣言し、Rel_* マクロで接続し、最後に @enduml で閉じる、という流れです。rectangle "Layer Name" { ... } を使うと、モデルを読みやすく整理できます。include を省略したり、間違った fence を使ったりすると、図は意図どおりにレンダリングされません。

出力をよくするプロンプトの進め方

安定した archimate guide にしたいなら、3 段階で進めるのが効果的です。まずアーキテクチャ上の問いを定義し、次に要素と関係を列挙し、最後に PlantUML 図だけを求めます。良い入力には、命名規則、希望する詳細度、serving、realization、access、triggering など必ず含めたい関係を含めてください。元資料が雑然としている場合は、いきなり複数レイヤーに広げるのではなく、まず 1 つの対象ビューに正規化するよう依頼するとよいです。

archimate skill FAQ

archimate は通常のプロンプトより優れている？

はい。安定した ArchiMate 構文と、レンダリング・編集可能な図が必要なときは特に有効です。通常のプロンプトでもそれらしいアーキテクチャ説明は出せますが、必要なマクロ、レイヤーのグルーピング、関係タイプを落としがちです。archimate skill は、図の正確さと再利用性を重視するときにより役立ちます。

インストール前に知っておくべきことは？

主な前提は、ArchiMate の意味論に合う図のゴールをすでに持っていることです。この skill は、モデル化したいアクター、アプリケーション、capability、サービス、technology node を名前で挙げられるなら、特にうまく機能します。まだ漠然としたイメージしかなくても使えますが、幅広い企業要望を一気に投げるより、範囲を絞ったビューを与えたほうが、最初の出力は確実によくなります。

初心者でも archimate は使える？

はい。いくつかのマクロパターンを学ぶ意欲があれば使えます。リポジトリの例は一般的なビューと要素タイプを示しているので、初心者でも全体の記法を暗記せずに構造をまねできます。初心者のよくある失敗は、いきなり全社マップを求めてしまうことです。まずは 1 つのビュー、1 つのレイヤー、または 1 つのプロセス断片から始めてください。

ほかの skill を選ぶべきなのはどんなとき？

図の主題がクラウドリソース、物理ネットワーク配置、またはエンタープライズアーキテクチャの意味論を伴わない一般的なソフトウェア構成なら、別の skill を選んでください。標準化された関係を気にしない、純粋に見た目だけのスケッチが必要な場合も避けたほうがよいです。構造、トレーサビリティ、ステークホルダーに読める EA 記法に価値があるなら archimate を使ってください。

archimate skill を改善するには

テーマではなくビューから始める

品質を最も大きく引き上げるのは、欲しい ArchiMate view を正確に指定することです。「銀行のエンタープライズアーキテクチャ」では広すぎますが、「レガシー請求システムの移行計画ビューで、baseline、2 つの plateau、work package、gap を含める」と言えば実行可能です。archimate でより良い結果を出したいなら、レイヤー構成、想定読者、図が支えるべき意思決定を明示してください。

要素と関係の意図を漏れなく伝える

重要なノードと、それらがどうつながるかを列挙すると、skill の精度は上がります。たとえば「ログインフローを示して」と言う代わりに、「Identity Provider が Auth Service を serving し、Auth Service が Access Control を realizes し、Users が Login Request を trigger する」のように書いてください。こうした構造を足すことで、あり得ない関係の生成を減らし、実際のアーキテクチャに沿った図に近づきます。

1 つの成果物に絞って反復する

よくある失敗は、複数のビューを一度に求めてしまい、図が散らかって関係が弱くなることです。まず 1 枚の図を作り、マクロの選び方がアーキテクチャの言語に合っているか確認し、そのあと不足要素、命名、グルーピングの修正を依頼してください。archimate usage では、1 回で巨大なプロンプトを投げるより、反復で詰めるほうがたいてい良い結果になります。

例をパターン集として使う

依頼の切り方に迷ったら、リポジトリの例に合わせてください。business-capability, application-integration, data-architecture, security-architecture, devops-pipeline, migration-planning が参考になります。これらの例を見ると、どの関心ごとにどのマクロを使うのか、リポジトリがどのようなレイヤー分けを想定しているのかが分かります。この構造を借りることで、プロンプトはより具体的になり、図も元の意図に忠実になります。