platforms — 管理配置平台

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

platforms list

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

xskill platforms list

裸命令 xskill platforms 等同于 xskill platforms list

默认输出格式(NAMEPATHCOMPAT 三列):

NAME         PATH      COMPAT
Claude Code  .claude   ✗
Codex        .codex    ✓

绿色表示兼容(agents_compat: true), 红色表示不兼容,便于肉眼区分。

显示详细平台信息,包含禁用渠道及其 ENABLED 状态(NAMEPATHSKILLSAGENTSSOURCECOMPATENABLED 七列):

xskill platforms list -a

输出格式:

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  ✓       ✗

只显示已启用渠道的详细信息(隐藏禁用渠道):

xskill platforms list -e

选项:

  • -a, --all — 显示详细信息(路径、技能目录、代理文件、源文件、agents 兼容性和启用状态),包含全部渠道(含禁用)
  • -e, --enabled — 详细视图仅显示已启用(enabled: true)的渠道;与 -a 同时指定时按启用过滤优先

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

platforms reset

platforms 重置为内置默认平台列表,执行前弹出 skim 单选 TUI(↑/↓ 选择,Enter 确认,Esc 取消,回车默认选中第一项):

  • 完全恢复(第一项,默认)— 所有平台恢复内置默认配置,移除自定义平台
  • 谨慎合并 — 只更新内置平台,自定义平台保留
  • 取消 — 不修改任何配置

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

示例:

$ xskill platforms reset
Custom platforms: my-custom
# skim TUI: 完全恢复(默认) / 谨慎合并 / 取消
Platforms reset: 18 platforms, replaced with defaults (custom dropped)

边界情况:

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