デザイン&モーション · nexu-io/html-anything

deck-tech-sharing

GitHub-dark + JetBrains Mono + ターミナルコードブロック、アジェンダ + Q&A 付属

L3 ネットワーク · ドメインとキー範囲を宣言V1 コミット固定ネットワーク通信Dual-pass Audit
Author nexu-ioGitHub nexu-io/html-anything ↗Stars 8827License Apache-2.0(工作副本根目录 LICENSE 文件 = Apache License Version 2.0;GitHub API spdx_id=Apache-2.0。注意:skill 目录本身不含独立 LICENSE,许可来自仓库根;第三方来源模板在 README 另有署名说明)Commit 553ed98c28
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

本スキルは html-anything の「テンプレートパッケージ」です。frontmatter はセレクターがメタデータを取得するために使用され、SKILL.md 本文(frontmatter 以降の body)は loader によってそのまま読み出され、モデルへの指示として渡されます。

next/src/lib/templates/loader.ts
const { fm, body } = parseFrontmatter(raw);
本テンプレートの本文は 24 行 / 597 バイト(本バッチ 9 テンプレート中最も短い)です。frontmatter は parseFrontmatter により fm/body の 2 つに分割され、ディレクトリ内にはスクリプトが一切関与しません。

モデルに実際に送信される prompt = 共有設計指示 + 本テンプレート本文 + 【入力形式】 + 【ユーザーコンテンツ】となります。共有指示にはオーバーライド規則も含まれており、テンプレート内のページ数やレイアウト数は上限ではないことが宣言されています。

next/src/lib/templates/shared.ts
return `${SHARED_DESIGN_DIRECTIVES} ${opts.body.trim()}
同一ファイル内で直後に続くオーバーライド規則には一語一句違わず記載されています:テンプレートは「利用可能なレイアウト / スタイル / 配色 / フォント / コンポーネントライブラリ」のみを定義し、スライド / フレーム / カード / セクションの数は**定義しません**。

成果物の規律は共有指示によって厳密に制約されます。エージェントがファイルシステムツールを使用することは禁止されており、HTML は stdout 経由のテキストストリーミングで出力され、フロントエンド側でディスクに保存される必要があります。

next/src/lib/templates/shared.ts
- **禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何
本テンプレート自体はディスク保存方式を宣言しておらず、完全にこの共有制約に依存しています。

発表の流れは「Cover → Agenda → 本文複数 → Demo → Q&A」の 5 段構成で整理され、本文ページはコードブロック + キーポイントを中心に構成されます。

next/src/lib/templates/skills/deck-tech-sharing/SKILL.md
- 正文页若干 (代码块 + 关键观点)
同セクションには「- Demo ページ (ターミナルスクリーンショット)」や「- Q&A ページ」も含まれており、技術トークの典型的な構成要素が標準化されています。

ビジュアルトーンは GitHub-dark 配色 + JetBrains Mono 等幅フォントをベースとし、コードの可読性を最優先しています。

next/src/lib/templates/skills/deck-tech-sharing/SKILL.md
- GitHub-dark 配色 + JetBrains Mono
表紙ページにはアジェンダ名 + 登壇者 + ハンドルネームを明記することが要求され、カンファレンストークの署名慣例に準拠しています。

CLI キーワードルーティング:tech / sharing / 技术分享 / tech talk → deck-tech-sharing。

cli/src/skills-matcher.ts
[["tech", "sharing", "技术分享", "tech talk"], "deck-tech-sharing"],
同一テーブルの「博客/post/文章」は article-magazine にマッピングされており、「技術コンテンツ」がジャンルに応じて異なるテンプレートへ振り分けられることを示しています。

ページコンテナはリポジトリ全体の deck 規約に準拠しています。example.html の 8 つの section はすべてクラス名に slide を含んでおり、ホストのエクスポートパイプラインに適合します。

next/src/lib/export/deck.ts
/** Export the deck as a multi-slide PPTX. Each slide goes in as a full-bleed PNG. */
PDF/PNG/PPTX へのエクスポートはホスト側の機能(export/deck.ts)であり、本スキルは規約に準拠した HTML を出力することのみを担当します。

2コア機能

01技術トークの 5 段構成:Cover(アジェンダ + 登壇者 + ハンドル名)→ Agenda → 本文ページ複数 → Demo → Q&A
02エンジニアリング共有の情報形態に適した、コードブロック + キーポイント主体の本文ページ
03口頭での補足ではなく構成として組み込まれた、ターミナルスクリーンショット枠付き Demo ページ
04締めくくりの Q&A ページ
05コードの可読性を最優先する GitHub-dark 配色 + JetBrains Mono 等幅フォント
06CLI キーワードルーティング:tech / sharing / 技术分享 / tech talk → deck-tech-sharing
07ホストのエクスポートパイプライン(PDF / PNG zip / 複数ページ PPTX)に対応する、リポジトリ全体の deck 規約に準拠したページコンテナ

3外部依存関係

KindDependency / Endpoint
cli宿主本机 agent CLI(应用侧 spawn;非本 skill 指令)
networkGoogle Fonts(产物示例引用,非 skill 正文要求)

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
アクセス可能ドメインとキー範囲を宣言
管理者向け
最小権限のキー、リクエストログを保持
判定根拠(ファイルパスと抜粋)
  • 网络端点: 外部ネットワークアクセスの宣言:example.html 内に複数の fonts.googleapis.com フォント @import(JetBrains Mono 含む)が存在。リモート <sc はなし
監査ノート: 。判定対象=スキルディレクトリ(SKILL.md + example.html):実行可能スクリプトなし、クレデンシャル読み取りなし、ディスク書き込み指示なし。SKILL.md 本文には URL なし、CDN/インターフェース要件なし(構成リストと「GitHub-dark 配色 + JetBrains Mono」のフォント/配色指定のみ)。ディレクトリ内エンドポイントの自己証明:example.html の複数の fonts.googleapis.com @import(生成物での参照)。本リポジトリの html-anything テンプレートはバッチ 4 の基準に基づき一律 🟢 グリーン判定:判定対象=スキル自身のディレクトリ。ホストシェル(loader.ts/assemblePrompt/ローカルエージェント CLI/プレビュー iframe)および example.html 内のフォントや CDN の参照は生成物フェーズの動作(ブラウザが取得し、スキル実行時には外部送信されない)であり、reason/risks にのみ記載し格付けには影響しません。

5二重目の独立検証

  • [ok] 文件清单(2 个文件,无脚本) — SKILL.md(597B) + example.html(30407B)。
  • [ok] 正文零端点复核 — SKILL.md 内 http/CDN/fetch/script 零命中(JetBrains Mono 是字族名不是 URL)。
  • [ok] 目录内端点自证 — example.html: 多条 fonts.googleapis.com @import(含 JetBrains Mono);无远程 script、无 fetch/XHR。
  • [ok] 无凭证读取 — key/secret/token/.env 零命中。
  • [ok] 无写盘指令 — SKILL.md 无 write/save 类指令;shared.ts 明令禁文件工具。
  • [ok] 五段结构逐条可复核 — Cover(议题+讲者+handle) / Agenda / 正文页若干(代码块+关键观点) / Demo(terminal 截图) / Q&A 全在正文。
  • [ok] official_desc 逐字命中 — 与第 6 行 description 引号内文本一致。
  • [ok] CLI 路由行存在 — cli/src/skills-matcher.ts 第 74 行 tech-sharing 行逐字命中。

6結論

  • エンジニアリング共有に最も適した構成:アジェンダ、コードページ、Demo、Q&A の 4 点セットが揃っており、発表者が自身で構成を補う必要がありません。
  • 等幅フォント + コードブロック優先で、コードの可読性を第一級の設計目標としています。
  • 本文が極めて短く(597 バイト)、生成コストが低く、テンプレートがコンテンツを阻害しません。
  • 中国語トリガーワード(技术分享)と英語(tech talk)の両方を備え、直感的なルーティングが可能です。
  • 最適な用途: 社内技術共有、カンファレンストーク、コードレビューのオープニング、新規フレームワークの紹介に最適:アジェンダ + コードページ + Demo + Q&A の標準構成を必要とし、ダークテーマの開発者向けデザインを好む用途。
    不向きな用途: 明るい環境での投影や印刷を必要とする場面(ダークテーマ基調のみ);コードを扱わない共有テーマ(等幅フォントとコードブロックが無駄になるため、deck-swiss-international や deck-simple を推奨);発表者原稿(逐字録)を必要とするプレゼンテーション(aside.notes の仕組みがありません)。
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload deck-tech-sharing.tar.gz
    sha256: 0f3b5b26571a3c37…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 553ed98c28.