cosense

name	cosense
description	Cosense（旧Scrapbox）のページを読み・調べ・編集するスキル。 ユーザーが「Cosenseで〇〇調べて」「このCosenseページ読んで」「Scrapboxで〇〇」「scrapbox.ioのページを見て」「このページにコメントを追記して」等と言った時に使用する。 cosense CLIを使ってページを取得し、ユーザーの問いに情報源を示しながら答える。

Cosense Skill 手順書

cosense CLIを使い、Cosenseのページを読み・調べてユーザーに回答する。 書き込み (ページ編集・コメント追記等) はユーザーが明示的に指示した時のみ行う。

Cosenseとはどういう物か

Cosenseは複数のページ同士をリンクさせ、複雑な情報をナレッジグラフとして表現するweb状のWiKiである。 ページ間リンクは [ページタイトル] というブラケット記法で表現する。

Cosenseを読み解く際のTips

• キーワード検索だけに頼らず、関連ページリストを眺めて、辿るべきだ。単独のページでは見えなかった文脈が浮かびあがる
• ナレッジグラフ上での被リンク数やページランク値が大きいページは、実質的にフォルダやカテゴリのような階層構造の親としても機能している
• 一見、観念的なページタイトルだけがあり、本文で何も説明されていなくても、他のページの文脈の中で説明されている事がある

こういう時はこうする

調査したい時、あるいは特定のページを読みたい時

ページの読み方: read-page.md

• プロジェクト名だけ指定された時は、https://scrapbox.io/<project> を projectUrl としてCLIに渡す
• プロジェクト名+ページタイトルが指定された時は、https://scrapbox.io/<project>/<title> を pageUrl としてCLIに渡す
• プロンプト中にURLが書かれている時、URLは https:// から最初の空白文字までが丸ごと一つ。Cosenseのタイトルは長い日本語の文章になりうる（タイトル中の空白はURL上では _）ので、日本語・記号・_・で/をに見える助詞も、空白が来るまで全部URLの一部。ASCII→日本語の境目で切ると、ユーザーが意図したのと別のページを読みに行ってしまう
• 記号を含むURLは shell でクォート（'...'）で囲んで渡す

読んでいたページが見つからなくなった時、共同編集者の変更を追いたい時

変更の追い方: read-page.md の「変更を追う」を参照

• 読んでいたページが急に 404 や「未作成の空ページ」になったら、共同編集者がタイトルを変更した可能性がある
• 読んだ時に控えた pageId と commitId を使い、browsePageChanges で何が変わったか（リネーム含む）を確認してから読み直す

ページを編集したい時、コメントを書き込みたい時

ページ編集手順: edit-page.md

• ユーザーが明示的に「書き込んで」「編集して」「コメント追記して」等を指示した時のみ
• 調査・閲覧・要約タスクでは参照しない

ログインしたい時、あるいは認証エラーが返ってきた時

ログイン手順: login.md

• ユーザーから「Cosenseにログインして」と明示的に指示された時
• 認証が必要なプロジェクトに browsePage 等でアクセスし、HTTP 401 または 403 が返ってきた時

CLIの挙動が想定と違う時

バージョン互換性チェック: version-mismatch.md

• unknown command / unknown option エラー
• 戻り値JSONの構造が手順書と違う
• --help の出力に手順書で参照しているコマンドが無い

CLIコマンド一覧

CLI実行コマンド形式

• cosense <command> <args...> を実行する
• 事前に npm install -g @helpfeel/cosense-cli でインストールしておく
• Node 24+ 前提

コマンド一覧

command	用途
login	Personal Access Token または Service Account を設定ファイルに保存する
whoami	現在の認証ユーザーの情報を取得する
listProjects	自分が参加しているprojectの一覧を取得する
browsePage	単一ページを読む。メタデータ+アイコン記法+テロメア+Infobox+本文をAIが読みやすい形式で出力する。行permalink (#<lineId>) 付きなら該当行をマークする
browseRelatedPages	1-hop+2-hopの関連ページタイトル一覧をAIが読みやすい形式で出力する。infobox定義ページでは文芸的データベース(TSV表)を出力する
browsePageChanges	ページの編集履歴(commit)をpageId起点で取得し、誰が何をどう変えたかを自然言語で説明する。タイトル変更(リネーム)も検出する
readPage	単一ページを読む
readFileInfo	ファイルのメタデータと抽出済みテキストを取得する
downloadFile	ファイル本体をダウンロードしてローカルに保存する
readProjectMembers	プロジェクトのメンバー一覧を取得する
listPages	プロジェクトのページ一覧を取得する
list1hopLinks	1-hop近傍を取得する
list2hopLinks	2-hop近傍を取得する
searchVector	ベクトル検索でページを探す（タイトル+本文中リンク記法のみ対象）
searchFullText	本文全文を対象に検索する
search1hopLinks	1-hop近傍を全文検索でフィルタする
search2hopLinks	2-hop近傍を全文検索でフィルタする
previewEdit	ページ編集opsをdry-runしてpreviewIdを取得する
submitEdit	previewEditで取得したpreviewIdを使ってページ編集を確定する

コマンドの詳細を知りたい時

• 全コマンド一覧と概要: cosense --help
• 個別コマンドの引数・戻り値スキーマ・HTTPエラー: cosense <command> --help
• 戻り値のJSON構造に確信が持てない時は、必ずヘルプを読んでから使う

回答の形式

• 情報源（ページURL）を示しながらユーザーの問いに直接答える
• 固定テンプレートは規定しない