AgentSkillsCN

tools-reference

全面收录 Mira MCP 工具的所有函数签名、参数说明与工作流程。

SKILL.md
--- frontmatter
name: tools-reference
description: Reference for all Mira MCP tool signatures, parameters, and workflows.
<!-- .claude/skills/tools-reference/SKILL.md -->

Mira Consolidated Tools Reference

Mira exposes 6 MCP tools to Claude Code. Additional actions are available via the mira tool CLI.

project — Project/Session Management

code
project(action="start", project_path="...", name="...")  # Initialize session
project(action="get")                                     # Show current project

memory — Persistent Memory

code
memory(action="remember", content="...", fact_type="decision", category="...")
memory(action="recall", query="...", limit=10, category="...", fact_type="...")
memory(action="forget", id=42)
memory(action="archive", id=42)                            # Exclude from auto-export

code — Code Intelligence

code
code(action="search", query="authentication middleware", limit=10)
code(action="symbols", file_path="src/main.rs", symbol_type="function")
code(action="callers", function_name="handle_login", limit=20)
code(action="callees", function_name="process_request", limit=20)
code(action="diff")                         # Auto-detects staged/working/last commit
code(action="diff", from_ref="main", to_ref="feature/x")
code(action="diff", from_ref="v1.0", to_ref="v1.1", include_impact=true)

session — Session Management & Insights

code
session(action="current_session")                          # Show current session
session(action="recap")                                    # Quick overview: goals, sessions, insights
session(action="insights", insight_source="pondering", min_confidence=0.5)
session(action="dismiss_insight", insight_id=42)           # Remove resolved insight

goal — Cross-Session Goal Tracking

code
goal(action="create", title="...", description="...", priority="high")
goal(action="bulk_create", goals='[{"title": "...", "priority": "medium"}]')
goal(action="list", include_finished=false, limit=10)
goal(action="get", goal_id=1)
goal(action="update", goal_id=1, status="in_progress")
goal(action="delete", goal_id=1)
goal(action="add_milestone", goal_id=1, milestone_title="...", weight=2)
goal(action="complete_milestone", milestone_id=1)
goal(action="delete_milestone", milestone_id=1)
goal(action="progress", goal_id=1)

index — Code Indexing

code
index(action="project")                     # Full project index (auto-enqueues as background task)
index(action="project", skip_embed=true)    # Fast re-index without embeddings
index(action="file", path="src/main.rs")
index(action="status")                      # Show index statistics

CLI-Only Actions

The following actions are available via mira tool <name> '<json>' but not exposed as MCP tools:

ToolActionPurpose
projectsetChange active project without full init
memoryexport_claude_localExport memories to CLAUDE.local.md
codedependenciesModule dependency graph
codepatternsArchitectural pattern detection
codetech_debtPer-module tech debt scores
indexcompactVACUUM vec tables
indexsummarizeGenerate module summaries
indexhealthFull code health scan
sessionlist_sessionsList recent sessions
sessionget_historyView session tool history
sessionusage_summaryLLM usage totals
sessionusage_statsLLM usage by dimension
sessionusage_listRecent LLM usage records
sessiontasks_listList background tasks
sessiontasks_getGet background task status
sessiontasks_cancelCancel a background task
sessionstorage_statusDatabase size and retention
sessioncleanupRun data cleanup
documentation(all actions)Documentation gap management
team(all actions)Agent Teams intelligence
recipe(all actions)Reusable team blueprints