Orchestkit Docs MCP

115 项技能 · 36 个 Agent · 161 个钩子

从这里开始

OrchestKit 是一款免费开源的 Claude Code 插件，提供用于审查、测试、安全和记忆的技能、Agent 和钩子。

claude plugin marketplace add yonatangross/orchestkit && claude plugin install ork@orchestkit

文档 · v10 新功能 · yonyon.ai

浏览文档 → · OrchestKit 社区 →
_{技能浏览器、演示图库、设置向导}

目录

• 快速开始
• 为什么选择 OrchestKit？
• 你将获得什么
• 关键命令
• 配置
• OrchestKit 会观察什么
• 安装
• 常见问题
• 开发
• 新功能
• 社区

快速开始

选择你实际使用的宿主。Claude Code 提供完整插件（技能 + Agent + 钩子）。Cursor 可使用相同的 ork 插件，但不包含 Claude 钩子脚本。skills.sh 仅提供技能——从下面的 12 项开始，而不是整个目录。

宿主支持矩阵

数据于 2026-09-08 在 pi 0.85、Codex CLI 和 cursor-agent 上测得。详情、命令和通道模型请参阅：OrchestKit 在 pi、Codex 和 Cursor 上的支持情况。Antigravity 数据于 2026-09-18 在 agy 1.2.6 上测得；完整证据见 docs/audits/agy-host-support-2026-09-18.md。

Claude Code

/plugin marketplace add yonatangross/orchestkit
/plugin install ork

然后运行 /ork:setup。向导会扫描代码库、推荐技能，并写入 MCP 配置。

等效 CLI 命令：claude plugin marketplace add yonatangross/orchestkit && claude plugin install ork@orchestkit。

Cursor

Settings → Plugins / marketplaces → 添加 yonatangross/orchestkit → 启用 ork → 打开新聊天。这是与 Claude Code 安装的同一个插件，不是拆分成五个技能的分支。请参阅安装 → Cursor。

skills.sh（Cursor、Codex、OpenCode 等）

从实际安装情况中选出的 12 个入门技能，加上我们保留的 ork 技能（完整原因说明表见安装）：

npx skills add yonatangross/orchestkit -s devops-deployment -s responsive-patterns -s architecture-decision-record -s ui-components -s rag-retrieval -s agent-orchestration -s brainstorm -s expect -s auto -s review-pr -s fix-issue -s commit

完整目录：npx skills add yonatangross/orchestkit（数百个 SKILL.md 文件；不要将其视为独立用户数量）。实时安装总数见上方 skills.sh 徽章。

为什么选择 OrchestKit？

每个 Claude Code 会话都从零开始。你得一次又一次地说明自己的技术栈、模式和偏好。

OrchestKit 让 Claude 持久掌握可自动应用的生产模式：

你将获得什么

一个统一插件，包含所有功能。

全部可通过单条命令 /plugin install ork 使用。技能按需加载。Hook 会自动运行。

在文档中浏览全部内容 →

关键命令

/ork:auto         # Front door: describe a goal, it routes to the right skill
/ork:setup        # Personalized onboarding wizard
/ork:implement    # Full-stack implementation with parallel agents
/ork:expect       # Diff-aware AI browser testing
/ork:review-pr    # PR review with parallel agents
/ork:verify       # Multi-agent validation
/ork:commit       # Conventional commit with pre-checks
/ork:explore      # Analyze unfamiliar codebase
/ork:remember     # Save to persistent memory
/ork:doctor       # Health check

配置

/ork:setup 会检测你的技术栈、推荐 MCP 服务，并为你写入配置。

推荐的 MCP 服务

在 .mcp.json 中为前三项设置 "alwaysLoad": true。这样会跳过逐技能的工具探测，并将冷启动时间缩短约 150ms。

Context7 是前置条件，ork 不会附带它。 22 个 Agent 会在其 frontmatter 中授予 mcp__context7__*，但 .mcp.json 由用户管理且作用于项目，因此该授权指向的是你需要添加的服务。若跳过此项，这些 Agent 会根据训练数据作答，且不会报错。推荐配置项使用托管 HTTP 服务，无需启动本地进程：

"context7": {
  "type": "http",
  "url": "https://mcp.context7.com/mcp"
}

免费套餐：1,000 次请求，支持公开仓库，无需账户。Context7 Pro（每个席位每月 $10）将额度提高到每席位 5,000 次请求，并支持解析私有仓库；添加 "headers": { "Authorization": "Bearer ${CONTEXT7_API_KEY}" } 并导出 ctx7sk- 密钥。只有在变量已导出后才添加该请求头：如果变量未设置，未展开的字面值会被当作令牌发送，导致每次查询都失败，而且不会回退到匿名免费套餐，因此上方不带密钥的配置项严格优于添加了请求头却没有密钥的配置。托管端点无法访问时，可使用旧版 stdio 传输方式（npx -y @upstash/[email protected]）作为回退方案，但它会为每个 Claude Code 会话启动一个子进程，因此进程数量会随着你保持打开的会话数增加。

自定义技能

技能会以文件形式安装在磁盘上，但不要手动编辑已安装的副本——更新时它会被覆盖，并且会悄然偏离规范操作手册。受支持的扩展方式（用户级技能、项目技能、向上游提交 PR，或禁用捆绑技能）请参阅 docs/extending-skills.md。

OrchestKit 会监控什么

OrchestKit 是一个质量门插件，因此它的钩子就是产品本身，而非附加功能。本节会明确说明钩子会读取哪些内容、数据会发送到哪里，以及如何关闭各项功能。

范围：广泛且有意为之。 OrchestKit 会在 32 个生命周期事件中注册 161 个钩子，包括 SessionStart、UserPromptSubmit、PreToolUse、PostToolUse 和 Stop。这些钩子不会限定于特定框架或项目类型，因为它们实施的质量门（阻止写入密钥、保护文件防护、Git 安全、文件大小限制、Agent 状态协议）适用于任何代码库。如果你只想在部分项目中启用这些质量门，请按项目启用插件，而不要全局启用。

数据去向：你自己磁盘上的本地文件。

本地写入刻意不设全局关闭开关，因为质量门依赖这些状态（Git 安全钩子和链陈旧状态钩子会读取此前的事件）。如要完全停止写入，请禁用插件。部分产生较多事件的钩子有各自的退出选项：ORK_DISABLE_DEBT_TRACKER、ORK_DISABLE_WORKTREE_VERIFIER、ORK_DISABLE_COORDINATION_METRICS、ORK_NO_NOTIFY、ORK_NO_STALE_SWEEP 和 ORCHESTKIT_SKIP_SLOW_HOOKS 等。

网络访问默认关闭，只有选择启用后才会开启。 已发布的钩子包中没有任何硬编码的远程主机（执行 grep -o 'https\?://' plugins/ork/hooks/dist/*.mjs 不会返回任何结果）。只有在你自行配置目标位置后，才会发起出站调用，配置方式包括以下任一项：

• ORCHESTKIT_HOOK_URL + ORCHESTKIT_HOOK_TOKEN，用于启用手动运行的 hooks/bin/telemetry-sync.mjs CLI。它会将本地 JSONL POST 到你自己的 端点。没有任何钩子会调用它；需要你手动运行。
• ORK_HQ_TELEMETRY_URL，用于将遥测 HTTP 接收端指向你自己的收集器。
• ORK_HQ_TELEMETRY_USE_HQ_API=1 与 HQ_API_URL 搭配使用，将同一接收端 指向可自托管的 HQ API。
• ORK_SESSION_CATEGORY_PROVIDER=jev（或 shadow）与 TypeSafe 密钥变量 ORK_TYPESAFE_API_KEY 搭配使用，为会话工作类别添加第二个分类器。 会话身份钩子已经会请求本地 claude -p --model haiku 进程生成标题和类别；设置这两个变量后，它还会请求 TypeSafe 的 Jev 模型（api.typesafe.ai，模型固定为 jev-1.13.0），针对 相同的八个类别和相同的标准文本，返回一个类型化 Choice。这是上述“没有硬编码主机”说明的唯一例外，且只有在两个变量都设置后才会启用。离开你设备的数据：git 分支名和会话首条提示词的前 600 个字符，这些数据会发送给受其自身数据政策约束的第三方处理方。jev 模式下的变化：当 Jev 的置信度达到 0.8 或以上时，由它的类别决定会话颜色（在 150 个会话上留出测试，该置信度区间的准确率为 93.5%）； 低于 0.8 或出现任何错误时，仍由 haiku 的类别决定。在 shadow 模式下，你看不到任何变化；Jev 只会与 haiku 的结果一同记录。要在本地启用它，请在启动 claude 的 shell 中运行：export ORK_TYPESAFE_API_KEY="$(<your secret manager> ...)" 和 export ORK_SESSION_CATEGORY_PROVIDER=jev。每个会话的两种结果都会在钩子日志中记录一次，格式如下： category jev: haiku=<cat> jev=<cat> agree=<bool> confidence=<n> decided_by=jev|haiku threshold=0.8 latency_ms=<n>， 同时以相同字段（标签、决策、耗时；绝不包含提示词文本）写入 session-identity.shadow.json，并与原始答案文件 session-identity.jev.json 一同保存在会话数据目录中。选择启用的代价：会话的首条提示词需要等待调用完成；从全新钩子进程测得耗时为 1.1 到 1.7 秒（评估中的 320 ms 是连接已预热时的耗时），最多等待 3 秒，之后就会放弃。
• ORK_ROUTE_JEV=shadow（或 steer）与 ORK_TYPESAFE_API_KEY 搭配使用，为 /ork:auto (#4233) 启用 Jev 路由接口。默认关闭。设置后，每条构建类提示词（使用与每会话一次的执行器提醒相同的测试：包含命令式构建或修复动词、长度不少于 40 个字符，且不含显式的 /plugin:skill）都会发送到相同的 TypeSafe 端点和模型，以一个类型化 Choice 在十九种路由类别和四项辅助判断（是否需要工作树、是否需要浏览器、变更风险、是否需要操作人员）中进行选择。离开你设备的数据：经脱敏器将秘密、电子邮件、以色列电话号码、九位数字 ID、op:// 引用和 clients/ 下的目录名分别替换为 [SECRET]、[EMAIL]、[PHONE] 和 [CLIENT] 后的提示词前 1,500 个字符，以及仓库的基本名称。序列化后的请求在离开设备前还会再次扫描；任何未能脱敏的内容都会导致调用被拒绝。在 shadow 模式下，你看不到任何变化；判定结果会被记录。在 steer 模式下，当置信度达到 ORK_ROUTE_JEV_FLOOR（默认值为 0.5）或以上时，单行执行器提醒会指出该类别对应的执行器 （route: dev_fix -> /ork:fix-issue (conf 0.83)）；模型仍会读取 /ork:auto 表并判断是否同意。回退采取故障开放策略：无密钥、超时、非 2xx 响应、答案格式错误、置信度低于下限，或达到每日令牌预算上限（ORK_ROUTE_JEV_DAILY_TOKENS，默认值为 2,000,000），都意味着现有路径会原样运行；收到 402 或 429 响应时，该接口会关闭 24 小时。每条提示词记录一行日志， route jev: intent=<class> conf=<n> top3=<a:p,b:p,c:p> worktree=<n> browser=<n> mutation=<n> operator=<n> floor=<n> decided_by=jev|table|off|budget|egress latency_ms=<n> input_tokens=<n> redacted=<n>， 并在 jev-route.jsonl 中为每条提示词记录一条记录，该文件与 session-identity.jev.json 放在一起（包含标签、耗时和脱敏文本的 sha256；绝不包含提示词文本）。离线重放：node scripts/eval/route-check.mjs --jev 和 node scripts/eval/jev-route-score.mjs。供应商的 Agent 技能是从其自有市场安装的同级插件，绝不能复制目录： claude plugin marketplace add typesafe-ai/skills 然后运行 claude plugin install typesafe@typesafe-ai；/ork:doctor 会根据市场报告已安装的版本，并打印更新命令。 当 URL 或令牌缺失时，接收端会提前返回，telemetry-sync.mjs 会打印 No ORCHESTKIT_HOOK_URL or TOKEN configured. Nothing to sync.，然后以状态码 0 退出。不会发送分析数据，不会运行崩溃报告程序，也不会获取功能标志。

OrchestKit 从不读取的内容。 不会查询 OS 密钥链，不会读取 ~/.aws/credentials、 SSH 私钥、浏览器 Cookie 或登录存储，也不会读取剪贴板。源代码中唯一出现类似机密路径的位置是 plugins/ork/hooks/dist/pretool.mjs，其中 id_rsa、.pem、.env 和 credentials.json 组成阻止列表，用于阻止 Claude 写入这些文件。该代码会拒绝访问，不会读取这些文件。

第三方 MCP 服务是推荐项，而非捆绑依赖。 此插件不附带 .mcp.json，也未声明任何 mcpServers。配置 下方的表格仅供参考，且 /ork:setup 会在写入任何内容前征求确认。

安装

/plugin install ork

没有层级之分，没有版本混淆，只有一个强大的插件。

不用 Claude Code？通过 skills.sh 将入门 12 项引入任意 Agent（Cursor、Codex、OpenCode 等）——第一天不要安装全部内容。以下精选技能来自我们在 skills.sh 列表中的安装数据，以及我们实际保留的 ork 技能：

npx skills add yonatangross/orchestkit -s devops-deployment -s responsive-patterns -s architecture-decision-record -s ui-components -s rag-retrieval -s agent-orchestration -s brainstorm -s expect -s auto -s review-pr -s fix-issue -s commit

全部技能：npx skills add yonatangross/orchestkit。实时安装总数显示在上方的 skills.sh 徽章 中，此处不硬编码。

Cursor

Cursor 会加载 Agent Plugins 和 Cursor 插件。 此仓库已附带 Agent Plugins 清单 plugins/ork/plugin.json。 将 GitHub 仓库添加为 Cursor 市场（Settings → yonatangross/orchestkit）， 启用 ork，然后打开新聊天。这与 Claude Code 安装的是同一个插件，而不是由五个技能组成的分支。

它还通过插件的 rules 键附带 14 条规则，这些规则由 src/rules/ 和 src/shared/rules/ 生成。规则由 Agent 按需获取，因此只有当规则描述与任务匹配时才会占用上下文。

Claude 钩子脚本不会为 Cursor 注册：它们依赖 ${CLAUDE_PLUGIN_ROOT}（orchestkit#293，已关闭）。HQ 仓库在 Cursor 中的强制执行仍由使用该插件的项目的 .cursor/hooks.json 负责。

“Include third-party Plugins”可能会泄露 ~/.claude/plugins 中的 SKILL.md。这不算安装。证明是 ork 插件 ID 和完整技能目录。

Codex

Codex 使用自己的插件格式、技能选择器和独立角色配置。添加 OrchestKit 的 Codex 市场，然后安装精简的可移植工作流包：

codex plugin marketplace add yonatangross/orchestkit --ref main --sparse .agents/plugins --sparse plugins/ork-codex
codex plugin add ork-codex@orchestkit-codex

安装后重启 Codex。使用 $ork-brainstorm、$ork-explore、$ork-implement、$ork-assess、$ork-verify 或 $ork-review-pr 显式调用工作流；它们精简的描述也能让 Codex 自动选择相关工作流。

插件有意将角色作为模板提供，因为 Codex 从 ~/.codex/agents/ 加载自定义角色，而不是从插件清单加载。从 OrchestKit 检出目录运行以下一次性、不会覆盖文件的安装命令：

plugins/ork-codex/scripts/install-codex-roles.sh ~/.codex/agents

此命令会安装 ork_explorer、ork_implementer、ork_reviewer 和 ork_verifier；启动这些角色前请重启 Codex。

无人值守运行：ork-mech 配置

对于机械性工作（重命名、版本升级、代码转换，以及最终会产生差异的批量修改）， 安装随附的配置并通过它运行 codex exec：

plugins/ork-codex/scripts/install-codex-profile.sh ~/.codex
codex exec --profile ork-mech "<task>" </dev/null

该配置是一个文件，而不是要粘贴到 config.toml 中的代码片段。在 codex-cli 0.153.4 上测得：--profile <name> 会将 $CODEX_HOME/<name>.config.toml 叠加到基础配置上；如果 config.toml 中还留有旧式的 [profiles.<name>] 表，同一个标志会导致配置加载错误。安装程序会拒绝在存在该表时运行，也会拒绝覆盖已有的配置文件。

它设置的内容（由 codex exec 在自己的标头中打印）：

approval: never
sandbox: workspace-write [workdir, /tmp, $TMPDIR] (network access enabled)
reasoning effort: high

它有意不固定模型（请传入 -m），也不会使用 --dangerously-bypass-approvals-and-sandbox，因为该参数会完全取消沙盒。 TOML 文件无法表达以下两项约定，因此它们仍需在命令行中指定：

• </dev/null。 即使提供了提示词参数，codex exec 仍会读取标准输入。继承的打开状态管道会让运行卡在 Reading additional input from stdin...，且没有超时。

• Git 工作树中的 --add-dir。 可写入的根目录为 [workdir, /tmp, $TMPDIR]。链接工作树的 Git 公共目录位于工作目录之外，因此首次提交会因 index.lock 失败。请将其添加进去：

  codex exec --profile ork-mech \
    --add-dir "$(git rev-parse --path-format=absolute --git-common-dir)" \
    "<task>" </dev/null
  

保持安装为最新版本

市场来源中的 ref main 是缓存的快照，而不是更新跟踪器。在 2026-09-08 的审计机器上，codex plugin list 显示的是 10.0.0-beta.5，而 main 已领先三个版本。OrchestKit 发布新版本后，请更新并检查：

codex plugin update
codex plugin list | grep ork-codex          # installed version
jq -r .version plugins/ork-codex/.codex-plugin/plugin.json   # what main ships

文档查询（context7）

该插件在自己的清单中附带了一个 context7 MCP 服务（.codex-plugin/plugin.json 中的 mcpServers，定义于 mcp.json），因此安装插件时会注册该服务。使用 codex mcp get context7 确认。它的范围仅限于 context7 提供的两个工具：resolve-library-id 和 query-docs；它使用托管的 HTTP 传输，而不是 npx 标准输入／输出子进程，因此每个 Codex 会话都不会产生额外的进程开销。

启动 Codex 前，请导出密钥。插件只引用变量名，不会存储其值，因此不会将令牌写入 ~/.codex/config.toml：

export CONTEXT7_API_KEY_CODEX="<your-context7-api-key>"

将其写入 shell 配置文件，以便每个 Codex 会话都能继承该变量。请从你自己的 context7 账户获取密钥，并确保其值不进入代码仓库。如果将其存储在密钥管理器中，请替换为你自己的保管库和条目名称（使用 1Password CLI 时，参考路径为 op://<vault>/<item>/credential），并缓存解析后的值，而不是在每个 shell 中都重新读取保管库：每次直接读取都会单独提示解锁。

以下两点行为值得了解：

• 如果你已在 ~/.codex/config.toml 的 [mcp_servers.context7] 下自行定义服务，该定义优先，插件的定义会被完全忽略（包括其工具范围设置）。这是有意为之：插件绝不会覆盖你自己的配置。如果想使用插件的定义，请移除你自己的条目。
• 没有有效密钥时，服务仍会连接，也仍会列出其工具。只有实际调用时才会失败，并显示 Invalid API key。因此，连接成功并不能证明身份验证成功。

pi

pi（0.85）读取相同的 SKILL.md 格式，仓库现在也包含 pi 清单，因此该软件包可以直接安装：

pi install git:github.com/yonatangross/orchestkit

这会注册所有技能。添加 -l，即可将设置写入项目中的 .pi/settings.json， 而不是用户设置。仍可让 pi 指向检出目录，无需安装（pi --skill ./plugins/ork/skills）。

标记为 disable-model-invocation 的 29 个技能仍只能通过 /skill:<name> 访问。有两个经实测发现的注意事项：--no-builtin-tools 会隐藏所有技能 （pi 只有在启用了文件读取工具时才会列出技能），而 pi -p 在 stdin 未关闭时会一直阻塞， 因此无头运行需要使用 </dev/null。

pi 的 MCP 服务依次从 .pi/mcp.json、.mcp.json 和 ~/.config/mcp/mcp.json 加载。复制随附的模板，即可获取推荐的服务；每个服务都配有只读的 includeTools 允许列表：

cp .pi/mcp.json.example .pi/mcp.json

完整详情及跟踪 Epic： OrchestKit 在 pi、Codex 和 Cursor 中的使用指南。

Devin

devin plugins install yonatangross/orchestkit

Devin 按以下顺序检查插件根目录中的清单：.devin-plugin/plugin.json， 然后是 .claude-plugin/plugin.json，最后是根目录下的 plugin.json （插件参考文档）。 仓库根目录中只有最后一个，即 Agent Plugins 清单。该清单要求技能位于根目录的 skills/ 目录中，而本仓库并没有该目录， 因此以前直接安装时会显示 107 个技能中有 0 个、0 个钩子，且只有 AGENTS.md 规则（GH-4146）。现在，根目录级别的 .devin-plugin/plugin.json 会将 skills 映射到 ./plugins/ork/skills，与 Claude Code 和 Cursor 已读取的构建目录相同。

完成此更改后，devin plugins info ork 会列出 107 个技能中的 76 个（在 Devin CLI 3000.10.27 上测得）。其余 31 个技能，例如 auto、verify、help、 brainstorm 以及类似的路由或工作流技能，在 frontmatter 中声明了 triggers: 键，其结构为对象（keywords、examples、anti-triggers）。Devin 自身的 triggers 字段要求使用扁平的 [user, model] 列表，结构不匹配会导致整个技能被丢弃， 而不是发出警告。重命名该键会影响其他三个读取器 （scripts/eval/eval-coverage.sh、tests/skills/triggering/test-trigger-keywords.sh 和 tests/plugins/test-command-frontmatter-passthrough.sh 中的 SKILL_ONLY 允许列表）， 因此该问题仍由 GH-4146 跟踪，而不并入此修复。直接安装子路径 devin plugins install yonatangross/orchestkit#plugins/ork，也能获取相同的 76 个技能 以及插件的 36 个自定义子 Agent，但这两种方式都不会通过 devin plugins info 显示这些子 Agent。 该子路径正是本仓库自己的 .claude-plugin/marketplace.json 已指向的 Claude Code 路径。

目前，OrchestKit 的插件钩子只能在 Claude Code 下工作；171 个钩子在 Devin 下都不会触发。 原因有两个。位置：OrchestKit 将钩子放在 plugins/ork/hooks/hooks.json，而 Devin 自身的插件格式会读取插件根目录下的裸 hooks.json。结构和工具名称：OrchestKit 的文件使用 Claude Code 工具名称，例如 Bash 和 Write|Edit，并会在命令参数中展开 ${CLAUDE_PLUGIN_ROOT}，这两者都仅适用于 Claude Code。Devin 自身的 hooks.v1.json 格式则使用其自身的工具名称， 例如 exec、write、edit 等（参见 生命周期钩子）， 并采用相同的 {matcher, hooks:[{type, command}]} 事件映射结构。 即使技能已能正常解析，devin plugins info 仍会确认显示 Hooks (none)。 PreToolUse 和 PostToolUse 与 OrchestKit 自己的 pretool 和 posttool 钩子所做的事情最为接近， 因此可作为未来 Devin 钩子清单的首选候选项；届时应明确编写工具名称映射，而不是猜测。

请固定到某个发行版，而不是跟踪 main：release-please 会将每个发行版标记为 v10.0.0-beta.N。单参数命令 devin plugins install <source> 本身没有固定引用的语法； 应通过 requiredPlugins 条目固定（可写在本仓库自己的 .devin/config.json 中， 也可写在个人、组织或企业清单中）：

{
  "requiredPlugins": [
    { "source": "github", "repo": "yonatangross/orchestkit", "ref": "v10.0.0-beta.30" }
  ]
}

Antigravity

npx skills add yonatangross/orchestkit -s devops-deployment -s responsive-patterns -s architecture-decision-record -s ui-components -s rag-retrieval -s agent-orchestration -s brainstorm -s expect -s auto -s review-pr -s fix-issue -s commit

Antigravity（agy，Google 的 Agent CLI）会从工作区的 .agents/skills 目录读取 Agent Skills，因此上面的共享 skills.sh 命令就是安装路径，而且 Antigravity 已在安装器的通用目标列表中（基于 agy 1.2.6 的实测；完整证据见 docs/audits/agy-host-support-2026-09-18.md）。在仓库根目录运行 agy -p "/skills" --add-dir "$PWD" 进行验证：打印模式只能通过绝对路径 --add-dir 注册工作区；交互式 TUI 会将启动目录作为工作区，无需标志。

有两个实际限制。npx skills add -g 会安装到 ~/.agents/skills，agy 不会读取该目录；用户级技能应放在 ~/.gemini/config/skills（或 ~/.gemini/skills）。此外，ork 的 171 个钩子都无法移植：agy 的 hooks.json 使用自己的事件名称和载荷格式，而 agy plugin validate plugins/ork 会报告跳过了钩子，因为 ork 将它们放在 hooks/hooks.json，而不是 agy 查找的插件根目录 hooks.json 中。

更完整的安装方式需要本地检出仓库： agy plugin validate <checkout>/plugins/ork 会报告 skills: 108 processed、agents: 36 processed；agy plugin install <checkout>/plugins/ork 会将它们复制到 ~/.gemini/config/plugins/ork/，并使用 ork:<name> 命名空间，这与 /ork:<skill> 的写法相符。插件内置的 mcp_config.json 也能正常工作（已通过标记端到端验证），但仓库级 .mcp.json 不会被读取。

常见问题

/plugin list
/plugin uninstall ork && /plugin install ork

开发

npm run build      # Build plugins from src/
npm test           # Run all tests

编辑 src/ 和 manifests/，不要编辑 plugins/（自动生成）。

详情请见 CONTRIBUTING.md。

最新动态

v10.3.1 · 2026-10-26

• deps-dev: 升级 @biomejs/biome (#4916)
• deps: 升级 npm-minor-patch 组 (#4920)
• deps: 在 /docs/site 中升级 npm-minor-patch 组，包含 6 项更新 (#4917)
• deps: 在 1 个目录中升级 remotion 组，包含 21 项更新 (#4919)
• traffic: 生成 2026-10-19 当周的快照 (#4927)
• …以及 1 项更新（参见 CHANGELOG.md）

v10.3.0 · 2026-10-26

• skills: 为计划和研究工件配对，并在文件内进行审查 (#4897)
• ci: 不启用武装状态即可打开工作流 PR (#4930)
• plugin: 使用简单描述说明钩子范围 (#4759)
• tests: docs.yml 一致性测试比较临时文件，而非 /dev/fd (#4933)
• skills: 将 json-render 技能移至 0.21.3 (#4929)

v10.2.2 · 2026-10-26

• hooks: 合并提示词钩子进程 (#4909)
• hooks: 在 --restricted 模式下，绝不启动不受限制的 claude (#4906)
• site: 补齐 orank 沙盒、卡片和可发现性方面的缺口 (#4908)

v10.2.1 · 2026-10-25

• coderabbit: 谨慎使用免费的 OSS 审查，并匹配组织设置 (#4886)

v10.2.0 · 2026-10-25

• prompt-enhancer: 基于短技术栈的改写，并使用提示词缓存目录 (#4857)
• secrets-veil: 将扫描时的缩放上限扩大至 31.6x (#4898)

v10.1.1 · 2026-10-24

• deps: 修补四个锁定文件中的 npm 审计公告问题 (#4894)

v10.1.0 · 2026-10-23

• ci: 当机器人审查讨论串尚无回复时，使 PR 失败 (#4864)
• ci: 让 apt 在文档依赖步骤中等待 dpkg 锁 (#4879)
• hooks: 顾问决定描述内容，并忽略否定请求 (#4853)
• hooks: 加固自动批准和重试钩子 (#4858)
• hooks: 保留后续子句引用的停止条件（继 #4853 之后）(#4880)
• …以及 6 项更新（参见 CHANGELOG.md）

v10.0.2 · 2026-10-23

• release: 从 release-please 提交中排除 .claude-plugin

完整发布历史请参见 CHANGELOG.md。

社区

加入 Building with AI 社区，获取 AI 开发技巧、OrchestKit 支持，并与其他创作者交流：

名称和受众与 yonyon.ai 上的呈现一致，因此两个界面不会出现偏差。所有链接都通过 yonyon.ai/go/* 跳转，因此更换邀请链接时无需修改 README，也不会在此处公开原始邀请链接。

谁在构建

OrchestKit 由 Yonatan Gross 构建和维护，他来自 AI 咨询团队 Yonyon AI。这是从真实客户项目中提炼出的工具包，而非业余项目：这里的模式都是经过实际交付验证的。

它始终采用 MIT 许可证并免费提供。没有任何内容设限，以下内容也不会改变这一点。

想了解 AI 在你的业务中究竟能发挥什么作用？ AI 准备度评估是一项免费评估，可梳理你的工作流并生成一份按优先级排序的报告——这也是开启咨询合作的同一项诊断。

想让工具包在你的团队中正常运行？ 我可以按固定范围的合作项目，为你提供设置、配置，并根据你的技术栈打造可运行的 Agent 循环。欢迎发起讨论，或通过社区联系我。

安全政策和报告方式：SECURITY.md。