| name | note |
| description | 会話で学んだことをトピック単位で brain vault に知識ノートとして保存する。 Claude Code で /note、Codex で $note と入力したとき、または「ノートに残して」「ノートにして」「メモしておいて」と言ったときに使用する。 |
| argument-hint | トピック名(任意) |
/note
会話で得た知識を brain vault に Zettelkasten 形式のノートとして保存する。
トピック抽出
会話を振り返り、学んだトピックの候補を一覧提示する。
- トピック名 + サマリーの形式
- スキルを呼び出した発話でトピックが指定されていれば、それを優先する
- 候補がなければ「特になし」で終了
ユーザーが保存したいトピックを選んでから次へ進む。
brain vault の worktree 作成
git remote が nozomiishii/brain を指す clone をホストの project 一覧または既存の local clone から探し、その絶対パスを REPO とする。sibling の wt SKILL.md を明示的に読む。clone が見つからなければ、その repo 準備手順を使う。Claude Code の branch 名は note-<トピックの英訳 kebab-case>、Codex は wt skill が codex/note-<トピックの英訳 kebab-case>-<task suffix> を作る。作成結果の worktree 絶対パスを WT、実際の branch 名を BRANCH として保持し、ホスト固有の配置場所から再構築しない。
ノート作成
選ばれたトピックごとに brain/main/<ノート名>.md に作成する。ノート名はトピック名そのままの日本語。スペースを含んでよく、ファイル名に使えない文字だけ置き換える。
frontmatter のスキーマは $REPO/scripts/schemas/obsidian/main.ts を読んで従う。
ノートの要件:
重複チェックと関連ノート整理
ノートを作成したら、コミットする前に既存ノートとの重複・関連を確認する。
# タイトル・タグ・キーワードで既存ノートを検索
grep -rl "<キーワード>" "$WT/brain/main/" | head -10
確認する観点:
- 同じトピックのノートが既に存在しないか(重複防止)
- 関連する既存ノートがあれば
[[wiki-link]] で相互リンクを張る
- 既存ノートに追記した方が良い内容であれば、新規作成ではなく追記を提案する
結果をユーザーに報告する:
- 重複候補が見つかった場合: 「既存の
<ノート名> と内容が重なりそうです。追記 / 新規 / スキップのどれにしますか?」
- 関連ノートが見つかった場合: 「
<ノート名> に wiki-link を追加しました」
- 見つからなかった場合: そのまま次へ進む
ユーザー確認
ノートを作成したら、コミットする前にユーザーに内容を確認してもらう。
確認用に、作成したノートを現在のホストで開ける Markdown リンクで出力する。
Claude Code では cwd 相対のリンクを使う。cwd は予測できないのでこう作る:
python3 - "$WT/brain/main/<ノート名>.md" <<'PY'
import os, sys
target = sys.argv[1]
rel = os.path.relpath(target, os.getcwd()).replace(" ", "%20")
print(f"[{os.path.basename(target)}]({rel})")
PY
Codex では現在の response rules に従う。通常は $WT を展開した絶対パスを Markdown リンクの target にする。スペースを含む target は山括弧で囲む。
承認を得てから次へ進む。
commit, push, PR
worktree 内で commit → push し、PR を作成する。複数ノートは 1 つの PR にまとめる。
git -C "$WT" add "brain/main/<ノート名1>.md" "brain/main/<ノート名2>.md"
git -C "$WT" commit -m "chore: add <topic> note"
git -C "$WT" push -u origin "$BRANCH"
BODY_FILE=$(mktemp) && cat > "$BODY_FILE" <<'EOF'
(日本語の PR 本文)
EOF
gh pr create -R nozomiishii/brain --base main --head "$BRANCH" --title "chore: add <topic> note" --body-file "$BODY_FILE"
--head を必ず付ける(cwd が brain worktree ではない場合があるため)
git add はファイル単位で指定する。ディレクトリ指定やワイルドカードは禁止
- PR 本文: 日本語
- merge はユーザーが手動で行う。AI はマージしない