cosense-notation

name	cosense-notation
description	Cosense（旧Scrapbox）の記法を使ってコンテンツを書くためのスキル。ユーザーがCosense/Scrapboxのページ内容を作成・編集・整形したいとき、Cosense記法で書いてほしいと依頼されたとき、またはCosenseプロジェクトに書き込む内容が必要なとき、必ずこのスキルを使ってください。**coscliコマンド（cos page append/edit/new/insert等）でページに書き込む内容を生成する場合も必ず参照すること。** 「Cosense記法で」「Scrapbox形式で」「Scrapboxページを作って」などのキーワードがあれば常に参照します。

Cosense（Scrapbox）記法ガイド

Cosenseのページはプレーンテキストで書かれ、特定の記法によってリンク・装飾・構造が表現されます。

---

⚠️ Markdown ではなく Cosense 記法を使うこと

よく混同される点:

Markdown	Cosense（正しい）
# 見出し / ## 見出し2	使わない（見出し機能なし）
- 箇条書き / * 箇条書き	行頭スペース/Tab でインデント
| 列 | 列 | テーブル	table:名前 + Tab区切り
**太字**	[[太字]] または [* 太字]
*斜体*	[/ 斜体]

---

coscli との連携

coscliの書き込みコマンドに渡すコンテンツは以下のルールに従うこと:

特定の記法のみ確認したい場合は cos notation <topic> でトピック別に取得できる (例: cos notation table、cos notation decoration)。cos notation で全トピック一覧を表示。

• 複数行: --line フラグに文字列として渡す。行の区切りは \n（coscli が改行として解釈する）または実際の改行文字どちらでも良い
• ⚠️ cos page new の注意: タイトルは positional 引数として渡す。--line にタイトルを含めると2行目に重複して挿入される
  • NG: cos page new "タイトル" --line "タイトル\n本文..." ← タイトルが重複する
  • OK: cos page new "タイトル" --line "本文..." ← 本文のみ渡す
• インデント: スペース1つが1段インデント（タブも可）
• テーブルのセル区切り: タブ文字（実際のタブ または \t）を使う

# 例: 新規ページ作成（タイトルは引数のみ、--line には本文を渡す）
cos page new "ページタイトル" \
  --line "#author:claude #waiting-review\n概要文\n 箇条書き1\n 箇条書き2" \
  --project myproject

# 例: テーブルを追記
cos page append "ページタイトル" \
  --line "table:メンバー一覧\n\t名前\t役割\n\t田中\tエンジニア\n#author:claude #waiting-review" \
  --project myproject

---

基本原則

• [ と ] でテキストを囲むと「ブラケティング」になる。これだけ覚えれば十分
• ページは箇条書き中心で書く（長文の章立てではなく、論理構造を視覚的に表現）
• 見出しを作る機能はない。独立した内容は別ページに切り出してリンクする

---

記法一覧

ページリンク

[ページタイトル]

• 同プロジェクト内のページへのリンクを作る
• 存在しないページへのリンクも有効（後から作れる）

外部リンク

https://example.com
[https://example.com タイトル]
[タイトル https://example.com]

別プロジェクトへのリンク

[/プロジェクト名/ページ名]

箇条書き（インデント）

行頭にスペースまたはTabキーで箇条書き
 1段インデント → 中黒表示
  2段インデント → さらに深い階層

「セクション」に相当する親行はインデントなし、その内容をインデント1段で表現する:

参加者
 田中
 鈴木
議題
 来期予算の確認

アイコン記法

[ページ名.icon]
[ユーザー名.icon]
[ユーザー名.icon*3]

画像の埋め込み

[画像のURL]
[[画像のURL]]   ← 横幅いっぱいの大きな画像

文字装飾

記法	用途
[[強調]]	太字・強調
[* 強調]	太字（*の数で大きさ変化）
[** もっと大きく]	より大きい文字
[/ 斜体]	イタリック
[/* 太字斜体]	ボールドイタリック
[- 打ち消し]	取り消し線
[! 任意記号]	* / - 以外の記号も使用可（deco-! などの CSS class として出力）

引用

> 行頭に > を書くと引用になります

インラインコード

`コード`

コードブロック

code:ファイル名.js
 function () {
   alert("hello")
   // インデント（スペースまたはTab）で囲む
 }

• code: の後にファイル名（拡張子で言語ハイライト）
• ブロック内はインデントで囲む

テーブル

table:テーブル名
	見出しA	見出しB
	データ1	データ2

• table: の後にテーブル名（内容を示す短い名前。例: メンバー一覧、タスク、スケジュール）
• ヘッダ行と通常行の書式は同じ（Cosense はヘッダを特別扱いしない）
• セルはタブ文字で区切る（テーブル名にスペースを含めることも可能）
• ブロック内はインデントで囲む

ハッシュタグ

#タグ名

• [リンク] と機能的には同じ
• 日本語では多用を避ける（関係ないページが関連しすぎてしまう）

---

必須タグ

Claudeがコンテンツを作成・編集する際は、以下のタグを追加すること：

#author:claude #waiting-review

配置ルール:

• 新規ページ作成時 (cos page new): --line の先頭行（ページの2行目）に記述
• 既存ページへの追記時 (cos page append): 追記内容の末尾行に記述
• ページ全体の書き換え時 (cos page edit): ページ末尾に記述

---

注意点

• 1行目がページタイトルになる（cos page new ではタイトル引数から自動設定）
• 長いページを作らないのがCosenseのベストプラクティス
• 独立した内容は別ページに切り出し、リンクでつなぐ
• [リンク名] が増えるほど関連ページリストが充実する

---

参考

• 元スキル作者: taiseiue