AI 编程 4.0 · 优秀 2026-02-28 · X

Claude Code 核心开发者分享:构建 Claude Code 的经验教训——像 Agent 一样看世界

Thariq 原文的中文翻译。构建 agent 框架最难的部分是设计行动空间。工具设计要匹配 Agent 能力(纸笔→计算器→电脑的类比)。AskUserQuestion 工具三次迭代:修改 ExitPlanTool(Claude 困惑)→修改输出格式(不可靠)→独立工具(成功)。最终方案可引导结构化输出、确保多选项、支持 SDK 集成。

打开原文回到归档

Claude Code 核心开发者分享:构建 Claude Code 的经验教训——像 Agent 一样看世界

Claude Code是一款由Anthropic开发的自主式AI编程代理工具,旨在通过自动化编程任务、理解项目结构和提供智能辅助来提升开发效率。关于Claude Code的构建经验教训,Anthropic的核心工程师Thariq Shihipar曾分享了其内部构建数百个Skills的体系方法论,这些Skills覆盖了从代码编写到部署运维的完整工程流水线。

Thariq Shihipar分享的Skills体系并非简单的提示词集合,而是通过文件系统实现上下文工程与渐进式披露的复杂交互。Skills的本质是一个文件夹,包含Markdown入口文件、脚本、配置文件、数据集和模板资源,允许Claude自主探索并按需读取内容。

构建Skills的核心设计理念包括:

上下文工程与渐进式披露

入口Markdown提供目录索引,详细文档拆解至子目录,资源与脚本分层存放。Claude在执行过程中逐层展开、按需加载,以保证信息完整性并优化上下文窗口的使用效率。

9大功能分类与工程化验证

Skills分为代码工程类(涵盖代码编写、代码审查、部署运维、数据分析、团队自动化)和产品验证类(全流程自动化测试、支付流程模拟、终端交互检测、对抗式代码审查)。其中,“产品验证”被认为是反直觉但价值最高的核心分类,Anthropic甚至建议工程师花一周时间专门打磨一个验证类Skill,以让Claude自主验证代码。

关键实践方法

  • 精准描述触发机制:Skills的“描述”字段是决定触发时机的关键,应编写明确的触发条件
  • 利用日志实现记忆:通过创建只追加的日志文件,Skill可以记住历史状态,实现上下文连贯
  • 钩子机制保障安全:设置如的钩子可拦截高危命令,或使用锁定目录禁止编辑,提供即时安全屏障

其他使用技巧和最佳实践

  • 给Claude一种验证其工作的方式:包含测试、截图或预期输出,以便Claude可以自我检查
  • 先探索,然后规划,然后实施:对于复杂任务,应先让Claude进行规划(使用命令),而不是直接开始编码
  • 管理上下文窗口:Claude的上下文窗口很快就会被填满,并且随着填满,性能会下降,因此管理好上下文窗口是最重要的资源
  • CLAUDE.md文件:这是一个纯文本文件,Claude在每次会话开始时读取,用于理解项目背景、编码习惯、代码规范和最佳实践