AI教程

使用 claude-kit 构建更智能的 Claude Code 工作流

了解 claude-kit 如何通过 savvy-flow 规划工作流和 savvy-progress 界面扩展 Claude Code。本教程涵盖市场与手动安装、插件命名空间、会话配置、验证以及实用的使用模式。

AI我搜编辑部2026年10月4日阅读约 8 分钟

claude-kit 提供的功能

claude-kit 是一组适用于 Claude Code 的独立技能、代理和 mod。每个项目都位于仓库的 plugins/ 目录下，因此你可以只安装所需的功能。

savvy-flow：一个技能和代理包，可让会话规划任务、将工作委派给分级的工作子代理，并审核它们的结果。手动安装时使用 /savvy-flow 调用；通过市场安装时，则使用其插件命名空间调用。
savvy-progress：一个在提示符上方添加进度条和实时代理面板的 mod。它专为 savvy-flow 设计，但也可以显示任意子代理。

这两个插件可以独立工作。两者都安装后，savvy-flow 会驱动进度条，而其工作代理会将进度报告到代理面板。

从市场安装 claude-kit

使用市场是在 Claude Code 中安装插件的最简单方式。

打开 Claude Code。
将仓库添加为市场，并安装所需的插件：

/plugin marketplace add johnnyvizz/claude-kit
/plugin install savvy-flow@claude-kit
/plugin install savvy-progress@claude-kit

安装后重启会话。通过市场安装的技能和代理会使用命名空间。因此，savvy-flow 技能应调用为 /savvy-flow:savvy-flow，其代理使用类似 savvy-flow:savvy-careful 的名称。

如果你的工作流更适合，也可以只安装一个插件。当你希望规划工作流和可视化进度指示器协同工作时，请同时安装两个插件。

手动安装组件

当你想要将技能复制到 Claude Code 配置中，或直接从本地检出加载 mod 时，手动安装会很有用。

克隆仓库

git clone https://github.com/johnnyvizz/claude-kit.git ~/claude-kit

复制 savvy-flow 技能和代理

以这种方式安装时，技能不需要插件系统。将技能文件夹复制到 Claude Code 的技能目录：

cp -R ~/claude-kit/plugins/savvy-flow/skills/savvy-flow ~/.claude/skills/

然后将提供的代理定义复制到代理目录：

cp ~/claude-kit/plugins/savvy-flow/agents/*.md ~/.claude/agents/

使用这种方式时，名称会保持简短：技能使用 /savvy-flow 调用，代理使用类似 savvy-careful 的名称。

为单个会话加载 savvy-progress

若只想为特定的 Claude Code 会话加载进度 mod，请使用其插件目录启动 Claude Code：

claude --plugin-dir ~/claude-kit/plugins/savvy-progress

为每个会话加载 savvy-progress

若要让该 mod 在每个会话中可用，包括桌面应用，请在 ~/.claude/settings.json 中配置 CLAUDE_CODE_PLUGIN_DIRS：

{
  "env": {
    "CLAUDE_CODE_PLUGIN_DIRS": "~/claude-kit/plugins/savvy-progress"
  }
}

如果配置多个插件文件夹，请使用 : 分隔。如果 CLAUDE_CODE_PLUGIN_DIRS 已有值，请追加新文件夹，而不是替换现有条目。

运行基本工作流

安装 savvy-flow 后，向它提供一个任务，让它进行规划和协调。例如，使用手动复制的技能时：

/savvy-flow review the authentication changes and identify missing tests

使用市场安装时，请使用带命名空间的形式：

/savvy-flow:savvy-flow review the authentication changes and identify missing tests

会话模型会规划工作，将任务委派给工作子代理，并审核它们的输出。如果 savvy-progress 也处于活动状态，进度条和代理面板会实时显示这些活动。

具体任务由你决定：可以提交代码审查、调查或其他能从规划和委派工作中受益的开发任务。

了解仓库布局

每个插件都遵循可预测的结构。市场目录和插件清单定义了 Claude Code 如何发现这些组件：

.claude-plugin/marketplace.json   `/plugin marketplace add` 读取的目录
plugins/<name>/
  .claude-plugin/plugin.json      清单
  skills/<skill>/SKILL.md         技能
  agents/*.md                     随附的子代理
  hooks/hooks.json                mod：指向 hooks 模块
  hooks/register.tsx              mod：模块本身
  types/index.d.ts                mod：其 $.state 契约

在此布局中，技能由 SKILL.md 文件描述，也可以附带代理定义。mod 使用 hook 配置和注册模块；其类型声明记录了 $.state 契约。

发布前验证插件

使用 Claude Code 的验证命令检查单个插件或市场目录：

claude plugin validate plugins/<name>
claude plugin validate .

第一个命令验证插件目录。第二个命令从仓库根目录验证仓库目录。

保持手动安装为最新版本

当你直接从克隆的仓库加载 mod 时，使用以下命令更新：

cd ~/claude-kit
git pull

从该目录加载的 mod 会使用更新后的文件。复制到 ~/.claude/skills/ 的技能不会自动更新；拉取新更改后，请再次复制技能和代理文件。

高级注意事项

有意选择命名空间命令或简短命令

从 Marketplace 安装可通过 /savvy-flow:savvy-flow 等带命名空间的名称实现插件隔离。手动安装技能会绕过插件系统，并保留简短命令。请根据你更重视 Marketplace 管理还是直接使用本地文件，选择最合适的方法。

考虑 mod 兼容性

mod 通过 hooks/register.tsx 使用函数钩子，这是 Claude Code 的早期访问 API。该仓库已在 Claude Code 2.1.286 上测试，API 可能会在不同版本之间发生变化。

如果通过 Marketplace 安装的 mod 没有出现，请使用 --plugin-dir 手动加载，或通过 CLAUDE_CODE_PLUGIN_DIRS 配置其文件夹。

需要可见性时同时使用这些插件

savvy-flow 无需 savvy-progress 即可运行，savvy-progress 也无需 savvy-flow 即可运行。安装两者可提供最完整的信息：工作流负责协调任务，而 mod 会显示进度和活动代理状态。

结语

claude-kit 为 Claude Code 用户提供模块化的规划、委派、审查和进度监控工具。从 Marketplace 安装 savvy-flow 和 savvy-progress 以使用托管式配置，或克隆仓库并手动复制或加载组件。请记住命名空间的差异，在发布前验证更改，并单独更新复制的技能和从仓库加载的 mod。