Claude-skill-registry-data markdown-session-format

Claude Codeセッションの標準的なMarkdownフォーマット規約。セッションログ、対話履歴、ツール実行結果を一貫した構造で記録する必要がある場合に使用。不正確な情報への注釈方法とnb標準のハッシュタグ形式も定義

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry-data

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry-data "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/markdown-session-format" ~/.claude/skills/majiayu000-claude-skill-registry-data-markdown-session-format && rm -rf "$T"

manifest: data/markdown-session-format/SKILL.md

source content

Claude Code セッションマークダウンフォーマット規約

このSkillは、Claude Codeのセッション内容を記録する際の標準的なマークダウンフォーマットを定義します。

ファイル命名規則

YYYYMMDDHHMMSS.md

例:

20251120173000.md

(2025年11月20日 17:30:00)

基本構造テンプレート

# [セッションタイトル] - YYYY-MM-DD HH:MM:SS

`#tag1` `#tag2` `#tag3`

## 概要
[セッションの目的、達成内容、主要な成果を3-5行で要約]

## 対話履歴

### プロンプト 1: [簡潔なタイトル]

> ユーザーの入力内容をそのまま引用

**Claudeの応答**:
[応答内容のサマリーまたは重要な部分]

**実行ツール**:
1. ツール: `ToolName`
   - 主要パラメータ: `value`
   - 目的: [なぜこのツールを使ったか]

<details>
<summary>📄 実行結果の詳細</summary>

```language
[ツールの出力内容をそのまま記載]

</details>

結果: ✅ 成功 / ❌ エラー / ⚠️ 警告

プロンプト 2: [簡潔なタイトル]

...

参照した公式ドキュメント

すべての公式ドキュメントリンクを検証済みであることを示す：

✅ ドキュメント名 - 検証日: YYYY-MM-DD
- 使用箇所: プロンプト N
- 抽出情報: [具体的に何を参照したか]

不正確な情報への注釈

情報の正確性に問題がある場合、以下のフォーマットで警告を追加：

[!WARNING] 不正確な情報を検出

該当箇所: [具体的な記述] 問題点: [何が不正確か] 根拠: [WebFetch/context7による検証結果] 正しい情報: [検証済みの正確な情報]

推論ベースの内容には明示的にマーク：

[!NOTE] 推論: この内容は公式ドキュメントに基づかない推測です。

[推論内容]

学んだこと・重要なポイント

セッションから得られた知見を箇条書き：

✅ [成功したアプローチ]
💡 [発見した重要な概念]
⚠️ [注意すべき落とし穴]

試して失敗した方法

学習価値のため、うまくいかなかった試行も記録：

❌ 試したこと: [具体的な方法]
- 失敗理由: [なぜうまくいかなかったか]
- エラーメッセージ:
```
[実際のエラー文]
```
- 学び: [この失敗から何を学んだか]

実行コマンドのサマリー


## 主要なコマンドを再実行可能な形で記録

command1
command2

次のステップ・TODO

未完了のタスク
フォローアップが必要な項目

メタデータ

作業ディレクトリ:
```
/path/to/working/directory
```
Claudeモデル:
```
model-name
```
セッション開始: YYYY-MM-DD HH:MM:SS
セッション終了: YYYY-MM-DD HH:MM:SS
総ツール呼び出し数: N
成功: N / 失敗: N


## タグ（ハッシュタグ）規約

### フォーマット

nb標準の `#hashtag` 形式を使用します。**重要**: フォーマッタ対策のため、各タグは必ずバッククォートで囲むこと：

```markdown
# タイトル

`#tag1` `#tag2` `#tag3`

タグ配置

タイトル（
```
#
```
見出し）の直後の行に配置
各タグはバッククォート（`）で囲む
1行にスペース区切りで複数タグを記載
タグ行は空行で区切らない

タグ選定基準

1. 技術・ツール系タグ（使用した主要技術）:

```
#git
```
,
```
#aws
```
,
```
#typescript
```
,
```
#python
```
,
```
#docker
```
```
#claude-code
```
,
```
#mcp
```
,
```
#bash
```

2. テーマ系タグ（セッションの目的）:

```
#debugging
```
,
```
#refactoring
```
,
```
#documentation
```
```
#troubleshooting
```
,
```
#configuration
```
,
```
#setup
```

3. ドメイン系タグ（関連分野）:

```
#infra
```
,
```
#security
```
,
```
#frontend
```
,
```
#backend
```
```
#devops
```
,
```
#automation
```
,
```
#monitoring
```

4. 記録タイプ系タグ:

```
#session-log
```
,
```
#learning
```
,
```
#investigation
```
```
#solution
```
,
```
#workaround
```

タグ数の目安

最小: 2個
推奨: 3-5個
最大: 5個（可読性のため）

タグの命名規則

すべて小文字
複数単語は
```
-
```
でつなぐ（例:
```
#claude-code
```
,
```
#session-log
```
）
既存のnbノートブック内のタグと整合性を保つ

タグ例

デバッグセッション:


```text

```text

```markdown

## Git pre-commit hook エラーの解決 - 2025-11-20 17:30:00

`#git` `#debugging` `#troubleshooting`

インフラ設定:


## AWS CDKでS3バケット暗号化設定 - 2025-11-20 18:00:00

`#aws` `#infra` `#security` `#cdk`

ドキュメント作成:


## Claude Code Subagentsの調査と設計 - 2025-11-20 19:00:00

`#claude-code` `#documentation` `#learning` `#investigation`

フォーマット原則

時系列順: すべての対話を発生順に記録
完全性: プロンプト、ツール呼び出し、結果をすべて含める
検証可能性: リンクと情報源を明示
再現性: 他者が同じ手順を追えるように記述
学習価値: 成功と失敗の両方を記録
タグ付け: 検索性を高めるため適切なハッシュタグを付与

使用例

このSkillは以下のような場面で参照されます：

```
session-exporter
```
Subagentがセッションログを作成する際
手動でセッション記録を作成する際
他のエージェントがセッションフォーマットを参照する必要がある際
nbノートブックで過去のセッションを検索する際（タグで絞り込み）