nippo
本日の作業実績(コミット・PR・チケット・Claude Code のセッション履歴)を集めて日報を作成・最新化する。1日に何度実行してもよい。
SKILL.md.claude/skills/nippo/SKILL.md
GitHub日報完成プロンプト
分析対象ファイル
$HOME/nippo/$(date +%Y)/$(date +%m)/nippo.$(date +%Y-%m-%d).md
ここはリモート追跡ありの private リポジトリ(github.com/NakamuraFumiya/nippo)。
このスキルは push しない。push は /nippo-push で行う。
実行指示
1. 現在の日報ファイルを読み込む
ファイルが存在しない場合は、手順 2 で集めた内容から新規作成する。 直近の日報ファイルを読んで書式を揃える。
2. 本日の作業実績を集める
ファイルの有無にかかわらず毎回行う。 ファイルに既に書かれている作業ログは
nippo コマンドや手書きで入れた分しかなく、それだけでは実態を取りこぼす。
A. コミット・PR・チケット
- 本日のコミット(作業中のリポジトリと worktree を対象に
git log --since) - 本日触った PR の状態(
gh pr view/gh pr list) - 関連チケット(Linear MCP の
get_issue。見つからなければ Jira MCP のjira_get_issue)
B. Claude Code のセッション履歴
コミットに残らない作業(調査・原因究明・設計判断・レビュー対応・採用しなかった案)は ここにしか残らない。学びと気づきの主な供給源になるので必ず読む。
python3 -c "
import sys, json
for filepath in sys.argv[1:]:
project = filepath.split('projects/')[1].split('/')[0]
project = project.replace('-Users-fumiyanakamura-', '').replace('-Users-fumiyanakamura', '(home)')
messages = []
with open(filepath) as f:
for line in f:
d = json.loads(line)
if d.get('type') != 'user':
continue
content = d.get('message', {}).get('content', '') if isinstance(d.get('message'), dict) else ''
texts = [content] if isinstance(content, str) else [
c.get('text', '') for c in content if isinstance(c, dict) and c.get('type') == 'text']
for text in texts:
text = text.strip()
if len(text) > 5 and not text.startswith(('<command-', '<local-command')):
messages.append(text[:200])
if messages:
print(f'=== Project: {project} ===')
for m in messages:
print(f' - {m}')
print()
" $(find ~/.claude/projects -name "*.jsonl" -not -path "*/subagents/*" -mtime 0)
会話の流れから作業の文脈を読み取り、発言の羅列ではなく意味のある要約にする。 中断・リトライ・コマンド実行などのノイズは除く。
セッション履歴には認証情報・実データ・同僚の氏名がそのまま残っていることがある。 日報へ写す段で必ず落とす(手順 7 を参照)。
C. 作業ログへの反映
集めた内容のうち、既存の作業ログに無いものを時系列で追記する。 既にある記述と重複させない。手で書かれた記述は上書きしない。
3. 各セクションの状況を確認
- 📝 作業ログ: 本日の全活動を時系列で確認
- 🎯 今日の目標: 設定された目標と達成状況
- 📊 進捗状況: 空欄や不完全な記述を確認
- 💡 学びと気づき: 追加すべき学習内容や気づき
- 🚀 明日への申し送り: 空欄や不十分な内容を確認
4. 以下の分析と補完を実行
A. 進捗状況の自動生成
作業ログから以下を抽出して「📊 進捗状況」セクションに追記:
- 完了したタスクのリスト
- 進行中のタスクとその進捗率
- 今日の主要な成果
- 時間配分の分析
B. 学びと気づきの補強
作業ログから以下を抽出して「💡 学びと気づき」セクションに追記:
- 新しく習得した技術や知識
- 発見した問題や課題
- 効率化のアイデア
- 今後の改善点
C. 明日への申し送りの生成
以下を分析して「🚀 明日への申し送り」セクションを充実:
- 未完了タスクの整理
- 明日優先すべき作業
- 注意点や引き継ぎ事項
- 必要なリソースや準備
D. 目標達成度の評価
「🎯 今日の目標」セクションに以下を追加:
- 各目標の達成度(%)
- 未達成の理由分析
- 明日に繰り越すべき目標
5. サマリーセクション
日報の最後に「## 📋 本日のサマリー」を置き、以下を記載:
- 主要成果: 今日達成した最も重要なこと(3つまで)
- 学習効果: 新しく得た知識やスキル
- 課題: 明日解決すべき問題
- 総合評価: 今日の働きを5段階で評価とその理由
既に存在する場合は、追加せず中身を書き直す。 ファイル内に 「## 📋 本日のサマリー」は常に1つだけ存在する状態にする。
6. 出力形式
- 空欄や「(〇〇時に記入)」となっている箇所を具体的な内容で置き換え
- 新しく生成する内容は既存の書式に合わせる
- 箇条書きは Markdown のリスト記法(
-)を使う。•などの記号文字は リストとして解釈されず、GitHub 上で行が繋がって表示される - ネストは親のマーカー幅に合わせて 2 スペース単位でインデントする
6-1. 1日に何度実行しても壊れないこと
このスキルは 1 日に複数回実行される。午前に一度回してから、午後に 最新化するために再実行する使い方を前提にする。
- セクションは追加ではなく更新する。 対象セクションが既にあれば、 見出しを増やさず中身を書き直す。同じ見出しが2つ以上できてはいけない
- 手で書かれた内容は消さない。 作業ログのうち、自分で書いた記述や
nippoコマンドが入れた時系列の記録はそのまま残す。 書き換えてよいのは、このスキルが生成した分析セクション (進捗状況・学びと気づき・明日への申し送り・目標の達成度・サマリー) - 後から増えた作業を取り込む。 2 回目以降も手順 2 をやり直し、前回の実行以降に 増えたコミット・PR・セッション履歴を読んだうえで、分析セクション全体を現時点の 内容で作り直す。前回の記述をそのまま温存しない(古い達成度や「レビュー中」が残る)
- 実行後、同じ見出しが重複していないか確認する
7. 記載してよい情報の範囲
日報は個人アカウントのリポジトリに push される。会社の管理外に置かれる前提で、 以下のルールで書く。判断に迷うものは書かない。
書かない
- 認証情報全般(トークン・パスワード・API キー・接続文字列・署名付き URL)
- 顧客・学校・企業の実名、および個人を特定できる情報(氏名・メールアドレス・電話番号)
- 同僚の氏名・アカウント名。発言を引用する必要があるときは「レビューで指摘があった」等、 誰の発言かを伏せた形にする
- 社内ドキュメント・Slack の URL。参照元を残したい場合はドキュメントの表題だけにする
- 実データの値そのもの(レコードの中身、SQL の生の実行結果)
- チケットや PR のタイトルの引き写し。自分で書いたとは限らず中身を制御できないため、 何をしたかは自分の言葉で書く(例:「説明会フォームの郵便番号バリデーションを追加」)
要約に留める
- 障害・ポストモーテムは、技術原因と再発防止の要点だけを自分の言葉で書く。 社内ドキュメントの本文を引き写さない。影響ユーザー数・発生時刻などの運用値も書かない
- DB を調べた結果は、判断の根拠になる集計値(件数・割合)までにする
書いてよい
- 社内リポジトリ名・PR 番号・チケット番号・コミットハッシュ。 自分の作業を後から辿るのに要る。番号は単体では意味を持たず、 リポジトリ名と組でしか使えないため、片方だけ伏せる意味はない
- 技術的な原因と対処。ライブラリ名・バージョン・設定値
- 自分の学びと気づき
8. 注意事項
- 作業ログの内容から客観的に分析すること
- 過度に楽観的にならず、現実的な評価を行うこと
- 明日のスケジュールや優先度を考慮した申し送りにすること
- 学びや気づきは具体的で実用的な内容にすること
- チケット番号・PR 番号には、何の作業かが分かる説明を必ず添える
- 番号だけでは後から見返したときに内容が分からないため、全セクションで徹底する
- 元の情報は Linear MCP の
get_issue(見つからなければ Jira MCP のjira_get_issue)やgh pr view {番号} --repo {org/repo}で読む。 ただしタイトルをそのまま貼らず、自分の言葉に直して書く