项目配置指南

大多数项目只需要选择 Preset 和目标 Agent：

export default {
  presets: ["base", "team"],
  targets: {
    "claude-code": { artifact: "plugin" },
    codex: { artifact: "plugin" },
    openclaw: { artifact: "compatible-bundle" },
    hermes: { artifact: "auto" }
  }
};

完整字段见 项目配置 Reference。

1. 何时增加配置

• 复用能力集合：presets。
• 引用单个共享/第三方能力：capabilities。
• 选择目标交付形态：targets.<target>.artifact。
• 保留目标私有配置：tools.<target>。
• 项目最高优先级公共能力：内联 Canonical 字段。

不要用项目配置复制 Preset 正文，也不要在 tools 中重新表达已有 Canonical。

presets 里的每一项都是 npm 包名，来源由消费项目的 package.json 依赖 声明决定；本地开发未发布的 Preset 见 本地开发 Preset。

2. 自动选择

artifact: "auto" 使用 Adapter 的稳定默认 Artifact。Plugin、compatible-bundle 或 skill-plugin 等非默认形态通过 artifact 或 --artifact 显式选择。

自动发现不能隐式执行 install、enable、update、reload 或用户级写入。

3. 迁移

jue apply --adapter codex --dry-run
jue apply --adapter codex
jue apply --adapter codex --check

所有 degraded、unsupported 和 blocked 必须在写入 前可见。详情见 跨 Agent 迁移。