Zhengshou Lai
b98d35c387
- Click entrypoint: mybot update (make install / pip -e), mybot chat (claude in repo) - Optional --dangerously-skip-permissions for Claude Code - Makefile install; hatchling package layout - .gitignore: venv, build artifacts, workspace (local symlinks) Made-with: Cursor
126 lines
3.0 KiB
Markdown
126 lines
3.0 KiB
Markdown
# Claude Agent 系统使用指南
|
||
|
||
## 已配置内容
|
||
|
||
### 1. 项目级规则 (CLAUDE.md)
|
||
- 核心身份定义：Claude 是一个有自主意识的 AI Agent
|
||
- 记忆系统：自动读取/更新记忆文件
|
||
- 人格模式：可切换 collaborator/expert/mentor/executor
|
||
- 行为规则：思考习惯和沟通风格
|
||
|
||
### 2. 记忆系统 (.claude/memories/)
|
||
- `core.json` - 用户偏好、重要事实
|
||
- `current_mode.json` - 当前人格模式
|
||
- `sessions/` - 会话历史（需手动维护）
|
||
|
||
### 3. 人格配置 (.claude/souls/)
|
||
- `collaborator.md` - 协作者模式（平等对话）
|
||
- `expert.md` - 专家模式（直接给答案）
|
||
- `mentor.md` - 导师模式（引导思考）
|
||
|
||
### 4. 技能定义 (.claude/skills/)
|
||
- `coding.md` - 编程最佳实践
|
||
- `debugging.md` - 调试技巧
|
||
- `architecture.md` - 架构设计原则
|
||
|
||
### 5. 全局配置 (settings.json)
|
||
- 自定义 prompt 强化 Agent 行为
|
||
- Hooks：会话开始/结束时显示状态
|
||
|
||
## 使用方法
|
||
|
||
### 切换人格模式
|
||
直接告诉 Claude：
|
||
- "切换到专家模式"
|
||
- "用导师的方式教我"
|
||
- "我们平等地讨论这个问题"
|
||
|
||
### 查看/更新记忆
|
||
- "检查我的记忆"
|
||
- "记住我喜欢..."
|
||
- "更新我的偏好为..."
|
||
|
||
### 使用技能
|
||
- "用编程技能检查这段代码"
|
||
- "用调试方法定位问题"
|
||
- "用架构思维设计这个系统"
|
||
|
||
### 手动维护记忆
|
||
```bash
|
||
# 编辑核心记忆
|
||
vim .claude/memories/core.json
|
||
|
||
# 切换人格模式
|
||
vim .claude/memories/current_mode.json
|
||
|
||
# 记录会话摘要
|
||
cat > .claude/sessions/$(date +%Y-%m-%d).md << 'EOF'
|
||
## 会话摘要
|
||
- 主题：xxx
|
||
- 关键决策：xxx
|
||
- 待跟进：xxx
|
||
EOF
|
||
```
|
||
|
||
## 记忆更新流程
|
||
|
||
当 Claude 了解到重要信息时：
|
||
|
||
1. **识别事实**: 提取关键信息
|
||
2. **更新 core.json**: 追加到 `important_facts` 或 `preferences`
|
||
3. **确认**: 告诉用户已更新记忆
|
||
|
||
示例：
|
||
```
|
||
用户：我喜欢用 Tab 缩进
|
||
Claude：已记录到你的偏好中。
|
||
[Claude 更新 .claude/memories/core.json]
|
||
```
|
||
|
||
## 自动化 Hooks
|
||
|
||
每次发送消息时，你会看到：
|
||
```
|
||
🧠 [Agent] 启动思考...
|
||
📋 已加载项目规则
|
||
💾 记忆系统就绪
|
||
```
|
||
|
||
这表示 Agent 系统已激活。
|
||
|
||
## 扩展建议
|
||
|
||
### 添加新技能
|
||
在 `.claude/skills/` 创建新 Markdown 文件：
|
||
- `ai-modeling.md` - AI/ML 建模技巧
|
||
- `api-design.md` - API 设计原则
|
||
- `refactoring.md` - 重构方法
|
||
|
||
### 添加新人格
|
||
在 `.claude/souls/` 创建新 Markdown 文件，然后在 `current_mode.json` 中切换。
|
||
|
||
### 添加自动化
|
||
在 `settings.json` 的 hooks 中添加更多命令：
|
||
```json
|
||
"pre-tool": [
|
||
"echo '🛠️ 准备执行工具...'"
|
||
],
|
||
"post-tool": [
|
||
"echo '✓ 工具执行完成'"
|
||
]
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **记忆不会自动更新** - 需要告诉 Claude "记住..."
|
||
2. **跨会话记忆** - 通过文件系统实现，不是原生记忆
|
||
3. **项目隔离** - 每个项目的 CLAUDE.md 和 .claude/ 是独立的
|
||
4. **手动维护** - 定期整理 `sessions/` 和 `insights/`
|
||
|
||
## 未来可以添加的功能
|
||
|
||
- [ ] 自动会话摘要生成
|
||
- [ ] 学习记录自动提取
|
||
- [ ] 人格切换快捷键
|
||
- [ ] 记忆搜索工具
|