被Claude写的冗余代码坑麻了？Karpathy总结4个原则，让AI编码精准不翻车

andrej-karpathy-skills 是一个帮助用户学习和掌握AI领域核心技能的开源资源库。简单讲，它整理了Andrej Karpathy等AI专家推荐的学习路径与工具技巧，助力快速入门深度学习与编程。适用人群：想进入AI领域的学生、开发者及自学者。

项目地址：https://github.com/forrestchang/andrej-karpathy-skills

主要语言：

stars: 8.8k

核心功能

此项目旨在通过一个 CLAUDE.md 文件改进 Claude Code 的行为，其灵感源自 Andrej Karpathy 对大语言模型（LLM）编码陷阱的观察。该项目针对 LLM 在编码时存在的问题，提出了四个指导原则。

问题分析

• 模型会在未检查的情况下做出错误假设，不处理困惑、不寻求澄清、不指出不一致之处、不呈现权衡方案，该反驳时却不反驳。
• 模型倾向于过度复杂化代码和 API，使抽象概念臃肿，不清理死代码，本可用 100 行代码解决的问题，却实现了超过 1000 行的臃肿结构。
• 模型有时会在处理任务时，作为副作用更改或删除它们不够理解的注释和代码，即使这些与任务无关。

解决方案

• Think Before Coding：解决错误假设、隐藏的困惑和缺失的权衡问题。要求明确陈述假设，存在歧义时给出多种解释，有更简单的方法时提出反驳，困惑时停止并请求澄清。
• Simplicity First：应对过度工程化的倾向。只编写解决问题所需的最少代码，不添加额外功能、不必要的抽象、未请求的“灵活性”或“可配置性”，不处理不可能出现的错误场景，若代码可简化则进行重写。
• Surgical Changes：避免对无关代码进行修改。编辑现有代码时，不“改进”相邻代码、注释或格式，不重构未损坏的部分，匹配现有风格，发现无关死代码时仅提及不删除；自己的更改造成孤儿代码时，移除因自己更改而变得无用的导入、变量或函数，除非被要求，否则不删除预先存在的死代码。
• Goal-Driven Execution：将命令式任务转化为可验证的目标。通过测试优先和可验证的成功标准来实现，对于多步骤任务，制定简要计划并明确验证步骤。

安装方式

• Claude Code 插件（推荐）：在 Claude Code 中，先添加市场，再安装插件，可使该技能在所有项目中可用。
• CLAUDE.md（按项目）：新项目可使用 curl 命令下载文件；现有项目可在文件末尾追加该文件内容。

优势

• 减少差异中的不必要更改，只出现请求的更改。
• 减少因过度复杂化导致的重写，代码一次编写就保持简单。
• 在实现前提出澄清问题，避免错误后才发现问题。
• 生成干净、最小化的拉取请求，无附带的重构或“改进”。

应用场景

适用于使用 Claude Code 进行编码的项目，尤其是非平凡的工作，旨在减少代价高昂的错误。对于简单任务，可根据实际情况灵活应用这些原则。

定制

这些指南可与特定项目的说明合并，可在现有的 CLAUDE.md 文件中添加项目特定规则，如使用 TypeScript 严格模式、所有 API 端点必须有测试等。

权衡说明

这些指南倾向于谨慎而非速度。对于简单任务（如简单的拼写错误修复、明显的单行代码），可灵活判断，并非每个更改都需要严格遵循所有原则，目标是减少非平凡工作中的错误，而非减慢简单任务的速度。

爆火的Claude SEO神器来了！从调研到发文全流程自动化，AI代理+实时数据赋能，轻松写出霸屏搜索的长文

[seomachine] 是一个 自动化SEO优化分析 的 工具。简单讲，它能帮你快速找出网站在搜索引擎优化中的问题并提供改进建议。适用人群：SEO从业者、网站运营人员、Python开发者

项目地址：https://github.com/TheCraigHewitt/seomachine

主要语言：Python

stars: 4.4k

仓库核心功能

SEO Machine 是一个基于 Claude Code 的工作区，用于为各类企业创建长格式、具备 SEO 优化的博客内容。它具备以下核心功能：

• 自定义命令：拥有一系列自定义命令，如 /research 进行关键词和竞品研究、/write 创作文章、/rewrite 更新现有内容、/analyze-existing 分析现有文章、/optimize 进行最终优化等，还包含专门的研究和着陆页命令。
• 专业代理：配备多个专业代理，如内容分析器、SEO 优化器、元元素创建器、内部链接器、关键词映射器、编辑器、性能分析器、标题生成器、CRO 分析师和着陆页优化器等，可自动分析内容并提供专业建议。
• 营销技能：提供 26 种营销技能，涵盖文案撰写、转化率优化（CRO）、A/B 测试、电子邮件序列、定价策略等多个营销领域。
• 高级 SEO 分析：能进行搜索意图检测、关键词密度与聚类分析、内容长度比较、可读性评分以及 SEO 质量评级（0 - 100）等。
• 数据集成：集成了 Google Analytics 4、Google Search Console 和 DataForSEO 等实时数据源，为内容策略提供数据支持。
• 上下文驱动：通过品牌声音、风格指南、SEO 准则和示例来指导所有内容的创作。
• 工作流组织：拥有结构化目录，用于存放主题、研究资料、草稿和已发布内容。

优势

• 高效工作流：从内容研究、撰写到优化和发布，提供了一套完整的工作流程，简化了内容创作过程，提高了工作效率。
• 数据驱动决策：集成多种数据分析工具，能根据实时数据进行内容创作和优化，使内容更符合搜索引擎算法和用户需求，提高内容排名。
• 内容质量保证：通过上下文文件的配置，确保内容符合品牌声音、风格和 SEO 要求，同时满足内容、SEO、可读性和结构等方面的质量标准。
• 个性化定制：可以根据企业的特定需求和情况，定制上下文文件和配置，实现个性化的内容创作。
• 专业代理支持：多个专业代理能自动分析内容并提供详细的优化建议，帮助用户不断提升内容质量。

可能的应用场景

• 企业博客内容创作：企业可以使用 SEO Machine 创建高质量的博客文章，提高网站在搜索引擎中的排名，吸引更多潜在客户。
• 营销内容优化：对现有的营销内容进行分析和优化，提升内容的转化率和营销效果。
• 着陆页设计与优化：创建和优化着陆页，提高页面的转化率，促进业务增长。
• SEO 策略制定：通过关键词研究和竞争分析，制定有效的 SEO 策略，提升网站的整体性能。

安装与配置

• 前提条件：需要安装 Claude Code 并拥有 Anthropic API 账户。
• 安装步骤：
  • 克隆仓库：git clone https://github.com/[your-username]/seomachine.git && cd seomachine
  • 安装 Python 依赖：pip install -r data_sources/requirements.txt
  • 在 Claude Code 中打开：claude-code .
  • 自定义上下文文件：填充 context 目录下的模板文件，如 brand-voice.md、writing-examples.md 等，以符合企业的信息和需求。

代码架构特点

• 模块化设计：代码被组织成多个模块，包括自定义命令模块、专业代理模块、数据分析模块等，便于管理和维护。
• 目录结构清晰：采用结构化目录存储不同类型的文件，如 topics 存放主题创意、research 存放研究资料、drafts 存放草稿文章等，方便查找和使用。
• 扩展性强：可以根据需要添加新的命令、代理或分析模块，以满足不同的业务需求。

更新与维护

• 定期维护：提供了周、月、季度的维护建议，如每周添加新话题、更新关键词；每月审查已发布内容性能、更新相关示例；每季度进行上下文文件的全面审计和更新等，确保系统的持续有效运行。
• 问题解决：针对常见问题，如内容风格不符、关键词密度异常、内部链接不相关、文章与竞品相似等，提供了相应的解决方案。

原文：https://mp.weixin.qq.com/s/-MrdOxc_jrkE-b75TyBbLQ

欢迎关注公zh：AI Tech研习社

关注公zh，后台回复【OpenClaw完全使用手册】，领取OpenClaw完全使用手册.pdf学习资料，更多学习资源敬请期待。