目次
- このページで分かること
- 実践ログ化で大事なこと
- 記事化する流れ
- 実践ログ化テンプレート
- やってはいけないこと
- 公開前チェックリスト
- 関連ページ
このページで分かること
Codexの作業報告は、その場の完了確認だけでなく、実践ログ型ガイドの記事素材にもなります。ただし、自動公開はせず、人間が確認し、一般化し、匿名化してから公開する必要があります。
実践ログ化で大事なこと
- 作業報告をそのまま公開しない
- 実ドメイン名や案件名を出さない
- 内部の保存場所を出さない
- 秘密情報を出さない
- 作業パターンとして一般化する
- 読者が使える指示文とチェックリストに直す
この形で実際に運用しているのがclaude-code.tokyoです。うまくいった手順だけでなく、誤った判断をした過程とその原因まで残す方針で、実測値と日付を必ず添える形にしています。書き方の方針を決める時の参考になります。
記事化する流れ
報告書を読む
変更内容、確認結果、未確認事項を見る。
転用可否を判断する
一般化して役立つ作業か確認する。
伏せる情報を消す
固有名詞や内部情報を一般化する。
指示文に変える
次回使える依頼文へ整える。
チェックリスト化する
読者が再利用できる確認項目にする。
実践ログ化テンプレート
転用可否:
理由:
記事タイトル案:
一般化した作業内容:
公開してよい表現:
伏せるべき情報:
使ってはいけない表現:
次回使える指示文テンプレート:
確認チェックリスト:
関連ページ:
記事化する場合のURL案:
注意点:「日記」と「実践ログ」の分かれ目
同じ作業記録でも、読者に価値があるかどうかは書き方で決まります。分かれ目は「読んだ人が自分の作業に持ち帰れるものがあるか」です。
| 日記になってしまう書き方 | 実践ログになる書き方 | |
|---|---|---|
| 出来事 | 「今日は404エラーを直した」 | 「404の原因は大文字小文字の違いだった。同じ症状ならまずここを疑う」 |
| 手順 | 「Codexに頼んだらやってくれた」 | 「この指示文で頼んだら1回で通った」と実際の指示文を載せる |
| 失敗 | 「うまくいかなくて大変だった」 | 「この指示だと範囲が広がりすぎた。絞る書き方に変えたら安定した」 |
| 結論 | 「無事終わってよかった」 | 「次回も使えるチェックリストはこの5項目」 |
コツは、書く前に「この記事を読んだ人が、明日の自分の作業で何をコピーできるか」を1つ決めることです。コピーできるもの(指示文、チェックリスト、原因の切り分け表)が1つもない記事は、内容がどれだけ詳しくても日記側に落ちます。逆に、短い記事でもコピーできるものが1つあれば実践ログとして成立します。
やってはいけないこと
- 作業報告をそのまま貼る
- 内部情報を残す
- 秘密情報の有無を確認しない
- 結果保証の表現にする
- 読者が再利用できない日記で終える
公開前チェックリスト
- 匿名化した
- 一般化した
- 伏せる情報を消した
- 禁止表現を確認した
- 指示文テンプレートがある
- 確認チェックリストがある
- 関連ページへリンクした
- 人間が確認した


