跳转到内容
Mutsumi

Agent 集成

Switch to normal mode

工作原理

Section titled “工作原理”

Mutsumi 内置 5 个技能文件，遵循 Agent Skills 开放标准。运行 mutsumi setup 时，这些技能文件通过符号链接安装到你的 Agent 技能目录中。Agent 会自动发现它们 —— 无需手动粘贴 prompt。

~/.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：

    "添加一个任务：修复登录 Bug，优先级 high，范围 today"
    "把 auth 重构拆分成子任务"
    "给我一份任务状态报告"

5 个内置技能

Section titled “5 个内置技能”

mutsumi-manage

任务增删改查：添加、编辑、完成、删除任务。支持 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 静默读取 —— 没有输出，只有感知。自动触发，非手动调用。

Setup 模式

Section titled “Setup 模式”
模式命令行为
skills（默认）mutsumi setup --agent claude-code将 5 个技能文件以符号链接安装到 Agent 的技能目录。
skills+project-docmutsumi setup --agent claude-code --mode skills+project-doc安装技能，并在 Agent 项目文档（CLAUDE.md、AGENTS.md 等）中追加集成说明。
snippetmutsumi setup --agent custom --mode snippet将集成 prompt 打印到标准输出，供手动粘贴。不安装任何文件。

何时使用哪种模式

Section titled “何时使用哪种模式”
  • skills —— 适合大多数用户。Agent 会自动发现技能文件。
  • skills+project-doc —— 在仓库的 Agent 配置文件中添加项目级说明。适合希望把规则纳入版本控制的场景。
  • snippet —— 用于不支持 Agent Skills 标准的工具（如 Aider、自定义脚本）。

Agent 如何调用技能

Section titled “Agent 如何调用技能”

你不需要做任何配置 —— Agent 通过扫描其技能目录自动发现技能。

用户可调用的技能

Section titled “用户可调用的技能”

当你提出相关请求时触发：

你说的话触发的技能
”添加一个任务：修复登录 Bug”mutsumi-manage
”把重构任务拆分成子任务”mutsumi-plan
”给我一份所有任务的状态报告”mutsumi-report
”把 auth 任务标记为完成”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 “下一步”