CLAUDE.md•4.69 kB
# Claude Code MCP优化规则
## 项目信息
- **项目名**: ai-conversation-logger-mcp
- **位置**: 已存在的TypeScript项目
- **当前状态**: 基础功能已实现，需要优化
## 核心设计原则
1. **纯保存模式** - MCP只负责格式化和存储，不做内容分析和提取
2. **AI主导内容** - 所有记录内容由AI（你）决定和提供
3. **为AI回溯设计** - 记录格式要便于AI快速理解项目历史
## 共有3个工具
### 1. log_conversation - 核心记录工具
```typescript
interface LogConversationParams {
userRequest: string; // 用户原始需求 + 上传文件说明
aiTodoList: string[]; // 你的执行计划清单（即使只是查看也要列出）
aiSummary: string; // 你的操作总结（3-5句话，包括解释、分析等）
fileOperations: string[]; // 文件操作总结，格式："动作 文件路径 - 说明"（可为空）
title?: string; // 对话标题（可选）
tags?: string[]; // 标签数组（可选）
project?: string; // 项目名（可选，自动检测）
}
```
**优化要求**：
- 所有会话都要记录，不仅仅是修改代码
- userRequest要包含上传文件的说明
- 即使没有文件操作也要记录会话
- 确保使用本地时间 `new Date().toLocaleDateString('zh-CN')`
### 2. search_conversations - 搜索工具
```typescript
interface SearchParams {
keywords?: string[]; // 关键词搜索
filePattern?: string; // 文件名模式搜索
days?: number; // 最近N天
project?: string; // 项目过滤（默认当前）
}
```
**优化要求**：
- 搜索要包括文件名
- 支持中文搜索
- 返回结果要包含完整context
### 3. get_context_suggestions - 上下文推荐
```typescript
interface ContextParams {
currentInput: string; // 当前用户输入
currentFiles?: string[]; // 当前涉及的文件
}
```
**优化要求**：
- 基于文件关联性推荐
- 优先推荐最近的相关记录
## 日志保存格式
每条记录必须包含以下结构：
```markdown
## [时间戳] 标题 #标签
### 🗣️ 用户需求
[用户的原始需求]
### 📋 AI执行计划
- [x] 完成的任务
- [ ] 未完成的任务
### 🤖 AI回复总结
[你完成了什么的总结，重点是功能而非技术细节]
### 📂 文件操作总结
- **创建** `path/to/file` - 用途说明
- **修改** `path/to/file` - 修改了什么
- **删除** `path/to/file` - 删除原因
### 🏷️ 标签
#模块 #技术 #类型
```
## 当你使用MCP记录时
### 记录时机
**所有会话都要记录**，包括但不限于：
- 完成新功能开发
- 修复bug（无论大小）
- 代码重构
- 修改配置文件
- 代码解释和分析
- 回答技术问题
- 查看或审查代码
- 任何涉及项目的对话
### 调用示例
```javascript
// 在完成用户请求后，调用MCP记录
await use_mcp_tool("conversation-logger", "log_conversation", {
userRequest: "实现用户登录功能",
aiTodoList: [
"创建LoginForm组件",
"添加表单验证",
"集成到App.tsx"
],
aiSummary: "成功创建了完整的登录组件系统，包含表单验证、错误处理和响应式设计",
fileOperations: [
"创建 src/components/LoginForm.tsx - 登录表单组件",
"创建 src/components/LoginForm.css - 组件样式",
"修改 src/App.tsx - 导入并使用LoginForm组件"
],
tags: ["auth", "react", "feature"]
});
```
## 代码优化重点
### 1. 项目检测
```typescript
// 自动检测当前项目
const project = params.project || process.cwd().split('/').pop();
```
### 2. 日期处理
```typescript
// 使用本地日期，不要UTC
const fileName = `${new Date().toLocaleDateString('zh-CN')}.md`;
// 输出格式: 2025-08-07.md
```
## 需要修复的问题
1. **搜索功能不够智能** - 添加文件名搜索支持
2. **日期使用UTC** - 改为本地时间
3. **自动提取功能** - 移除所有自动分析，内容由AI提供
## 测试你的优化
优化后，测试以下场景：
1. **记录测试**
```
"帮我实现一个React组件"
→ 完成后自动调用log_conversation记录
→ 检查ai-logs/目录下是否正确生成文件
```
2. **搜索测试**
```
"搜索关于登录的历史记录"
→ 调用search_conversations
→ 应该返回所有包含"登录"的记录
```
3. **上下文测试**
```
"继续改进登录功能"
→ 调用get_context_suggestions
→ 应该推荐相关的登录记录
## 记住
- 这个MCP是给AI（你自己）用的工具
- 重点是记录"做了什么"，不是"怎么做的"
- 保持记录简洁但信息完整
- 每次重要操作后都要记录