名称: Claude 代码指南 描述: 高效使用 Claude Code 的完整指南。包括配置模板、提示策略“思考”关键词、调试技巧以及与代理交互的最佳实践。
Claude 代码指南
目的
提供配置和使用 Claude Code(代理式编码工具)以实现其最大潜力的全面参考。本技能综合了最佳实践、配置模板和高级使用模式。
配置 (CLAUDE.md)
启动新项目时,在根目录中创建一个 CLAUDE.md 文件以指导代理。
模板 (通用)
# 项目指南
## 命令
- 运行应用: `npm run dev`
- 测试: `npm test`
- 构建: `npm run build`
## 代码风格
- 所有新代码使用 TypeScript。
- React 使用带有 Hooks 的函数式组件。
- 使用 Tailwind CSS 进行样式设计。
- 错误处理使用早期返回。
## 工作流程
- 首先阅读 `README.md` 以理解项目上下文。
- 编辑前,阅读文件内容。
- 编辑后,运行测试以验证。
高级功能
思考关键词
在提示中使用这些关键词以触发代理的深度推理:
- “逐步思考”
- “分析根本原因”
- “执行前计划”
- “验证你的假设”
调试
如果代理卡住或行为异常:
- 清除上下文: 启动新会话,或者如果代理困惑,要求它“忘记之前的指令”。
- 明确指令: 对路径、文件名和期望结果要极其具体。
- 日志: 要求代理“检查日志”或“运行命令并显示详细输出”。
最佳实践
- 小上下文: 不要将整个代码库转储到上下文中。首先使用
grep或find定位相关文件。 - 迭代开发: 要求进行小更改,验证后再继续。
- 反馈循环: 如果代理犯错,立即纠正,并请求它将“添加教训”到其内存中(如果支持)或
CLAUDE.md。