创建 Preset

Preset 是声明式 Capability 集合，不包含可执行 Extension 或目标安装状态。

1. 创建目录

text

jue-preset-team/
├── package.json
├── README.md
├── AGENTS.md
├── skills/
├── commands/
├── rules/
├── agents/
├── hooks/
├── mcp.json
└── tools/

按需创建目录，不生成空能力或示例噪声。

2. 编写 manifest

json

{
  "name": "jue-preset-team",
  "version": "1.0.0",
  "files": [
    "README.md",
    "AGENTS.md",
    "skills",
    "commands",
    "rules",
    "agents",
    "hooks",
    "mcp.json",
    "tools"
  ],
  "ai": {
    "presets": ["base"],
    "capabilities": {}
  }
}

完整字段见 Preset Manifest Reference。

3. 添加能力

简单 command、rule、agent 或 hook 使用 <类型>/<id>.md；需要目录结构时使用 <类型>/<id>/。同一 <id> 只选择一种模式。
只属于当前 Preset：直接写入对应能力目录。
被多个 Preset 共用：通过 ai.capabilities 引用单一来源。
第三方 skill/MCP：使用外部 Capability 引用与显式 format。
目标私有配置：写入 tools/<target>/config.json。
运行时代码：不要放进 Preset；创建独立 Jue Extension。

同一 Skill 需要出现在多个 Agent 项目根时，按跨 client root 发现合同选择：

首选：jue apply 为每个 Adapter 物化 Artifact。
bash
```
npx jue apply --adapter claude --adapter cursor
```
次选：在仓库内复制目录并保持同步。
text
```
.claude/skills/review/
.agents/skills/review/
```
末选：仓库内符号链接，并配套 checkout 后恢复链接的脚本。Windows Git 默认 core.symlinks=false 会把链接变成普通文件，Agent 因此找不到 SKILL.md。
text
```
.claude/skills/review -> ../../.agents/skills/review
```

jue inspect --diagnostics 报告破损、降级、仓库内和仓库外的链接。

4. 验证和打包

jue validate 校验的是消费项目的 ai.config.js（presets 数组、预设安装与 extends 路径），不是 Preset 自身；本地开发时先按本地开发 Preset 把 Preset 用本地路径依赖接入一个消费项目，再运行：

bash

npx jue validate

发布前用 npm pack 预览包内容：

bash

npm pack --dry-run

验证必须覆盖 manifest、Canonical 目录、嵌套依赖、循环、路径穿越、凭据和敏感信息。Pack 输出文件 inventory；不得因为文件存在于仓库就自动进入包。

5. 消费

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

Preset 不因目标不同而复制。Artifact 由对应 Adapter 选择和生成。

创建 Preset ​

1. 创建目录 ​

2. 编写 manifest ​

3. 添加能力 ​

4. 验证和打包 ​

5. 消费 ​