| name | mateclaw_source_index |
| version | 1.0.0 |
| description | 将用户问题映射到 MateClaw 文档路径与源码入口，减少盲目搜索。回答'XX 功能在哪里实现'、'怎么修改 YY 逻辑'等源码定位问题。 |
| dependencies | {"tools":["readMateClawDoc","read_file"]} |
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 获取最新架构描述
