Communitygithub.com

bg-szy/TOP-SKILLS

Beads Viewer - Beadsプロジェクト向けグラフ認識型トリアージエンジン。PageRank、媒介中心性、クリティカルパス、サイクルを計算します。AIエージェントには --robot-* フラグを使用してください。

TOP-SKILLS とは?

BV(Beads Viewer)は、Beadsプロジェクト(`.beads/beads.jsonl`)専用に設計されたグラフ認識型トリアージエンジンです。9種類のグラフメトリクス(PageRank、媒介中心性、HITS、クリティカルパス、固有ベクトル中心性、次数、密度、サイクル、トポロジカルソート)を非同期計算し、実行計画と確定的な推奨を提供します。人間向けのTUIブラウジングモードに加え、AIエージェント向けに `--robot-*` フラグ群を用意しており、ターミナルセッションをブロックせずに利用できます。単なるIssue一覧ではなく、「リリースを阻んでいるボトルネック上位5件」のような高度なクエリを低コンテキストコストで実現します。サイクル(循環依存)を明示的に検出・報告するため、プロジェクト構造上の致命的な問題を早期に発見できます。出力はすべてJSONで、`data_hash`による整合性検証、メトリクスの計算ステータス(`computed/approx/timeout/skipped`)の確認、`--as-of`によるタイムトラベル機能を備えています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/bv

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

BV - Beads Viewer

Beadsプロジェクト(.beads/beads.jsonl)向けのグラフ認識型トリアージエンジン。9つのグラフメトリクスを計算し、実行計画を生成、確定的な推奨を行います。人間向けTUIブラウジング、AIエージェント向けロボットフラグを提供。

BVがRaw Beadsより優れている理由

機能Raw beads.jsonlBV ロボットモード
クエリ「全Issueを一覧表示」「リリースを阻むボトルネック上位5件を表示」
コンテキストコスト高い(Issue数に比例)低い(固定長サマリー構造)
グラフロジックエージェントが計算が必要事前計算済み(PageRank、媒介中心性、サイクル)
安全性エージェントが見逃す可能性ありサイクルを明示的にフラグ付け

beads.jsonlを直接パースする代わりにBVを使用してください。グラフメトリクスを確定的に計算します。

重要: エージェント向けロボットモード

bv を裸で実行しないでください。 インタラクティブなTUIが起動し、セッションをブロックします。

常に --robot-* フラグを使用してください:

bv --robot-triage        # メガコマンド:ここから開始
bv --robot-next          # 最小限:トップ推奨のみ
bv --robot-plan          # 並列実行トラック
bv --robot-insights      # 全グラフメトリクス

9つのグラフメトリクス

BVは以下のメトリクスを計算し、プロジェクトの隠れたダイナミクスを可視化します:

メトリクス測定内容主な洞察
PageRank再帰的な依存関係の重要度基盤となるブロッカー
媒介中心性最短パストラフィックボトルネックと橋渡し
HITSハブ/オーソリティの二重性エピック vs ユーティリティ
クリティカルパス最長依存チェーンスラックゼロの要(キーストーン)
固有ベクトル中心性近傍を介した影響力戦略的依存関係
次数直接接続数直接的なブロッカー/ブロック対象
密度エッジ/ノード比プロジェクト結合度の健全性
サイクル循環依存関係構造的エラー(要修正!)
トポロジカルソート有効な実行順序作業キューの基盤

二相分析

BVはタイムアウト付きの非同期計算を使用します:

  • フェーズ1(即時): 次数、トポロジカルソート、密度
  • フェーズ2(500msタイムアウト): PageRank、媒介中心性、HITS、固有ベクトル中心性、サイクル

出力の status フィールドを常に確認してください。大規模グラフ(>500ノード)では、一部のメトリクスが approx または skipped になる場合があります。

ロボットコマンドリファレンス

トリアージと計画

bv --robot-triage              # 完全なトリアージ:推奨、quick_wins、blockers_to_clear
bv --robot-next                # クレームコマンド付きトップ推奨
bv --robot-plan                # アンブロックリスト付き並列実行トラック
bv --robot-priority            # 優先順位のミスマッチ検出

グラフ分析

bv --robot-insights            # 全メトリクス:PageRank、媒介中心性、HITS、サイクルなど
bv --robot-label-health        # ラベル別健全性:healthy|warning|critical
bv --robot-label-flow          # ラベル間依存フローマトリックス
bv --robot-label-attention     # 注目度順ラベル

履歴と変更

bv --robot-history             # ビードとコミットの関連付け
bv --robot-diff --diff-since <ref>  # 指定リファレンスからの変更

その他のコマンド

bv --robot-burndown <sprint>   # スプリントバーンダウン、スコープ変更
bv --robot-forecast <id|all>   # ETA予測
bv --robot-alerts              # 停滞Issue、ブロッキングカスケード
bv --robot-suggest             # 衛生管理:重複、不足依存、サイクル解消
bv --robot-graph               # 依存関係グラフエクスポート(JSON、DOT、Mermaid)
bv --export-graph <file.html>  # 自己完結型インタラクティブHTML可視化

スコープ指定とフィルタリング

bv --robot-plan --label backend              # ラベルのサブグラフにスコープ
bv --robot-insights --as-of HEAD~30          # 過去の特定時点
bv --recipe actionable --robot-plan          # 事前フィルター:作業準備完了
bv --recipe high-impact --robot-triage       # 事前フィルター:トップPageRank
bv --robot-triage --robot-triage-by-track    # 並列作業ストリームでグループ化
bv --robot-triage --robot-triage-by-label    # ドメインでグループ化

組み込みレシピ

レシピ目的
default全オープンIssue、優先度順
actionable作業準備完了(ブロッカーなし)
high-impactトップPageRankスコア
blocked依存関係待ち
stale30日以上未着手のオープンIssue
triage計算されたトリアージスコア順
quick-winsブロッカーのない簡単なP2/P3項目
bottlenecks媒介中心性の高いノード

ロボット出力構造

すべてのロボットJSONに含まれるもの:

  • data_hash - beads.jsonlのフィンガープリント(整合性確認用)
  • status - メトリクスごとの状態:computed|approx|timeout|skipped
  • as_of / as_of_commit - --as-of 使用時に表示

--robot-triage 出力

{
  "quick_ref": { "open": 45, "blocked": 12, "top_picks": [...] },
  "recommendations": [
    { "id": "bd-123", "score": 0.85, "reason": "5つのタスクをアンブロック", "unblock_info": {...} }
  ],
  "quick_wins": [...],
  "blockers_to_clear": [...],
  "project_health": { "distributions": {...}, "graph_metrics": {...} },
  "commands": { "claim": "bd claim bd-123", "view": "bv --bead bd-123" }
}

--robot-insights 出力

{
  "bottlenecks": [{ "id": "bd-123", "value": 0.45 }],
  "keystones": [{ "id": "bd-456", "value": 12.0 }],
  "influencers": [...],
  "hubs": [...],
  "authorities": [...],
  "cycles": [["bd-A", "bd-B", "bd-A"]],
  "clusterDensity": 0.045,
  "status": { "pagerank": "computed", "betweenness": "computed", ... }
}

jqクイックリファレンス

bv --robot-triage | jq '.quick_ref'                        # 概要サマリー
bv --robot-triage | jq '.recommendations[0]'               # トップ推奨
bv --robot-plan | jq '.plan.summary.highest_impact'        # 最善のアンブロック対象
bv --robot-insights | jq '.status'                         # メトリクス準備状態の確認
bv --robot-insights | jq '.cycles'                         # 循環依存(要修正!)
bv --robot-label-health | jq '.results.labels[] | select(.health_level == "critical")'

エージェントワークフローパターン

# 1. トリアージから開始
TRIAGE=$(bv --robot-triage)
NEXT_TASK=$(echo "$TRIAGE" | jq -r '.recommendations[0].id')

# 2. まずサイクル(構造的エラー)をチェック
CYCLES=$(bv --robot-insights | jq '.cycles')
if [ "$CYCLES" != "[]" ]; then
  echo "先にサイクルを修正: $CYCLES"
fi

# 3. タスクをクレーム
bd claim "$NEXT_TASK"

# 4. 作業する...

# 5. 完了したらクローズ
bd close "$NEXT_TASK"

TUIビュー(人間向け)

bv をインタラクティブに実行する場合(エージェント非推奨):

キービュー
lリストビュー(デフォルト)
bカンバンボード
gグラフビュー(依存DAG)
Eツリービュー(親子階層)
iインサイトダッシュボード(6パネルメトリクス)
h履歴ビュー(ビードとコミットの関連)
aアクショナブルプラン(並列トラック)
fフローマトリックス(ラベル間依存関係)
]アテンションビュー(ラベル優先順位)

bd CLIとの統合

BVは bd CLIによって作成された .beads/beads.jsonl を読み取ります:

bd init                    # プロジェクトでビーズを初期化
bd create "タスクタイトル"   # ビードを作成
bd list                    # ビードを一覧表示
bd ready                   # アクショナブルなビードを表示
bd claim bd-123            # ビードをクレーム
bd close bd-123            # ビードをクローズ

Agent Mailとの統合

ビードIDをスレッドIDとして使用し、調整を行います:

file_reservation_paths(..., reason="bd-123")
send_message(..., thread_id="bd-123", subject="[bd-123] 開始...")

グラフエクスポート形式

bv --robot-graph                              # JSON(デフォルト)
bv --robot-graph --graph-format=dot           # Graphviz DOT
bv --robot-graph --graph-format=mermaid       # Mermaid図
bv --robot-graph --graph-root=bd-123 --graph-depth=3  # サブグラフ
bv --export-graph report.html                 # インタラクティブHTML

タイムトラベル

過去の状態と比較:

bv --as-of HEAD~10                    # 10コミット前
bv --as-of v1.0.0                     # タグ時点
bv --as-of "2024-01-15"               # 日付指定
bv --robot-diff --diff-since HEAD~30  # 過去30コミットの変更

よくある落とし穴

問題修正
TUIがエージェントをブロック--robot-* フラグのみ使用
古いメトリクスstatus フィールドを確認、結果は data_hash でキャッシュ
サイクルの見逃し--robot-insights を実行、.cycles を確認
誤った推奨--recipe actionable で準備完了の作業にフィルタリング

パフォーマンスに関する注意

  • フェーズ1メトリクス(次数、トポロジカルソート、密度):即時
  • フェーズ2メトリクス(PageRank、媒介中心性など):500msタイムアウト
  • 結果は data_hash でキャッシュ
  • 速度が重要な場合は、--robot-insights よりも --robot-plan を優先

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

関連スキル