claude-code-guide

Claude Code Guide

用途

为配置与使用 Claude Code（智能体式编程工具）提供综合参考，帮助发挥其全部潜力。该技能汇总了最佳实践、配置模板与高级使用模式。

配置（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.

高级功能

思考类关键词

明确说明期望的调查与验证标准。以下短语用于描述任务，并非保证会调整模型推理强度的开关：

"Think step-by-step"
"Analyze the root cause"
"Plan before executing"
"Verify your assumptions"

调试

如果智能体卡住或行为异常：

清理上下文：在开启新会话前保存任务状态与相关证据。要求忘记指令的提示不会清除已加载的项目规则。
明确指令：对路径、文件名和期望结果给出极其具体的说明。
日志：让智能体“检查日志”或“以详细输出运行命令”。

最佳实践

精简上下文：不要把整个代码库塞进上下文。先使用 rg 或 rg --files 定位相关文件。
迭代开发：要求小步修改，验证后再继续。
反馈循环：如果智能体出错，立即纠正，并让它“添加一条经验”到其记忆中（若支持）或 CLAUDE.md。

验证

检查生成的 diff，并确认预期指令确实在已安装的宿主中加载。项目指令用于引导行为，不构成安全边界。不要将密钥写入受版本控制的指令中。请对照官方记忆文档核实当前功能。

参考

基于 Claude Code Guide by zebbern。

使用时机

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

限制

仅当任务与上述范围明确匹配时使用本技能。
不要将输出视为环境特定验证、测试或专家评审的替代品。
如果缺少必要输入、权限、安全边界或成功标准，请停下来请求澄清。