version: "1.0.1" name: project-setup description: 新しいプロジェクトに Cursor Knowledge Management System を導入する際、または導入済みプロジェクトの CKMS を新しい版へ更新する際に使用。初期セットアップ、更新（再実行）、構造検証、カスタマイズガイドを提供する。 license: MIT compatibility: Cursor 3.x, Claude Code, Codex metadata: tags: [setup, cursor, knowledge-management]

プロジェクトセットアップ

新しいプロジェクトに Cursor Knowledge Management System を導入するためのスキルです。

When to Use

• 新しいプロジェクトに知識管理システムを導入したいとき
• 既存プロジェクトにスキル・hooks・subagent を追加したいとき
• 導入済みプロジェクトの CKMS を新しい版へ更新したいとき
• セットアップの正しさを検証したいとき

Instructions

1. 導入方法の選択

以下は init.sh を使う場合の手順です。

2. 初期セットアップ

init.sh は Mac / Linux 用です。Windows では同じディレクトリの init.ps1、または Git Bash / WSL で init.sh を使ってください。

デフォルト: .agents/skills に配置。Cursor / Codex はこれを直接読み、Claude Code は標準では .agents/skills を探索しないため .claude/skills へのシンボリックリンクで橋渡しする（自動作成）

bash path/to/cursor-knowledge-management-system/skills/project-setup/scripts/init.sh /path/to/target-project

主なオプション:

配置されるもの:

• <base>/skills/ — スキル 13 種
• <base>/debug-sessions/ — デバッグセッションの保存先
• .claude/skills — <base>/skills へのシンボリックリンク（Claude Code 用。既定で作成）
• .claude/hooks/ と .claude/settings.json — 記録支援 hooks（Claude Code 用）
• .cursor/agents/knowledge-curator.md — 知識ベース棚卸し用の subagent
• .cursor/hooks/ と .cursor/hooks.json — 記録支援 hooks（Cursor 用）
• .cursorignore

手動でコピーする場合:

# Mac/Linux
cp -r skills /path/to/your-project/.agents/skills
cp -r agents /path/to/your-project/.cursor/agents
cp hooks/*.sh /path/to/your-project/.cursor/hooks/
cp templates/.cursorignore /path/to/your-project/.cursorignore
mkdir -p /path/to/your-project/.agents/debug-sessions
find /path/to/your-project/.agents/skills -name "*.sh" -exec chmod +x {} \;
 
# Claude Code にも読ませる場合
mkdir -p /path/to/your-project/.claude
ln -s ../.agents/skills /path/to/your-project/.claude/skills
mkdir -p /path/to/your-project/.claude/hooks/claude-code
cp hooks/_hook-lib.sh /path/to/your-project/.claude/hooks/
cp hooks/claude-code/*.sh /path/to/your-project/.claude/hooks/claude-code/
chmod +x /path/to/your-project/.claude/hooks/_hook-lib.sh /path/to/your-project/.claude/hooks/claude-code/*.sh
cp templates/.claude/settings.json.template /path/to/your-project/.claude/settings.json
printf '@AGENTS.md\n' > /path/to/your-project/CLAUDE.md

手動コピーの場合、.cursor/hooks.json は hooks/hooks.json を参考に自分で作成してください。スクリプトのパスを .cursor/hooks/ 起点に書き換える必要があります。

3. 構造の検証

bash .agents/skills/project-setup/scripts/validate.sh
# （.claude/skills / .cursor/skills も検出対象）

Windows では Git Bash で実行してください。

4. 初期カスタマイズ（推奨順序）

最小限の更新（10 分）

1. /update-context でプロジェクト基本情報を記入
2. /record-decision で最初の技術判断を記録

推奨更新（20 分）

1. /add-pattern で初期パターンを登録
2. team-standards スキルの references/STANDARDS_TEMPLATE.md をプロジェクトの規約に更新（SKILL.md の frontmatter にある paths も使用言語に合わせる）

フル活用（30 分）

1. debug-workflow のテンプレートを確認
2. improvement-tracking の目標を設定
3. <base>/knowledge-hooks.conf で hooks の挙動を調整

5. 動作確認

• Cursor の Customize > Skills でスキルが検出されることを確認
• チャットで / を入力し、/record-decision などのアクションスキルが表示されることを確認
• エージェントとの対話でドメインスキルが自動適用されることを確認
• hooks を有効にした場合、新しい会話の冒頭で知識の索引が読み込まれることを確認

6. 導入済みプロジェクトの更新

配布元（CKMS リポジトリ）を最新にしてから、最初と同じコマンドで init.sh / init.ps1 を再実行します。配布元のスクリプトを使ってください。導入先に入っているスクリプトを、その導入先自身へ向けて実行するとエラーで止まります。

• 置き換わるのは、配布元にある CKMS のスキルだけです
• 残るもの: decisions/・patterns/・improvements/ の記録、references/*_TEMPLATE.md、プロジェクト固有のスキル、ほかの配布元のスキル。記録ディレクトリがシンボリックリンクなら、リンクのまま残ります
• 置き換える前に、skills/ を隣の skills.backup-YYYYmmdd-HHMMSS/ へ退避します（--no-backup / -NoBackup で省略）
• SKILL.md は配布元の内容になります。カスタマイズしていた場合は、警告に出る退避先から戻してください。team-standards の規約は references/STANDARDS_TEMPLATE.md に書けば残ります（paths は SKILL.md にあるため戻ります）
• 失敗したときは、利用者データの退避先と戻し方を表示します。validate.sh は、失敗で残った一時ディレクトリを警告します

v5 以前からの移行

.cursor/commands/ にあった 7 つのコマンドは、v6 でアクションスキルへ統合されました。移行手順は docs/getting-started/migration-from-v5.md を参照してください。

関連

• Cursor Plugin 配布や Marketplace 提出については docs/advanced/plugin-development.md
• hooks の詳細は docs/advanced/hooks-guide.md
• subagent の詳細は docs/advanced/subagents-guide.md
• gh skill install による導入については README
• Microsoft APM 経由の導入については docs/reference/apm-integration.md