DSH のアーキテクチャ図：agent に検証可能なシステムマップを描かせる
Mermaid が返すのは一枚の絵です。archify スキルは型付きの仕様、自己完結型のインタラクティブ HTML 図、そして検証レポートを返します。リポジトリにはコミュニティ版の DeepSeek Harness 連携手順も書かれています。以下は実際の「一文で生成」の記録です。
最終更新: 2026-09-27
チャットの返信の中に図を出す最短手段は今も Mermaid のコードブロックですが、それは絵で止まります。このページが扱うのはその次の段階です。agent がリポジトリか説明文を読み、型付きの仕様を書き、自己完結型のインタラクティブ HTML 図をレンダリングし、成果物が自身のチェックを通るまで渡そうとしない——そんなワークフローです。中核のスキルは archify（tt-a1i/archify。2026-09-27 時点の確認で 72,468 スター）で、リポジトリには DeepSeek Harness 向けの連携が文書化されています。
スクリーンショットの前に一つ。この映像に DeepSeek Harness の画面は一切出てきません。写っているのは作者の GitHub ページ、archify の公式サイト、そして汎用 agent IDE の分割画面セッションだけです。したがってこれはスキルの出力とワークフローの記録であり、dsh の操作手順ではありません。以下のコマンドと数値はすべて 2026-09-27 に github.com/tt-a1i/archify、その integrations/deepseek-harness README、npm レジストリで確認し直したものです。録画内の GitHub ページが 'Starred 19.1k' なのは、プロジェクトのより早い段階で収録されたためです。
結論から
- ▸archify は agent スキルであり、dsh の組み込み機能ではありません。汎用の導入は npx skills add tt-a1i/archify -g、dsh 側はコミュニティ版の dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0 です。
- ▸リポジトリがなくても始められ、一文で足ります。根拠のある図が欲しいときは、リポジトリを解析してコア構成 8〜12 個、主要パス 1 本、外部依存、信頼境界を返すよう依頼します。
- ▸成果物は 2 ファイルです。型付きのアーキテクチャ仕様と、開く・転送する・書き出すのに何もインストールしなくてよい自己完結型のインタラクティブ HTML 図。
- ▸受け渡しはレポートで止められます。9/9 showcase チェック、0 errors、0 warnings、visual_review passed、4 種類のデスクトップ幅ではみ出しなし、加えて仕様と成果物の sha256。
導入からレポート受け取りまで、順を追って
入れる前に、これが何なのかを確かめる
- 1
インストールの前にリポジトリを読む
github.com/tt-a1i/archify を開いてツリーを見ます。179 コミット、25 ブランチ、.impeccable、benchmarks/ordinary-model-floor、experiments といったディレクトリがあり、そして今回いちばん重要なのが integrations/deepseek-harness です。最新コミットは 'ci(dsh): install acceptance runtime with pnpm'。About には、検証可能なアーキテクチャ・ワークフロー・シーケンス・データフロー・ライフサイクル図を自己完結型 HTML として描く agent スキルだと書かれ、トピックには deepseek-harness、dsh-plugin、mermaid-alternative が並びます。
npx skills add tt-a1i/archify -g
まずツリーを見る：dsh のアダプタはスキル本体ではなくリポジトリ側にあります。動画の 2:40 へ - 2
汎用スキルを入れ、DSH バンドルを足すか決める
汎用の導入は Cursor、Claude Code、Codex CLI、OpenCode で動きます。リポジトリにはコミュニティ版の DSH オプトインも書かれています。@tt-a1i/archify-dsh@0.1.0 というスキル専用バンドルで、developer-preview の @deepseek-ai/dsh@0.1.0-rc.6 と Node ^22.19.0 または >=24.0.0 に対する実験的な互換性を宣言し、Archify Skill 2.14.0 を同梱し、README で「DeepSeek 公式製品ではなく、DeepSeek の推奨を意味しない」と明言しています。dsh plugin add tt-a1i/archify は試さないでください。リポジトリのルートには DSH バンドルのメタデータがありません（issue #341）。別系統のサードパーティ移植 GongYuanCaiJi/dsh-archify も 2026 年 8 月に登場しており、tt-a1i/archify からの移植だと述べています。
dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0Use the archify skill to map this repository's runtime architecture.
インストール手順とその適用範囲は README と releases ページに書かれています。動画の 2:30 へ
何を返すと約束しているのか
- 3
まず公式サイトで出力形式を確かめる
サイトの見出しは 'From plain English to architecture you can trust'。LIVE PROOF パネルはモックアップではなく実際に生成された成果物を再生し、読み込めるサンプルが 3 つ並びます——S-01 Agent Tool Call、S-02 Production Deployment、S-03 Cache Miss。覚えておく価値があるのは下のカウンター行です。図の種類 5、ビジュアルプリセット 4、配色済みテーマ 2、ネイティブ書き出し倍率 4×、そして依存関係 0。この 0 が HTML を持ち運べる理由です。
05 DIAGRAM TYPES · 04 VISUAL PRESETS · 02 COORDINATED THEMES4× NATIVE EXPORT SCALE · 00 DEPENDENCIES
LIVE PROOF が再生するのは実物の成果物。カウンターの最後は依存関係 00 です。動画の 0:48 へ - 4
プロンプトを書く前に図の種類を決める
ギャラリーには 5 つの視覚言語が並びます——Architecture、Workflow、Sequence、Data Flow、Lifecycle。リポジトリにコミットされている Proof Lab には 11 シナリオがあり、それぞれの JSON ソース、名前付きビュー、検証レポートが付いています。画面の Architecture の例は Web リクエストの経路で、CloudFront → Load Balancer → API Server → PostgreSQL、脇に S3、SQS、ワーカーが付き、凡例はデータベース 2、クラウド 3、セキュリティ 1、メッセージバス 1、外部システム 1 と数えています。なお Mermaid の自動解析は対象外だとリポジトリが明言しているので、.mmd ファイルを渡せば変換してくれるとは期待せず、種類はプロンプトで指定します。
Architecture · Workflow · Sequence · Data Flow · LifecycleT-01 Architecture · T-03 Sequence · T-04 Data Flow · T-05 Lifecycle
型の凡例付きの Architecture。同じギャラリーに Sequence、Data Flow、Lifecycle も並びます。動画の 0:55 へ
実際に一度走らせ、レポートを読む
- 5
一文で依頼し、検証レポートを一行ずつ読む
録画でのプロンプトは「Archify 生成这个项目的架构图」の一文だけ。所要 2 分 44 秒で、成果物を 2 つ返しました——図の HTML と図の仕様です。その上に通過必須のチェックが並びます：diagram_type: architecture、validation: 9/9 showcase, 0 errors, 0 warnings、visual_review: passed、そして 1440×900、1600×1000、1920×1080、2048×1320 の 4 種類のデスクトップサイズではみ出しなし。セッションは specification_sha256 と artifact_sha256 も出力し、diff カウンターは仕様が +52 行、削除 0 行で編集されたことを示しています。
diagram_type: architecturevalidation: 9/9 showcase, 0 errors, 0 warningsvisual_review: passed桌面尺寸: 1440×900 · 1600×1000 · 1920×1080 · 2048×1320 均无溢出
2 分 44 秒と一文で、一行ずつ読めるレポートが返ってきます。動画の 1:24 へ - 6
ガイド付きチャプターを歩いて、図の主張を確かめる
生成された HTML には作者が書いたガイド付きチャプターが同梱されています。3/3 の「WorkFlow 执行」は 5 つの停車点を順にたどります——Workflow Runtime、Child Session、Tool Surface、Runtime Evidence、Project Workspace——倍率は 145%。各ノードには固有の事実ラベルが付きます。Child Session は in-process · bounded tools · fail-closed、Tool Surface は ordinary · package tools、Workflow Runtime は graph · runner · journal、Runtime Evidence は journal · artifacts · receipts。静的レンダリングでは得られない層です。ページ内の凡例はバックエンド 5、データベース 1、セキュリティ境界 1、外部システム 1 と集計しています。
引导视图 3 / 3 · WorkFlow 执行01 Workflow Runtime → 02 Child Session → 03 Tool Surface → 04 Runtime Evidence → 05 Project Workspace
ガイド付きチャプターが図を解説の動線に変え、各ノードは固有の事実ラベルを保ちます。動画の 2:06 へ - 7
成果物をワークスペースに残し、パスを聞き返す
成果物の最後に並ぶ 3 枚のカード——Pi-native composition、Runtime authority、Evidence boundary——は、権限がどこで止まり、どこからが証拠なのかを図自身が宣言したものです。session、モデル、スキル、信頼、通常のツールは Pi が持ちます。子セッションは文脈を継承し、fail-closed のツール交差を受け取ります。完了は UI のラベルではなく終端の証拠で確定します。dsh ではバンドルの制限も覚えておきましょう。シェルコマンドが作ったファイルは Web Produced Files の帯には自動で出ません。そこで最後に、仕様 JSON と HTML 成果物の正確なワークスペースパスを返すよう agent に依頼します。
After delivery, return the exact workspace paths of the specification JSON and the HTML artifact.
成果物が自ら線を引いています。ランタイムが持つもの、そして証拠と見なせるもの。動画の 2:13 へ
まず Mermaid、レビューに耐える図なら archify
両者は競合ではなく、archify のリポジトリはこの境界をかなり率直に書いています。
- ▸Mermaid はその場でレンダリングし、コストはコードブロック 1 つ。捨てる前提のスケッチや、一度読めば済むシーケンスに向きます。
- ▸Mermaid の出力はレンダリング結果です。ノードは押せず、名前付きパスはたどれず、出典ポインタは開けず、「この成果物は再現可能」と書かれたレポートを渡すこともできません。
- ▸archify 自身がこう書いています——'Archify is not a general-purpose drawing editor or a Mermaid theme'。Mermaid の自動解析も明確に対象外とされています。
- ▸代わりに得られるのは別の受け渡し契約です。型付き JSON IR、schema・レイアウト・HTML/SVG・経路・ラベルと経路の間隔にわたる原子的な検証、そして検査に落ちたときの機械可読な修正レポート。
- ▸実用的な分担はこうです。会話の中の図は Mermaid、デザインレビューや障害の振り返り、新入りの資料に載る図は archify。
よくある質問
この映像が実際に呼び起こす疑問に、リポジトリと npm レジストリの確認結果で答えます。
DSH に公式のアーキテクチャ図プラグインはありますか？
ありません。dsh 側の経路はコミュニティのオプトインで、@tt-a1i/archify-dsh@0.1.0 として公開されています。README には DeepSeek 公式製品ではなく推奨も意味しないと明記され、developer-preview の @deepseek-ai/dsh@0.1.0-rc.6 を対象に Archify Skill 2.14.0 を同梱しています。別系統のサードパーティ移植 GongYuanCaiJi/dsh-archify は 2026 年 8 月に現れ、tt-a1i/archify からの移植だと述べています。どちらも同じスキルの外側のアダプタです。
この動画は DeepSeek Harness で archify を動かしているのですか？
いいえ。写っているのは GitHub のリポジトリページ、archify の公式サイト、分割画面の agent IDE セッションで、dsh の Web 画面は一度も出てきません。示しているのはスキルの出力と作者のワークフローであり、dsh のセッションではありません。本ページのコマンドはすべてリポジトリの README か npm レジストリに基づき、2026-09-27 に確認しています。
既存の Mermaid 図をインタラクティブな成果物に変換できますか？
自動ではできません。Mermaid の自動解析は対象外だとリポジトリが明記しており、.mmd の取り込み経路はありません。同じシステムを文章で説明し、そこから agent に型付き仕様を書かせることはできます。
「validation: 9/9 showcase, 0 errors, 0 warnings」は何を証明するのですか？
成果物が作者の書いた仕様と一致し、同梱の schema・レイアウト・レンダリング・経路・ラベルと経路の間隔の検査を 4 種類のデスクトップ幅で通過したことを証明します。だからこのファイルは再現可能で、安心して転送できます。ただしアーキテクチャ自体が正しいことの証明ではありません。図はあなたや情報源の説明から作られ、こうした成果物は稼働中のインフラを調査しないとリポジトリも述べています。
関連ガイド
最初の検証済みの図を描いたあとに読むもの。
先に入れたい DSH スキル
archify と組み合わせやすい短いリスト。各スキルが実際に何を返すのか、agent が既定で選ぶのはどれか。
ガイドを読むDSH のチャットで生 HTML をレンダリングする
レンダリングされた HTML カードが dsh の会話でどう振る舞うか。生成された成果物が隣り合う層です。
ガイドを読むCoding workbench コレクション
セッションを実際の開発環境に変えるプラグインとスキルのまとまり。
ガイドを読む自分の DSH プラグインを作る
このワークフローを、毎週打ち直すプロンプトではなくインストールできるプラグインとしてまとめる。
ガイドを読むスキル作成ガイド
SKILL.md をきちんと書けば、同じ説明を繰り返さなくても agent がこの手順を再現します。
ガイドを読む出典とクレジット
映像は下にクレジットした Bilibili の 1 本で、各ステップは該当秒へ深くリンクしています。本ページのコマンドと数値はすべて 2026-09-27 に github.com/tt-a1i/archify、その integrations/deepseek-harness README、npm レジストリで確認しました。録画内の GitHub ページが 19.1k スターなのは、プロジェクトのより早い段階で収録されたためです。スキルという形式に初めて触れる方は スキル作成ガイド