init-simple-memorix

init-simple-memorix

概要

このスキルは、Memorix hooks を簡素化し、Memorix MCP の設定を確認します。基本方針は、問題が hooks のノイズに属するのか、MCP の接続やツール公開の問題に属するのかを先に判断し、該当する層だけに対処することです。

• hooks の目的：ツール呼び出し、ファイル編集、コマンド実行など、頻繁に発生するトリガーを削除し、セッションのライフサイクルイベントだけを残します。
• MCP の目的：memorix server entry が serve --mode full を使用していることを確認し、WorkBuddy が挿入する Node パラメーターによって stdio MCP の起動が妨げられないようにします。
• 配布の観点：スクリプト、テンプレート、ソースインデックスはすべてスキルのインストールディレクトリをルートとし、リポジトリのソースパスや開発時の生成物は参照しません。

使用する場合

• ユーザーが init-simple-memorix、Memorix の初期化、Memorix hooks の簡素化、記憶のノイズ削減について明確に言及している場合。
• ユーザーが Memorix のセットアップまたはアップグレードを完了した後、デフォルトの hooks が再び頻繁なノイズを発生させていると疑っている場合。
• ユーザーがプロジェクトレベルまたはグローバルレベルの hooks テンプレートを参照したい場合。
• ユーザーから Memorix MCP ツールが見つからない、full モードではない、MCP サーバーの起動に失敗すると報告された場合。
• ユーザーが WorkBuddy で memorix MCP の切断が繰り返される、承認後も利用できない、NODE_OPTIONS または Node ABI 関連のエラーが発生すると報告した場合。

使用しない場合

• ユーザーが既存の Memorix ツールを使った記憶の読み書き方法だけを尋ねており、hooks/MCP の設定に問題がない場合。
• ユーザーがインシデントの記録、経験の蓄積、または記憶の同期を求めている場合は、record-bug-fix-memory を優先してください。
• ユーザーがリリース、changeset の作成、コードのコミット、またはレポートの生成を求めている場合、このスキルは背景情報を提供するだけで、これらの作業は引き受けません。
• 発生している症状が通常のビジネスコードのバグ、テストの失敗、またはビルドの失敗であり、Memorix hooks/MCP に関する手がかりがない場合。

判断手順

1. まず問題を分類します。
   • 記憶が多すぎる、雑多である、ツール呼び出しのたびに記録される：hooks に対処します。
   • MCP ツールが見つからない、full モードが利用できない、サーバーが切断される：MCP 設定を確認します。
   • WorkBuddy の承認、Node パラメーター、better-sqlite3 のエラー：WorkBuddy Notes に進みます。
2. 次に適用範囲を判断します。
   • 現在のプロジェクトだけに影響する場合：templates/ のプロジェクトレベルテンプレートを使用します。
   • ユーザーのグローバルエージェントに影響する場合：templates-global/ を参照します。ただし、明確な許可なしにユーザーのホームディレクトリの設定を書き換えないでください。
3. 最後に実行方法を選びます。
   • スクリプトの動作確認だけが必要な場合：ヘルプまたは dry-run を実行します。
   • 実際に書き込む必要がある場合：ユーザーから明確な依頼が必要です。また、実行前に変更するユーザー設定ファイルを説明してください。
4. hooks のノイズが問題の場合は、まず hooks に対処し、WorkBuddy MCP の信頼チェーンの調査を主な手順にしないでください。

参照先の振り分け

このスキルの本文には、判断の入口と頻度の高いルールだけを記載します。詳細が必要な場合は、状況に応じて対応する参照ファイルを読み込み、すべての references を一度に読み込まないでください。

参照ファイル	読み込むタイミング
references/hooks-reference.md	ユーザーが hooks の簡素化、ノイズの確認、プロジェクトレベル/グローバルレベルの hooks の統合を求める場合、または旧版の完全な hooks 表とテンプレート形式の詳細が必要な場合。
references/workbuddy-mcp-notes.md	ユーザーから WorkBuddy で memorix MCP の接続失敗、untrusted/disabled、Connection closed、Node/ABI、NODE_OPTIONS、または承認 hash の問題が報告された場合。
references/memorix-setup-notes.md	ユーザーが memorix setup を実行したばかりの場合、Memorix プラグインをグローバルにインストールまたはアップグレードした場合、または setup 後に上書きされる可能性のある hooks/MCP 設定を確認したい場合。

ユーザーが「記憶がうるさすぎる」または「ツール呼び出しのたびに記録される」とだけ訴えている場合は、まず references/hooks-reference.md を読み込みます。MCP 接続、ツールの欠落、承認、または Node エラーも同時に発生している場合に限り、references/workbuddy-mcp-notes.md を読み込みます。

安全ルール

• Memorix の setup または cleanup を自発的に実行しないでください。コマンドを提示する必要がある場合は、--help または --dry-run / -DryRun / -d の形式だけを提示してください。
• 明確な許可なしにユーザーのホームディレクトリの設定を変更しないでください。
• permissions、カスタム hooks、その他の MCP server entries など、ユーザーが設定した Memorix 以外のフィールドを削除しないでください。
• 存在しないテンプレートを案内しないでください。プロジェクトレベルには Codex hooks テンプレートがなく、Codex が含まれるのはグローバルテンプレートだけです。
• full モードのツール数を固定値で記載しないでください。full モードでツール一式が公開されることだけを求めてください。
• 本文中のコマンドやリソースインデックスで、開発時のパス、テストディレクトリ、CI 設定、レポートディレクトリ、または依存関係のインストールディレクトリを参照しないでください。
• 設定を統合する際は、不明なフィールドを保持し、Memorix 関連の entry だけを正確に調整してください。

Hooks クイックリファレンス

適用範囲のモデル：

シナリオ	動作
プロジェクトレベル	ユーザーがグローバル設定を求めていない場合は、現在のプロジェクトのルートディレクトリにある IDE hooks 設定だけを扱います。
グローバルレベル	ユーザーがグローバル設定、--global、または setup 後のグローバルな簡素化を明確に求めた場合に限り、ユーザーのホームディレクトリにあるグローバル hooks 設定を扱います。
両方の適用範囲	ユーザーがグローバルとプロジェクトレベルの両方を必要としている場合は、まずグローバルを処理してから現在のプロジェクトを処理します。2 種類のパスを一度の書き込みで混在させないでください。

対応する hooks 設定の対象：

工具	项目级目标	全局级目标
Claude Code	.claude/settings.local.json	~/.claude/plugins/cache/memorix-local/memorix/{version}/hooks/hooks.json
Codex	不提供项目级模板	~/.codex/plugins/memorix/hooks/hooks.json
Cursor	.cursor/hooks.json	~/.cursor/hooks.json
Windsurf	.windsurf/hooks.json	暂不支持
Gemini CLI	.gemini/settings.json	暂不支持
Kiro	.kiro/hooks/memorix-file-save.kiro.hook	暂不支持
WorkBuddy	.workbuddy/hooks/hooks.json（实验性，待运行时验证）	暂不支持
ZCode	.zcode/config.json 或 zcode.json	暂不支持
Antigravity	.agents/hooks.json	~/.gemini/config/plugins/memorix/hooks.json

项目级模板：

工具	模板	目标形态
Claude Code	templates/claude-code.settings.local.json	.claude/settings.local.json
Cursor	templates/cursor.hooks.json	.cursor/hooks.json
Windsurf	templates/windsurf.hooks.json	.windsurf/hooks.json
Gemini CLI	templates/gemini-cli.settings.json	.gemini/settings.json
Kiro	templates/kiro.memorix-file-save.kiro.hook	.kiro/hooks/memorix-file-save.kiro.hook
WorkBuddy	templates/workbuddy.hooks.json（实验性，待运行时验证）	.workbuddy/hooks/hooks.json
ZCode	templates/zcode.config.json	.zcode/config.json 或 zcode.json
Antigravity	templates/antigravity.hooks.json	.agents/hooks.json

全局模板：

工具	模板	说明
Claude Code	templates-global/claude.hooks.json	版本目录需动态发现
Codex	templates-global/codex.hooks.json	仅全局模板
Cursor	templates-global/cursor.hooks.json	全局 hooks
Antigravity	templates-global/antigravity.hooks.json	全局 hooks

应移除或禁用的高频事件：

ツール	高頻度ノイズイベント
Claude Code	PreToolUse, PostToolUse
Codex	PostToolUse
Cursor	afterFileEdit, afterMCPExecution, beforeShellExecution
Windsurf	post_write_code, post_run_command, post_mcp_tool_use
Gemini CLI	AfterTool
Kiro	ファイル保存フックは enabled: false のままにします
WorkBuddy	PreToolUse, PostToolUse
ZCode	PreToolUse, PermissionRequest, PostToolUse, PostToolUseFailure
Antigravity	PreToolUse, PostToolUse

保持するライフサイクルイベント：

ツール	ライフサイクルイベント
Claude Code	SessionStart, UserPromptSubmit, PreCompact, Stop
Codex	SessionStart, UserPromptSubmit, Stop
Cursor	sessionStart, beforeSubmitPrompt, preCompact, stop
Windsurf	pre_user_prompt, post_cascade_response
Gemini CLI	SessionStart, PreCompress, AfterAgent
WorkBuddy	SessionStart, UserPromptSubmit, PreCompact, Stop
ZCode	SessionStart, UserPromptSubmit, Stop
Antigravity	PreInvocation, PostInvocation, Stop

形式に関する注意点：

• Cursor の hooks は { "command": "memorix.cmd hook" } のようなオブジェクトの配列です。command 文字列の配列ではありません。
• WorkBuddy の hooks は matcher をネストした構造を使用します。各イベント配列には { "matcher": "*", "hooks": [...] } が含まれます。プロジェクトレベルの対象とテンプレートは実験的なものであり、実行時の検証が必要です。
• ZCode の設定ファイル hooks は、トップレベルの hooks.enabled: true と hooks.events を使用します。イベント項目は matcher と hooks をネストした構造を使用し、hook コマンドは memorix.cmd hook です。プラグイン hooks の構造にはしないでください。matcher は大文字と小文字を区別する正規表現で、省略できます。* は指定できません。すべてに一致させる場合は .* を使用します。
• ZCode の設定ファイル hooks はデフォルトで無効です。テンプレートでは hooks.enabled: true を明示的に設定する必要があり、全体のタイムアウトには hooks.timeoutMs を使用できます。
• ZCode が現在サポートしている設定ファイルイベントは、SessionStart、UserPromptSubmit、PreToolUse、PermissionRequest、PostToolUse、PostToolUseFailure、Stop です。PreCompact はサポートされていないため、ライフサイクルテンプレートに含めないでください。
• Antigravity のプロジェクトレベルテンプレートは、実際に templates/antigravity.hooks.json に存在します。
• プロジェクトレベルの Codex hooks テンプレートはありません。Codex はグローバルテンプレートでのみ説明します。
• Claude Code のグローバルパスには {version} が含まれます。インストール済みの Memorix プラグインのうち、最新バージョンのディレクトリを動的に検出する必要があります。
• Kiro のファイル保存 hook は、ファイルを削除するのではなく、enabled: false にして無効化します。

統合方針：

• 既存の設定をすべて上書きしないでください。明示的に指定された高頻度の Memorix hooks のみを削除し、ライフサイクル hooks を補完または維持してください。
• permissions、not-use-now-hooks、カスタム hooks、Memorix 以外の MCP サーバー項目など、ユーザーのフィールドを維持してください。
• WorkBuddy の設定では、matcher、description などの構造フィールドを維持してください。テンプレートで置き換えて、意味を失わせないでください。
• 同じイベントに適切なライフサイクル hook がすでに存在する場合は、重複して追加しないでください。
• ユーザーから過去のノイズ記憶のクリーンアップを求められた場合は、まずリスクを説明してください。memorix cleanup を自発的に実行しないでください。

MCP Full Mode

memorix MCP サーバーエントリの一般的な必須要件は、command と args が full モードを指定していることです：

{
	"mcpServers": {
		"memorix": {
			"command": "memorix",
			"args": ["serve", "--mode", "full"]
		}
	}
}

TOML 形式：

[mcpServers.memorix]
command = "memorix"
args = ["serve", "--mode", "full"]

スクリプトのエントリポイントは、スキルのインストールディレクトリ内でのみ使用します：

tsx scripts/install-mcp.ts --help
tsx scripts/install-mcp.ts --dry-run

Windows PowerShell のフォールバック：

.\fallback\install-mcp.ps1 -DryRun

Bash のフォールバック：

./fallback/install-mcp.sh -d

メンテナンスのポイント：

• scripts/install-mcp.ts は dry-run と追加の設定ファイル引数をサポートします。実際に書き込む前に、まず dry-run を実行してください。
• MCP 設定に memorix エントリがすでに存在する場合は、args に --mode full が含まれているかどうかだけを確認します。
• WorkBuddy 関連の MCP エントリでは、親プロセスから注入された Node パラメーターの継承を避けるため、env.NODE_OPTIONS = "" を保持するか、設定することを推奨します。現在のスクリプトの主な役割は full args の調整であり、dry-run で WorkBuddy の env も必ず補完されるとは説明しないでください。

既知の MCP 設定プラットフォーム：

プラットフォーム	設定パス	形式
Codex	~/.codex/config.toml, ~/.codex/config-2026-6-13-bg.toml	TOML
Claude Code	~/.claude.json	JSON
Cursor	~/.cursor/mcp.json	JSON
WorkBuddy	~/.workbuddy/mcp.json, ~/.workbuddy/.mcp.json	JSON
ZCode	~/.zcode/cli/config.json	JSON
Qoder	~/AppData/Roaming/Qoder/SharedClientCache/mcp.json	JSON
Kiro	~/.kiro/settings/mcp.json	JSON

スクリプトの出力ステータス：

ステータス	意味
created	設定ファイルが存在しないため、スクリプトが新しいファイルを作成します。dry-run ではプレビューのみ行います。
updated	設定ファイルが存在し、memorix エントリを full モードに変更する必要があります。dry-run ではプレビューのみ行います。
skipped	設定が要件を満たしているか、dry-run で実際の書き込みをスキップしました。
error	設定の解析、読み書き、または形式の処理に失敗しました。まず該当ファイルの問題を解決してください。

memorix setup／アップグレードとの連携：

• memorix setup によってデフォルトの hooks が再インストールされることがあります。setup 後にユーザーがノイズの低減を求めている場合は、hooks の簡素化を再度実行してください。
• Memorix プラグインのアップグレード時に、グローバル hooks ファイルが新しいバージョンのディレクトリやデフォルトの内容で上書きされることがあります。特に Claude Code のグローバルパスにはバージョン番号が含まれるため、動的に再検出する必要があります。
• MCP full モードと hooks の簡素化は別々の経路です。ツールが見つからない場合は、まず MCP を確認してください。記憶のノイズが問題の場合は、まず hooks を確認してください。

WorkBuddy Notes

• WorkBuddy は子プロセスに NODE_OPTIONS を注入することがあります。古い Node バージョンが --use-system-ca を認識しない場合、stdio MCP は起動時に終了します。memorix MCP エントリには env.NODE_OPTIONS = "" を明示的に設定することを推奨します。
• WorkBuddy の MCP 信頼ハッシュは、サーバーエントリの JSON.stringify の結果に対して SHA-256 を適用して計算されます。mcp.json のエントリを変更すると、再承認が必要になることがあります。
• mcp.json の変更後は、WorkBuddy を完全に再起動する必要があります。ウィンドウの更新やセッションの再起動だけでは、古い信頼状態が引き続き使われることがあります。
• Node 22.x の ABI はすべて 127 です。同じ major バージョン内では、通常 better-sqlite3 の再ビルドは不要です。major バージョンをまたいでアップグレードまたはダウングレードした場合に限り、まず再ビルドを検討してください。
• trustLevel=gray だけでは、失敗と判断できません。サーバーの status=connected と、Memorix のツールが実際に公開されているかどうかを重点的に確認してください。
• ユーザーが記憶のノイズについて不満を述べた場合は、まず hooks のテンプレートと高頻度イベントを確認してください。最初から問題を MCP の信頼経路のせいにしないでください。

Verification Checklist

• YAML frontmatter が有効で、metadata.version が更新されていること。
• description にはトリガー条件のみを記載し、手順の説明を含めず、一人称を使用しないこと。
• プロジェクトレベルのテンプレート表に templates/antigravity.hooks.json が含まれていること。
• プロジェクトレベルのテンプレート表に templates/zcode.config.json が含まれており、対象の形式が .zcode/config.json または zcode.json であること。
• プロジェクトレベルのテンプレート表に Codex が含まれていないこと。Codex は templates-global/codex.hooks.json にのみ記載すること。
• ZCode のドキュメントで、設定ファイルの hooks には hooks.enabled: true が必須で、イベントは hooks.events に記述することが明記されており、サポートされていない PreCompact が含まれていないこと。
• Cursor の形式の説明がオブジェクト配列であり、command 文字列の配列ではないこと。
• ドキュメントに full モードのツール数が固定値として記載されていないこと。
• コマンド例がヘルプまたは dry-run のみで、ユーザー設定への書き込みを行わないこと。
• リソースインデックスには、スキルのインストールディレクトリ内の相対パスのみを記載すること。

ユーザーまたはメインスレッドに、以下の実行を提案できます：

tsx scripts/install-mcp.ts --help
tsx scripts/install-mcp.ts --dry-run

.\fallback\install-mcp.ps1 -DryRun

./fallback/install-mcp.sh -d

Resource Index

路径	用途
scripts/install-mcp.ts	MCP 配置检查与安装 CLI 入口
fallback/install-mcp.ps1	Windows PowerShell 兜底入口
fallback/install-mcp.sh	Bash 兜底入口
src/platforms.ts	MCP 平台注册表
src/install-mcp.ts	MCP 配置读写逻辑
templates/	项目级 hooks 模板目录
templates/claude-code.settings.local.json	Claude Code 项目级模板
templates/cursor.hooks.json	Cursor 项目级模板
templates/windsurf.hooks.json	Windsurf 项目级模板
templates/gemini-cli.settings.json	Gemini CLI 项目级模板
templates/kiro.memorix-file-save.kiro.hook	Kiro 项目级模板
templates/workbuddy.hooks.json	WorkBuddy 项目级模板
templates/zcode.config.json	ZCode 项目级配置文件 hooks 模板，可用于 .zcode/config.json 或 zcode.json
templates/antigravity.hooks.json	Antigravity 项目级模板
templates-global/	全局 hooks 模板目录
templates-global/claude.hooks.json	Claude Code 全局模板
templates-global/codex.hooks.json	Codex 全局模板
templates-global/cursor.hooks.json	Cursor 全局模板
templates-global/antigravity.hooks.json	Antigravity 全局模板
references/hooks-reference.md	hooks 作用域、噪音事件、生命周期事件、模板格式与合并策略详解
references/workbuddy-mcp-notes.md	WorkBuddy MCP 连接、信任审批、NODE_OPTIONS、Node ABI 与日志检查详解
references/memorix-setup-notes.md	memorix setup / 插件升级后的全局配置影响与重新精简策略