ドキュメント&知識ベース · nexu-io/html-anything

exec-briefing-memo

Decision needed + recommendation + evidence + tradeoffs により、複雑な資料を即決可能な1ページの決定メモに凝縮します。

L1 基本 · ソース登録のみV1 コミット固定Dual-pass Audit
Author nexu-ioGitHub nexu-io/html-anything ↗Stars 8827License Apache-2.0(仓库根 LICENSE = Apache License 2.0;GitHub API license.spdx_id = Apache-2.0;next/package.json 亦声明 Apache-2.0)Commit 553ed98c28
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

本skillは実行可能プログラムではなく、「1ディレクトリ=1テンプレート」の構成です。SKILL.md の frontmatter はセレクター表示用であり、本文(body)はモデルに送るプロンプトそのものです。テンプレートの追加はディレクトリの追加のみで完結し、TypeScriptの変更は不要です。

next/src/lib/templates/loader.ts
routes rescan disk and the client refetches `/api/templates`.
同一ファイルのヘッダーコメントにディレクトリ規約が明記されています:SKILL.md(frontmatter + prompt body)/ example.md(任意の入力サンプル)/ example.html(任意のプレビュー)。本skillディレクトリはまさにこの構造を採用しています。

実際に発行されるプロンプトは、プラットフォーム共有設計指示(SHARED_DESIGN_DIRECTIVES)+本skillの SKILL.md 本文+ユーザーコンテンツとなり、assemblePrompt によって1つのプロンプトに組み立てられます。

next/src/lib/templates/shared.ts
Wrap a per-template instruction body with the shared design directives and
したがって、本skillの本文は「レイアウト/スタイル/コンポーネントライブラリ」の部分のみを担当します。出力規律(単一ファイルHTML、ユーザー実データの使用必須、コンテンツ主導のボリューム設計)は共有指示に由来するため、テンプレート作成者が重複して宣言する必要はありません。

完成稿はファイルシステムを経由しません。共有指示により Write/Edit/Bash などのファイルツールの使用が明示的に禁止されており、モデルはHTML全体を返答本文として直接ストリーミング出力します(stdout はフロントエンド側で捕捉されてディスクに保存されます)。

next/src/lib/templates/shared.ts
**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。不要把 HTML 写到任何 \`.html\` 文件里。前端直接捕获你的 stdout 文本, 文件落盘由前端负责。
これが「skill自体のディスク書き込みゼロ」メカニズムの根拠です。ファイルを書き込むのはホスト側のフロントエンドであり、skillではありません。本ディレクトリ内にもスクリプトは一切存在しません。

成果物は議事録・週報・PRDではなく「3分で即決できる1ページ」と定義されており、9つの必須構成セクション(memo header / decision needed / recommendation / why now / key facts / tradeoff table / risks / decision path / next actions)が指定されています。

next/src/lib/templates/skills/exec-briefing-memo/SKILL.md
【意图】这不是会议纪要、不是周报、不是 PRD。它的唯一目标是帮助决策者在 3 分钟内理解问题并拍板。
構造には強制的な判定基準が含まれます。推奨事項は明確かつ confidence level(確信度)付きでなければならず、「検討可能」といった曖昧な記述は禁止されています。Tradeoff は Option A/B/C ごとに upside / cost / risk / reversibility を比較し、Risks は各項目に緩和策を提示する必要があります。

ファーストビュー(首屏)の規律が設計要件に組み込まれています。結論と推奨事項を最優先で表示し、背景説明を先行させてはなりません。

next/src/lib/templates/skills/exec-briefing-memo/SKILL.md
- 首屏必须直接呈现 decision + recommendation, 不要先铺陈背景。
サンプルもこれに従って実装されています。最初のセクション内では header pills(Executive memo / Owner / Deadline / Audience)が先行し、その直後に「Decision needed」の大見出しと右側の緑色の Recommendation カード(Approve a narrow Enterprise Preview. + Confidence: medium-high + Reversible)が配置されています。

本テンプレートは全9種の中で唯一、選択可能なスタイルアセット用ディレクトリを備えています。assets/ 配下に即時適用可能な3種類のHTMLスタイル(デフォルトの board-memo / ダーク調司令室の decision-command / 取締役会ペーパーの board-paper)が格納されており、状況に応じて1つを選択し、混用は不可と規定されています。

next/src/lib/templates/skills/exec-briefing-memo/SKILL.md
- `assets/board-memo.html`: 默认风格。浅色高管 memo, 适合 CEO/CFO/CRO、运营、产品决策。
同セクションに選定ルールが記載されています:未指定の場合は board-memo、緊急性・リスク・行動指揮を強調する場合は decision-command、取締役会や正式承認向けは board-paper。3つのアセットはいずれも Tailwind CDN を用いた単一ファイルです。

サンプルの完成稿は assets/board-memo.html と同一ソースです。ディレクトリ内の example.html は「デフォルトスタイル」のアセットをインスタンス化したバージョンです。

next/src/lib/templates/skills/exec-briefing-memo/assets/board-memo.html
<div class="label">Tradeoff table</div>
両ファイルの diff に差異はありません(バイト単位で同一)。したがってプレビューで確認できるのは board-memo スタイルそのものであり、他の2つのスタイル(decision-command ダーク、board-paper セリフ)は assets 内にスタイルのベースのみが提供され、完成サンプルの付属はありません。

コンテンツの真実性と証拠の欠落(Evidence gaps)がルールとして規定されています。数値、顧客、予算、日付の捏造は禁止されており、重要情報が不足している場合は Evidence gaps を明記しつつ、暫定的な推奨事項(provisional recommendation)を提示する必要があります。

next/src/lib/templates/skills/exec-briefing-memo/SKILL.md
- 如果缺少关键信息, 在 Evidence gaps 中列出, 但仍给出基于现有证据的 provisional recommendation。
付属の example.md は「断片的な材料 → 1ページの決定メモ」の入力サンプルです。FlowLedger の営業・製品・財務・リスク・経営陣の懸念など混在したシグナルを用いて、モデルが単一の意思決定フレームへ要約できるかを検証します。

意思決定パスは単なる「次のステップ」の文章ではなく、並列する3枚のカード(Approve / Reject / Need evidence)としてプロダクト化されています。

next/src/lib/templates/skills/exec-briefing-memo/example.html
<h3 class="font-extrabold">Need evidence</h3>
これは SKILL.md の第8項「approve / reject / ask for more evidence の3つのパスそれぞれのネクストステップ」に対応しています。サンプルの Tradeoff table や Risks & mitigations も独立したブロックとなっており、「結論 — 根拠 — トレードオフ — リスク — 決定パス」という意思決定チェーンを形成しています。

サーバーサイドの /api/convert が行う処理は3点のみです。templateId に基づいてディスクから skill を読み込み、プロンプトを組み立て、ローカル agent CLI を spawn して出力を SSE ストリームで転送します。

next/src/app/api/convert/route.ts
prompt = assemblePrompt({ body: skill.body, content, format });
同ファイル内でまず `const skill = loadSkill(templateId);` が実行され(該当テンプレートが存在しない場合は400を返却)、その後 invokeAgent に渡されます。skill ディレクトリ自体がプロセスを生成したり、ネットワーク通信を行ったりすることはありません。

2コア機能

01断片的な材料を1ページの意思決定メモに凝縮(Decision needed + Recommendation + Confidence)
02Option A/B/C に基づくトレードオフ表の作成(upside / cost / risk / reversibility)
033択の意思決定パス(approve / reject / ask for more evidence)とそれぞれのネクストステップ提示
04ネクストアクション一覧の生成(owner / due date / expected artifact)
05シーンに応じて3択で選べるスタイルアセット(board-memo / decision-command / board-paper)
06リスクと緩和策のペア出力(3〜5件のリスクそれぞれに緩和策を提示)
07入力サンプルの同梱(FlowLedger が Enterprise Plan を導入すべきかどうかの断片材料)
08ファーストビューで結論を示すレイアウト規律

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
自動ロード可能
管理者向け
ソースとバージョンの記録
判定根拠(ファイルパスと抜粋)
  • SKILL.md: 純粋なプロンプト指示およびルール定義テキストのみで構成され、スクリプト実行や外部への影響はありません。
監査ノート: 評価対象=skill 自身のディレクトリ(SKILL.md / example.html / example.md / assets の3つのスタイル):スクリプトなし(生成物HTML内の Tailwind CDN script を除く)、認証情報の読み取りなし、ディスク書き込み指示なし、実行時のネットワーク呼び出しコードなし。第4バッチの最終規定に基づき、「成果物による参照」は評価対象外です。SKILL.md が指定する assets/board-memo.html、assets/decision-command.html、assets/board-paper.html、example.html はそれぞれ cdn.tailwindcss.com および fonts.googleapis.com を参照していますが、これらエンドポイントは完成したHTMLがブラウザ側で取得するものであり、skill 実行時に外部通信は行われません。静的スタイル/フォントCDNであり、ユーザー素材の送信や認証情報の関与もないため、green を維持します。ディレクトリ内エンドポイントの検証:① https://cdn.tailwindcss.com ×3(各 assets の7行目)、② https://fonts.googleapis.com(board-memo/example は Inter + Noto Sans SC、board-paper は Source Serif 4、decision-command は Inter を参照)。ホスト側に関する補足:ローカル agent CLI の spawn、プレビュー用 iframe の allow-scripts + allow-same-origin。orange 要件なし(外部生成バックエンドの呼び出しなし)、red 要件なし(リバースエンジニアリング/なりすまし/バイパス/ダウングレードなし)。

5二重目の独立検証

  • [discrepancy] 9 段强制结构中样例实际覆盖的部分 — 样例含 Decision needed / Recommendation(含 Confidence: medium-high)/ Tradeoff table / Risks & mitigations / Decision path(Approve·Reject·Need evidence)/ header(Owner·Deadline·Audience);缺 Why now、独立 Key facts 块(仅 4 张指标卡)、Next actions、Evidence gaps。
  • [ok] example.html 与 assets/board-memo.html 字节相同 — diff 输出为空;挂载的预览即默认风格资产的实例化版本。
  • [ok] 三套风格资产存在且风格迥异 — board-memo(--paper:#faf9f5)、decision-command(--bg:#101418 深色)、board-paper(--paper:#fbfaf6 + Source Serif 4 + 双线 rule)三份齐全。
  • [discrepancy] README 收录情况 — 仓库 README 的模板表(105 处模板链接)未列出 exec-briefing-memo,grep briefing/memo 只命中 deck-safety-alert;属文档滞后——目录存在、loader 能加载、featured=8 已声明。
  • [ok] 成稿版式依赖 Tailwind 运行时 — 三份资产均 <script src="https://cdn.tailwindcss.com"></script> 且大量使用 Tailwind 工具类(p-7 / lg:grid-cols-[1.15fr_.85fr] 等);离线时栅格与间距会失效,仅内联 <style> 部分保留。
  • [ok] 「不要捏造数字」与样例输入的关系 — example.md 提供了 18 inbound / 7 accounts / $18k-35k / 4-6w 等素材,样例成稿的 4 张指标卡(Enterprise asks 18、Large accounts 7、Potential ACV $18k-35k、Roadmap cost 4-6w)逐项对得上,未被编造。
  • [ok] 目录内无脚本、无凭证读取 — 除 Tailwind CDN script 外无 JS;无 token/env 读取;assets 只被 SKILL.md 指定为风格参考,不执行。

6結論

  • 意思決定のみを目的としたテンプレート:構成項目がすべて判断基準(明確な推奨+確信度、3つのパス、4軸のトレードオフ)で設計されており、出力自体が「即決可能性」を備えています。
  • 経営陣の3分間読書習慣に合致した結論先行型:ファーストビュー最上部に decision + recommendation のハイライトカードを配置し、エビデンスやトレードオフは後続に配置。
  • ルールとしてのスタイル:3種類のアセット+明確な選定条件(デフォルトは board-memo / 緊急時は decision-command / 取締役会向けは board-paper)により、モデルの即興デザインに依存せず高い再現性を担保。
  • 捏造防止の規律:情報不足時は Evidence gaps を列挙しつつ provisional recommendation を提示するよう義務付け、誠実性と行動可能性を両立。
  • 入力サンプルが付属し導入ステップが明確:雑多な経営陣向け資料から1ページの決定メモへの変換フローを直接確認・学習可能。
  • 最適な用途: 会議の議事メモ、調査資料、営業や財務からのフィードバックを即決可能な1ページの決定メモにまとめたいシーンに最適。CEO、CFO、取締役会、投資家に向けた意思決定材料を作成するプロダクトマネージャーやオペレーション責任者に好適。Go/No-go判断、予算承認、リリース判定(ゲート審査)の標準化フォーマットとして適しています。
    不向きな用途: 完全な論証プロセスを要する長文レポートには不向き(本テンプレートは意図的に1ページに凝縮されています)。会議の議事録、週報、PRDには不向き(SKILL.md で明示的に除外)。外部向けマーケティング資料には不向き(ストーリー展開やブランド表現は含まれません)。大量のデータに基づき複数ページのグラフを必要とする詳細な財務分析には不向き(指標カードおよびテーブルの収容数に限りがあるため)。
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload exec-briefing-memo.tar.gz
    sha256: 69bd73088bbba9e0…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 553ed98c28.