octkp/ba2-memo

ba2-memo

チケット番号に紐づかない日々の作業メモを、日付軸で体系化して残すスキル。 朝会・MTG のメモ、調べた小ネタ、TODO、判断の経緯などを、月単位のファイルに日付見出しで追記していく。

既存スキルとの違い

• ba2-ticket-knowledge-logger … チケット単位（BAX-XXXX/ ディレクトリ）。特定チケットの調査・実装の記録。JIRA にもコメント投稿する。
• ba2-memo（このスキル） … 日付単位（YYYY-MM.md）。チケットを横断する日々の雑多なメモ。JIRA 投稿はしない。

「このメモは特定の BAX チケットの調査・実装記録だ」と明確なら ba2-ticket-knowledge-logger を案内する。日付軸の雑多なメモなら本スキルを使う。

メモ と 雑記 の使い分け（git管理の有無）

同じ docs/{苗字}/ 配下でも、用途で2つに分ける。メモ/ は共有リポ（main）に push される共有物、雑記/ はgitignore でローカルのみの非共有。

大前提：メモ/ に書くのは「共有してよいこと」だけ。 メモ/ は git 管理されチーム共有 main に push されるので、ここに入れる内容は共有前提とみなす。ユーザーが「メモして」と言った内容は、原則そのまま メモ/ に追記してよい（共有してよいものを書いている前提）。 スキル（Claude）側が私的かどうかを勝手に判定して 雑記/ へ振り分けることはしない。 雑記/ に回すのは、ユーザーが「これは雑記で」「私的だから残さなくていい」等と明示したときだけ。

• メモ（docs/{苗字}/メモ/YYYY-MM.md）… 共有してよい日付軸の作業ログ。git管理対象。本スキルが自動コミット＆プッシュする（後から振り返る・横断検索する前提）。
• 雑記（docs/{苗字}/雑記/）… 叩き台・検討メモ・MTG資料の下書き・使い捨ての個人メモ、共有したくない私的な内容など。.gitignore で docs/*/雑記/ を無視しているためgit管理しない（コミット・プッシュしない）。

判断の目安:

• 既定（ユーザーが「メモして」とだけ言った）→ メモ（共有してよい前提で commit する）
• ユーザーが「雑記で」「下書き」「私的」「残さなくていい」と明示 → 雑記（commit しない）

雑記にファイルを作ったときの注意:

• コミット・プッシュは行わない（保存だけして終わる）。
• リポに docs/*/雑記/ の .gitignore 設定が無ければ、.gitignore に docs/*/雑記/ を追記してから保存する（git check-ignore "docs/$USER_NAME/雑記/<file>" で無視されることを確認する）。
• 過去に雑記相当のファイルを誤って追跡していた場合は git rm --cached <path> で追跡から外す（共有 main に push 済みなら履歴の巻き戻し＝force push はしない。前向きに「以降追跡しない」対応に留める）。

前提

• 実行場所: ba2-workspace リポ内で実行すること（git rev-parse --show-toplevel で REPO_ROOT を解決する）。
• JIRA 認証は不要: 本スキルは JIRA へコメント投稿しない。BAX-XXXX は静的に JIRA URL へリンク化するだけ。

出力先の解決（実行時に動的解決）

固定パスではなく、実行時に以下の手順で USER_NAME / REPO_ROOT / MEMO_FILE を解決する。

ユーザー名（苗字）

# whoami の末尾の _◯（最後の _ 以降）を除いた苗字をフォルダ名にする
# 例: takano_y -> takano / ushiroyama_k -> ushiroyama / _ を含まなければそのまま
USER_NAME=$(whoami | sed 's/_[^_]*$//')
[ -z "$USER_NAME" ] && USER_NAME=$(whoami)  # フォールバック

REPO_ROOT

REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
if [ -z "$REPO_ROOT" ]; then
  echo "ERROR: ba2-workspace リポ内で実行してください" >&2
  exit 1
fi

• 環境変数・設定ファイル・対話によるパス入力は使わない（スキルとナレッジが同居しているため）。

当月メモファイル

# 現在の年月（追記対象の月）。過去日を指定された場合はその月に合わせる
YM=$(date "+%Y-%m")                       # 例: 2026-05
MEMO_DIR="$REPO_ROOT/docs/$USER_NAME/メモ"
MEMO_FILE="$MEMO_DIR/$YM.md"              # 例: .../docs/takano/メモ/2026-05.md
mkdir -p "$MEMO_DIR"

ファイル構造

月1ファイル。見出し階層は以下で固定する。

# 2026-05 メモ

## 5/8 (金)

### FUKURIリダイレクトの工数見直し([BAX-11445](https://kokopelli-inc.atlassian.net/browse/BAX-11445))
中野さんとペアプロ的に見た。test4 で確認できたので概ね安心。
- [ ] 5/12 に再度1時間とって工数確定する

### 05/25リリース
- [ ] 長時間トランザクション（[BAX-11333](https://kokopelli-inc.atlassian.net/browse/BAX-11333)）終わりそう？
- [x] 課金データ作成のパフォーマンス改善 → リリース待ちにした

## 5/9 (月)

### Yappliアカウントについて
...

• H1（# YYYY-MM メモ）= ファイルタイトル。1ファイルに1つ。
• H2（## M/D (曜)）= 日付見出し。曜日は date で取得した実際の曜日を入れる。
• H3（### トピック）= その日のトピック。本文は箇条書き・TODO・リンクを含む素のテキスト。

ワークフロー A: 当日メモに追記

ユーザーが「今日のメモに○○」「メモして」「これ記録しといて」などと言った場合。

1. 追記対象の日付・ファイルを決める

TODAY_H2=$(date "+%-m/%-d (%a)" | sed 's/Mon/月/;s/Tue/火/;s/Wed/水/;s/Thu/木/;s/Fri/金/;s/Sat/土/;s/Sun/日/')
# 例: 5/29 (金)

• 既定は当日。ユーザーが「昨日の」「5/14の」など過去日を指定したらその日付・その月のファイルに合わせる（必要なら YM を変える）。

2. ファイル・日付見出しの存在確認

• MEMO_FILE が無ければ # YYYY-MM メモ の H1 を持つ新規ファイルを作る。
• 当日の H2（## M/D (曜)）が無ければファイル末尾に追加する。
• 既にあればその H2 セクションの末尾に追記する（既存トピックは壊さない）。

3. 内容を構造化して追記

会話の内容を H3 トピック単位に整理して書く。整形は最小限（素の言い回しは残す）だが、以下だけは必ず行う:

• BAX-XXXX のリンク化: 本文中の BAX- + 数字を [BAX-XXXX](https://kokopelli-inc.atlassian.net/browse/BAX-XXXX) に変換する。既にリンク化済みのものは二重変換しない。
• TODO のチェックボックス化: 「○○する」「○○しないといけない」「確認する」「依頼する」等の未完了アクション、および「やること」リストは - [ ] にする。完了が明示されたもの（「DONE」「完了」「済み」「→やった」）は - [x] にする。
• それ以外（経緯・気づき・調査結果・引用 URL・Slack/Notion リンク）はそのまま箇条書き or 段落で残す。

4. 自動コミット＆プッシュ（確認不要）

docs/ 配下は main 直プッシュ可。当該メモファイルのみを add してコミット＆プッシュする。

cd "$REPO_ROOT" && \
git add "docs/$USER_NAME/メモ/$YM.md" && \
git commit -m "memo($USER_NAME): $YM $TODAY_H2 追記

Co-Authored-By: Claude Opus 4.8 <[email protected]>" && \
git push origin main

• 対象は当該メモファイルのみ add する（無関係な変更を巻き込まない）。
• 差分が無い場合（nothing to commit）はスキップしてよい。
• push 失敗時はエラーを表示するが、ローカルファイルの追記は完了とみなす。
• コミットメッセージ末尾に Co-Authored-By 行を付ける。

ワークフロー B: 振り返り・横断検索

ユーザーが「先週のメモ見せて」「FUKURI の件どうなった？」「5月のメモまとめて」「あの件のメモどこ？」などと言った場合。

1. 検索範囲を決める

• 期間指定（「今週」「先週」「今月」「5/14」など）→ 該当する YYYY-MM.md（複数月にまたがるなら複数ファイル）を対象にする。
• キーワード指定（「FUKURI」「BAX-11445」「ソニペイ」など）→ メモディレクトリ全体を対象に検索する。

MEMO_DIR="$REPO_ROOT/docs/$USER_NAME/メモ"
# キーワード検索（ファイルと行番号、見出し文脈つき）
grep -rn "FUKURI" "$MEMO_DIR"

2. 読み取り・要約

• 該当ファイル／該当箇所を読み、どの日付の・どのトピックで・何が書かれていたかを時系列で要約する。
• 同じトピックが複数日にまたがる場合は、日付順に経緯（最初の言及 → その後の進展 → 現状）をまとめる。
• 出典として YYYY-MM.md の日付・トピック見出しを明記する（後から本人が辿れるように）。

3. 未完了 TODO の横断集計

「未完了TODO」「やり残し」「TODO一覧」などと言われた場合。

# 全メモから未完了 TODO（- [ ]）を、ファイル名・行番号つきで抽出
grep -rn "^- \[ \]" "$REPO_ROOT/docs/$USER_NAME/メモ"

• 抽出した - [ ] を、それが属する日付見出し（直前の ## M/D）と紐付けて一覧化する。
• 古いものほど対応漏れの可能性が高いので、日付の古い順に並べると気づきやすい。

使用例

当日メモに追記

ユーザー: 「今日のメモに、DB再起動は毎週月曜19時にSREがやる流れになった、って書いといて」

実行:

1. docs/takano/メモ/2026-05.md を開く（無ければ作る）
2. ## 5/29 (金) を確認／追加
3. ### DB再起動 トピックを追記
4. 当該ファイルを自動コミット＆プッシュ

振り返り

ユーザー: 「FUKURIリダイレクトの件、今までの経緯まとめて」

実行:

1. docs/takano/メモ/ を FUKURI で grep
2. 5/8・5/15・5/19・5/21・5/22 の言及を日付順に読む
3. 「工数見直し → 中野さんと整理 → 三島さんへ共有 → 5/21 MTG → リロ側カテゴリ変更」と経緯を時系列要約

未完了 TODO

ユーザー: 「今月のやり残し教えて」

実行:

1. 2026-05.md から - [ ] を抽出
2. 日付見出しと紐付けて一覧化し、古い順に提示

注意事項

• 日付軸で残す。チケット単位の調査・実装記録は ba2-ticket-knowledge-logger を案内する。
• 既存トピック・既存日付セクションは壊さず追記する（上書きしない）。
• 機密情報（パスワード、API キー、内部認証情報等）はメモに書かない。
• 整形は最小限。本人の言い回し・ニュアンスを勝手に要約・改変しない（追記時）。リンク化と TODO チェックボックス化だけは必ず行う。
• メモファイル更新後は当該ファイルのみ自動コミット＆プッシュする（docs/ 配下は main 直プッシュ可。ユーザー確認不要）。
• メモ/ に書くのは共有してよいことだけ（共有 main に push されるため）。スキル側が私的か否かを勝手に判定して振り分けることはしない。私的・下書き・使い捨てはユーザー明示時のみ docs/{苗字}/雑記/（gitignore 対象）へ置き、コミット・プッシュしない。git 管理して残すのは メモ/（日付軸の作業ログ）だけ。