cortex-setup-project skill
✓ 検証済み新しいプロジェクトのCortexをブートストラップするか、既存のセッション履歴をインポートして、認知プロファイルとコードベースのメモリを構築します。
- GitHubスター
- 76
- ファイル
- 1
- 最終コミット
- 2026年11月12日
- ライセンス
- MIT
- 許可されたツール
- —
cortex-setup-project skillは何をしますか
新しいプロジェクトのCortexをブートストラップするか、既存のセッション履歴をインポートして、認知プロファイルとコードベースのメモリを構築します。
skillのSKILL.mdから生成された要約。
cortex-setup-project skill について
このSKILLは、新しいプロジェクトの認知プロファイルの初期化と、コードベースのメモリのシード(種まき)を可能にします。開発者は、ゼロから開始するか、既存のセッション履歴をインポートして知識の基盤を構築することで、Cortexシステムをブートストラップできます。このプロセスは完全に自律的であり、インフラの検証、プロファイルの構築、コードベースのシードを、手動でのコマンド実行やユーザーの判断を介さずに実行します。
ユーザーがCortexのセットアップ、プロジェクトのシード、またはメモリのバックフィルを要求した際、エージェントはこのSKILLをロードする必要があります。このSKILLは、接続確認のための cortex:memory_stats や、ドメインハブを作成するための cortex:rebuild_profiles といったツールに依存しています。ai-architect-mcp-codebase サーバーが利用可能な場合、このSKILLはより深いシンボルレベルの分析を行い、コードベースの構造を取り込むことができます。プロセスは、減衰と圧縮を通じてメモリを統合し、ドメイン、エンティティ、および知識のギャップに関する最終的なサマリーを提供することで完了します。
エージェントができること
- 1新しいプロジェクトのメモリをブートストラップする新しいコードベースに対してCortex環境を初期化し、ドメイン固有の認知プロファイルの構築を開始します。
- 2過去の会話履歴をインポートする最大500件の既存のセッションファイルをメモリストアにバックフィルし、プロジェクト知識の継続性を維持します。
- 3詳細なコードベース分析を実行するai-architect-mcp-codebase サーバーを統合することで、大規模なコードベースに対してシンボルレベルのメモリと構造化分析を有効にします。
- 4メモリインフラの検証と修復SQLite または PostgreSQL メモリバックエンドとの接続問題を自動的に診断し、修正します。
skill の SKILL.md から作成されています。すべてのユースケースは、その引用と照合されています。
cortex-setup-project skillのインストール方法
各コマンドはskillフォルダをクライアントのskillsディレクトリにコピーします。読み込むには、クライアントを再起動するか新しいセッションを開始してください。プラグインにcortex-setup-project skillをインストールする
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Claude Codeにcortex-setup-project skillをインストールする
~/.claude/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.claude/skills/cortex-setup-projectClaude Code (project)にcortex-setup-project skillをインストールする
.claude/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project .claude/skills/cortex-setup-projectCodexにcortex-setup-project skillをインストールする
~/.agents/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.agents/skills/cortex-setup-projectGemini CLIにcortex-setup-project skillをインストールする
~/.gemini/skills/cortex-setup-project/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-setup-project ~/.gemini/skills/cortex-setup-projectClaude.aiにcortex-setup-project skillをインストールする
npx degit cdeust/Cortex/skills/cortex-setup-project cortex-setup-project && zip -r cortex-setup-project.zip cortex-setup-project # claude.ai → Customize → Skills → + → Create skill → Upload a skill → cortex-setup-project.zip
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。エージェントに実行させる前にスクリプトを読んでください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能cdeust/cortex/skills/cortex-setup-project is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-setup-proje ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit 2026-11-12github.com/cdeust/cortex/commits ↗合格
- スクリプトにダウンロード実行や認証情報の窃取がないNo scripts in the skill folder合格
- SKILL.md に隠れた指示がないNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗合格
- 事前許可ツールが限定されているNo pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗合格
- SKILL.md が Agent Skills の形式に従っているValid name and description; says when to use it; 67 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-setup-proje ↗合格
SKILL.md
GitHubで表示Setup Project — Fully Autonomous Bootstrap
Execute all four phases sequentially without asking the user any questions. If a phase fails, attempt automatic recovery before reporting the error. Never ask the user to run commands manually or choose between options.
Phase 1: Infrastructure Verification
- Call
cortex:memory_stats({})to verify store connectivity. If it succeeds, the store is healthy — this covers both backends (the zero-config SQLite default needs no PostgreSQL, so do NOT runpg_isreadyor any PostgreSQL setup when this passes). Proceed to Phase 2. - Only if
memory_statsfails: callcortex:check_setup({})(backend-aware diagnostics) to identify the failure.- SQLite backend reported: fix per the check output (usually
~/.claude/methodologypermissions or a corruptmemory.db); do NOT install PostgreSQL. - PostgreSQL backend reported: run
pg_isreadyvia bash, thenbash "${CLAUDE_PLUGIN_ROOT}/scripts/setup.sh"automatically. Do not ask for permission. After setup.sh completes, callcortex:memory_stats({})again to verify. - If it still fails, report the error output and stop. Do not continue to later phases.
- SQLite backend reported: fix per the check output (usually
Phase 2: Build Methodology Profiles
- Call
cortex:rebuild_profiles({"force": true})to scan all session history and build cognitive profiles per domain. - This creates the domain hubs that memories, entities, and discussions link to. It must run before seeding.
- Record the domain count for the final summary.
Phase 3: Codebase Seeding
- Call
cortex:seed_project({"directory": "<cwd>"})where<cwd>is the current working directory. - Record the count of discoveries for the final summary.
Phase 3b: Pipeline Codebase Analysis (Optional)
The ai-architect-mcp-codebase MCP server provides structured codebase analysis (symbol graph, processes, communities, cross-file impact). It is optional — Cortex core memory/recall works without it. Enable only if the user asks for "deeper code understanding", "symbol-level memory", or the codebase is large (>5k files) where substring-based hooks underperform.
- Detection: attempt
cortex:ingest_codebase({"project_path": "<cwd>"}). If it succeeds, record the counts (wiki pages, memory entities, KG edges) for the summary and skip to Phase 4. - If
ingest_codebasefails withMcpConnectionError(pipeline not installed/configured):- Check if the sibling checkout exists at
../anthropic/ai-architect-mcp-codebase/Cargo.toml(or equivalent). If so, runbash -c 'cd ../anthropic/ai-architect-mcp-codebase && cargo install --path . 2>&1 | tail -20'(accepts ~1-2 min compile) and re-run the ingest. - If the source checkout is missing or cargo is unavailable, skip Phase 3b silently and proceed to Phase 4. Do NOT block setup on this.
- Check if the sibling checkout exists at
- The pipeline's auto-wire happens on every SessionStart via
pipeline_discovery, so once the binary exists on PATH (or sibling source is built), future sessions pick it up automatically. No manual mcp-connections.json editing needed.
Phase 4: History Import
- Call
cortex:backfill_memories({"dry_run": true, "max_files": 500})to preview available session files. - If files are available, call
cortex:backfill_memories({"max_files": 500, "min_importance": 0.35})to import. - Record the count of imported memories for the final summary.
Phase 5: Consolidation and Verification
- Call
cortex:consolidate({})to run decay, compression, CLS, and causal discovery on all memories. - Call
cortex:memory_stats({})to get the final system state. - Call
cortex:detect_gaps({})to identify knowledge gaps.
Final Summary
After all phases complete, print a single summary block:
Cortex Setup Complete
---------------------
Domains: <count from rebuild_profiles>
Memories stored: <total from memory_stats>
Entities: <count from memory_stats>
Relationships: <count from memory_stats>
Pipeline: <"active — N wiki pages, M memories" | "skipped (not installed)">
Gaps found: <count and brief description from detect_gaps>
Do not print intermediate status updates between phases beyond what the tool calls themselves return. One summary at the end.
このスキルのファイル
1cortex-setup-project skillに関する質問
Claude Codeにcortex-setup-project skillをインストールするには
npx degit cdeust/Cortex/skills/cortex-setup-project ~/.claude/skills/cortex-setup-projectを実行してください。Claude Codeは~/.claude/skills(すべてのプロジェクト)または.claude/skills(単一プロジェクト)からskillsを読み込み、説明がタスクに一致する場合にskillを使用します。
cortex-setup-project skillはどのクライアントで使用できますか
Agent Skills形式を読み込むすべてのクライアントで使用できます: Claude Code、Codex、Gemini CLI、claude.ai(ZIPとしてアップロード)。skill内のスクリプトは、クライアントがコード実行を許可した場合にのみ実行されます。
セットアップ中にデータベース接続に失敗した場合はどうなりますか?
システムはバックエンドを認識した診断を実行し、自動復旧を試みます。SQLiteの場合は権限や破損を確認し、PostgreSQLの場合はbash経由でセットアップスクリプトの実行を試みます。
セットアップ中にコードベースをより深く理解することはできますか?
はい、リクエストがあった場合やコードベースが大きい場合には、シンボルレベルのメモリと構造化分析を行うためのオプションのパイプライン・コードベース分析を有効にできます。
セットアッププロセスに手動での介入は必要ですか?
いいえ、セットアップは完全に自律的に動作するように設計されており、質問への回答や手動でのコマンド実行を必要とせず、すべてのフェーズを順次実行します。