helpfeel/cosense-cli/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

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

自分で調べた内容をページに書いた後

用語ページを作る事を通して細部を改めて調べ、本筋の誤りと言い過ぎを直す心得: term-pages.md

• 検索・閲覧・比較して自分で組み立てた内容を、ページとして新規作成した後、またはページに大きく書き足すか書き換えた後に読む

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

ファイルアップロード手順: upload-file.md

• ユーザーが明示的に「この画像をアップロードして」「ファイルを貼って」「レポートに画像を埋め込んで」等を指示した時のみ
• アップロードだけで終わらせず、埋め込みまでがこの手順の範囲

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

ログイン手順: login.md

• ユーザーから「Cosenseにログインして」と明示的に指示された時
• CLIが失敗し、エラー文が cosense login を案内している時

CLIの挙動が想定と違う時

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

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

CLIコマンド一覧

CLI実行コマンド形式

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

コマンド一覧

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

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

回答の形式

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