Claude Code 命令、代理、技能怎么用？1 个天气工作流讲清三者接力
【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice
claude-code-best-practice 是一个 Claude Code 最佳实践参考仓库，收录了官方风格的 Claude Code 工作流写法。它把"查数据、出报告"这类要反复打长提示词的重复操作，组装成一条命令就能跑的自动化流程。如果你还在纯聊天式地使用 Claude Code，想升级成一条指令走完的流水线，这个仓库就是现成的起点。
先用类比看懂命令、代理、技能三件套
把一次工作流想象成开餐厅：
- **命令（Command）**是前台接待：你敲的斜杠指令入口，负责跟你对话、串起整个流程
- **代理（Agent）**是专业员工：有自己独立上下文、专门负责某件事（比如取数）的执行单元
- **技能（Skill）**是员工随身携带的作业手册：放在 .claude/skills/ 下的 markdown 指令文件
三者按"命令 → 代理 → 技能"接力：命令接住请求，把子任务派给代理，代理照预装的手册干活，最后再由技能产出成品。
技能有两种调用方式，差别很大：
| 类型 | 怎么生效 | 定位 |
|---|---|---|
| 代理技能 | 通过 skills: 字段在启动时预装进代理上下文 | 当领域知识用，不单独触发 |
| 普通技能 | 由 Skill 工具按名字调用 | 独立执行一段任务 |
跑通官方天气编排示例
先把仓库克隆到本地并启动：
git clone https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice && cd claude-code-best-practice && claude然后在会话里敲这条命令，接着就不用再说话：
/weather-orchestrator接下来全程自动：
- 命令先问你用摄氏度还是华氏度
- 确认后 weather-agent 启动，它带着预装的 weather-fetcher 技能（作为领域知识注入上下文）去 Open-Meteo 拉取迪拜实时温度并返回
- 命令再调用 weather-svg-creator 技能，把天气卡片 weather.svg 和文字摘要 output.md 一起写进 orchestration-workflow/ 目录
一条指令走完"问单位 → 取数 → 出图出摘要"的完整链路。
想逐步对照每个节点在做什么，读 编排工作流文档 即可。
让 Claude 自动生成你的 SKILL.md
技能文件不用手写。直接在会话里描述你想要什么技能，Claude 会在 .claude/skills/<名字>/ 下生成带 YAML 头部的 SKILL.md：头部写 name、description（和可选的 user-invocable），正文就是给模型看的指令说明。
要让技能挂到代理上，就在代理定义文件（.claude/agents/ 下的 markdown）里加一行 skills: 字段写上技能名。启动时整份技能内容会注入该代理的上下文，相当于给它配了一本随身手册。下图是代理文件通过 skills: 字段引用技能，以及终端实际调用效果：
两种调用模式的文件结构细节，见 技能实现说明。
进阶配置清单
- 技能头部加 user-invocable: false，它就不会出现在 / 菜单里，只作为代理的背景知识存在，避免被误触发
- 定时任务用 /loop，最小粒度 1 分钟、仅当前会话生效、3 天后自动过期，适合临时监控，比如：
/loop 1m "tell current time"运行后返回一张调度摘要表，含 cron 表达式、执行间隔和任务 ID。
- CLAUDE.md 每文件控制在 200 行以内，写多反而稀释注意力
- 上下文用量到 50% 左右就手动 /compact；会话拖得越久，模型状态越容易变差，该压就压、别等撑不住
把示例搬进你自己的项目
正确姿势是把仓库里的命令、代理、技能文件复制到你自己的项目里跑，而不是改仓库源码。跑通这条接力链后，建议接着读 README 的 Tips and Tricks 部分，83 条带出处的技巧覆盖提示词、上下文管理和调试，够你再深挖一阵。
【免费下载链接】claude-code-best-practicefrom vibe coding to agentic engineering - practice makes claude perfect项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
