1仕組みと動作原理
本スキルは実行可能プログラムではなく、プレーンテキストのプロンプトテンプレートです。ホストが正規表現で SKILL.md の YAML frontmatter をパースし、本文（body）をプロンプト本体として読み込みます。
next/src/lib/templates/loader.ts
const { fm, body } = parseFrontmatter(raw);
リポジトリのディレクトリ規約に関する説明：「SKILL.md — frontmatter (id, scenario, tags, …) + prompt body」、および「Adding a template = adding a folder. No TS code change required」— テンプレートはディレクトリ規約によって登録されます。リポジトリ全体の TS/TSX 内に "pm-spec" のハードコードされた参照は見当たらず、本テンプレートに対するコード上の個別分岐処理はありません。
テンプレート本文は単体で実行されるのではなく、最終プロンプトの「テンプレート部分」に組み込まれます：共有デザイン指示 + 本テンプレート本文 + ユーザーコンテンツ。
next/src/app/api/convert/route.ts
prompt = assemblePrompt({ body: skill.body, content, format });
shared.ts の assemblePrompt の説明：「Wrap a per-template instruction body with the shared design directives and the user content tail.」。リクエストはまず const skill = loadSkill(templateId); で本ディレクトリの本文を取得した後に組み立てられます。
グローバルの「コンテンツ主導の分量」ルールがテンプレート内のいかなる数値指定よりも優先されます。テンプレートはレイアウト／スタイル／配色／コンポーネントライブラリのみを定義し、出力の長さを定義しません。
next/src/lib/templates/shared.ts
数量**完全由【用户内容】的实际长度和信息结构决定**
このルールは「最高優先度であり、テンプレート内のいかなる数値も上書きする」と明記されており、deck 系テンプレートにおける「6〜10枚」といった数値は「短いサンプルの下での参考下限値とみなす」と指定されています。したがって、本テンプレートが提供するのは利用可能なレイアウトと制約であり、ページ数の上限ではありません。
成果物の形式はグローバルで厳格に制約されています：単一ファイル HTML、コードフェンスなしの純粋な HTML、最初の文字は < でなければならず、ファイル書き込みは禁止されています（フロントエンドが stdout をキャプチャ）。
next/src/lib/templates/shared.ts
不要用 markdown 代码围栏包裹, 不要任何解释性文字
同じ箇所に「Write / Edit / MultiEdit / Bash / Create / ファイルシステムツールの使用は禁止」とも明記されています。ファイルのディスク保存はホストのフロントエンド側が担当し、テンプレート側で書き込み処理は行われません。
frontmatter のメタデータがセレクターの表示（中国語名／英語名／emoji／説明／カテゴリ／シナリオ／アスペクト比／タグ／サンプルメタデータ）を制御します。
next/src/lib/templates/loader.ts
zhName: fm.zh_name ?? fm.name ?? id,
本テンプレートのメタデータ：category=doc、scenario=product、aspect_hint=長ページ（featured なしのため、セレクターではおすすめ枠の後ろに配置）。セレクターは category/scenario でグループ化され、featured でソートされます。すべて frontmatter で決定され、コード側の特別扱いはありません。
同梱のサンプルアセットは2つの読み取り専用 API を通じてフロントエンドに公開されます：example.html は iframe 内にそのまま返され、example.md は「プレビュー」ボタンの入力コンテンツとして機能します。
next/src/app/api/templates/[id]/preview/route.ts
verbatim so it can be loaded into an
example.html のレスポンスヘッダーは Content-Type: text/html; charset=utf-8 です。別ルートでは content: skill.exampleMd ?? "" としてサンプルテキストをクライアントに渡します。本ディレクトリには example.html（14,291バイト）のみが存在し、example.md はありません。
実行チェーン（ホスト側の挙動であり、本テンプレートのコードではありません）：ホストはローカルでログイン済みの agent CLI を spawn し、組み立てたプロンプトを stdin 経由で送り、stdout から HTML をストリーミングで回収します。
next/src/lib/agents/invoke.ts
child.stdin.write(opts.prompt);
子プロセスは cwd=process.cwd()（cwd: opts.cwd ?? process.cwd(),）で実行され、stdio はすべて pipe されます。プロンプトはシェルの文字列結合ではなく stdin/--message 経由で渡されます（not interpolated into a shell command）。
テンプレートが提供するのは「セクション順序 + 各セクションの分量／文型制約」であり、視覚的な仕様ではなく閲覧順序の仕様です（設計意図：「製品要件定義書のシングルページ、構造が明確」）。
next/src/lib/templates/skills/pm-spec/SKILL.md
【意图】产品需求文档单页, 结构清晰。
design 系テンプレートとは異なり、配色やフォントサイズに関する制約はほとんどなく、PRD の必須セクションを標準化・固定化することに価値があります。
2つの分量／文型の厳格な制約（KPI 3〜5個、ユーザーストーリーに Given/When/Then を使用）により、自由な散文ではなく比較・レビューが可能な出力になります。
next/src/lib/templates/skills/pm-spec/SKILL.md
- Success metrics (3-5 个 KPI)
共有指示ではスライド／フレーム／カード／セクションの数はコンテンツによって決定されると規定されていますが、ここでの「KPI 3〜5個」はコンテンツ自体の焦点を絞るための要求（指標が多すぎる＝重点が不明瞭）であり、両者は矛盾しません。
長ページの位置付け（aspect_hint: 長ページ）と共有指示の組版規律（8px ベースライン、段落の最大幅 65ch）が組み合わさることで、そのまま直接読める単一ファイルのドキュメントが得られます。
next/src/lib/templates/skills/pm-spec/SKILL.md
- Rollout plan + Open questions
本ディレクトリの example.html は 14,291 バイトに達し、9つのテンプレートの中で最大のプレビュー成果物となっており、「長ページ」の位置付けに合致しています。
2コア機能
01ドキュメントヘッダーにステータスピル（draft/approved/shipped）を備え、ライフサイクルをレイアウトに反映
02指標の乱立を防ぐため、成功指標を3〜5個の KPI に限定
03スコープを明示的に二分：in / out
04ユーザーストーリーに Given/When/Then 構文を強制
05デザイン説明エリアにモックアップ用のプレースホルダーを確保
06リリース計画と未解決のオープンクエスチョンで締めくくり
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| network | Tailwind Play CDN（共享指令对产物的要求） |
| network | jsdelivr CDN（可选：图表/动画脚本） |
| network | Google Fonts（共享指令指定） |
| cli | 本机 coding-agent CLI（宿主检测 PATH 并 spawn） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
アクセス可能ドメインとキー範囲を宣言
管理者向け
最小権限のキー、リクエストログを保持
判定根拠（ファイルパスと抜粋）
- 网络端点: 外部ネットワークアクセスの宣言：成果物側（共有デザイン指示による要求）：生成された HTML はブラウザ内で cdn.tailwindcss.com（Tailwind Play）および Google Fonts を読み込みます。
監査ノート： 判定基準：本スキルディレクトリ（SKILL.md + example.html）のみを評価対象とし、ホスト環境や成果物の外部リンクは評価に含めません。ディレクトリ内にはスクリプト、ネットワークエンドポイント、認証情報の読み取り、ディスク書き込み指示は一切存在せず、トークンスキャンでの検出はゼロ件です。SKILL.md 内で実行時に読み込むべき CDN、フォント、API の指定もありません。評価を変更しない補足事項2点：① ホスト環境（loader.ts → assemblePrompt → agents/invoke.ts によるローカル CLI の spawn；claude の引数に --permission-mode bypassPermissions が含まれ、envFor が {...process.env} で環境変数を透過）はホストの挙動であり、verdict.risks に記載済みです。② ホストから注入される共有デザイン指示により、成果物の <head> 内で Tailwind Play / Google Fonts が参照されます（成果物の実行時外部リンクに該当）。
5二重目の独立検証
- [ok] skill 目录资产面（脚本 / references / 数据 / 模板） — 目录实为 2 个文件：SKILL.md 与 example.html；无 scripts/、无 references 目录、无任何可执行文件（.sh/.py/.js/.mjs/.ts 零命中）。
- [ok] 「无脚本、无网络、无凭证、无写盘」的反例搜索 — 对目录递归 token 扫描（api[_-]?key|token|secret|\.env|process\.env|child_process|fetch\(|curl |wget |npm |npx |exec\(|subprocess|writeFile|fs\.）：零命中；SKILL.md 另按 http|CDN|cdn|font|API|api|fetch|Google|script 扫描，仅命中 font-semibold / font-black 这类字重类名，无端点。
- [ok] 官方描述 vs 实际能力（有无夸大） — frontmatter description（问题 + 成功指标 + 范围 + user stories + 设计 + 发布 + 待解决）与正文一致：描述承诺的版式要素都能在正文找到对应条目，未见正文未支持的越界承诺。
- [ok] 外部资源/工具条目逐条回源 — external_deps 中的仓库级条目（Tailwind Play CDN / jsdelivr / Google Fonts / 本机 agent CLI）逐条回到 shared.ts 与 argv.ts 原文取证；本模板无目录级端点条目。
- [ok] 宿主执行链（供 security.reason / verdict.risks 使用，不参与判级） — prompt 经 stdin 送入被 spawn 的本机 CLI（invoke.ts），HTML 从 stdout 分流捕获；claude 参数含 --permission-mode bypassPermissions、envFor 透传 process.env；预览 iframe sandbox="allow-scripts allow-same-origin"（template-picker.tsx:544 / preview-pane.tsx:297）。
- [ok] 路径与 commit 一致性 — 工作副本 /var/ytdown/skills-portal/spy-repos/html-anything 的 git HEAD = 553ed98c283f9c0f489902d035416a972d6a9699（与任务表 pin 一致）；skill.path=next/src/lib/templates/skills/pm-spec 下确有 SKILL.md，全仓无第二份同名模板。
- [ok] "设计备注含 mockup 占位"是否意味着抓取外部图 — 原文是 "- Design notes (含占位 mockup)"，即版面占位；共享指令另有"不要引用任何外部图片 URL"的禁令，方向一致，不存在外链图片要求。
- [ok] 随包 example.html 的外链与脚本面 — pm-spec/example.html（14291 字节）无 http(s) 外链、无 <script>：长文档排版全部内联 CSS，预览不会产生外部请求。
6結論
最適な用途： 既存の要件メモをレビュー可能な PRD 1ページに素早く変換する用途に最適：課題提起、指標、スコープ、ユーザーストーリー、リリース計画を一度にまとめ、プロダクト／開発／デザインチームのレビューに回せます。
不向きな用途： 厳格な社内テンプレートへの準拠（全必須フィールドの網羅、承認・サインオフワークフローを含む）が求められる正式な成果物作成には不向きです（セクション構成と構文の提案のみを提供し、フィールド検証は行いません）。また、純粋な視覚的プレゼンテーション用途には適していません（ポスターや deck 系テンプレートを選択してください）。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload pm-spec.tar.gz
sha256:
Option B · Copy Guide for Agent3cd90ed0d79647d1…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 553ed98c28.