|
来自Claude 官方的这个《Claude Code: Best practices for Agentic coding》文章开篇就是王炸。 
Claude秉承了一贯的特色,从来不玩那些虚的! 明明白白告知Claude Code这个AI命令行工具使用了最基本最low-level最无主见的最原始模型能力。 然后就是直入主题:AI编程最有效的提示和技巧。 
虽然是讲Claude Code,但是对于所有AI编程的思考和思想都是一致的,摘录其中部分我认为比较有用比较普适的内容。 CLAUDE.md 是 Claude 在开始对话时自动提取到上下文中的特殊文件,这个类似于Cursor Rule。 类似于昨天讲的Cursor Rules 原理和最佳实践 CLAUDE.md 文件没有必需的格式。官方建议保持它们简洁易读。例如: #Bashcommands
-npmrunbuild:Buildtheproject
-npmruntypecheck:Runthetypechecker
#Codestyle
-UseESmodules(import/export)syntax,notCommonJS(require)
-Destructureimportswhenpossible(eg.import{foo}from'bar')
#Workflow
-Besuretotypecheckwhenyou’redonemakingaseriesofcodechanges
-Preferrunningsingletests,andnotthewholetestsuite,forperformance上面就是一个 Claude.md 文件的模板, 用来帮助 Claude 更好地理解项目环境、代码风格和工作习惯, 从而在对话中提供更准确、更有上下文感知的建议。 当然它并不是固定的,可以根据项目实际情况进行修改和拓展。 具体应该填哪些内容呢?Claude官方给出了如下的方向。 
官方最推荐的做法是:把 CLAUDE.md 放在代码仓库根目录, 并提交到 Git。这样Claude 每次运行时都能自动加载你设定的上下文, 同时团队成员也能共享这份配置。 接下来是一个Claude Code 与 GitHub 的深度整合,主要通过 gh CLI 实现。 可以对 Claude 说:“请为这个更改创建一个 PR,并写一个合适的提交信息。” Claude 会读取 diff,生成 commit message,推送代码,并通过 gh 创建 PR。 GH CLI详细的安装操作请点击这里:gh安装和使用 下面是重头戏,Claude的AI编程工作流。 1. 通览项目 让 Claude 读取相关文件、图像或 URL,提供通用指针(“读取处理日志记录的文件”)或特定文件名(“读取 logging.py”),但明确告诉它暂时不要编写任何代码。 换句话说:你可以让Claude 先了解问题背景, 比如让它读取代码、图片或网页; 可以用模糊描述, 也可以直接给文件名。 但重点是:你要明确告诉 Claude“现在不要写代码”, 先让它只做阅读和理解。 这是 Claude Code 推荐的第一步, 用来建立上下文、避免它过早进入编码阶段。 尤其在处理复杂问题时, 这种做法能提高 Claude 的准确性和效率。 2. 深度思考 
这个文章官方主要针对Claude Code来讲的,而且很绕。 其实说白了,就是让你在正式入编写前代码前,来制定和评估各种方案,分析利弊, 最后给出一份详细的执行计划。并且在这一步就开始建立git版本控制检查点。 3. 方案制定 让Claude 在代码中实现其解决方案。这也是要求它在实现解决方案的各个部分时 显式验证其解决方案的合理性的好地方。 4. 测试驱动开发 通过单元、集成或端到端测试,测试驱动开发 (TDD) 通过代理编码变得更加强大。 很不巧,本人正好也写过这种文章: 营销号都在教你写贪吃蛇2048,我却要和你聊一聊真正的编程实践,在Cursor中践行TDD
这是 Anthropic 官方非常推荐的一种工作方式, 适用于可以通过测试轻松验证 的更改 (如单元测试、集成测试、端到端测试) 。它的流程如下: 1.让 Claude 根据预期输入/输出编写测试 ,明确告诉 Claude:你正在进行测试驱动开发 (TDD), 这样 Claude 就不会提前写出“假实现”或“模拟代码”, 即使功能还不存在也不会乱写。 2.运行测试并确认失败,告诉 Claude 运行测试, 并确认它们失败,明确指示它:此阶段不要写任何实现代码,样可以确保测试是有效的, 且尚未被实现代码“误通过”。 3.编写实现代码, 直到测试通过 告诉 Claude:现在写实现代码, 但不要修改测试。 4.Claude 会开始迭代开发:写代码 >运行测试-修复错误>再次测试。 一般需要几轮迭代, 直到所有测试通过。 如果你对测试逻辑满意, 可以让 Claude把测试代码提交到版本库。 Claude 在有明确目标 (如测试用例) 时表现最佳。通过测试驱动开发, 你能让 Claude更稳定地输出正确代码。这个流程尤其适合那些“改动小但要确保正确性”的任务, 比如修 bug、加小功能、重构等。 优化工作流程 最后,官方给出了使用 Claude Code 时,通过明确指令、合理利用图像、文件和 URL、及时纠正方向以及使用清单和暂存区等方式。 具体来说,越具体的指令越能帮助 Claude 精准理解任务;提供截图、文件路径或链接能增强上下文理解 通过这些方法,用户不仅能更高效地完成任务,还能更好地引导 Claude 成为真正的协作伙伴。 |