1仕組みと動作原理
テンプレート本体に実行可能コードは含まれません:loaderがsrc/lib/templates/skills/<id>/SKILL.mdからfrontmatterと本文を読み込み、本文(body)とexampleの内容をまとめてLoadedSkillとして返します。
const raw = safeRead(path.join(dir, "SKILL.md"));
ホストは配信前にプロンプトを固定順で組み立てます:テンプレート本文は共通デザイン指示(SHARED_DESIGN_DIRECTIVES)と【入力形式】/【ユーザーコンテンツ】の間に挟まれます。
Wrap a per-template instruction body with the shared design directives and
共通指示はハード制約をエージェントへの明示的な禁止事項として記述し、コンテンツ主導の枚数決定を強制します(テンプレート内の数値は参考下限値に過ぎません)。
**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。
実際に実行するのはユーザーのローカル環境にインストール・ログイン済みのコーディングエージェントCLIです:ホストが子プロセスをspawnしてプロンプトを渡し、HTMLをstdoutからストリーミングでキャプチャします。
import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
/api/convertはテンプレートの実行パスです:skill.bodyとユーザーコンテンツをプロンプトに組み立てた後、invokeAgentに渡します。
prompt = assemblePrompt({ body: skill.body, content, format });
出力は同一サイズのN枚のカードからなる垂直flexカラムであり、1枚あたり1080×1440(3:4)で、全体のスクロールキャプチャと単票ごとのスクリーンショットの双方に対応します。
- 输出 N 张连续卡片, 每张 `w-[1080px] h-[1440px]`, 用 flex 纵向排列方便整体截图也方便单张截图。
枚数はコンテンツの情報量に応じて決定され、プラットフォーム側の上限と目安の範囲が提示されます(最大18枚、通常は9枚以内が最適、短いコンテンツは3〜6枚から開始、1枚につき1つのコアメッセージ)。
N 由【用户内容】信息量决定: 短内容 3-6 张起步
カードシーケンスは明確なナラティブ構造を持ちます:カバーカード(巨大なタイトル + 1行のサブタイトル + 目を引くバッジ)、中間カード(各1つのコアメッセージ:絵文字 + 短文 + 1〜2の具体例)、最終カード(まとめ + CTA)。
- 最后一张是总结 + 行动号召 (关注 / 收藏 / 评论)。
モバイルでの可読性が必須要件として指定されています:大きなフォントサイズ、広い行間、強いコントラスト。理由は小紅書がスマートフォンで閲覧されるためです。
- 字号大、行距宽、对比强(小红书在手机上看, 小字根本看不清)。
各カードの右下にウォーターマーク(作成者名/日付)が入り、サンプルでは@HTMLAnything + ページ番号の形式で実装されています。
- 每张卡片右下角小水印 (作者名 / 日期)。
カラーパレットと要素スタイルは、柔らかなモランディ/パステルトーン、丸みを帯びた要素、十分な余白に限定されており、サンプルでは一連のグラデーション背景によって実現されています。
- 配色: 选择柔和的莫兰迪色或粉色系; 元素圆润, 大量留白。
2コア機能
4推奨統制措置と判定根拠
- SKILL.md: 純粋なプロンプト指示およびルール記述テキストのみであり、スクリプト実行や外部影響はありません
5二重目の独立検証
- [ok] 张数一致性(输入分节 ↔ 输出卡数) — example.html 中 class="card" 出现 7 次,与 example.md 的封面 + 5 个观点卡 + 总结一致;SKILL.md 的「3-6 张起步 / 通常 9 张以内最佳」是区间指导,示例 7 张落在区间内。
- [ok] 封面徽标与结尾 CTA 是否落实 — 封面卡含「⚡ 建议收藏 · 干货预警」标签(对应吸引人的标签),末卡含「关注」「收藏」按钮样式(对应行动号召),均可逐字定位。
- [ok] 水印要求落地 — 7 张卡各有一个 .watermark 元素;封面带页码「@HTMLAnything · 5/11」,符合水印位(作者名 / 日期页码)设计。
- [ok] 端点与判级 — 目录内 http(s) 仅 cdn.tailwindcss.com 与 fonts.googleapis.com(产物期引用);SKILL.md 正文无端点要求,执行期零外发,维持 green。
- [ok] license / stars / commit 元数据 — GitHub API(api.github.com/repos/nexu-io/html-anything):spdx_id=Apache-2.0、stargazers_count=8827、pushed_at=2026-09-15T03:36:24Z;工作副本 git HEAD = 553ed98c283f9c0f489902d035416a972d6a9699(与任务表 pin 553ed98c283f 同源)。
- [ok] skill.path 与目录资产面 — pin 目录内该路径存在且含 SKILL.md;目录内文件清单已用 glob 全量核对(含隐藏文件),无 scripts/、无 references/、无二进制资产(competitive-teardown 的 assets/ 为纯 HTML,另行记录)。
6結論
f54e465c136dc217…