コンテンツにスキップ
Mutsumi

Agent セットアップ

Switch to normal mode

仕組み

Section titled “仕組み”

Mutsumi は Agent Skills オープン標準 に準拠した 5 つのバンドルスキルを同梱しています。mutsumi setup を実行すると、これらのスキルファイルがシンボリックリンクで Agent のスキルディレクトリにインストールされます。Agent は自動的にスキルを検出するため、手動でプロンプトをペーストする必要はありません。

~/.mutsumi/skills/          ← SSOT（信頼できる唯一の情報源）
  mutsumi-manage/SKILL.md
  mutsumi-track/SKILL.md
  mutsumi-plan/SKILL.md
  mutsumi-report/SKILL.md
  mutsumi-context/SKILL.md
        │
        ├── symlink → ~/.claude/skills/     (Claude Code)
        ├── symlink → ~/.agents/skills/     (Codex CLI)
        ├── symlink → ~/.gemini/skills/     (Gemini CLI)
        └── symlink → ~/.config/opencode/skills/  (OpenCode)

クイックスタート

Section titled “クイックスタート”

  1. Mutsumi をインストール（まだの場合）：

    Terminal window
    pip install mutsumi-tui

  2. Agent に対して setup を実行：

    Terminal window
    mutsumi setup --agent claude-code

    スキルは ~/.claude/skills/ にインストールされます。

  3. インストールを確認：

    Terminal window
    ls ~/.claude/skills/mutsumi-*/SKILL.md   # Claude Code の例
    # mutsumi-manage/SKILL.md
    # mutsumi-track/SKILL.md
    # mutsumi-plan/SKILL.md
    # mutsumi-report/SKILL.md
    # mutsumi-context/SKILL.md

  4. 使い始める — Agent に話しかけるだけ：

    "ログインバグ修正のタスクを追加して、優先度 high、スコープ today"
    "認証リファクタリングをサブタスクに分解して"
    "タスクのステータスレポートを出して"

5 つのバンドルスキル

Section titled “5 つのバンドルスキル”

mutsumi-manage

タスク CRUD：タスクの追加・編集・完了・削除。CLI コマンド（mutsumi add、mutsumi done）と直接 JSON 操作の両方に対応。

mutsumi-track

自動進捗トラッキング：作業中にタスクのステータスを自動更新。サブタスクの完了マークや親タスクの進捗更新を行う。Agent が自動的にトリガーし、手動呼び出し不要。

mutsumi-plan

タスク分解：複雑な目標を parent-children 構造のアクショナブルなサブタスクに分解。呼び出し方：“v2 への移行を計画して”。

mutsumi-report

ステータスレポート：mutsumi.json を読み取り、スコープ別（Today → Week → Month → Inbox）の進捗サマリーを生成。呼び出し方：“タスクレポートを出して”。

mutsumi-context

コンテキストローダー：セッション開始時にタスクボードを読み込み、現在の優先順位を把握。Agent がサイレントに読み込む — 出力なし、認識のみ。自動トリガー、手動呼び出し不要。

セットアップモード

Section titled “セットアップモード”
モードコマンド動作
skills（デフォルト）mutsumi setup --agent claude-code5 つのスキルファイルをシンボリックリンクで Agent のスキルディレクトリにインストール。
skills+project-docmutsumi setup --agent claude-code --mode skills+project-docスキルをインストールし、Agent のプロジェクトドキュメント（CLAUDE.md、AGENTS.md など）に統合手順を追記。
snippetmutsumi setup --agent custom --mode snippet統合プロンプトを標準出力に表示。ファイルのインストールなし。

どのモードを使うべきか

Section titled “どのモードを使うべきか”
  • skills — ほとんどのユーザーに最適。Agent がスキルを自動検出します。
  • skills+project-doc — リポジトリの Agent 設定ファイルにプロジェクトレベルの指示を追加。ルールをバージョン管理に含めたい場合に有用。
  • snippet — Agent Skills 標準をサポートしないツール（Aider、カスタムスクリプトなど）向け。

Agent がスキルを呼び出す方法

Section titled “Agent がスキルを呼び出す方法”

設定は不要です — Agent はスキルディレクトリをスキャンして自動検出します。

ユーザー呼び出しスキル

Section titled “ユーザー呼び出しスキル”

関連するリクエストをすると発動：

あなたの発言トリガーされるスキル
「ログインバグ修正のタスクを追加して」mutsumi-manage
「リファクタリングをサブタスクに分解して」mutsumi-plan
「全タスクのステータスレポートを出して」mutsumi-report
「認証タスクを完了にして」mutsumi-manage

自動トリガースキル

Section titled “自動トリガースキル”

コンテキストに基づいて自動的に発動：

動作スキル
Agent がセッション開始時にタスクボードを読み込むmutsumi-context
Agent が作業中にタスク進捗を更新するmutsumi-track

対応 Agent 一覧

Section titled “対応 Agent 一覧”
Agentスキルディレクトリプロジェクトドキュメント
Claude Code~/.claude/skills/CLAUDE.md
Codex CLI~/.agents/skills/AGENTS.md
Gemini CLI~/.gemini/skills/GEMINI.md
OpenCode~/.config/opencode/skills/opencode.md
Aider——
Custom——

確認とトラブルシューティング

Section titled “確認とトラブルシューティング”
Terminal window
# インストール済みスキルを確認
ls -la ~/.claude/skills/mutsumi-*/SKILL.md


# 再インストール（壊れたシンボリックリンクを修復）
mutsumi setup --agent claude-code


# アンインストール（手動削除）
rm -rf ~/.claude/skills/mutsumi-*

次のステップ

Section titled “次のステップ”