Agent 技能提供程序路径¶

最后验证：2026-08-11。

V1 仅支持其路径由官方文档独立确立的提供程序。 注册表被刻意保持精简；它不会从社区路径表复制或同步。

Codex 的位置和符号链接行为已在官方 OpenAI 文档中说明： 构建技能。

Claude Code 的位置、优先级、父级遍历、实时检测和符号链接行为已在官方 Anthropic 文档中说明： 使用技能扩展 Claude。

因此，Codex 无需提供程序特定的放置方式。Claude Code 未将 .agents/skills 记录为发现根目录，因此 Orca 会将其文档中记录的 .claude/skills 路径对齐到规范副本。Orca 从不替换其不拥有的路径。如果无法创建别名，则经验证的副本回退会记录在安装回执中，以便更新和移除能够检测漂移。

注册表变更流程¶

每次注册表变更都需要常规代码审查以及以下全部证据：

1. 链接当前官方提供程序文档，说明全局和工作区路径。
2. 记录该提供程序是否直接读取 .agents/skills，以及其文档中记录的链接行为。
3. 在提供程序支持这些平台的情况下，验证 macOS、Linux、原生 Windows 和 WSL 上的全局和文件夹工作区发现。
4. 演练本地、配对运行时和 SSH 主机自有路径解析。
5. 测试别名拒绝、损坏的自有别名、独立副本漂移、更新、回滚和移除。
6. 如果放置契约发生变化，更新混合版本能力证据。

不要添加自动的上游路径表同步。改变发现语义的提供程序发布必须通过此审查流程进入。