nippo

Claude Code / Codex で作業するだけで日報ができる。

# Claude Code
/nippo

# Codex
$nippo

これだけで、今日やったこと・判断したこと・改善点が reports/nippo-20XX-YY-ZZ.md にまとまる。手動で何も記録する必要はない。Claude Code / Codex の作業ログがそのまま日報になる。 Claude Code では /nippo、Codex では $nippo で同じ日報生成フローを実行できる。

何が出力されるか

/nippo — 日報

# 日報 2026年03月21日（金）

## 今日の作業

- 作業時間帯: 09:14 〜 18:32（ローカルタイムゾーン）
- ソース: requested all | resolved claude, codex
- プロジェクト: nippo, oitoriaezu-owarasero
- セッション数: 35

**やったこと**

- Rust 製コレクターの設計・実装
- 全章の論理フローレビュー（16並列エージェント）

## 判断の記録

| 場面     | 選んだこと        | 他の選択肢        |
| -------- | ----------------- | ----------------- |
| 実装言語 | Rust（rayon並列） | Python（GIL制約） |

## 用語レビュー

| 使った表現      | より正確な表現       | 補足                |
| --------------- | -------------------- | ------------------- |
| lifetime エラー | 借用チェッカーエラー | lifetime はその一種 |

## 統計

- メッセージ: user 82 / assistant 958
- ツール使用: Bash(234), Read(198), Edit(70)

/nippo reflection — 自分で考えるための問い

回答は書かれない。空欄のまま出力される。書くのはあなた。

- rayon の lifetime エラーに3時間かかったとき、
  どの時点で「別のアプローチを試そう」と思いましたか？
  >
- 明日、ひとつだけ変えるとしたら何を変えますか？
  >

インストール

# 1. Rust バイナリ
cargo install nippo

# 2. リポジトリ取得
git clone https://github.com/nwiizo/nippo && cd nippo

# 3-a. Claude Code スキル（シンボリックリンク推奨）
ln -s "$(pwd)/.claude/skills/nippo" ~/.claude/skills/nippo

# 3-b. Codex スキルをグローバルに使う場合
mkdir -p ~/.agents/skills
ln -s "$(pwd)/.agents/skills/nippo" ~/.agents/skills/nippo

Codex は repo 内の .agents/skills/ も自動検出するので、このリポジトリ内で使うだけなら追加インストールなしでも使える。 Codex 対応後は、skill が見えている環境なら $nippo でそのまま実行できる。

シンボリックリンクにすると git pull でスキルとテンプレートの更新が自動反映される。 スキルディレクトリ内の docs シンボリックリンクにより、どのディレクトリから /nippo を実行してもテンプレートが正しく読み込まれる。

コピーする場合は cp -r .claude/skills/nippo ~/.claude/skills/nippo（テンプレート更新時は再コピーが必要）。

要件: Claude Code または Codex + Rust 1.85+

全コマンド

Claude Code では /nippo ...、Codex では $nippo ... を使う。引数と挙動は同じ。

日々の記録

自分で振り返る

学びを得る

他者に見せる

期間を俯瞰する

期間指定・プロジェクト指定

全コマンド共通:

/nippo daily                  # /nippo と同じ（日報）
/nippo daily codex            # Codex 履歴だけで日報
/nippo daily claude           # Claude Code 履歴だけで日報
/nippo daily all              # Claude Code + Codex を混ぜて日報
/nippo 3                      # 過去3日分
/nippo insight 30              # 過去30日分
/nippo insight 30 nippo        # nippo プロジェクトのみ
/nippo review 180              # 過去半年の自己評価

出力先はコマンドを実行したディレクトリの reports/ 配下。同じ日付・同じモードのレポートがある場合は、最新の収集結果で上書きする。

Rust CLI（単体でも使える）

スキルを介さずに、Rust バイナリを直接実行してデータを確認できる。

nippo collect --period today                     # 今日の JSON 出力
nippo collect --days 1                           # 今日の JSON 出力（ローカル日付基準）
nippo collect --days 7 --format summary          # テキストサマリー
nippo collect --source codex --period today      # Codex 履歴のみ
nippo collect --source all --days 7              # Claude Code + Codex
nippo collect --period last-week                 # 先週
nippo collect --from 2026-03-01 --to 2026-03-15  # 日付範囲
nippo collect --project ccswarm                  # プロジェクトフィルタ

--days / --from / --to / --period の日付境界は、コマンドを実行した環境のローカルタイムゾーン基準。--days 1 は「今日のローカル日付」を意味する。

期間: today | セッション: 48 | プロジェクト: 4 | 意思決定: 8
メッセージ: user 115 / assistant 1234 | ツール使用: 794
トークン: input 19146 / output 422103

プロジェクト:
  nippo                           24 セッション    1185 メッセージ
  oitoriaezu-owarasero            17 セッション      99 メッセージ

なぜ作ったか

記録と振り返りの分離

日報ツールに「今日の学び」を自動生成させていた時期がある。楽だった。楽すぎた。書いてあることは正しいのに、何も残らなかった。

思考・努力・内省まで外注してはいけない。 /nippo reflection の問いに答える5分間は、自動生成された振り返りの100行より価値がある。

リフレクション理論

アーキテクチャ

/nippo 実行
    │
    ▼
[Rust] nippo collect
    ├─ ~/.claude/projects/**/*.jsonl を rayon で並列パース
    ├─ ~/.codex/history.jsonl + state_5.sqlite + rollout データを収集
    ├─ mtime プレフィルタ + 2パスデシリアライズ
    └─ JSON 出力
    │
    ▼
[Claude] テンプレートに従いレポート生成
    │
    ▼
reports/ に保存

nippo/
├── crates/collector/src/     # Rust コレクター
│   ├── main.rs               # CLI (clap)
│   ├── filter.rs             # 日付・期間フィルタ
│   ├── session.rs            # source 共通セッション表現
│   ├── output.rs             # JSON / summary 出力
│   └── sources/
│       ├── claude_code.rs    # Claude Code JSONL パーサ
│       └── codex.rs          # Codex 履歴パーサ
├── .agents/skills/nippo/
│   └── SKILL.md              # Codex 用 skill
├── .claude/skills/nippo/
│   ├── SKILL.md              # スキル定義
│   └── docs -> ../../../docs # テンプレートへのシンボリックリンク
├── AGENTS.md                 # Codex 用 repo ガイド
├── docs/
│   ├── templates/            # 各モードのテンプレート
│   ├── reflection-theory.md  # リフレクション理論
│   └── data-sources.md       # JSONL 仕様
└── .github/workflows/ci.yml  # CI

テンプレートのカスタマイズ

docs/templates/ のテンプレートを編集すると、各コマンドの出力形式を変更できる。

テンプレートの編集に Rust の再ビルドは不要。シンボリックリンクで配置していれば、ファイルを編集するだけで即反映される。

Claude Code /insights との関係

Claude Code には組み込みの /insights コマンドがある。両者は同じセッションログを使うが、片付けたい用事（ジョブ）が違う。

使い分け:

• 仕事の振り返りをしたいなら → /nippo insight
• ツール設定を改善したいなら → /insights
• 両方やると補完的に効く

制約

• データ収集は Rust バイナリのみ。Python は使わない
• 他のスキルのスクリプトを参照しない
• 書籍・URL は紹介しない（ハルシネーションリスク）。概念名と検索キーワードを示す
• reports/ は .gitignore 済み（個人データ）

ライセンス

MIT