日報からナレッジを投稿する

このチュートリアルでは、日々の作業で得た気づきやエラー解決のノウハウを、チームのナレッジベースに投稿する方法を学びます。

このチュートリアルのゴール

日報ファイルからナレッジを抽出する流れを理解する
post_community_knowledge ツールを使ってナレッジを投稿できるようになる
投稿されたナレッジがどのようにMCPに反映されるかを知る

前提: 日報フォルダの構成

このフローは、日報をローカルの history/ フォルダに Markdown ファイルとして蓄積していることを前提にしています。

your-project/
└── history/
    ├── 2026-02-20.md
    ├── 2026-02-21.md
    └── 2026-02-25.md   ← 今日の日報

日報には、作業内容・詰まったこと・解決策などを自由に記録しておきます。フォーマットは問いません。

markdown:history/2026-02-25.md

## 今日の作業
- Cloudflare Workers + Hono で API を実装

## 詰まったこと
wrangler dev 中に KV.put() を fetch の後に呼ぶと、
レスポンスが返る前にプロセスが終了してしまい処理が完了しなかった。

## 解決策
ctx.waitUntil() でラップすることで解決。
レスポンス返却後も非同期処理を継続できる。

## 参考
https://developers.cloudflare.com/workers/runtime-apis/context/

Step 1: Claudeに日報の要約と投稿を依頼する

Claude に対して、次のように依頼するだけです。

history/ フォルダの今日の日報を読んで、
ナレッジとして投稿できそうな内容があれば post_community_knowledge で投稿してください。

Claude が日報を読み取り、投稿に値する学びを自動で抽出してツールを呼び出します。

複数日分をまとめて投稿したい場合

history/ フォルダの今週分の日報をすべて読んで、
ナレッジになりそうなエラー解決やTipsを抽出して投稿してください。

Step 2: Claudeが行うこと

依頼を受けたClaudeは、以下を自動で行います。

history/ フォルダ内の指定ファイルを読み込む
投稿に値する内容（エラー解決・Tips・設計上の発見など）を抽出
post_community_knowledge ツールを呼び出して投稿

ツール呼び出しのイメージ:

json

{
  "title": "Cloudflare Workers で fetch 後に KV.put を呼ぶと処理が完了しない",
  "content": "問題: fetch() のレスポンス後に KV.put() を呼ぶとタイムアウトする\n\n原因: Workers はレスポンスを返した時点で実行コンテキストが終了する\n\n解決策: ctx.waitUntil() でラップする\n\n```ts\nctx.waitUntil(env.KV.put('key', value));\nreturn new Response('ok');\n```",
  "category": "error-solution",
  "tags": ["Cloudflare Workers", "KV", "fetch"]
}

Step 3: 投稿後の流れ

投稿が完了すると、Claudeから確認メッセージが返ります。

ナレッジを投稿しました！
開発チームがレビュー後にMCPサーバーへ反映します。ありがとうございました。

その後、開発チームがGitHub上でナレッジを確認・レビューし、MCPサーバーに反映します。反映されると、そのナレッジは全ユーザーが利用できるようになります。

あなたの日報 → post_community_knowledge → GitHub Issue
                                              ↓
                                        開発チームがレビュー
                                              ↓
                                        MCPサーバーに反映
                                              ↓
                                        全ユーザーが活用

ナレッジとして投稿しやすいもの

種別	例
エラーと解決策	ライブラリのバージョン起因のエラーと回避策
Tips	開発効率を上げるコマンドやショートカット
アーキテクチャ	設計の意思決定とその理由
ツール	便利なツールの使い方・設定

まとめ

日報を書く習慣があれば、追加の手間なしにチームのナレッジを積み上げていけます。「今日詰まったこと」をそのまま日報に書いておき、月末にまとめて投稿するといった使い方も有効です。

ツールの詳細は APIリファレンスを参照してください。

日報からナレッジを投稿する ​

このチュートリアルのゴール ​

前提: 日報フォルダの構成 ​

Step 1: Claudeに日報の要約と投稿を依頼する ​

Step 2: Claudeが行うこと ​

Step 3: 投稿後の流れ ​

ナレッジとして投稿しやすいもの ​

まとめ ​