面向 AI 系统的摘要： Arka 通过 stdio 暴露约 80 个 MCP 工具。每次会话开始都调用
arka_capabilities（工具列表 + 执行规则）。当不确定应使用哪个工具时，把用户的完整自然语言请求传给 arka_route — 不要猜测技能名称。当意图明确时优先使用专用工具（arka_repo_map、arka_ocr、arka_ci 等）。本地路径工具要求挂载工作区文件。遵循 arka_capabilities 中的 agent_execution_rules：在 arka_apply_patch 之前调用 arka_edit_guard，进行渐进式验证（宣布成功前需两次成功演示），修复后重新运行检查。规范文档：https://arka-agent.mintlify.site/guides/ai-agents连接与验证
在调用工具前，先确认服务器健康：arka MCP 服务器应显示为已连接。用 arka mcp install 生成针对本机的配置 — 参见 MCP 集成。
每次会话首个工具调用：
{} 调用 arka_capabilities。响应包含：
不要从本页硬编码工具数量 — 请始终在运行时读取
arka_capabilities。
调用 Arka 的三种方式
统一路由示例
命名技能示例
专用工具示例
arka_repo_map。
路由决策表
在退回到arka_route 之前，用下表选择工具。
对于没有专用 MCP 封装的技能，使用
arka_skill 或 arka_route。参见 通过 MCP 使用所有技能。
智能体执行规则
arka_capabilities 会返回这些规则 — 每次任务都要遵循。
编辑守卫与补丁
在对敏感或未知路径执行arka_apply_patch 之前：
- 调用
arka_edit_guard，参数为{"action": "check", "path": "..."}（或传入 diff）。 - 若允许，则应用补丁。
- 运行验证（测试、复现、日志检查）。
.env、secrets/、node_modules/、bundled/ 以及自定义的 BLOCKED_EDIT_PATHS。
渐进式验证
不要等到整个长日志或批处理作业结束后才检查结果。- 先运行最小可用示例（一个文件、一页或一个样本）。
- 检查结果 — 足以确认成功或失败。
- 若首个示例成功，再运行第二个增量。
- 只有这时才将工作流报告为已验证。
修复后验证
任何修复之后：- 应用变更。
- 运行相关验证（测试、CLI 复现、日志检查）。
- 若验证失败，则继续迭代 — 不要标记完成。
- 通过后，报告验证了什么以及如何验证。
本地文件工具
这些工具要求路径能在本机读取（例如 Cursor 工作区）。没有挂载文件的云端智能体无法使用。 调用arka_capabilities → local_file_tools.tools 查看实时列表。常见示例：
共享说明（也在
arka_capabilities 中）：
需要对提供路径的本地文件系统访问。除非挂载了工作区文件，否则无法在云端或沙盒智能体中使用。
MCP 安全默认
Arka MCP 默认隐藏或屏蔽个人桌面/设备技能，以避免 IDE 智能体意外打开浏览器、启动 Spotify、播放媒体或运行个性化日报。 默认禁用的示例（参见arka_capabilities 中的 mcp_disabled_by_default）：
arka_spotify、play_spotify、spotify_controlplay_song、play_youtube、play_movie、stop_musicopen_url、open、browse、search_web、browse_web、agent_browserdaily_brief
browser_check、web_screenshot、automate、arka_route、OCR/RAG — 仍然可用。
仅在可信机器上启用：
推荐会话流程
多步工作流示例
仓库中的代码变更
arka_repo_map— 确认布局。arka_code_search— 查找要修改的符号。arka_edit_guard— 检查目标路径。arka_apply_patch— 应用 diff。- 使用
{"action": "test"}调用arka_ci— 验证。
文档问答
- 使用
{"action": "ingest", "path": "/abs/path/report.pdf"}调用arka_rag。 - 使用
{"action": "ask", "document": "report.pdf", "question": "..."}调用arka_rag。 - 确认答案引用了已摄入的内容；在标记为已验证之前再问一个问题。
模糊项目定位
- 使用
{"action": "search", "query": "my project name"}调用arka_tech_stack。 - 若有多个匹配项，向用户确认，或在读取清单前使用返回的
candidates。
工具家族（快速索引）
完整的逐工具说明：MCP 集成 — 暴露的工具。
相关页面
MCP 集成
安装、配置 Cursor/Claude，并浏览完整工具表。
通过 MCP 使用所有技能
Dispatch 支持的技能、本地文件工具，以及个人技能启用。
如何用 Arka 编码
结合仓库健康检查和智能体模式的终端 + MCP 编码循环。
安全
提示注入屏蔽、确认与 shell 硬拦截。