- 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
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:
- "切换到专家模式"
- "用导师的方式教我"
- "我们平等地讨论这个问题"
查看/更新记忆
- "检查我的记忆"
- "记住我喜欢..."
- "更新我的偏好为..."
使用技能
- "用编程技能检查这段代码"
- "用调试方法定位问题"
- "用架构思维设计这个系统"
手动维护记忆
# 编辑核心记忆
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 了解到重要信息时:
- 识别事实: 提取关键信息
- 更新 core.json: 追加到
important_facts或preferences - 确认: 告诉用户已更新记忆
示例:
用户:我喜欢用 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 中添加更多命令:
"pre-tool": [
"echo '🛠️ 准备执行工具...'"
],
"post-tool": [
"echo '✓ 工具执行完成'"
]
注意事项
- 记忆不会自动更新 - 需要告诉 Claude "记住..."
- 跨会话记忆 - 通过文件系统实现,不是原生记忆
- 项目隔离 - 每个项目的 CLAUDE.md 和 .claude/ 是独立的
- 手动维护 - 定期整理
sessions/和insights/
未来可以添加的功能
- 自动会话摘要生成
- 学习记录自动提取
- 人格切换快捷键
- 记忆搜索工具