SuperAPI AI 工具集

claude-code-best-practices

智能体与模型

查看项目

更新于 10-15 20:05

技能介绍

用途:本技能是一份 Claude Code(代理式编码环境)最佳实践指南,用于优化其工作流与效果。Claude Code 可读取文件、运行命令、修改代码并自主推进任务,因此使用方式与聊天式问答不同。

适用场景:优化 Claude Code 工作流;编写或改进 CLAUDE.md;长会话中管理上下文;撰写更有效的提示词;运行并行 Claude Code 会话;排查效果不佳的原因;设置验证策略;学习“探索—计划—编码”流程;通过无头模式或扇出模式扩大使用规模。资料同时明确列出不适用场景:安装或配置排错、创建插件、编写技能或 SKILL.md、设置 hooks、配置 MCP 服务器、创建子代理或代理团队,这些应使用其他技能。

主要能力与核心原则:核心约束是上下文窗口会快速填满,性能随填充而下降。指南据此给出原则:一,给 Claude 验证自身工作的方式(测试、截图、linter、Bash 校验),并给出“实现 validateEmail 并运行测试”这类前后对比示例;二,先探索、再计划、再编码,四阶段为探索(Plan Mode)、计划(可用 Ctrl+G 在编辑器中直接编辑计划)、实现(切回 Normal Mode)、提交(描述性提交信息并创建 PR);三,提供具体上下文,明确文件、约束与既有模式;四,积极管理上下文。

必要用法与命令:任务间用 /clear 重置上下文;用 /compact <instructions> 定向压缩;用 Esc 中断、Esc + Esc 或 /rewind 打开回退菜单;用 /init 生成 CLAUDE.md 初稿;用 claude --continue 续接会话、--resume 从近期会话中选择、/rename 命名会话;用“use subagents to investigate X”委派调研。并行会话可用 git worktree add ../my-project-feature-a feature-a 等命令;大规模迁移可用无头模式循环:for file in $(cat files.txt); do claude -p "Migrate $file from React to Vue. Return OK or FAIL." --allowedTools "Edit,Bash(git commit *)"; done。

CLAUDE.md 建议:应写入 Claude 无法猜到的 Bash 命令、非默认代码风格、测试说明与测试运行器、仓库礼仪、架构决策、环境怪癖和常见陷阱;不应写入读代码即可得知的内容、标准语言约定、详细 API 文档、频繁变化的信息、长教程和逐文件描述。

常见失败模式:大杂烩会话、反复纠正、过度冗长的 CLAUDE.md、信任但不验证、无限探索,资料均给出对应修复方式(如两次纠正后 /clear 并重写初始提示)。

限制:本技能不处理安装配置报错、插件、技能编写、hooks、MCP、子代理等事项;其他具体价格、平台与效果资料暂未提供。