用最新 API 构建更靠谱的 AI 项目

在技术层面上每个 Skill 本质上是一个文件夹内部包含指令instructions脚本scripts资源文件resourcesClaude Code 会在运行时动态加载这些 Skills它能解决什么问题Agent Skills 的核心价值在于“降低幻觉 提高一致性”典型应用场景包括按公司/团队的编码规范生成代码按最新官方文档调用 API而不是靠模型记忆执行固定的工程化流程初始化项目、生成目录结构、部署脚本等自动化个人或组织级任务简单来说Skills 不是让模型更聪明而是让模型更“守规矩”。二、在 Claude Code 中安装 Agent Skills在 Claude Code 命令行中执行/plugin marketplace add anthropics/skills安装完成后你就已经具备了使用官方 Skills 的能力。这一步相当于为 Claude Code 打开了“官方增强模式”。三、创建自定义 Skill1️⃣ 文件夹结构在~/.claude/skills/my-custom-skillmy-custom-skill/ ├── SKILL.md # Skill 描述 ├── helpers.py # 可选脚本 └── resources/ # 可选资源文件比如模板、样例数据2️⃣ SKILL.md 内容规范--- name: my-custom-skill # Skill 名称 version: 1.0 # 版本号 description: | 这是一个自定义 Skill 示例。 它可以让 Claude 使用Context7 访问最新API生成。 tags: - report - markdown --- # 详细说明 - 输入格式要求纯文本或JSON - 输出格式要求Markdown - 步骤 1. 分析输入内容 2. 输出最终文档 3. 生成符合最新 API 代码 # 示例 输入 - 使用 langgraph 最新文档 输出 -3️⃣ 验证是否生效在 Claude 中输入有哪些可用的Skill4️⃣ 使用自定义 Skill使用 Skill: my-custom-skill 帮我生成一个 Markdown 报告内容如下 - xxx - xxx xxx四、安装 context7 插件接下来是本文的重点context7。1️⃣ 打开插件管理在 Claude Code 中输入/plugins然后使用键盘 ➡️ 进入Discover。2️⃣ 搜索并安装 context7在搜索框中输入context7完成安装。context7 本质上是一个 MCPModel Context Protocol插件能让 Claude直接参考并对齐最新的官方文档内容。五、结合 context7 生成项目代码安装完成后就可以在 Prompt 中显式声明使用context7。示例 Prompt使用 Skill: my-custom-skill # 指南 已使用以下技术栈生成企业级项目 - FastAPI 0.128.0带 Token 认证 - 使用 sqlite 生成 token - 不使用 JWT仅做 Token 校验 - langchain 1.2.6使用 create_agent - langchain-ollama 1.0.1 - modelqwen3-vl:32b - embeddingqwen3-embedding:8b - langgraph 1.0.6 - Milvuspymilvus2.6.6 - langfuse 3.12.0 # 约束 - 使用 Context7基于最新的官方文档通过这种方式你是在明确告诉 Claude不要靠“印象”写代码而是以当前官方文档为准。六、实际体验与问题分析真实结论只有一句话效果明显提升但依然不能“一次生成直接可用”。优点API 使用明显更接近最新文档过时参数、废弃方法显著减少工程结构更合理思路更偏向“真实项目”仍然存在的问题复杂技术栈组合LangChain LangGraph Milvus Langfuse仍然需要多轮调试才能完全跑通某些边界用法依然存在偏差我的判断