【MiniClaw 深度解析】第十八章：最佳实践建议

# 第十八章：最佳实践建议 > 💡 本章提供 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 深度解析》系列的第十八章，下一章将详细介绍常见问题与解决方案。*