Communitygithub.com

majiayu000/claude-skill-registry-data

コードフローの整理と可視化を行い、明確なASCIIフローチャート、データフロー図、表分析を生成します。既存コードの整理、新機能設計の説明、技術文書の作成に適しています。

claude-skill-registry-data とは?

このスキルは、コードフローを整理し、可視化ドキュメントを生成するための再利用可能なテンプレートと手法を提供します。主な目的は、テキストとASCII図を用いて、「データがどこから来て、どのレイヤーを通過し、最終的にどこへ行くのか」を明確に説明することです。CLI、Flow、Data、DB/APIといったレイヤーに分けたフロー図の作成、データベーステーブル構造の説明、データクラスの設計評価、複数シナリオの比較分析など、多様なニーズに対応するテンプレートが用意されています。各テンプレートはASCII文字を使用した統一された視覚スタイルを持ち、矢印や罫線でデータフローを直感的に表現します。このスキルはClaude CodeやCodexなどのAIエージェント上で動作し、ユーザーが既存コードの理解、新機能設計、コードレビュー、技術文書作成などを行う際に、視覚的に理解しやすい出力を生成するのに役立ちます。単なるコードの説明に留まらず、設計上の判断理由やビジネス上の重要なポイントを強調することで、より深い洞察を提供します。また、コードスタイルやアーキテクチャルールなど、他のスキルと連携して統一的なドキュメントを生成できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry-data/tree/HEAD/analysis/code-flow-viz-mmorit00-fund-portfolio-bot-2

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

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

ドキュメント

コードフロー可視化ガイドライン

このスキルは、コードフローを整理し、可視化ドキュメントを生成するための再利用可能なテンプレートと手法を提供します。

コア原則: テキストとASCII図で、「データがどこから来て、どのレイヤーを通過し、最終的にどこへ行くのか」を明確に説明します。

使用タイミング

以下のシナリオで本スキルを使用します:

  • ユーザーが「特定の機能はどのように動作するのか」と質問した場合
  • 新機能のデータフローを設計する必要がある場合
  • リファクタリング前に既存ロジックを整理する必要がある場合
  • 技術文書やアーキテクチャ説明を作成する場合
  • コードレビューでコールチェーンを可視化する必要がある場合

コアテンプレート

1. 完全フローチャート(複数シナリオ比較)

用途:機能の複数の使用シナリオ(手動 vs 自動、成功 vs 失敗など)を整理する場合

┌─────────────────────────────────────────────────────────────────────┐
│                    機能名(例:制限管理ライフサイクル)                 │
└─────────────────────────────────────────────────────────────────────┘

═══════════════════════════════════════════════════════════════════════
シナリオ 1:シナリオ名(例:自動で制限状態を照会)
═══════════════════════════════════════════════════════════════════════

  ユーザーコマンド
     │
     ▼
┌─────────────────────────────────────────────────────────────────┐
│  uv run python -m src.cli.xxx ...                               │
└────────────────┬────────────────────────────────────────────────┘
                 │
                 ▼
        ┌────────────────┐
        │  CLI レイヤー    │  Flow関数を呼び出し
        │  _do_xxx()      │ ────────────────────┐
        └────────────────┘                      │
                                                ▼
                                   ┌──────────────────────────┐
                                   │  Flow レイヤー            │
                                   │  xxx_flow()               │
                                   └───────┬──────────────────┘
                                           │
                                           ▼
                              ┌─────────────────────────────┐
                              │  Data レイヤー                │
                              │  XxxRepo / XxxClient         │
                              └────────┬─────────────────────┘
                                       │
                                       ▼
                          ┌────────────────────────────┐
                          │  外部システム / データベース │
                          │  (SQLite / API / etc)      │
                          └──────────┬─────────────────┘
                                     │ データを返す
                                     ▼
                    ┌──────────────────────────────────┐
                    │  データ処理(解析/変換)          │
                    └─────────────┬────────────────────┘
                                  │
                                  ▼
                        ┌──────────────────────┐
                        │  戻り値データクラス    │  ← なぜ保持/簡略化したかを説明
                        │  (Result / Item / ...)│
                        └──────────┬───────────┘
                                   │
                                   ▼
                        ┌──────────────────────┐
                        │  CLI レイヤー書式整形出力│
                        └──────────────────────┘
                                   │
                                   ▼
    ╔══════════════════════════════════════════════════╗
    ║  端末出力例                                       ║
    ║  (枠線で囲み、最終的にユーザーが見る効果を強調)   ║
    ╚══════════════════════════════════════════════════╝

═══════════════════════════════════════════════════════════════════════
シナリオ 2:別のシナリオ
═══════════════════════════════════════════════════════════════════════
(上記構造を繰り返し、差異を強調)

2. データベーステーブル構造説明

用途:機能に関連するデータベーステーブルを説明する場合

CREATE TABLE table_name (
    id INTEGER PRIMARY KEY AUTOINCREMENT,  -- ← 主キーの役割を説明
    field1 TEXT NOT NULL,                  -- フィールドの意味を説明
    field2 TEXT,                           -- NULL のビジネス的な意味
    ...
);

-- インデックス(なぜこのインデックスが必要か説明)
CREATE INDEX idx_xxx ON table_name(field1, field2);

サンプルデータテーブル:

idfield1field2field3説明
42value1value2value3このレコードのビジネス的な意味を説明
43............

代表的なクエリ:

-- シナリオ説明:いつこのクエリが必要か?
SELECT * FROM table_name 
WHERE condition1 = ? 
  AND (condition2 IS NULL OR condition2 >= ?);

3. レイヤー別コールチェーン図(簡略版)

用途:関数の呼び出し関係を素早く説明する場合

CLI レイヤー (_do_xxx)
    │
    └─> Flow レイヤー (xxx_flow)
            │
            ├─> Data/Repo (xxx_repo.get)
            │       │
            │       └─> SQLite (SELECT ...)
            │
            └─> Data/Client (xxx_client.fetch)
                    │
                    └─> 外部 API (HTTP GET ...)

4. データクラス設計分析テーブル

用途:中間データクラスの必要性を評価する場合

クラス名フィールド数用途判定理由
XxxResult6複数フィールド集約 + CLI 表示✅ 保持「最小必要原則」を満たす
XxxWrapper1単一フィールドラッパー❌ 削除過剰なラッピング、元の型を直接返す
XxxItem3リスト明細項目✅ 保持ビジネス的な意味がある

比較例:

# ❌ 過剰なラッピング
@dataclass
class XxxResult:
    field: SomeType  # フィールドが1つだけ

def xxx_flow() -> XxxResult:
    return XxxResult(field=value)

# ✅ 簡略化後
def xxx_flow() -> SomeType:  # 直接返す
    return value

5. ビジネス上の重要なポイントの注釈

用途:ビジネスルールや設計上の決定事項を強調する場合

┌─────────────────────────────────────────────────────────────┐
│                      ビジネスの重要ポイント                     │
├──────────────────────┬──────────────────────────────────────┤
│   なぜこの設計か?    │          具体的な判断                 │
├──────────────────────┼──────────────────────────────────────┤
│ • データ精度         │ 金額はDecimal、小数点2桁              │
│ • 冪等性             │ (fund_code, date) でユニーク制約      │
│ • トレーサビリティ   │ record_id をグローバル一意識別子として  │
└──────────────────────┴──────────────────────────────────────┘

使用方法

Step 1: 分析目標を決定

以下の質問に回答します:

  1. ユーザーはどの機能のフローを知りたいのか?
  2. その機能にはいくつのシナリオがあるか?(成功/失敗、手動/自動など)
  3. どのレイヤーが関係するか?(CLI → Flow → Data → DB/API)
  4. 重要なデータクラスは何か?なぜそのように設計されているのか?

Step 2: 適切なテンプレートを選択

  • 複数シナリオ比較 → テンプレート 1(完全フローチャート)
  • 単一フロー → テンプレート 3(レイヤー別コールチェーン)
  • データベース設計 → テンプレート 2(テーブル構造+サンプルデータ)
  • データクラス評価 → テンプレート 4(分析テーブル)

Step 3: 内容を記入

原則:

  • 長文の代わりにASCII図を使用
  • 矢印(│ ▼ ┐ ┘ └ ├ ─)でデータフローを接続
  • 罫線(┌ ┐ └ ┘ │ ─)でレイヤーを区切る
  • 二重線枠(╔ ╗ ╚ ╝ ║ ═)でユーザーが見える部分を強調
  • 重要なノードにコメントを追加(← 説明)

記号使用規則:

記号用途例
│ ▼垂直フローデータは上から下へ
→ ←水平説明record_id: int ← データベース主キー
┌ ┐ └ ┘単線枠コードブロック、コマンドを囲む
╔ ╗ ╚ ╝二重線枠端末出力、重要な結果を強調
═══区切り線異なるシナリオを区切る

Step 4: 比較分析を追加

Before vs After(リファクタリングシナリオ):

# Before(問題のあるバージョン)
...コード...

# 問題点:
# - 過剰なラッピング
# - フィールドの冗長性
# - 認知負荷の増加

# After(改善バージョン)
...コード...

# 改善点:
# - 意味のある型を直接返す
# - 中間レイヤーを削減
# - 保守コストの低減

実例

事例 1:制限管理フロー(完全版)

(上記テンプレート 1 の例を参照し、4つのシナリオの完全なフローを展開)

事例 2:データクラス評価(fund_restriction モジュール)

関数以前の戻り値現在の戻り値判定理由
add_restrictionAddRestrictionResult(6フィールド)保持✅CLIで全フィールドを表示する必要がある
end_restrictionEndRestrictionResult(4フィールド)bool❌成功/失敗だけが必要
check_trading_statusCheckStatusResult(2フィールド)ParsedRestriction | None❌単純なラッパーに過ぎない

出力チェックリスト

フロー可視化ドキュメントを生成する際は、以下を含めていることを確認:

  • トップレベルの概要(機能目標、関連モジュール)
  • シナリオの列挙(成功/失敗、手動/自動など)
  • レイヤー別フローチャート(CLI → Flow → Data → 外部)
  • データベーステーブル構造(該当する場合)
  • サンプルデータとクエリ(理解を助ける)
  • 主要データクラスの説明(なぜ保持/簡略化するか)
  • 設計理由(なぜそうするのか?)
  • 将来の拡張ポイント(TODO や将来のインターフェース)

アンチパターン(避けるべきこと)

❌ フローを純粋なテキストで説明

最初にCLIレイヤーの _do_xxx 関数が呼び出され、次に _do_xxx がFlowレイヤーの xxx_flow 関数を呼び出し、
xxx_flow がDataレイヤーの xxx_repo.get メソッドを呼び出します...

✅ ASCII図を使用

CLI (_do_xxx) → Flow (xxx_flow) → Data (xxx_repo.get) → SQLite

❌ 表に重点がない

フィールド型
idint
namestr

✅ ビジネス的な意味を強調

フィールド型説明ビジネス制約
idint主キー自動生成、グローバル一意
namestrファンド名必須、表示用

❌ SQLにシナリオ説明がない

SELECT * FROM table WHERE id = ?;

✅ ビジネスシナリオ付き

-- シナリオ:ユーザーが特定の制限レコードの詳細を照会
SELECT * FROM fund_restrictions WHERE id = ?;

-- シナリオ:DCA分析時に特定の日付が制限されているか確認
SELECT * FROM fund_restrictions
WHERE fund_code = ? AND start_date <= ? AND (end_date IS NULL OR end_date >= ?);

他のスキルとの連携

  • code-style: コード例を出力する際はコーディング規約に従う
  • architecture: フローチャートはレイヤーアーキテクチャの制約に従う
  • dev-workflow: フロー整理の前に、関連コードとドキュメントを読む

まとめ

本スキルのコアバリュー:

  1. 再利用可能なテンプレート: ゼロから作成する時間を削減
  2. 統一された視覚スタイル: ASCII図+テーブル+罫線
  3. ビジネス視点: コードフローだけでなく、「なぜ」に注目
  4. 比較分析: リファクタリング前後、複数シナリオ比較
  5. チェックリスト確認: 重要な情報の漏れを防止

使用頻度: 「特定の機能がどのように動作するか」を説明する必要があるたびに使用できます。

Individual skills in this repo

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

majiayu000/claude-skill-registry-data

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry-data

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry-data

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry-data

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry-data

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry-data

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry-data

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry-data

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry-data

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry-data

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry-data

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry-data

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry-data

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry-data

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry-data

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry-data

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

majiayu000/claude-skill-registry-data

Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]

majiayu000/claude-skill-registry-data

Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".

majiayu000/claude-skill-registry-data

Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".

majiayu000/claude-skill-registry-data

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

関連スキル