1仕組みと動作原理
このskillは実行可能プログラムではなく、ローカルのcoding-agent CLIに注入されるプロンプトです。ホストがSKILL.md本文を取得し、前にサイト全体の共通デザイン指示を付加し、後ろにユーザーコンテンツを連結してプロンプトを構築し、ログイン済みagentに渡して、agentのstdoutをHTMLとして取得します。
【输入格式】: ${opts.format} 【用户内容】: ${opts.content}
共通指示レイヤー（単一のskillには属さず、全テンプレートの上に被さる）は出力を「自己完結型シングルファイルHTML」に固定し、agentによるWrite/Edit/Bashなどのファイルシステムツールの使用を明示的に禁止し、HTMLは対話テキストとして直接ストリーミング出力されます。
- **禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何 \`.html\` 文件里。前端直接捕获你的 stdout 文本, 文件落盘由前端负责。
SKILL.mdの外側には「コンテンツ駆動の数量」オーバーライドルールが存在します。テンプレートに記載されたページ数／フレーム数／カード数はすべて参考下限値とみなされ、実際の数量はユーザーコンテンツによって決定されます。これによりagentがテンプレートの数字に合わせてユーザーコンテンツを圧縮するのを防ぎます。
- 模板只定义"可用版面 / 风格 / 配色 / 字体 / 组件库", **不定义** slide / 帧 / 卡片 / section 的数量。
読み込み規約は「1 skill = 1 フォルダ」です。SKILL.md（セレクター用YAML frontmatter + テンプレートプロンプト本文）、任意のexample.md（サンプル入力）およびexample.html（直接ブラウザ表示可能なプレビュー見本）で構成され、TSコードを変更せずにディレクトリ追加のみで新規テンプレートを追加できます。
* SKILL.md — frontmatter (id, scenario, tags, …) + prompt body * example.md — (optional) sample input content * example.html — (optional) pre-rendered preview, shown inline in the picker
選択パイプライン（CLI側）は3段階のファネルです。キーワードの強シグナル（1語一致につき2点、閾値3）→ tags/scenarioによるスコアリングへのフォールバック → それでも判定できない場合はユーザーコンテンツの先頭800文字をローカルagentに渡し、一文分類を実行します。
const CONFIDENCE_THRESHOLD = 3;
プレビューパイプラインは生成から独立しています。/api/templates/<id>/preview はexample.htmlをそのままtext/htmlとしてiframeに返します。フロントエンドのiframeはsandbox="allow-scripts allow-same-origin"を使用します。
sandbox="allow-scripts allow-same-origin"
テンプレートは3タブ構成のチーム管理単一ページ管理画面を定義します：Team Members / Team Details / Activity Log。これらに加え、KPI統計行、メンバー一覧テーブル（アバター＋役割＋ステータス）、役割分布棒グラフ、オンライン状態およびアクティビティスパークライン、Top contributorsパネルを含みます。
- Tabs: Team Members / Team Details / Activity Log - KPI stat row - Member table (avatar + 角色 + 状态) - Role distribution bar chart - Online presence + activity sparklines - Top contributors panel
インタラクション詳細が明示されています：ライト/ダーク切り替え、ホバーツールチップ、クリックズームパネル、および「CSVエクスポートボタン（フロントエンド実装）」— つまりエクスポートはサーバーを経由せずブラウザ側で生成されます。
- light/dark 切换, hover tooltip, click-to-zoom panels - CSV export 按钮 (前端实现)
FlowAIの美学に基づくチーム管理admin単一ページとして位置づけられており、レイアウトや配色は共通指示レイヤーに従い、本テンプレートは管理画面の情報設計のみを担当します。
【意图】FlowAI 美学的团队管理 admin 单页。
キャンバス仕様はデスクトップ1440（aspect_hint）を想定し、セレクターのメタデータはcategory=dashboard、scenario=operations、tagsはflowai/team/membersです。
aspect_hint: "桌面 1440"
本skillのexample.htmlは単なるiframeシェルであり、./assets/template.html を参照しています。このファイルは固定コミット内に存在しないため、プレビューエンドポイントはこのシェルをそのまま返し、iframeは404エラーとなります。
<iframe src="./assets/template.html" title="FlowAI Team Dashboard Example"></iframe>
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| network | Tailwind / Google Fonts 由共享指令层强制（本模板 SKILL.md 未提 CDN；示例壳自身零外链） |
| network | FlowAI 品牌/美学参照（仅出现于正文命名，无端点位） |
4推奨統制措置と判定根拠
- SKILL.md: 純粋なプロンプト指示およびルールテキストであり、スクリプト実行や外部への副作用はありません
5二重目の独立検証
- [ok] 三 tab / 布局宣称 — 重读 SKILL.md【布局】6 条与 JSON 引用逐字一致。
- [ok] 『CSV 导出前端实现』 — SKILL.md【设计细节】确写『CSV export 按钮 (前端实现)』；对目录做 createObjectURL/download=/Blob 扫描零命中——模板声明了该能力，实现由生成的页面自行承担。
- [discrepancy] 预览样张可用性 — example.html 仅含 <iframe src="./assets/template.html">，而该 pin 的 skill 目录（git ls-files 复核）只有 SKILL.md 与 example.html，无 assets 目录。结论：选择器/详情页预览会 404，样张缺失。
- [ok] featured/recommended 缺失的影响 — loader 只在 if (typeof fm.featured === "number") meta.featured = fm.featured; 时写 meta.featured，故本 skill 不进推荐位——与 README showcase（按 recommended 排的 8 个）中确无 flowai-team-dashboard 相互印证。
- [ok] 安全面 — 目录内 2 个文件无脚本/凭证/写盘/网络调用 token；示例壳无外链。
- [ok] meta 元数据 — GitHub API 实查 stars=8827、pushed_at=2026-09-15T03:36:24Z、license Apache-2.0。
- [unlocatable] 安装量 — 无公开安装量数据源，installs=null。
6結論
2b713fbcbced0b31…