Skip to content

feat(+connect): add Xenon agent detection and shared Agent Skills path #14

Description

@xianyu-sheng

背景 / Background

希望 Ark CLI +connectXenon 加入内置 Agent 注册表。Xenon 是终端 AI coding workspace,已经原生支持标准目录式 SKILL.md、渐进式加载以及共享 ~/.agents/skills 路径。

Please add Xenon to the built-in agent registry used by arkcli +connect. Xenon natively discovers standard directory-based Agent Skills from ~/.agents/skills and loads skill bodies progressively.

建议映射 / Proposed mapping

  • Agent ID: xenon
  • Detection marker: ~/.xenon
  • Skills directory: ~/.agents/skills
  • No Xenon-specific config patch is required

使用共享目录可以复用 Ark CLI 对 Codex、Pi、Cline、Warp 已有的路径去重语义,也避免同一 arkcli-* skill 同时出现在 ~/.xenon/skills~/.agents/skills

Using the shared directory preserves the existing path-deduplication behavior and avoids duplicate skill names across Xenon private and shared roots.

已完成的真实验证 / Reproducible evidence

测试版本:Ark CLI 1.0.4、正式发布的 Xenon v0.7.2

arkcli +connect --path /tmp/xenon-home/.agents/skills
HOME=/tmp/xenon-home xenon --version
HOME=/tmp/xenon-home xenon skill doctor --json
HOME=/tmp/xenon-home xenon integrations verify --json

结果:

  • Ark CLI 安装 24/24 个内嵌 Skills
  • Xenon 发现 24 个标准 Agent Skills
  • 0 个加载错误,legacy_skill_count=0
  • 正文保持延迟加载,列表阶段 instructions_loaded=false
  • integrations verify 返回 schema version 1.0,无 MCP 配置时检查成功

Xenon 也提供机器可读能力契约:

xenon integrations describe --json

其中公开 SKILL.md 格式、用户/项目 Skill 根目录、MCP transport 和安装后验证命令,外部工具无需改写 Xenon 私有 YAML。实现说明见 docs/INTEGRATIONS.md

验收建议 / Acceptance criteria

  • arkcli +connect list~/.xenon 存在时显示 xenon
  • 默认 arkcli +connect 将 Skills 安装到去重后的 ~/.agents/skills
  • 与 Codex、Pi、Cline、Warp 同时存在时,同一路径只 purge/install 一次
  • arkcli +connect uninstall 沿用现有共享路径清理语义
  • registry/list/connect 测试覆盖 Xenon detection 和 path deduplication

我愿意配合测试预发布二进制并补充 Xenon 侧验证数据。

I am happy to test a prerelease binary and provide additional Xenon-side verification.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions