1仕組みと動作原理
本テンプレートは「フォルダ=テンプレート」構造における純粋なデータです。SKILL.mdはセレクター用のYAML frontmatterを持ち、本文はエージェント向けのレイアウト指示文です。リポジトリはテンプレート個別のコードを持たず、テンプレートの追加=フォルダの追加となります。
SKILL.md — frontmatter (id, scenario, tags, …) + prompt body
実行時はホストが本テンプレートの本文を共有デザイン指示とユーザーコンテンツの間に挟み込んで1つのプロンプトを構築します。テンプレートの「インテリジェンス」はこの自然言語の中にのみ存在し、実行可能コードは一切ありません。
return `${SHARED_DESIGN_DIRECTIVES} ${opts.body.trim()}
ホストの/api/convertが本テンプレートをロード後、これらのテキストをローカルでログイン済みのcoding-agent CLIに渡し、stdoutのみをHTMLとしてストリーミング回収します。テンプレート自体は通信を行わず、認証情報を読み取らず、ファイルを書き込みません。
prompt = assemblePrompt({ body: skill.body, content, format });
テンプレートに付属するexample.htmlは「事前レンダリングされたサンプル」であり、プレビューAPIからそのまま出力されてセレクターやギャラリーのiframeに読み込まれます。テンプレートカードのプレビュー表示を決定するものであり、コンテンツ生成には関与しません。
Returns the skill's `example.html` verbatim so it can be loaded into an
frontmatterの各フィールドはセレクターのメタデータへとマッピングされ(featuredは全体ソート、recommendedはトップの「★ おすすめ」枠、example_*はサンプルカードのテキストを生成)、カテゴリやシナリオフィルターでの表示位置を決定します。
if (typeof fm.featured === "number") meta.featured = fm.featured;
本テンプレートの生成能力はすべて自身の本文によって実現されます。social-media-dashboard/SKILL.mdはレイアウト、配色、フォント、コンテンツ規律のみを記述しており、エージェントにツールの実行、API呼び出し、外部データの取得を指示する文は一切ありません。
【模板: 社媒创作者仪表板】
本文はダッシュボードの固定セクションを規定します:プラットフォームswitcher、KPI、成長曲線、Top post、サイドバーのトレンド/コメント。
【意图】面向博主 / 创作者的社媒数据看板。
プラットフォームswitcherはX / LinkedIn / YouTube / Instagram / TikTokの5プラットフォームを列挙し、「同一ダッシュボードでデータソースを切り替えて再利用する」ことを要求します。
- 顶部平台 switcher (X / LinkedIn / YouTube / Instagram / TikTok)
KPIグループはfollowers / engagement / likes / repostsの4つのソーシャル指標に限定されています。
- KPI 卡片 (followers / engagement / likes / reposts)
サンプル成果物はインラインJSを使用してプラットフォームの切り替えと全画面の再描画(ヒーロー、KPI、チャート、Top post、ハイライト状態の切り替え)を実現しています。
function switchPlatform(platform) {
チャートは静的画像ではありません。サンプルではJSを使用してSVG折れ線/エリアグラフを動的に生成し、アノテーションポイントもスクリプトで生成されます。
const line = document.createElementNS('http://www.w3.org/2000/svg', 'polyline');
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| network | Google Fonts(仅出现在产物示例 example.html) |
| network | 第三方头像图床(仅出现在产物示例 example.html 的内联脚本数据里) |
| cli | 本地 coding-agent CLI(宿主提供,模板自身不调用) |
4推奨統制措置と判定根拠
- scripts/: ローカルスクリプトまたはコマンドの実行: example.html内のインライン<script>(ブラウザ側:プラットフォーム切り替え、KPIフォーマット、SVG折れ線/エリア描画、コントリビューターグリッド)— セレクタープレビューのifra内でのみ実行
- 网络端点: 外部ネットワークアクセスの宣言: fonts.googleapis.com(example.htmlの<link>、プレビュー時にブラウザがフォントをリクエスト)
5二重目の独立検証
- [ok] skill 目录的脚本 / 网络 / 凭证 / 写盘面 — 目录仅 SKILL.md / example.html 2 个文件,无 scripts/references/数据目录;token 扫描(curl / wget / fetch / exec / spawn / process.env / API_KEY / token / secret / write / save / delete)在该目录的 SKILL.md 中零命中;无自带可执行脚本。
- [ok] 运行时链路复核 — 重读 loader.ts / shared.ts / app/api/convert/route.ts / app/api/templates/[id]/preview/route.ts:模板正文只作为 prompt body 被 assemblePrompt 拼装,宿主 spawn 本地 CLI 并捕获 stdout;模板不参与任何执行。
- [ok] commit 与元数据 — 工作副本 git HEAD = 553ed98c283f9c0f489902d035416a972d6a9699(=任务表 pin 的 full 40 位);GitHub API nexu-io/html-anything:stars 8827、license spdx Apache-2.0、pushed_at 2026-09-15T03:36:24Z(与本地 HEAD 提交时间 2026-09-15 11:36:24 +0800 一致)。
- [discrepancy] README 与源码的 frontmatter schema 漂移(仓库级) — README 第 213 / 217 / 468 行称模板 frontmatter 必须含 mode · scenario · surface · preview · design_system;但在 next/src/lib/templates/skills/ 下 '^mode:'、'^surface:'、'^design_system:' 全部零命中,实际字段是 category / scenario / aspect_hint / featured / recommended + example_*(loader.ts 的 SkillFrontmatter)。文档滞后于代码,不影响本模板运行,但照 README 新写模板会踩空。
- [ok] frontmatter 元数据映射 — loader.ts fmToMeta 逐字段映射 zhName / enName / emoji / description / category / scenario / aspectHint / tags + featured / recommended + example 卡;本模板取自 SKILL.md 的实际取值与之相符。
- [discrepancy] example.html 与 SKILL.md 的一致性(平台数量) — 正文写 '- 顶部平台 switcher (X / LinkedIn / YouTube / Instagram / TikTok)',示例 HTML 只渲染两个按钮(data-platform="x" 与 data-platform="github");内联 platformData 里确有 x/linkedin/youtube/instagram 四套数据,GitHub 走贡献者分支。只看示例会以为平台只有两个。
- [discrepancy] 外部图片 URL 与仓库共享指令相左 — shared.ts 的共享指令要求「不要引用任何外部图片 URL」,但本模板的 example.html 把 5 个 GitHub 头像写成 https://avatars.githubusercontent.com/u/… 绝对地址并在 <img src> 里加载,是该产物唯一会向第三方图床发请求的地方(作为示例产物可接受,但用户直接复用示例时会带上外部依赖)。
- [ok] 端点扫描(目录内) — 2 类端点:fonts.googleapis.com(Space Grotesk / Inter)与 avatars.githubusercontent.com(5 个头像);无 Tailwind CDN;SKILL.md 正文零 URL。
6結論
5c0986485a0bc508…