helpfeel 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）を示しながらユーザーの問いに直接答える
- 固定テンプレートは規定しない