cosense
ResearchCosense（旧Scrapbox）のページを読み・調べ・編集するスキル。 ユーザーが「Cosenseで〇〇調べて」「このCosenseページ読んで」「Scrapboxで〇〇」「scrapbox.ioのページを見て」「このページにコメントを追記して」等と言った時に使用する。 cosense CLIを使ってページを取得し、ユーザーの問いに情報源を示しながら答える。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/helpfeel/cosense-cli/blob/HEAD/skills/cosense/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/cosense, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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）を示しながらユーザーの問いに直接答える
- 固定テンプレートは規定しない