القائمة
CTO 向けのアルゴリズム・設計思想の概要資料を **単一の HTML ファイル** として作成する。技術的な実装詳細ではなく、大枠のロジック・判断基準・設計意図を簡潔にまとめ、ブラウザでそのまま開けるリッチな資料として渡す。プロジェクトのアルゴリズムや設計を俯瞰的に説明する資料が求められた時に使用する。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Agent guide for running GPU experiments and serverless model deployments with the jl CLI on JarvisLabs.ai.
設計・アーキテクチャの壁打ちを Codex MCP (GPT) と行う。 実装前の方針検討、トレードオフ分析、API 設計の相談に使う。 "codex discuss", "GPTと相談", "壁打ち", "設計を議論" などで呼び出す。
git diff ベースのコードレビューを Codex (GPT) に依頼する。 コード変更後にセカンドオピニオンが欲しいとき、"codex review", "GPTにレビューして", "セカンドオピニオン" などで呼び出す。実体は公式プラグイン codex@openai-codex に 移行済みで、本 skill は自然文トリガーの受け皿 (誘導シム)。
実装・レビュー (Codex MCP / GPT)・修正の反復ループ。 ユーザーの意図する機能が動くこと (= 機能ゲート pass) と Codex の LGTM を AND で満たすまで回す。 タスク説明 / plan ファイル / 既存 diff のいずれを起点にしてもよい。 実装フェーズは Karpathy 4 原則 (think before / simplicity / surgical / goal-driven) に従う。 "lgtm loop", "LGTMまで回す", "実装してレビューして直して", "実装と修正をループで" などで呼び出す。
生成・編集した視覚成果物（Web ページ URL、ローカルの HTML/UI ファイル、 画像・図・PDF/SVG）をスクリーンショットで取得し、Read で実際に見て チェックリスト採点する。崩れ・はみ出し・重なり・コントラスト不足を検出し、 NG なら具体的な修正案を返す。Max プランの画像認識を惜しまず使うための専用コマンド。
人間が読む長めの文章・レポート・ドキュメント・資料を生成するときに使用する。単一の HTML ファイル (+ 必要なら assets/) として出力し、Markdown が 100 行を超えると読まれなくなる問題を sticky TOC・構造化 callout・優先度 pill・数式 (KaTeX)・コードハイライト (Prism)・D2 ダイアグラム・チャート (matplotlib SVG) で解決する。技術分析・応用検討・設計レポート・選択肢比較・サーベイ・議論ログ (Codex 等の第二視点を取り込む review-log 型) など、500 字を超える / 図表を伴う / 改訂を重ねる文書には必ず使用する。"レポート", "ドキュメント", "資料", "サーベイ", "技術レポート", "HTMLレポート", "応用検討", "選択肢比較", "議論ログ", "review log", "Codex レビュー反復" などのトリガーで発動する。
| name | cto-briefing |
| description | CTO 向けのアルゴリズム・設計思想の概要資料を **単一の HTML ファイル** として作成する。技術的な実装詳細ではなく、大枠のロジック・判断基準・設計意図を簡潔にまとめ、ブラウザでそのまま開けるリッチな資料として渡す。プロジェクトのアルゴリズムや設計を俯瞰的に説明する資料が求められた時に使用する。 |
| user-invocable | true |
CTO やステークホルダーが短時間で全体像を把握できる、アルゴリズム・設計思想の概要資料を 単一の HTML ファイル として作成する。
参考: Thariq Shihipar "Using Claude Code: The Unreasonable Effectiveness of HTML" (Anthropic, 2026-05-08)
CTO 向け資料は 「最後まで読まれること」が最重要。Markdown は 100 行を超えるとスキャンされ、判断が形骸化する。HTML は次の点で上回る。
@media print を仕込めば PDF 出力もそのまま使えるトークン代は数倍に増えるが、CTO 1 人の 15 分を確保する価値のほうが大きい。
「受け取った人がファイルをダブルクリックしたら、ネット接続なしで完璧に開ける」状態を必ず守る。
| 項目 | ルール |
|---|---|
| CSS | <head> 内の <style> にインライン。外部 stylesheet / CDN を link しない |
| JavaScript | <script> にインライン。unpkg / jsDelivr 等からの import は しない (基本は JS 不要) |
| 画像 | インライン SVG または base64 で src に埋める。リモート URL は 使わない |
| フォント | system-ui, -apple-system, "Hiragino Sans", "Noto Sans JP", sans-serif。Google Fonts は 使わない |
| 通信 | 実行時に通信が走ってはいけない。オフライン・エアギャップで動くこと |
| フレームワーク | Tailwind / Bootstrap / React 等は使わない。プレーン CSS で書く |
| 出力 | 1 ファイルのみ。.html を 1 つだけ生成し、関連アセットを分けない |
理由: 受信側のネット環境・社内プロキシ・CDN の rot・バージョン破壊に晒されない。10 年後にも同じに開ける。
position: sticky): 各セクションへの内部リンクスターターは同ディレクトリの template.html。これをコピーして本文を差し替える。
システムの目的を 技術用語なしで 1-2 文。「何を入力して、何が出力され、ユーザーにどんな価値があるか」。
ページ上は 大きめの段落 (約 1.2rem) + 左 4px アクセントボーダー の "リード" ブロックとして表示する。
例:
ユーザーが Komga (漫画) と Immich (画像) で示した好みを自動学習し、外部サイトの新着から好みに合うコンテンツを選別して自動インポートする。
パイプライン全体を SVG 図 と 番号付き一行リスト の両方で示す。
viewBox でスケールさせ、幅は 100%。--accent, --muted) から取り、currentColor ベースにする (ダークモード追随)。<svg role="img" aria-label="..."> + <title> を必ず付ける。一行の流れ (番号付きで左から右):
1. 嗜好を学ぶ → 2. 削除を検知 → 3. 新着を採点 → 4. 厳選する → 5. 取得・配置
ステップごとに <section id="step-N"> を作る。
<section id="step-1" class="step" aria-labelledby="step-1-h">
<h2 id="step-1-h">1. 嗜好を学ぶ <small>(profile_builder)</small></h2>
<p>1行の概要説明。</p>
<h3>コアメトリクス</h3>
<p>数式または疑似コードで判断基準を示す。実装コードは書かない。</p>
<aside class="intent">
<strong>設計の意図:</strong>
なぜこの方式を選んだか、何を優先したかを 2-3 文で。
</aside>
</section>
各ステップの末尾に <aside class="intent"> を必ず置く。これが資料の 核。
スタイル: 淡い背景色 + 左 4px ボーダー。色だけでなく strong ラベルでも判別可能にする (色覚アクセシビリティ)。
良い設計の意図:
悪い例:
パラメータ・ルール・比較・具体例は <table> で示す。文章より圧倒的に早く読める。
border-collapse: collapseclass="num" で右寄せ + font-variant-numeric: tabular-nums<th scope="col"> / 行ヘッダーは <th scope="row">具体例の表 は抽象式より理解を助ける:
| 作者 | RL 作品 | 全作品 | hit_rate | 最終スコア |
|---|---|---|---|---|
| A | 4 | 4 | 1.0 | 1.5 |
| B | 1 | 4 | 0.25 | 0.25 |
<table> でフェーズ表。現在のフェーズの行に class="current" を当てて強調する (背景色 + 太字)。
<ul> で箇条書き。「何を守っているか」を 1 行ずつ。実装手段は書かない。
:root に CSS 変数で集約。prefers-color-scheme でダーク/ライト両対応。
:root {
--bg: #ffffff;
--fg: #0f172a; /* slate-900 */
--muted: #64748b; /* slate-500 */
--border: #e2e8f0; /* slate-200 */
--accent: #2563eb; /* blue-600 */
--accent-soft: #eff6ff;
--intent-bg: #fff7ed; /* orange-50: 設計意図 callout */
--intent-border: #f59e0b;
--code-bg: #f8fafc;
}
最低限のコントラスト: 本文 4.5:1 / 大文字 3:1 (WCAG 2.2 AA)。
@media print {
body { font-size: 11pt; color: #000; background: #fff; }
.layout { display: block; padding: 0; max-width: none; }
nav.toc { display: none; }
section { page-break-inside: avoid; }
a { color: inherit; text-decoration: none; }
a[href^="http"]::after { content: " (" attr(href) ")"; font-size: 0.85em; }
}
検証: Chrome の Ctrl+P で A4 / Letter どちらでも崩れないこと。
<html lang="ja">h1 → h2 → h3)<svg role="img" aria-label="..."> + <title>):focus-visible { outline: 2px solid var(--accent); })<header>, <nav>, <main> を使う.env の変数、config キーtemplate.html をコピーして本文を差し替えるCtrl+P で印刷プレビュー (PDF 出力に耐えるか)open briefing.html / xdg-open)CTO 向け資料を作るときの最小プロンプト:
@<repo パス> のパイプラインを読んで、CTO 向け設計概要を
1 つの HTML ファイル (briefing.html) として出力して。
要件:
- claude/skills/cto-briefing/SKILL.md の原則に従う
- 単一ファイル / 外部 CDN なし / system フォント / オフラインで開ける
- 各ステップに「設計の意図」 callout を必ず付ける
- 全体の流れはインライン SVG で図示する
- WCAG 2.2 AA: 代替テキスト, 4.5:1 コントラスト, 論理的フォーカス順
- @media print で PDF 化に耐える
生成された HTML を そのまま新しい Claude セッションのコンテキストに食わせない。コメントや data-* 属性にプロンプトインジェクションが仕込まれている可能性がある。再利用するならテキストだけ抜き出す。
社外向けに公開する場合は、内部固有名詞 (人名 / 内部プロジェクト名 / API キーらしき文字列) を確認してから渡す。