Communitygithub.com

Totoro-qaq/Cobsidian

エージェント非依存のワークフロースキル。Obsidian知識ベースを維持・拡張します。

Cobsidian とは?

Cobsidianは、Claude CodeやCursor、CodexなどのAIエージェントが、Obsidianボールトを知識体系として一貫性を保ちながら管理・拡張するための、エージェント非依存型ワークフロースキルです。単なるMarkdownファイルの生成に留まらず、既存ノートへのWikiリンク追加や重複チェック、バックリンク提案などを通じて、ボールトを相互にリンクされた知識システムとして維持します。ユーザーのリクエストから最適なモード(学習、プロジェクト、比較、索引、キャプチャ、拆解など)を自動選択または提案し、ボールトのパス解決、ファイルの作成・追記・分割を適切に判断します。さらに、検証スクリプトを用いた品質チェックや、完了レポートによる透明性の高い実行が可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add Totoro-qaq/Cobsidian

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Cobsidian は何をしますか?

基本原則

ボールトをリンクされた知識システムとして維持すること。単独のMarkdownファイルを生成するだけでは不十分です。

応答言語

モード選択、確認質問、完了レポートでは、ユーザーの言語に合わせます。

  • 中国語のリクエスト → 中国語のモード名。
  • 英語のリクエスト → 英語のモード名。
  • 混合言語のリクエスト → 支配的なユーザー言語を使用し、必要に応じて正規のモードIDをバッククォートで含めます。

ボールトの解決

対象ボールトは以下の順序で解決します。

  1. ユーザーのリクエスト内の明示的なボールトパス。
  2. cobsidian.config.yml 内の vault.path。
  3. MCPホスト設定による COBSIDIAN_CONFIG。
  4. MCPホスト設定による COBSIDIAN_VAULT。

プライベートなボールトパスを推測しないでください。有効なボールトパスが利用できない場合は、ボールトパスか設定パスのいずれかを簡潔に入力するよう1回だけ尋ねます。パスが存在しても無効な場合は、無効なパスを報告し、書き込み前に修正されたボールト/設定パスを尋ねます。

モード選択

ユーザーが明示的にモードを選択した場合はそれを使用し、モードメニュー全体は表示しません。モードが選択されていない場合は、最も小さな有用なモードを推測し、書き込み前にそれを明示します。モードが曖昧でファイル編集が伴う場合は、モードを簡単に紹介し、書き込み前に簡潔な質問を1回行います。

モード英語のトリガー中国語のトリガー使用目的
learninglearning mode, study note, explain学习模式, 知识点整理, 学习笔记概念、コース、動画、論文、技術解説。
projectproject mode, repo analysis, architecture项目模式, 项目整理, 源码项目プロジェクトアーキテクチャ、実装ノート、リポジトリ分析、運用ドキュメント。
reviewreview mode, retrospective, failure review复盘模式, 事故复盘, 实验复盘, 失败复盘インシデント、実験結果、失敗、学んだ教訓。
comparisoncomparison mode, compare, evaluate options对比模式, 选型, 方案比较ツール選択、アーキテクチャオプション、モデル/データベース/フレームワークの比較。
indexindex mode, map, learning path索引模式, 总览, 知识地图, 学习路线トピックマップ、ハブノート、学習パス、ナビゲーションページ。
capturecapture mode, daily capture, quick note捕获模式, 日常记录, 先记下来より深い整理の前の軽量な日次キャプチャ。
dissectiondissection mode, teardown, source analysis拆解模式, 源码拆解, 框架拆解, skill拆解ツール、リポジトリ、フレームワーク、エージェントシステム、プロンプト、スキル、ワークフローのリバースエンジニアリング。

対話型モード導入

ユーザーがREADMEやモードドキュメントを読んだことを前提にしないでください。以下の場合に会話の中でモードを説明します。

  • ユーザーがCobsidianに慣れていない、またはCobsidianで何ができるかを尋ねた場合
  • ユーザーがノートタイプを明確にせずに、Obsidianへの整理/書き込みを大まかに依頼した場合
  • 同じ素材が合理的に異なるノートタイプになり得る場合
  • 対象となる編集がモードによって異なる場合(例:洗練された学習ノートと大まかな日次キャプチャ)

ユーザーが既にモードを選択している場合、モードが明らかな場合、またはユーザーが直接実行を依頼した場合は、選択画面をスキップします。その場合は、推測されたモードを明示して続行します。

Mode: dissection / 拆解, because this is a framework or workflow teardown.

選択画面が必要な場合は、ユーザーの言語を使用します。

英語のモード選択画面:

Cobsidian can organize this in several modes:
- learning: concepts, courses, videos, papers
- project: repos, architecture, implementation, operations
- review: failures, incidents, experiments, lessons
- comparison: tool/model/database/architecture choices
- index: topic maps, learning paths, hub notes
- capture: quick rough notes for later cleanup
- dissection: internals of tools, frameworks, repos, skills, prompts

Choose one mode, or tell me to infer it.

中国語のモード選択画面:

Cobsidian 可以按这些模式整理:
- 学习模式:概念、课程、视频、论文、技术解释
- 项目模式:仓库、架构、实现、运维记录
- 复盘模式:失败、事故、实验结果、经验教训
- 对比模式:工具、模型、数据库、架构选型
- 索引模式:主题地图、学习路线、导航页
- 捕获模式:先快速保存粗糙材料,后续再整理
- 拆解模式:拆解工具、框架、仓库、skill、提示词系统

选一个模式,或者告诉我由我推断。

ワークフロー

  1. ユーザーのボールトパスと対象トピックを特定します。
  2. 書き込み前に既存のノートを検索します。
  3. 書き込み前にモードを選択、推測、または導入します。
  4. 以下のいずれかを決定します:
    • 新しいノートを作成
    • 既存のノートに追記
    • 複数のノートに分割
    • 重複のみを報告し、編集前に確認を求める
  5. 安定した見出しを持つ簡潔なMarkdownを記述します。
  6. 既存のノートに関連する [[Wikiリンク]] を追加します。
  7. 必要に応じて 関連ノート セクションを追加します。
  8. 検証を実行するか、少なくとも確認した内容を報告します。

書き込みルール

  • ユーザーの既存のノート命名スタイルを維持します。
  • チャットのトランスクリプト要約よりも、永続的な概念を優先します。
  • ユーザーが明示的にローカル運用記録を希望しない限り、プライベートパス、トークン、アカウント名、生のログを一般的なノートに含めないでください。
  • ソース、ファイル名、または完了したチェックを捏造しないでください。
  • 同じトピックが既に存在する場合は、ほぼ重複を作成する代わりに、追記またはマージします。

ヘルパースクリプト

  • scripts/scan_vault.py:ノート、タイトル、タグ、Wikiリンクを要約します。
  • scripts/find_duplicates.py:重複または類似したノートタイトルを検出します。
  • scripts/suggest_backlinks.py:ドラフトまたは対象ノートに関連するノートを提案します。
  • scripts/validate_notes.py:欠落しているWikiリンクと基本的な衛生問題を報告します。
  • scripts/dry_run.py:ファイルを変更せずに書き込みを計画します。作成/追記の決定、重複リスク、バックリンク提案、検証意図、空の書き込みを報告します。

ユーザーが vault.path、しきい値、バックリンク制限、検証設定を含むプロジェクト設定を持っている場合は、--config cobsidian.config.yml を使用します。

ノートの形状を選択するときは references/note-types.md を読んでください。 リンクを追加するときは references/backlink-policy.md を読んでください。 ノートをフォーマットするときは references/markdown-style.md を読んでください。

完了レポート

以下で締めくくります:

  • 作成または変更したファイル
  • 作成/追記の決定
  • 実行した重複チェック
  • 追加またはスキップしたバックリンク提案
  • 検証結果、または検証を実行しなかった理由

関連スキル