1仕組みと動作原理
本スキルは html-anything の「テンプレートパッケージ」です。frontmatter はセレクターがメタデータを取得するために使用され、SKILL.md 本文(frontmatter 以降の body)は loader によってそのまま読み出され、モデルへの指示として渡されます。
const { fm, body } = parseFrontmatter(raw);
モデルに実際に送信される prompt = 共有設計指示 + 本テンプレート本文 + 【入力形式】 + 【ユーザーコンテンツ】となります。共有指示にはオーバーライド規則も含まれており、テンプレート内のページ数やレイアウト数は上限ではないことが宣言されています。
return `${SHARED_DESIGN_DIRECTIVES} ${opts.body.trim()}
成果物の規律は共有指示によって厳密に制約されます。エージェントがファイルシステムツールを使用することは禁止されており、HTML は stdout 経由のテキストストリーミングで出力され、フロントエンド側でディスクに保存される必要があります。
- **禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何
発表の流れは「Cover → Agenda → 本文複数 → Demo → Q&A」の 5 段構成で整理され、本文ページはコードブロック + キーポイントを中心に構成されます。
- 正文页若干 (代码块 + 关键观点)
ビジュアルトーンは GitHub-dark 配色 + JetBrains Mono 等幅フォントをベースとし、コードの可読性を最優先しています。
- GitHub-dark 配色 + JetBrains Mono
CLI キーワードルーティング:tech / sharing / 技术分享 / tech talk → deck-tech-sharing。
[["tech", "sharing", "技术分享", "tech talk"], "deck-tech-sharing"],
ページコンテナはリポジトリ全体の deck 規約に準拠しています。example.html の 8 つの section はすべてクラス名に slide を含んでおり、ホストのエクスポートパイプラインに適合します。
/** Export the deck as a multi-slide PPTX. Each slide goes in as a full-bleed PNG. */
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | 宿主本机 agent CLI(应用侧 spawn;非本 skill 指令) |
| network | Google Fonts(产物示例引用,非 skill 正文要求) |
4推奨統制措置と判定根拠
- 网络端点: 外部ネットワークアクセスの宣言:example.html 内に複数の fonts.googleapis.com フォント @import(JetBrains Mono 含む)が存在。リモート <sc はなし
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結論
0f3b5b26571a3c37…