Claude Code 团队经验:Prompt Caching 就是一切

![生成特定风格图片 (1)](生成特定风格图片 (1).webp) 工程界有句老话:“缓存统治一切(Cache Rules Everything Around Me)”。在开发 AI 智能体(Agent)时,这句话同样适用。 像 Claude Code 这样需要长时间运行的智能体产品,之所以具有可行性,很大程度上归功于 Prompt 缓存(Prompt Caching)。它允许我们复用之前的计算结果,从而大幅降低延迟和成本。 关于 Prompt 缓存的原理和技术实现,这里不展开。在 Claude Code 团队,我们整个底层架构都是围绕 Prompt 缓存设计的。如果缓存命中率高,成本就能降下来,我们也能为订阅用户提供更宽松的使用限制。为此,我们甚至对缓存命中率设置了告警,一旦低于某个阈值,就会触发紧急故障(SEV)处理。 在优化大规模 Prompt 缓存的过程中,我们学到了很多经验。有些经验甚至有点反直觉,下面就和大家分享。 一、合理安排提示词的结构 Prompt 缓存的工作原理是“前缀匹配”(prefix matching)。API 会从请求的开头开始,一直缓存到你设置的断点。这意味着,内容的排列顺序至关重要。你希望尽可能多的请求,能够共享相同的前缀。 最好的做法是:把静态内容放在前面,动态内容放在后面。 在 Claude Code 里,我们的排列顺序是这样的: 静态系统提示词与工具定义(全局缓存) Claude.md 文件(在项目级别缓存) 会话上下文(在单个会话内缓存) 当前对话的具体消息 通过这种方式,我们能让更多的会话共享缓存命中。 但要注意,这种顺序出乎意料地脆弱!我们曾经踩过坑,破坏了这种顺序。比如:把详细的时间戳放进了静态系统提示词里、工具的排列顺序变成随机的、或者动态修改了工具的参数。这些都会导致前缀改变,缓存失效。 二、用消息来传递状态更新 有时候,你放在提示词里的信息会过期。比如,时间变了,或者用户修改了某个文件。你可能会想,那我去更新一下系统提示词吧。千万别这么做。这会导致缓存未命中,让用户付出高昂的成本。 更好的做法是:在下一轮对话中,通过“消息”来传递这些更新。 在 Claude Code 中,如果信息有更新(比如“现在是星期三了”),我们会在下一条用户消息或工具结果中插入一个 <system-reminder> 标签。这样既告诉了模型新情况,又保住了前面的缓存。 三、不要在对话中途切换模型 Prompt 缓存是和特定模型绑定的。这就导致了一个很反直觉的成本计算。 假设你正在用最强大的 Opus 模型聊天,已经积累了 10 万 token 的上下文。这时,你想问一个非常简单的问题。你可能觉得切换到便宜的 Haiku 模型会更省钱。错了。切换到 Haiku 反而更贵,因为你需要为 Haiku 重新建立那 10 万 token 的缓存。 ...

2026-06-12 · 1 min · 150 words

独立开发者免费资源汇总表

一、开发工具与服务 功能分类 服务名称 链接 价格 特点 一句话介绍 备注 代码托管 GitHub https://github.com $0 代码托管、版本控制 托管代码和管理版本的主流网站,可以协作开发、提 PR、做 Code Review。 docs.github 基础功能免费 代码审查 CodeRabbit https://coderabbit.ai $0 AI 代码审查 给你的代码和 PR 做 AI 审查,指出 bug、坏味道并给建议。 dev 提高代码质量 网络连接 Tailscale https://tailscale.com $0 安全网络连接 让多台设备通过互联网组成一个私有局域网,像在同一个 Wi‑Fi 下一样访问服务。 en.wikipedia 设备间安全通信 监控告警 Grafana https://grafana.com $0 监控和可视化 把数据库、日志、监控数据连起来做漂亮的大盘和图表,方便观察服务健康状况。 devops 数据监控分析 产品分析 PostHog https://posthog.com $0 产品使用分析 统计用户在你网站/应用里的点击、转化、留存,用来优化产品体验。 youtube 用户行为分析 图片/视频处理 Cloudinary https://cloudinary.com $0 媒体处理、云存储、CDN 负责存图、剪裁、压缩、加水印并通过 CDN 分发,省掉自己写媒体处理逻辑。 cloudinary 25GB 存储/月 技术栈 Next.js https://nextjs.org $0 全栈开发框架 基于 React 的 Web 框架,既能写前端页面也能写 API,支持 SSR、静态导出等。 vercel ORM Drizzle ORM https://orm.drizzle.team $0 轻量级 ORM 在 TS 里用类型安全的方式读写数据库,比直接写 SQL 更安全好维护。 refine 认证 Better Auth https://better-auth.com $0 全面鉴权库 帮你处理登录、注册、会话等鉴权逻辑,减少自己手写安全相关代码。 better-auth 邮件模板 React Email https://react.email $0 邮件模板系统 用 React 组件写邮件模板,让邮件 UI 和网站 UI 一样可复用、易维护。 文档 Fumadocs https://fumadocs.com $0 文档生成 帮你基于 MDX/Next.js 快速搭一个美观、可搜索的产品/技术文档站。 国际化 next-intl https://next-intl-docs.vercel.app $0 国际化支持 在 Next.js 里处理多语言文案、路由本地化,让网站轻松支持多种语言。 主题 next-themes https://github.com/pacocoursey/next-themes $0 暗色主题 一行配置就能给网站加上深色/浅色主题切换支持。 分析 Umami https://umami.is $0 开源网站分析 自己部署的轻量统计工具,看访问量、来源等,又不追踪用户隐私。 分析 Plausible https://plausible.io $0 隐私友好分析 类似 Google Analytics 的网站统计,但界面更简单、更加注重隐私。 UI 框架 Tailwind CSS https://tailwindcss.com $0 CSS 框架 提供一堆实用的类名,让你不用写很多自定义 CSS 就能快速搭出页面。 w3schools UI 组件 shadcn/ui https://ui.shadcn.com $0 可定制组件 提供一套可复制源码的 React 组件,例如对话框、表单、菜单等,适合做统一设计系统。 状态管理 Zustand https://zustand-demo.pmnd.rs $0 轻量级状态管理 管理 React 全局状态的超轻库,比 Redux 简单很多,学习成本低。 数据获取 TanStack Query https://tanstack.com/query $0 数据获取和缓存 负责管理前端请求状态、缓存和刷新策略,解决“加载中/错误/刷新”等繁琐逻辑。 表单 React Hook Form https://react-hook-form.com $0 表单处理 把表单输入、校验、提交封装成 Hook,既高性能又易于和 TS/验证库配合。 类型安全 TypeScript https://www.typescriptlang.org $0 类型系统 在 JS 上增加类型检查,帮助提前发现错误,提升开发体验和可维护性。 datacamp 验证 Zod https://zod.dev $0 模式验证 定义数据结构并校验输入是否符合要求,常用于接口入参、表单校验等。 格式化 Biome https://biomejs.dev $0 Lint 和格式化 集成代码格式化和静态检查,一次配置就能统一团队代码风格。 动画 Framer Motion https://www.framer.com/motion $0 动画库 给 React 组件加各种平滑动画效果,比如过渡、拖拽、手势等。 二、服务器 / 托管服务 服务名称 链接 价格 配置/额度 特点 一句话介绍 适合场景 AWS https://aws.amazon.com/free $0/年 新用户免费套餐 送半年+半年 VPS,Mac 实例带 GUI 全球最大的云平台,新人有免费额度,可以先玩 EC2、S3 等常见服务。 datacamp 最适合起步 腾讯云 https://cloud.tencent.com ¥20/月 轻量服务器 预配置 OpenClaw 环境 国内访问速度友好、价格合适,用来部署 Web/后端很常见。 国内用户 Hostinger https://www.hostinger.com $10/月 (~¥70) VPS 预配置 OpenClaw 环境 面向个人站长的便宜 VPS,适合部署博客、小应用等。 海外用户 Vercel https://vercel.com $0 100GB 带宽/月,1M 边缘请求 Next.js 官方支持 专门用来托管前端和全栈框架代码,“连 Git 仓库,一推就上线”。 vercel 非商业项目 Cloudflare Pages https://pages.cloudflare.com $0 无限请求和带宽 静态网站托管 把静态站点托管在 Cloudflare 边缘节点,访问速度快且基本免费。 静态网站 Zeabur https://zeabur.com $5/月起 按量付费 支持多种语言和框架 输入 Git 仓库就能部署后端、前端、数据库,很适合独立开发者。 容器部署 Railway https://railway.app $5/月额度 按资源使用付费 支持 PostgreSQL 和 Docker 通过 Web 界面快速创建服务和数据库,适合 PoC 和中小项目。 灵活 PaaS Fly.io https://fly.io <$5 免费 Shared-1x 256MB 全球部署 把应用打包成镜像后一键部署到全球多个机房,适合需要全球访问的服务。 小额免费 Dokploy https://dokploy.com 自托管 自建 PaaS 平台 一键部署、自动备份 自己有服务器时,用它搭一个类似 Railway 的“私有云平台”。 技术用户 Coolify https://coolify.io 自托管 开源部署平台 自托管方案 开源的自托管 PaaS,可以用浏览器操作把项目部署到自家服务器。 技术用户 Oracle https://cloud.oracle.com $0 可申请两台免费服务器 可申请两台免费服务器 公有云服务,服务器可免费更换固定 IP 小额用户 Appwrite https://appwrite.io/ $0 5G 带宽,2G 存储 75K 活跃用户 免费资源足够 Appwrite 是一个面向开发者的开源后端即服务平台,提供认证、数据库、文件存储、云函数和实时通信等能力,帮助更快搭建 Web 和移动应用后端 小额用户 三、AI 模型 / API 服务 服务名称 链接 价格 特点 一句话介绍 稳定性 备注 Anyrouter https://anyrouter.com $0 提供 Opus 但不稳定 聚合多个大模型的网关,可以统一一个 API 访问不同模型。 低 适合测试 公益站(Linux.do 等) https://linux.do 几元/天 逆向 Opus 社区里有人提供低价大模型 API,一般适合个人体验使用。 中 Linuxdo/闲鱼找 ZenMux https://zenmux.com $12/月起 企业级聚合平台 面向企业的多模型接入平台,主打稳定性和统一账单管理。 高 多模型切换方便 Claude https://console.anthropic.com 按量 官方 API Anthropic 官方提供的 Claude API,适合正式产品接入和严肃场景。 高 适合生产环境 四、数据库服务 服务名称 链接 价格 免费额度 特点 一句话介绍 备注 Supabase https://supabase.com $0 500MB 存储,5GB 带宽 PostgreSQL + 实时功能 “开源 Firebase 替代品”,内置认证、存储、实时订阅等一整套后端能力。 2 个项目限制 Neon https://neon.tech $0 0.5GB 存储,10 个项目 Serverless PostgreSQL 无需自己运维的云 Postgres,按使用量计费,支持分支等现代特性。 分支功能 PlanetScale https://planetscale.com $0 5GB 存储,10 亿读/月 MySQL 兼容 基于 Vitess 的云 MySQL,适合需要高扩展性又不想管运维的 Web 项目。 独立开发者推荐 TiDB Cloud https://tidbcloud.com $0 免费 tier 分布式数据库 云上的分布式 NewSQL 数据库,兼容 MySQL 协议,适合大数据量场景。 企业级特性 DynamoDB https://aws.amazon.com/dynamodb $0 25GB 存储+1GB 传输 AWS NoSQL AWS 的托管 NoSQL 数据库,适合键值和文档型数据。 github AWS 用户 CosmosDB https://azure.microsoft.com/products/cosmos-db $0 25GB 存储 兼容 MongoDB/PostgreSQL Azure 上的多模型数据库,支持多种 API 和全球分布。 Azure 用户 Cloudflare D1 https://developers.cloudflare.com/d1 $0 5GB 存储 SQLite 实现 Cloudflare 上的云 SQLite 数据库,适合和 Workers 搭配构建边缘应用。 Workers 集成 Upstash Redis https://upstash.com $0 1 万请求/天,256MB Serverless Redis 提供按调用计费的 Redis 服务,和 Edge/Serverless 环境很好配合。 边缘部署 五、存储与 CDN 服务名称 链接 价格 免费额度 特点 一句话介绍 备注 Cloudflare R2 https://www.cloudflare.com/products/r2 $0 10GB 存储,1000 万次 A 类操作 无带宽费用,S3 兼容 像 S3 一样存对象,但省掉大部分外网流量费用,适合做下载/媒体存储。 强烈推荐 Cloudinary https://cloudinary.com $0 25GB 存储,25000 次转换 图片/视频处理 专门用来存、处理和分发图片/视频的云服务。 媒体处理强大 BunnyCDN https://bunny.net $0 免费 tier CDN 加速 价格便宜、地区覆盖广的静态资源加速服务。 性价比高 jsDelivr https://www.jsdelivr.com $0 完全免费 JS 库 CDN 专门加速开源 JS/CSS 资源的公共 CDN。 公共库加速 网易云 NOS https://www.163yun.com/product/nos ¥0 50GB 存储,20GB 下行/月 国内访问快 网易云的对象存储,适合面向国内用户的静态资源托管。 国内用户 又拍云 https://www.upyun.com ¥0 10GB 存储,15GB 下行/月 国内 CDN 国内老牌 CDN/存储服务商,适合小站点冷启动。 需要申请联盟 GoEnhance.ai https://goenhance.ai $0 注册送 10G 对象存储+CDN 新兴的对象存储+CDN 组合方案,适合存放文件、图片和下载资源。 流量费用免费 六、监控与分析 服务名称 链接 价格 免费额度 特点 一句话介绍 备注 Google Analytics https://analytics.google.com $0 完全免费 网站统计分析 谷歌的站点统计工具,看 PV、来源、转化等数据。 nerdwallet 标准分析工具 Umami https://umami.is $0/自托管 开源 隐私友好分析 自托管的简洁统计面板,常被用来替代 GA 以避免隐私问题。 可自托管 Plausible https://plausible.io $0/自托管 开源 隐私友好分析 提供托管版和自托管版,界面非常干净,专注关键指标。 可自托管 Grafana https://grafana.com $0 - 监控可视化 将日志、时间序列等监控数据做成各种大屏、图形和告警。 devops 技术监控 PostHog https://posthog.com $0 - 产品分析 用事件、用户画像、漏斗等方式分析产品使用行为。 产品优化 UptimeRobot https://uptimerobot.com $0 50 个监控项,5 分钟检查 网站监控 定时请求你的站点,宕机时通过邮件/通知提醒你。 服务可用性监控 Uptime Kuma https://github.com/louislam/uptime-kuma 自托管 - 开源监控工具 类似 UptimeRobot 的自托管版,可以自己在服务器上搭。 自托管方案 七、邮件服务 服务名称 链接 价格 免费额度 特点 一句话介绍 备注 Resend https://resend.com $0 3000 封/月,100 封/天 开发者友好,现代 API 现代感很强的邮件发送服务,和 JS/Node 生态结合紧密。 推荐 Mailgun https://www.mailgun.com $0 免费 tier 邮件发送服务 老牌邮件 API 提供商,文档和生态都比较成熟。 独立开发者 React Email https://react.email $0 开源 邮件模板 用 React 编写和预览邮件模板,再配合任意 SMTP/API 发送。 配合 Resend Unsend https://github.com/unsend-io/unsend 自托管 - 开源 可以自己部署的邮件发送后端,用来替代托管型服务。 自托管方案 AWS SES https://aws.amazon.com/ses 按量 - 付费 AWS 提供的大规模批量邮件发送服务,单价非常低。 大规模邮件 网易企业邮 https://qiye.163.com ¥0 3G 容量 国内访问快 帮团队申请企业域名邮箱,适合国内团队。 国内用户 Zoho Mail https://www.zoho.com/mail ¥0 免费 tier 企业邮箱 提供无广告的免费企业邮箱账户。 无广告 八、支付服务 服务名称 链接 价格 特点 一句话介绍 适用场景 备注 Stripe https://stripe.com 按交易收费 成熟稳定,生态完善 全球主流线上收款平台,支持信用卡、钱包等多种支付方式。 stripe 正式产品 Paddle https://www.paddle.com 按交易收费 税务处理完善 专门替软件开发者代收款、代处理增值税和发票。 国际销售 Creem.io https://creem.io 按交易收费 无需开公司 帮个人开发者代收海外款、结算到国内账户。 国内开发者 Lemon Squeezy https://www.lemonsqueezy.com - 被 Stripe 收购 以前很火的数字产品收费平台,目前不再开放新用户。 - 九、设计资源 资源类型 服务名称 链接 价格 特点 一句话介绍 备注 图标 Font Awesome https://fontawesome.com $0 丰富图标库 常用图标集,比如菜单、社交图标等,前端项目里经常会用到。 基础需求满足 图标 Iconfinder https://www.iconfinder.com $0 可筛选免费图标 可以按风格、用途筛选图标,支持只看免费授权。 补充资源 图标 Tabler Icons https://tabler.io/icons $0 1900+ 统一风格图标 提供一整套线性风格图标,适合后台、管理系统 UI。 简洁美观 图标 Iconbolt https://iconbolt.com $0 6 万+ SVG 图标 聚合多套图标库,方便一站式搜索 SVG 图标。 免费使用 插画 Undraw https://undraw.co $0 免费插画 提供风格统一的扁平插画,可以按主题选择并自定义主色。 Landing page 必备 插画 Storyset https://storyset.com $0 可调整参数 提供多种风格插画,支持在线改颜色、姿势、场景等。 丰富多样 落地页 Ant Design Landing https://landing.ant.design $0 基于 Ant Design 用 Ant Design 的组件搭建营销/展示型页面模板。 组件丰富 落地页 Tailblocks https://tailblocks.cc $0 Tailwind CSS 组件 各类常见版块(Hero、Features 等)的 Tailwind 片段,可直接复制使用。 常用模块齐全 图片编辑 Photopea https://www.photopea.com $0 在线 PS 浏览器里的“简化版 Photoshop”,支持 PSD/PSB 等格式。 无需下载 图片放大 Upscayl https://github.com/upscayl/upscayl $0 开源图片放大 用 AI 将小图放大并增强细节,适合处理模糊图片。 AI 增强 图片清理 Lama Cleaner https://github.com/Sanster/lama-cleaner $0 AI 擦除物体 在图片中一键抹掉多余物体、人物,并自动补全背景。 开源工具 十、其他工具 功能分类 服务名称 链接 价格 特点 一句话介绍 备注 学生资源 学生资源福利汇总 https://edu.52it.de/ 折扣 学生资源 学生资源福利汇总 - 为学生提供最全面的优惠资源 教育邮箱 maricopa https://www.maricopa.edu/ $0 美国社区大学 美国社区大学,可免费注册教育邮箱 软件订阅 GamsGo https://www.gamsgo.com/details/chatgpt 折扣 折扣价格订阅软件 折扣价格订阅软件 域名 Freenom https://www.freenom.com $0 免费域名 (.tk/.ml 等) 提供部分后缀的免费域名,适合测试或冷启动项目。 冷启动使用 域名 Cloudflare Domains https://www.cloudflare.com/products/registrar $10/年 .com 域名 Cloudflare 自带的域名注册服务,价格接近成本价。 价格稳定 域名 Spaceship https://spaceship.com 可变 首年便宜 提供较便宜首年域名注册,注意第二年起续费价格。 注意续费价格 域名 Regery https://regery.com 可变 首年便宜 另一家便宜域名注册商,用来“薅首年价格”。 注意续费价格 域名搜索 tldx https://tldx.cc $0 开源域名搜索 搜索不同后缀下可用的域名,帮助你取名字。 寻找合适域名 HTTPS 证书 acme.sh https://acme.sh $0 免费证书 利用 Let’s Encrypt 自动申请和续期 HTTPS 证书的脚本。 Let’s Encrypt HTTPS 证书 certbot https://certbot.eff.org $0 免费证书 EFF 提供的官方 Let’s Encrypt 申请工具,支持多种服务器环境。 EFF 提供 音乐素材 Uppbeat https://uppbeat.io $0 免费背景音乐 提供适合视频、播客的免版税背景音乐,需按要求署名。 需注明版权 音乐素材 Pixabay Music https://pixabay.com/music $0 免费音乐 可商用的音乐素材下载站,适合做视频配乐。 可商用 音乐素材 Openverse https://openverse.org $0 免费音乐 搜索各类 CC 授权音频/媒体资源的聚合平台。 WordPress 音乐素材 NCS https://ncs.io $0 无版权音乐 在 YouTube 等平台很常见的免费电音/背景音乐。 适合视频 音乐素材 Dova-s https://dova-s.jp $0 免费音乐 日本站点,提供大量免费 BGM,适合游戏/视频。 日本站点 音乐素材 Incompetech https://incompetech.com/music $0 免费音乐 个人音乐人网站,提供可署名使用的背景音乐。 个人创作 工作流 n8n https://n8n.io 自托管 开源工作流自动化 像“自建 Zapier”,通过拖拽节点串联各种 API 和任务。 Zapier 替代 OAuth 管理 Nango https://www.nango.dev 自托管 开源 OAuth 管理 统一管理集成第三方服务时的 OAuth 授权流程和 token。 自托管方案 通知服务 ntfy https://ntfy.sh $0 开源 pub-sub 通知 通过 HTTP/订阅方式向手机、浏览器等发送自定义通知。 推送消息 通知服务 Gotify https://gotify.net $0 开源通知服务 自托管的推送服务器,配合客户端 App 接收通知。 类似 ntfy 博客平台 Sonic https://github.com/go-sonic/sonic $0 Go 语言博客系统 类似 WordPress 的博客系统,但用 Go 编写,性能不错。 轻量级 数据库练习 Crunchy Data https://www.crunchydata.com/developers/tutorials $0 在线 PostgreSQL 练习 提供在线环境和练习题,帮助你学习 SQL 和 Postgres。 学习 SQL Linux 练习 Sadservers https://sadservers.com $0 Linux 服务器管理题库 在“故障服务器”上做题,一边修一边练 Linux 运维技能。 浏览器实例 Python 教程 Full Stack Python https://www.fullstackpython.com $0 免费英文教程 从 Web、数据、部署等角度系统讲 Python 生态。 实战应用 Flask 教程 Flask Mega-Tutorial https://blog.miguelgrinberg.com/post/the-flask-mega-tutorial-part-i-hello-world $0 免费电子书 非常经典的 Flask 系列教程,从零搭建一个完整网站。 Flask 学习 如果你打算把这份表分享给刚入门的独立开发者,你最希望他们先重点看哪几块(比如:“先看开发工具 + 托管 + 支付”)? ...

2026-06-12 · 7 min · 1334 words

Claude Code 团队经验:学会用 Agent 的眼光看世界

![截屏2026-03-26 23.32.27](截屏2026-03-26 23.32.27.webp) 开发一个智能体(Agent)系统,最难的部分之一,就是怎么给它设计"工具箱"(Action Space)。 Claude 是通过调用工具(Tool Calling)来做事的。但在 Claude API 里,有各种各样的工具构建方式,比如执行 bash 命令、调用 Skills,或者最近新出的代码执行功能。 面对这么多选择,你怎么给 Agent 设计工具?是只给它一个全能工具(比如直接执行代码或 bash),还是给它 50 个工具,覆盖它可能遇到的每一种场景? 为了弄明白这个问题,我喜欢把自己代入模型。想象一下,如果给你一道很难的数学题,你希望手头有什么工具?这其实取决于你自己的能力! 给你一张纸是最低配置,但你只能手算。给你一个计算器会好很多,前提是你得知道怎么按那些高级功能键。最快、最强大的工具是一台电脑,但这要求你必须懂编程,能写代码来解题。 这是一个设计 Agent 时非常有用的思维框架。你给它的工具,必须跟它的能力相匹配。 可是,你怎么知道它有多大能耐呢?答案是:去观察它,去读它的输出,去不断实验。你要学会"用 Agent 的眼光看世界"。 在开发 Claude Code 的过程中,我们一直在观察 Claude。下面是我们学到的一些经验。 改进提问方式与 AskUserQuestion 工具 我们在开发 AskUserQuestion 这个工具时,目标是让 Claude 更擅长向用户提问(这通常被称为激发,elicitation)。 虽然 Claude 本来就能用纯文本问问题,但我们发现,回答这些问题通常很费时间。我们该怎么降低这种摩擦,让用户和 Claude 的沟通更高效呢? 尝试 1:修改 ExitPlanTool 我们最初的想法是,在现有的 ExitPlanTool(退出并输出计划的工具)里加一个参数,让它在输出计划的同时,也输出一组问题。这是最容易实现的方法,但它把 Claude 搞糊涂了。因为我们让它同时做两件事:一边给计划,一边问跟计划相关的问题。如果用户的回答和计划冲突了怎么办?Claude 是不是得再调用一次 ExitPlanTool?显然,这条路走不通。 尝试 2:改变输出格式 接着,我们尝试修改 Claude 的系统提示词,让它输出一种特定格式的 Markdown,用来表示问题。比如,我们可以要求它输出一个列表,括号里写上可选项。然后我们通过解析这个格式,在终端里渲染出一个漂亮的提问界面。 这看起来是个通用的改动,Claude 似乎也能做到,但这并不可靠。Claude 有时会多加几句话,有时会漏掉选项,或者干脆用了别的格式。 尝试 3:推出 AskUserQuestion 工具 ...

2026-03-26 · 1 min · 211 words

Claude Code 团队经验:如何用好 Skills

![截屏2026-03-23 23.45.24](截屏2026-03-23 23.45.24.webp) 前几天,Anthropic 团队分享了一篇文章,总结了他们内部使用 Claude Code 的经验,特别是关于 “Skills”(技能)的使用心得。我觉得这篇文章非常有启发性,不仅介绍了 Skills 的各种类型,还给出了很多编写好 Skill 的建议。 下面是这篇文章的中文翻译(略有删改)。 在 Claude Code 中,Skills 已经成为最常用的扩展方式。它们非常灵活、容易制作,分发起来也很简单。 但是,这种灵活性也带来了一个问题:不知道怎么用才是最好的。什么样的 Skill 值得开发?写好一个 Skill 的秘诀是什么?什么时候该把它们分享给其他人? 在 Anthropic 内部,我们在大规模使用 Claude Code 的 Skills,目前有数百个在活跃使用中。下面就是我们在开发中总结出的一些经验。 什么是 Skills? 如果你对 Skills 还不熟悉,建议先阅读官方文档,或者观看我们的最新教程。本文假设你已经对它有所了解。 关于 Skills,最常见的一个误解是:它们"只是 Markdown 文件"。但其实最有趣的地方在于,它们不仅是纯文本,还是一个完整的文件夹,可以包含脚本、静态资源、数据等等。AI 代理(agent)可以发现、探索并操作这些内容。 在 Claude Code 中,Skills 还有非常丰富的配置选项,甚至可以注册动态的 hook(钩子)。 我们发现,最有趣的一些 Skills,正是创造性地结合了这些配置选项和文件夹结构。 Skills 的常见类型 我们把内部的所有 Skills 梳理了一遍,发现它们基本上可以归为以下几类。最好的 Skills 通常只专注于其中一类,而那些让人困惑的 Skills 往往跨越了多个类别。 这并不是一个绝对的列表,但如果你想看看团队内部还缺什么工具,它是一个很好的参考。 1. 库与 API 参考指南(Library & API Reference) 这类 Skill 主要向 Claude 解释如何正确使用某个代码库、CLI 或 SDK。它们既可以针对内部私有库,也可以针对 Claude 容易出错的一些公共库。这类 Skill 通常包含一个参考代码片段的文件夹,以及一份列出各种"坑"的清单,让 Claude 在写代码时避开。 ...

2026-03-23 · 3 min · 486 words