메뉴
会話で学んだことをトピック単位で brain vault に知識ノートとして保存する。 Claude Code で /note、Codex で $note と入力したとき、または「ノートに残して」「ノートにして」「メモしておいて」と言ったときに使用する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
claude.ai の cloud 環境の init_script を内部 API で更新し、 環境スナップショットの再構築を発火させる。 Claude Code で /cloud-bump、Codex で $cloud-bump と入力したとき、または dotfiles の main にマージした変更が cloud 配信対象 (cloud-setup.yaml の paths) に触れていたときに使用する。 dotfiles を変更する PR を作成するときも、マージ後の bump の要否判定と予告のために使用する。
スキル (SKILL.md) の新規作成・編集の進め方の正本。 ユーザーが Claude Code で /skill、Codex で $skill と入力したとき、またはスキルの追加・変更を依頼したとき、 または home/.agents/skills/ 配下の SKILL.md を変更する前に使用する。
ドキュメント・記録の運用の正本 (置き場判定・原則・ADR の作法)。 issue / ADR / docs / brain ノートに振り分けて保存まで実行する。 Claude Code で /doc、Codex で $doc と入力したとき、「これ残しておきたい」「どこに書くべき?」と言ったとき、 設計ドキュメント・仕様・README などドキュメントを書く・編集する前、 および実装が完了して PR を作る前の残し漏れ確認に使用する。
repo をまたぐタスクの切り出し方、セッションの作り直し方、git worktree を用意する手順。 Claude Code で /wt、Codex で $wt と入力したとき、セッション開始ディレクトリ以外の repo を変更するとき、 コンテキストが増えたセッションを作り直したいと言ったとき、 またはスキルや作業フローが作業用 worktree を必要とするときに使用する。
現在のブランチに紐づく PR の CI 失敗・レビュー指摘・main との conflict を修復し、 mergeable な状態まで持っていく。Claude Code で /pr、Codex で $pr と入力したときに使用する。
会話やプランの内容をもとに、ブランチ作成・コミット・プッシュ・PR 作成を一括実行する。 Claude Code で /tha、Codex で $tha と入力したときに使用する。
| name | note |
| description | 会話で学んだことをトピック単位で brain vault に知識ノートとして保存する。 Claude Code で /note、Codex で $note と入力したとき、または「ノートに残して」「ノートにして」「メモしておいて」と言ったときに使用する。 |
| argument-hint | トピック名（任意） |
会話で得た知識を brain vault に Zettelkasten 形式のノートとして保存する。
会話を振り返り、学んだトピックの候補を一覧提示する。
ユーザーが保存したいトピックを選んでから次へ進む。
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 を読んで従う。
ノートの要件:
[[wiki-link]] でつなぐ。ノートを書く前に既存ノートの一覧を取得し、実在するノートだけを wiki-link にする。存在しないノートへの wiki-link は作らない
ls "$WT/brain/main/" | sed 's/\.md$//'
ノートを作成したら、コミットする前に既存ノートとの重複・関連を確認する。
# タイトル・タグ・キーワードで既存ノートを検索
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 は山括弧で囲む。
承認を得てから次へ進む。
worktree 内で commit → push し、PR を作成する。複数ノートは 1 つの PR にまとめる。
# 作成したファイルだけを個別に add する。
# `git add "brain/main/"` はディレクトリ全体をステージするため、
# 他の worktree や並行セッションが残したファイルまで巻き込む。
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 はファイル単位で指定する。ディレクトリ指定やワイルドカードは禁止