第十八章：最佳实践建议
💡 本章提供 MiniClaw 的使用最佳实践和优化建议。
18.1 日常使用建议
18.1.1 启动对话
┌─────────────────────────────────────────────────────────────────────┐
│ 启动对话建议 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ✅ 推荐做法： │
│ │
│ 1. 明确项目上下文 │
│ "我正在开发一个 React 项目，使用 TypeScript" │
│ │
│ 2. 说明当前任务 │
│ "需要实现一个用户认证功能" │
│ │
│ 3. 提供相关文件 │
│ "请查看 src/auth/ 目录下的文件" │
│ │
│ ❌ 避免做法： │
│ │
│ • 过于简短的提示 │
│ • 不提供上下文 │
│ • 一次性提出多个不相关的问题 │
│ │
└─────────────────────────────────────────────────────────────────────┘18.1.2 记忆管理
┌─────────────────────────────────────────────────────────────────────┐
│ 记忆管理建议 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ✅ 推荐做法： │
│ │
│ 1. 主动记录重要信息 │
│ "请记住我使用 pnpm 而不是 npm" │
│ │
│ 2. 定期查看 MEMORY.md │
│ 检查记忆是否准确 │
│ 删除过时信息 │
│ │
│ 3. 使用 miniclaw_note 记录关键决策 │
│ "记录：决定使用 Zod 进行参数验证" │
│ │
│ ❌ 避免做法： │
│ │
│ • 记录敏感信息（密码、密钥等） │
│ • 记录临时或无关信息 │
│ • 从不清理过时记忆 │
│ │
└─────────────────────────────────────────────────────────────────────┘18.2 DNA 文件优化
18.2.1 AGENTS.md 优化
┌─────────────────────────────────────────────────────────────────────┐
│ AGENTS.md 优化建议 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ✅ 推荐做法： │
│ │
│ 1. 根据项目类型定制 │
│ • Web 项目：添加前端框架规则 │
│ • Node 项目：添加服务端规则 │
│ • Python 项目：添加 Python 规范 │
│ │
│ 2. 保持简洁 │
│ • 核心规则 5-10 条 │
│ • 避免冗长描述 │
│ │
│ 3. 定期更新 │
│ • 根据项目演进调整 │
│ • 移除不再适用的规则 │
│ │
│ 示例优化： │
│ ❌ "不要使用 var，因为 var 有变量提升问题，可能导致..." │
│ ✅ "使用 const/let，不使用 var" │
│ │
└─────────────────────────────────────────────────────────────────────┘18.2.2 SOUL.md 优化
┌─────────────────────────────────────────────────────────────────────┐
│ SOUL.md 优化建议 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ✅ 推荐做法： │
│ │
│ 1. 定义清晰的语气 │
│ • 专业严谨 │
│ • 友好轻松 │
│ • 简洁直接 │
│ │
│ 2. 设置边界 │
│ • 能做什么 │
│ • 不能做什么 │
│ • 如何处理边缘情况 │
│ │
│ 3. 包含示例 │
│ • 好的回复示例 │
│ • 避免的回复示例 │
│ │
└─────────────────────────────────────────────────────────────────────┘18.3 技能开发建议
18.3.1 技能设计原则
┌─────────────────────────────────────────────────────────────────────┐
│ 技能设计原则 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 1. 单一职责 │
│ • 一个技能只解决一类问题 │
│ • 避免功能过于复杂 │
│ │
│ 2. 清晰命名 │
│ • 使用描述性名称 │
│ • 避免缩写 │
│ │
│ 3. 完整文档 │
│ • SKILL.md 详细说明 │
│ • 包含使用示例 │
│ • 说明前置条件 │
│ │
│ 4. 版本管理 │
│ • 使用语义化版本 │
│ • 记录变更日志 │
│ │
└─────────────────────────────────────────────────────────────────────┘本章小结
┌─────────────────────────────────────────────────────────────────────┐
│ 第十八章 核心要点 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 💬 日常使用 │
│ • 提供清晰的上下文 │
│ • 主动记录重要信息 │
│ • 定期清理过时记忆 │
│ │
│ 📝 DNA 文件优化 │
│ • AGENTS.md：项目规则定制 │
│ • SOUL.md：语气边界定义 │
│ • USER.md：个人偏好记录 │
│ │
│ 🔧 技能开发 │
│ • 单一职责原则 │
│ • 清晰命名规范 │
│ • 完整文档说明 │
│ │
│ ⚡ 性能优化 │
│ • 合理设置 Token 预算 │
│ • 定期归档旧日志 │
│ • 优化技能缓存 │
│ │
└─────────────────────────────────────────────────────────────────────┘本文档是《MiniClaw 深度解析》系列的第十八章，下一章将详细介绍常见问题与解决方案。
讨论回复
0 条回复还没有人回复