1仕組みと動作原理
本 skill は html-anything の「テンプレートパッケージ」です。frontmatter はセレクターがメタデータを取得するために使用され、SKILL.md 本文(frontmatter 以降の body)は loader によってそのまま読み出され、モデルへの指示として機能します。
const { fm, body } = parseFrontmatter(raw);
実際にモデルへ送られるプロンプト = 共通デザイン指示 + 本テンプレート本文 + 【入力フォーマット】 + 【ユーザーコンテンツ】です。共通指示には、テンプレート内のページ数やレイアウト数が上限ではないことを宣言する上書きルールも含まれます。
return `${SHARED_DESIGN_DIRECTIVES} ${opts.body.trim()}
出力規律は共通指示によって厳格に制約されます。agent によるファイルシステムツールの使用は禁止されており、HTML は stdout テキストストリームとして出力され、フロントエンド側でディスクに保存される必要があります。
- **禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何
警告セマンティクスは「45° hazard ストライプ + 取り消し線見出し」の二重シンボルによって実現されます。ストライプが上下を占有し、見出しは取り消し線によって「否定 / 却下」を表現します。
- 顶/底 45° 红黑 hazard 条纹
重要度レベルは L1/L2/L3 の 3 色 tier カードで表現されます。緑 / アンバー / 赤がそれぞれ対応し、リスクレベルを素早く読み取れるカードに仕立てています。
- L1/L2/L3 绿 / 琥珀 / 红 tier 卡片
Policy as Code シナリオは policy-yaml コードブロックで表現されます。左側の赤いボーダー + bad キーワードのハイライト表示が特徴です。
- policy-yaml 代码块 (红左边框 + bad 关键词高亮)
CLI キーワードルーティング: safety / alert / 安全 / 告警 / warning → deck-safety-alert。
[["safety", "alert", "安全", "告警", "warning"], "deck-safety-alert"],
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | 宿主本机 agent CLI(应用侧 spawn;非本 skill 指令) |
| network | Google Fonts(产物示例引用,非 skill 正文要求) |
| network | SVG 命名空间 URI(非网络端点) |
4推奨統制措置と判定根拠
- 网络端点: 外部ネットワークアクセスの宣言: example.html 内で fonts.googleapis.com フォントの複数の @import および SVG 名前空間 http://www.w3 が検出されました。
5二重目の独立検証
- [ok] 文件清单(2 个文件,无脚本) — SKILL.md(705B) + example.html(27352B)。
- [ok] 正文零端点复核 — SKILL.md 内 http/CDN/fetch/script 零命中。
- [ok] 目录内端点自证 — example.html: fonts.googleapis.com(多条 @import)+ http://www.w3.org/2000/svg(SVG 命名空间,无请求)。
- [ok] 无凭证读取 — key/secret/token/.env 零命中。
- [ok] 无写盘指令 — SKILL.md 无 write/save 类指令;shared.ts 明令禁文件工具。
- [ok] 6 条版式元素逐条可复核 — hazard 条纹 / 删除线标题 / L1-L2-L3 tier 卡 / 圆点 alert box / policy-yaml 代码块 / checklist + 堆叠柱状图 全在正文。
- [ok] 样例产物符合 deck 约定 — example.html: 8 个 <section>、8 处 class 含 slide、无 data-slide-id(id 回退为序号)。
- [ok] official_desc 逐字命中 — 与第 6 行 description 引号内文本一致。
6結論
e4a5a22db95ff0b0…