Handoff MCP v0.14.1〜v0.15.1 の3リリース分のアップデートをまとめてお知らせします。

v0.15.0: CLI API — 全37ツールをシェルから直接実行

MCP プロトコルを介さずに、すべてのツールをシェルコマンドとして呼び出せるようになりました。

handoff-mcp task list --status in_progress
handoff-mcp memory query --text "atomic write"
handoff-mcp metrics get

16のコマンドグループ（init、task、session、config、memory、referral、assignee、milestone、calendar、labels、project、metrics、capacity、schedule、dashboard、timer）に分類され、出力はすべて JSON です。VSCode 拡張などの外部ツールから child_process.execFile で直接呼び出すことを想定しています。

各グループのヘルプも利用可能です：

handoff-mcp memory --help

--project-dir オプションで任意のプロジェクトディレクトリを指定できます。

v0.15.1: メモリ運用スキルの追加

プロジェクトメモリ機能の運用ベストプラクティスを skills/handoff-memory/ としてスキル化しました。

保存時の全引数ガイド — text、kind、scope_paths、tags、merge_into、absorb_ids、force の使い分け
近似重複の判断フロー — conflict 応答時にマージするか force-save するかの基準
粒度ルール — 1メモリ = 1知見。独立して検索・削除できる単位で保存
scope_paths のベストプラクティス — ディレクトリレベルの substring マッチで注入精度を向上
クリーンアップ手順 — セッション開始時の自動実行と apply_exact_merges / stale_days オプション
自動注入フック — UserPromptSubmit / PreToolUse / SessionStart の設定方法

v0.14.1: ハイフン付きタスクIDの修正

m2-burst や feat-login のようなハイフンを含むタスクIDが正しく解決されない問題を修正しました。handoff_update_task、handoff_get_task、handoff_check_criterion、handoff_log_time、タイマーツールのすべてで正常に動作します。

また、タスクが見つからない場合に類似のタスクIDを提案するようになり、タイプミスの修正が容易になりました。

インストール・アップデート

npx handoff-mcp-server@latest