claude-code-guide

Claude Code 指南

目的

提供一份全面的参考指南，帮助用户配置并充分发挥 Claude Code（Agentic 编码工具）的作用。本技能汇总了最佳实践、配置模板和高级用法模式。

配置（CLAUDE.md）

首先阅读现有的项目说明。仅在请求的范围内添加或更新项目 CLAUDE.md，并保留仓库约定和现有说明。以下模板适用于 React/TypeScript npm 项目；请根据已核实的项目事实替换其中的命令和技术栈规则。

通用模板

# Project Guidelines

## Commands

- Run app: `npm run dev`
- Test: `npm test`
- Build: `npm run build`

## Code Style

- Use TypeScript for all new code.
- Functional components with Hooks for React.
- Tailwind CSS for styling.
- Early returns for error handling.

## Workflow

- Read `README.md` first to understand project context.
- Before editing, read the file content.
- After editing, run tests to verify.

高级功能

思考关键词

明确说明所需的调查内容和验证标准。这些短语用于描述任务；不能保证它们会切换大模型的推理强度：

• “逐步思考”
• “分析根本原因”
• “执行前先制定计划”
• “验证你的假设”

调试

如果 Agent 陷入停滞或行为异常：

1. 清除上下文：开始新会话前，保存任务状态和相关证据。要求忘记指令的提示词不会清除已加载的项目规则。
2. 明确说明：具体说明路径、文件名和预期结果。
3. 日志：要求 Agent“检查日志”或“使用详细输出运行命令”。

最佳实践

1. 控制上下文范围：不要将整个代码库都塞进上下文。先使用 rg 或 rg --files 定位相关文件。
2. 迭代开发：要求进行小幅修改，验证后再继续。
3. 反馈循环：如果 Agent 出错，请立即纠正，并要求它“添加一条经验”到其记忆（如果支持）或 CLAUDE.md 中。

验证

检查最终差异，并确认已安装的宿主环境实际加载了预期指令。项目指令用于指导行为，但不构成安全边界。不要将机密信息写入受版本控制的指令文件中。请根据官方记忆文档核对当前功能。

参考

基于 zebbern 编写的 Claude Code 指南。

适用场景

在配置项目指令、诊断相互冲突的 Claude Code 指引，或定义经过验证的构建和测试工作流时使用。

局限性

• 仅当任务明确符合上述范围时，才使用此技能。
• 请勿将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。