claude-code-best-practice：10 分钟搭好命令、代理、技能编排流水线
【免费下载链接】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 的参考实现仓库，内置一条"命令→代理→技能"编排工作流，把这类重复操作打包成 1 条斜杠命令。
跑通后你会看到什么
输入/weather-orchestrator，选一下温度单位，流程自动走完：weather-agent从 Open-Meteo 取数，再生成一张 SVG 天气卡片。最终在orchestration-workflow/目录落 2 个文件：weather.svg天气卡片和output.md摘要。之前要 3 步的取数加渲染流程，现在 1 条命令跑完。
命令、代理、技能三层原语各管什么
| 原语 | 职责 | 存放位置 | 调用方式 |
|---|---|---|---|
| 命令 | 入口，负责用户交互与整体调度 | .claude/commands/<名字>.md | 输入/命令名 |
| 代理（独立上下文的子任务机器人） | 承担取数等子任务 | .claude/agents/<名字>.md | 命令通过 Agent 工具发起 |
| 技能（放在固定目录下的 markdown 指令包） | 领域知识或独立产出 | .claude/skills/<名字>/SKILL.md | Skill 工具按名调用，也可经代理的skills:字段预装进上下文 |
一句话接力：命令发起流程，代理带着预装技能去取数，技能负责渲染产出。
从零到跑通
准备：克隆仓库并启动会话
git clone https://gitcode.com/GitHub_Trending/cl/claude-code-best-practice cd claude-code-best-practice && claude进入交互式会话后输入/，能看到内置斜杠命令列表。
执行：运行 /weather-orchestrator
/weather-orchestrator后面不用再说任何话：它先问你要摄氏度还是华氏度，然后 weather-agent 按预装的 weather-fetcher 技能去 Open-Meteo 取数，最后 weather-svg-creator 技能写文件。
验证：打开 orchestration-workflow/ 目录
确认两个产物：orchestration-workflow/weather.svg是天气卡片，orchestration-workflow/output.md是本次取数摘要，单位和温度应与你的选择一致。
改成你自己的 + 别踩这几个坑
把示例里的.claude/commands/、.claude/agents/、.claude/skills/文件复制到你的项目，替换数据源、输出格式和代理名 3 处，就是你自己的编排流程。文件不用手写，让 Claude 直接生成带 YAML 头的 SKILL.md：
- 代理专属技能忘了加
user-invocable: false，会被误触发 /loop定时任务只在当次会话生效，3 天自动过期- 上下文用到 50% 左右手动
/compact，别等自动压缩
进阶内容看 README 的 Tips and Tricks 部分。
【免费下载链接】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），仅供参考
