Skip to main content

slog

About 2 min

slog

作業ログ, ノート

slogとは

slogとは、以下の決まりで書いていく作業メモの事。SagyouLOGでslog。

  • 単なるmdファイルを特定のフォルダ下に置いていく
  • mdファイルは日付から生成されるファイル名
  • ファイルの先頭は必ずその作業のタイトルを書く

具体的な形式などは以下の各項目を参照のこと。

哲学

作業ログをいい感じにローカルに書いていくのに必要な決まりごとを考えた。考察は作業ログの方にも書いてある。

  • 気軽に新規の作業ログを開始出来る
    • ファイル名に頭を使わずに始められる（newfile.commandをダブルクリックするだけ）
    • タイトルは後で変更してもファイル名に影響無し（始めた後にタイトルを考えられるように）
  • 一つの作業ログに何を書き足してもほかの作業をしている時は目に触れない
    • 1作業1ファイル
    • 大量のログなどを貼っても他のメモを邪魔しない
  • ログやコマンド、コード片などを何も考えずにコピペしていける
    • ゆるいmdフォーマットだがmd違反があっても気にしない、プレーンテキスト
  • フォルダごとSyncthingで同期

新規ファイル作成スクリプト

ファイル名は2025_1212_211312.md とかにする。以下のスクリプトで作る。

#!/usr/bin/env bash

BASENAME=`date "+%Y_%m%d_%H%M%S"`


DEST=$(dirname $0)
FILENAME="$DEST/${BASENAME}.md"
echo $FILENAME
echo "# " > $FILENAME

Mac上ではnewfile.commandというファイルでslogのディレクトリに置いて、Finderからダブルクリックで作っている。 名前を考える前にダブルクリックで始められる、というのが結構良い。

一覧を選ぶシェルスクリプト

Copilotに書かせてみたらfzfを使ったいい感じのが出来た。

#!/usr/bin/env bash

DIR=$(dirname $0)

# 一時ファイルに日付とタイトルを抽出
LIST=$(for file in "$DIR"/*.md; do
    title=$(head -n 1 "$file" | sed 's/^# *//')
    date=$(basename "$file" .md | sed 's/_/ /g')
    echo "$date | $title | $file"
done)

# fzfで選択
SELECTED=$(echo "$LIST" | fzf --with-nth=1,2 --delimiter="|" --preview 'head -n 20 {3}' --preview-window=down:wrap)

# ファイルパスを抽出して開く
FILE=$(echo "$SELECTED" | awk -F '|' '{print $3}' | xargs)
[ -n "$FILE" ] && open "$FILE"

タイトルと日付のリストで、上にフォーカスを当てると先頭20行が表示される。すげー便利。 これもFinderからダブルクリックで使っている。

こういうの書かせるにはLLMは最強だな。

使ってみた感想

以下に雑多な感想などを書いてみる

結構いい感じだ 2026-01-04 (日)

単にちょっとした決まりごとを決めてシェルスクリプトを二つ書いただけなのだが、凄くいい感じだ。 WIkiなどに統合するよりも単なるテキストファイルにしてVSCodeで書く方が良い。 正しい事を始めた感じがする。

今の所スクショが貼れないが、MdImgr使って貼れるように考えてもいいかもしれない。この辺は必要になったら考える。 先に始められているのがこのコンセプトの正しさを証明している気がする。

日報との使い分け 2026-01-06 (火)

slogを書いていると日報的な毎日何やったかを書く作業ログの記述が過小になりがちという問題があるかもしれない。 今やってる作業がMFGStudioのオープンソース化という、社内ライブラリの依存を粛々と切っていくだけの作業なのでそうなっているだけかもしれないが。

1日にやった事箇条書き、一週間のまとめ、一ヶ月のまとめ、くらいはやっぱり別に欲しいんだよなぁ。

皆様の反応

slogの話をしたらomo先生は以下のような感じとか。

Per-Bug Pages - 2026-01-05 / Spinach Forest

違う部分もあるがモチベーションと解決策にはかなり近いものがある。 バグとかチケットごとのテキストファイルを専用のフォルダに置く、というのは何かの答えなのかもしれない。

Per-task notes - @kyanny's blog

元々作業ログのページはkyanny's blogのやり方のリンクから始まっている事からも明らかなように、影響はかなり受けているかもしれない。 細部はそれぞれ違っていて、その違いはそれぞれの環境の違いから来るのだろうな。

  • Daily Notes的なものが別にある
  • タスクごとに別個のmdファイルがある
  • 特定のフォルダに置く

このくらいは結論として良いのかもしれない。