How do I install the Mateclaw Source Index skill?

Run npx skillmds@latest add mateaix/mateclaw-source-index in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Mateclaw Source Index skill do?

将用户问题映射到 MateClaw 文档路径与源码入口，减少盲目搜索。回答'XX 功能在哪里实现'、'怎么修改 YY 逻辑'等源码定位问题。 It is listed under Coding & Dev Tools on SkillMD.

Is Mateclaw Source Index safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mateclaw Source Index?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mateclaw Source Index free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mateclaw Source Index?

mateaix (@mateaix) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mateclaw Source Index by mateaix — Agent Skill

Name: Mateclaw Source Index
Author: mateaix

File contents

MateClaw 源码导航

当用户询问"XX 功能在哪里实现"、"Agent 流程入口在哪"、"如何修改 YY 逻辑"等源码定位问题时使用本技能。

工作流程

第一步：查文档索引

readMateClawDoc(action="list")

根据用户问题关键词在文件列表中找到最相关文档。

第二步：读取架构文档

readMateClawDoc(action="read", path="zh/architecture.md")

或直接读 CLAUDE.md（项目根目录，包含最完整的包结构说明）：

read_file(filePath="CLAUDE.md")

第三步：返回定位结果

回答格式：文件路径 : 行号范围 + 一句话说明入口作用

示例：

agent/graph/StateGraphReActAgent.java — ReAct 循环图的组装入口，连接 ReasoningNode → ActionNode → ObservationNode

核心路径速查表

Agent 运行时

功能	文件路径
ReAct 图组装	`agent/graph/StateGraphReActAgent.java`
Plan-Execute 图组装	`agent/graph/plan/StateGraphPlanExecuteAgent.java`
推理节点	`agent/graph/node/ReasoningNode.java`
动作节点	`agent/graph/node/ActionNode.java`
观察节点	`agent/graph/node/ObservationNode.java`
最终答案节点	`agent/graph/node/FinalAnswerNode.java`
Agent 图构建器	`agent/AgentGraphBuilder.java`
上下文注入	`agent/context/RuntimeContextInjector.java`
Token 估算 / 裁剪	`agent/context/TokenEstimator.java`

工具 & 审批

功能	文件路径
工具注册中心	`tool/ToolRegistry.java`
MCP 适配器	`tool/mcp/`
工具守卫规则	`tool/guard/`
人工审批流程	`approval/ApprovalWorkflowService.java`
审批 Controller	`approval/ApprovalController.java`

渠道 & 对话

功能	文件路径
渠道适配器接口	`channel/ChannelAdapter.java`
Web SSE 聊天	`channel/web/ChatController.java`
渠道 Webhook	`channel/ChannelWebhookController.java`
流追踪器	`channel/web/ChatStreamTracker.java`

记忆 & Wiki

功能	文件路径
记忆生命周期协调者	`memory/MemoryLifecycleMediator.java`
Dream 引擎	`memory/dream/DreamService.java`
Dream 报告 Controller	`memory/controller/DreamController.java`
Wiki 处理流水线	`wiki/service/WikiProcessingService.java`
Wiki Controller	`wiki/controller/WikiController.java`

技能运行时

功能	文件路径
技能运行时服务	`skill/runtime/SkillRuntimeService.java`
技能安全扫描	`skill/security/SkillSecurityService.java`
技能 Controller	`skill/controller/SkillController.java`

数据库 & 配置

功能	文件路径
Flyway 迁移（H2）	`resources/db/migration/h2/`
Flyway 迁移（MySQL）	`resources/db/migration/mysql/`
种子数据（中文）	`resources/db/data-mysql-zh.sql`
系统设置	`system/service/SystemSettingService.java`

注意

路径均相对于 mateclaw-server/src/main/java/vip/mate/（Java 文件）或 mateclaw-server/src/main/resources/（资源文件）
如找不到精确文件，先用 readMateClawDoc 搜索，再用 read_file 读取 CLAUDE.md 获取最新架构描述

---name: mateclaw-source-indexdescription: 将用户问题映射到 MateClaw 文档路径与源码入口，减少盲目搜索。回答'XX 功能在哪里实现'、'怎么修改 YY 逻辑'等源码定位问题。---# MateClaw 源码导航当用户询问"XX 功能在哪里实现"、"Agent 流程入口在哪"、"如何修改 YY 逻辑"等源码定位问题时使用本技能。## 工作流程### 第一步：查文档索引```readMateClawDoc(action="list")```根据用户问题关键词在文件列表中找到最相关文档。### 第二步：读取架构文档```readMateClawDoc(action="read", path="zh/architecture.md")```或直接读 CLAUDE.md（项目根目录，包含最完整的包结构说明）：```read_file(filePath="CLAUDE.md")```### 第三步：返回定位结果回答格式：**文件路径 : 行号范围 + 一句话说明入口作用**示例：> `agent/graph/StateGraphReActAgent.java` — ReAct 循环图的组装入口，连接 ReasoningNode → ActionNode → ObservationNode## 核心路径速查表### Agent 运行时| 功能 | 文件路径 ||------|---------|| ReAct 图组装 | `agent/graph/StateGraphReActAgent.java` || Plan-Execute 图组装 | `agent/graph/plan/StateGraphPlanExecuteAgent.java` || 推理节点 | `agent/graph/node/ReasoningNode.java` || 动作节点 | `agent/graph/node/ActionNode.java` || 观察节点 | `agent/graph/node/ObservationNode.java` || 最终答案节点 | `agent/graph/node/FinalAnswerNode.java` || Agent 图构建器 | `agent/AgentGraphBuilder.java` || 上下文注入 | `agent/context/RuntimeContextInjector.java` || Token 估算 / 裁剪 | `agent/context/TokenEstimator.java` |### 工具 & 审批| 功能 | 文件路径 ||------|---------|| 工具注册中心 | `tool/ToolRegistry.java` || MCP 适配器 | `tool/mcp/` || 工具守卫规则 | `tool/guard/` || 人工审批流程 | `approval/ApprovalWorkflowService.java` || 审批 Controller | `approval/ApprovalController.java` |### 渠道 & 对话| 功能 | 文件路径 ||------|---------|| 渠道适配器接口 | `channel/ChannelAdapter.java` || Web SSE 聊天 | `channel/web/ChatController.java` || 渠道 Webhook | `channel/ChannelWebhookController.java` || 流追踪器 | `channel/web/ChatStreamTracker.java` |### 记忆 & Wiki| 功能 | 文件路径 ||------|---------|| 记忆生命周期协调者 | `memory/MemoryLifecycleMediator.java` || Dream 引擎 | `memory/dream/DreamService.java` || Dream 报告 Controller | `memory/controller/DreamController.java` || Wiki 处理流水线 | `wiki/service/WikiProcessingService.java` || Wiki Controller | `wiki/controller/WikiController.java` |### 技能运行时| 功能 | 文件路径 ||------|---------|| 技能运行时服务 | `skill/runtime/SkillRuntimeService.java` || 技能安全扫描 | `skill/security/SkillSecurityService.java` || 技能 Controller | `skill/controller/SkillController.java` |### 数据库 & 配置| 功能 | 文件路径 ||------|---------|| Flyway 迁移（H2） | `resources/db/migration/h2/` || Flyway 迁移（MySQL） | `resources/db/migration/mysql/` || 种子数据（中文） | `resources/db/data-mysql-zh.sql` || 系统设置 | `system/service/SystemSettingService.java` |## 注意- 路径均相对于 `mateclaw-server/src/main/java/vip/mate/`（Java 文件）或 `mateclaw-server/src/main/resources/`（资源文件）- 如找不到精确文件，先用 `readMateClawDoc` 搜索，再用 `read_file` 读取 CLAUDE.md 获取最新架构描述

Frequently asked questions

Mateclaw Source Index