写 crewAIInc/crewAI 教程时，最容易混淆的是两层东西：CrewAI Skills 是给编码代理看的结构化指导，CrewAI Python 包才是用来创建和运行 crew 项目的框架。

这个 skill 教程适合刚接触 CrewAI 的新手。你可以先给 Claude Code、Codex 或 Cursor 装官方 CrewAI Skills，让代理按官方模式帮你写项目；真正要运行多代理工作流，还需要安装 Python 包、创建 crew、配置 Key 并运行。

先决定是教代理，还是跑项目

如果目标是让 Claude Code 学会 CrewAI 最佳实践，官方 README 给了插件路径：

/plugin marketplace add crewAIInc/skills
/plugin install crewai-skills@crewai-plugins
/reload-plugins

Cursor、Codex、Windsurf 等可走 skills.sh 入口：

npx skills add crewaiinc/skills

这一步只是在教编码代理如何 scaffold Flow、配置 Crew、设计 agents/tasks、查询 docs。它不会直接替你启动一个 CrewAI 项目。

运行项目要装 Python 包

CrewAI 要求 Python >=3.10 且 <3.14。官方推荐用 UV 管理依赖，基础包和工具扩展分开装：

uv pip install crewai
uv pip install 'crewai[tools]'

如果遇到 tiktoken 模块缺失，可按 README 建议安装 crewai[embeddings] 或 crewai[tools]。Windows 构建 wheel 失败时，还要检查 Rust 或 Visual C++ Build Tools。

第一次用模板项目验证

用 CLI 创建一个最小 crew 项目，它会生成 pyproject.toml、.env、src/.../crew.py、config/agents.yaml 和 config/tasks.yaml。

crewai create crew latest-ai-development
cd latest-ai-development

运行前在 .env 放模型 Key。README 示例提到 OPENAI_API_KEY 和 SERPER_API_KEY；如果你改用其他 LLM，也要按对应 provider 配。

crewai install
crewai run
python src/latest_ai_development/main.py

跑通后看 report.md

模板示例成功时，控制台会有执行输出，项目根目录会出现 report.md。看到这个文件再去改 agents、tasks、tools 或把 Crews 和 Flows 组合起来。新手不要把 Skills 安装成功当成项目运行成功；一个教代理，一个跑代码，分开验证会少走很多弯路。

读完后可以把入门拆成两张清单：编码代理侧确认 Skills 已能给出 CrewAI 写法建议，Python 项目侧确认 crewai run 生成 report.md。两边都能闭环，再谈复杂工具、记忆、Flow 分支和生产部署。