1仕組みと動作原理
本スキルはhtml-anythingの「テンプレートパック」です。frontmatterはセレクターがメタデータを取得するために使用され、SKILL.md本文(frontmatter以降のbody)はloaderによってそのまま読み出され、モデルへのプロンプト指示として渡されます。
const { fm, body } = parseFrontmatter(raw);
モデルに実際に送られるプロンプト = 共通デザイン指示 + 本テンプレート本文 + 【入力形式】 + 【ユーザー入力内容】。共通指示には、テンプレート内のページ数やレイアウト数は上限値ではないことを宣言するオーバーライド規則も含まれます。
return `${SHARED_DESIGN_DIRECTIVES} ${opts.body.trim()}
出力規律は共通指示によって厳格に制限されます。エージェントによるファイルシステムツールの使用は一切禁止されており、HTMLはstdoutテキストストリームとして出力され、フロントエンド側でディスクに保存されます。
- **禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何
コアメカニズムは「固定キャンバス + 自由レイアウト」です。全ページを1920×1080に強制し、transform: scaleでビューポートに適応させることで、ページ内レイアウトの完全な自由度を確保しています。
- 画布: 每页严格 `width: 1920px; height: 1080px;` 用 `transform: scale(...)` 适配视窗 (默认 `scale(0.7)` 居中)。
「単一の視覚的重心」によって自由度を適切に統制:テンプレートを強制しない一方で、各ページに許容される視覚的重心は1つのみとし、同等な重みを持つ2つのテキストブロックの並列を禁止しています。
- 但每页**必须遵守一条规则**: 视觉重心 (visual hierarchy) 只有 1 个 — 一句金句、一个数字、一张图, 不要"什么都强调"。
配色とタイポグラフィは列挙値に厳格制限:4種類のカラーパレットから1つを選択して全体で一貫適用、フォントサイズは固定の10段階type scale、余白は96/128/160の3段階のみを使用します。
【调色板 — 每个 deck 选 1 套, 全程不改】
ページコンテナはリポジトリ全体のdeck規約である `<section class="slide" data-slide-id="N">` に従うよう規定されており、アプリ側のdeck.tsがこれに基づいてHTML全体をページごとのスクリーンショット用個別ドキュメントに分割します。
<section class="slide" data-slide-id="N">
真正の上流と同一のソース元:テンプレート自身に「Inspired by 1weiho/open-slide」と記載され、frontmatterに出典を示すexample_source_urlを持ち、READMEのサードパーティソース表にも同期登録されています。
example_source_url: "https://github.com/1weiho/open-slide"
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | 宿主本机 agent CLI(Claude Code / Codex / Cursor / Gemini 等,由 html-anything 侧 spawn;非本 skill 指令) |
| network | Tailwind CDN(本 skill 正文点名的产出物交付方式;产物渲染时由浏览器拉取) |
| network | Google Fonts(产物示例引用,非 skill 正文要求) |
| network | 出处置标(frontmatter 元数据,非运行时调用) |
4推奨統制措置と判定根拠
- 网络端点: 外部ネットワークアクセスの宣言: example.htmlにリモートスクリプトタグ <script src="https://cdn.tailwindcss.com"> およびGoog
5二重目の独立検証
- [ok] 文件清单(3 个文件,无脚本) — SKILL.md(2930B) / example.md(192B) / example.html(2317B);无 .sh/.py/.js/.mjs/.ts,目录内无可执行代码。
- [ok] 目录内端点与档位依据 — SKILL.md:53「单文件 HTML; Tailwind CDN; 不要外链图片。」= 正文唯一 CDN 字样(端点 URL 见 example.html);example.html 另有 fonts.googleapis.com 字体 @import 与 frontmatter 的 github.com/1weiho/open-slide 出处置标——均属产物引用/元数据,不判级。
- [ok] 无凭证读取 — 目录内 key/secret/token/.env/keychain 全部零命中。
- [ok] 无写盘指令 — 目录内 write/save/append 零命中;共享指令反而明令禁止文件系统工具。
- [ok] 画布硬规格可复核 — SKILL.md 逐字含 1920px/1080px、transform: scale、默认 scale(0.7)、禁止 overflow 四条。
- [ok] 10 级字号表与 4 套调色板可复核 — 字号表 2xs:18 … 5xl:220 与 Ash & Lime / Sea Indigo / Mate Mocha / Pearl Rose 四套 hex 均在正文逐字存在。
- [ok] frontmatter 与 loader 读取面一致 — featured/recommended/example_* 等字段都在 loader.ts 白名单 case 内,可被 fmToMeta 读成选择器元数据。
- [ok] official_desc 逐字命中 — meta.official_desc 取自 SKILL.md 第 6 行 description 引号内原文,未改写。
6結論
993c6c72c87e99e3…