platforms — 管理配置平台

列出或重置所有已配置的 AI 编程平台。

platforms list

列出已配置的平台。默认只显示启用(enabled: true)的渠道,按显示名称排序;NAME 列为渠道显示名称(缺失时回退到配置 key):

xskill platforms list

裸命令 xskill platforms 等同于 xskill platforms list。

输出格式(NAME、PATH、SKILLS、AGENTS、SOURCE、COMPAT、ENABLED 七列):

NAME         PATH     SKILLS  AGENTS      SOURCE     COMPAT  ENABLED
Claude Code  .claude  skills  CLAUDE.md   AGENTS.md  ✗       ✓
Codex        .codex   skills  AGENTS.md   AGENTS.md  ✓       ✓
Cline        .cline   skills  CLAUDE.md   AGENTS.md  ✓       ✗

✓ 绿色表示兼容/启用(agents_compat: true / enabled: true),✗ 红色表示不兼容/禁用,便于肉眼区分。

显示全部平台信息,包含禁用渠道:

xskill platforms list -a

输出格式同默认视图(NAME、PATH、SKILLS、AGENTS、SOURCE、COMPAT、ENABLED 七列),禁用渠道以 ENABLED 列 ✗ 标识:

NAME         PATH     SKILLS  AGENTS      SOURCE     COMPAT  ENABLED
Claude Code  .claude  skills  CLAUDE.md   AGENTS.md  ✗       ✓
Codex        .codex   skills  AGENTS.md   AGENTS.md  ✓       ✓
Cline        .cline   skills  CLAUDE.md   AGENTS.md  ✓       ✗

选项:

  • -a, --all — 包含全部渠道(含禁用),以 ENABLED 列标注启用状态

所有视图均输出完整列信息(NAME、PATH、SKILLS、AGENTS、SOURCE、COMPAT、ENABLED)。

兼容平台(agents_compat: true)会在 add、link 等命令的交互式目标平台选择器中自动预选。

platforms reset

将 platforms 重置为内置默认平台列表,通过互斥旗标指定模式(非交互执行,不弹出 TUI):

  • --replace(短参 -r)— 完全恢复:所有平台恢复内置默认配置,移除自定义平台
  • --merge(短参 -m)— 谨慎合并:只更新内置平台,自定义平台保留

两个旗标必须且只能提供一个:同时提供时报错且不执行重置;均不提供时打印上述用法帮助(退出码 0,不修改配置)。

若存在自定义平台,会先打印提示。其他配置字段(sources、cache、proxy 等)不受影响。

示例:

$ xskill platforms reset --replace
Custom platforms: my-custom
Platforms reset: 18 platforms, replaced with defaults (custom dropped)

边界情况:

  • 未配置任何平台时输出 “No platforms configured”。
  • 空字段显示 -。