cosense

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

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

ファイルをアップロードしてページに埋め込みたい時

ファイルアップロード手順: upload-file.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	単一ページを読む
readPageSnapshot	snapshotのIDを指定してPage History上の過去の本文を読む
readFileInfo	ファイルのメタデータと抽出済みテキストを取得する
downloadFile	ファイル本体をダウンロードしてローカルに保存する
uploadFile	ファイルをprojectにアップロードして埋め込みURLを取得する
deleteFile	ファイルをprojectから削除する
readProjectMembers	プロジェクトのメンバー一覧を取得する
listPages	プロジェクトのページ一覧を取得する
listPageSnapshots	ページのsnapshot一覧(Page History)をpageId起点で取得する
list1hopLinks	1-hop近傍を取得する
list2hopLinks	2-hop近傍を取得する
searchVector	ベクトル検索でページを探す（タイトル+本文中リンク記法のみ対象）
searchFullText	本文全文を対象に検索する
search1hopLinks	1-hop近傍を全文検索でフィルタする
search2hopLinks	2-hop近傍を全文検索でフィルタする
previewEdit	ページ編集opsをdry-runしてpreviewIdを取得する
previewDelete	ページ削除をdry-runしてpreviewIdを取得する
submitEdit	previewEdit/previewDeleteで取得したpreviewIdを使ってページ編集・削除を確定する
replaceLinks	旧タイトルへのリンク記法を新しいタイトルに一括置換する

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

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

回答の形式

• 情報源（ページURL）を示しながらユーザーの問いに直接答える
• ページURLはCLIが出力した物をそのまま使い、ページタイトルをリンクテキストにしたMarkdownリンクで示す。日本語を生で書いたURLは、%2F 等のエスケープと混ざると、ターミナルでクリックした時に別のページへ飛ぶ事がある
• 固定テンプレートは規定しない