
English · 简体中文

v0.5.0:团队模式(client-server)、隐私脱敏、Python 3.9 支持、无需 git依赖。详见 Release notes。pip install xskill。~/.trae-cn/skills / ~/.trae/skills。agent 每次撞上同一个问题,都会把同一套解法重推一遍。你要么再讲一遍,要么自己维护一份 prompt 库——而这份库没人看的时候就慢慢腐烂。
xskill 跑起来之后,这件事不用你管了:
pip install xskill # 需要 Python 3.9+
xskill serve # 生成 ~/.xskill/config.yaml 模板后退出
打开 ~/.xskill/config.yaml,填好两个模型 endpoint:
skill_dir: ~/.xskill/skill
llm:
base_url: https://api.deepseek.com
model: deepseek-v4-flash
api_key: YOUR_KEY
embedding:
base_url: https://api.deepseek.com
model: deepseek-embedding
api_key: YOUR_KEY
dim: 0
再跑一次 xskill serve,它会自动扫机器上装好的所有 agent(Claude Code、Codex、OpenCode、OpenClaw、Cursor、Trae)开始监听。如果还有一份历史轨迹归档想一起吃进来:
xskill registry add /path/to/trajectories
xskill 真正想在组织里铺开的形态是团队模式:一台机器当 server,其他人作为瘦客户端接入,共用 server 上长出来的同一份 Skill 库。
xskill serve --server # 启动后打印 join token
xskill connect <host:port> --token <token>
user-staging/<client_id> 分支,作为下一步进化参考。几个职责单一的 LLM agent 各管一摊:一个把轨迹切成单一意图的 Atom;一个把每个 Atom 路由到对应 Skill;一个等某个 Skill 攒够素材了就重写它的 SKILL.md;一个在真实流量上 A/B 测试新版本,留下赢家。每个 Skill 本身就是一个独立 git 仓库,改了什么、谁改的、能不能回退都有据可查。细节见 docs/agent.md。
| Agent | 状态 | 轨迹采集 | Skill 安装 |
|---|---|---|---|
| Claude Code | ✅ 已验证 | 扫 ~/.claude/projects/ |
symlink → ~/.claude/skills/<name>/ |
| Codex CLI | ✅ 已验证 | 扫 ~/.codex/sessions/ |
symlink → ~/.agents/skills/<name>/ |
| OpenCode | ✅ 已验证 | 读 SQLite ~/.local/share/opencode/opencode.db |
symlink → ~/.agents/skills/<name>/ |
| OpenClaw | 🟡 已对接,not well tested | 扫 ~/.openclaw/agents/ |
拷贝 → ~/.agents/skills/<name>/ |
| Cursor | 🟡 已对接,not well tested | 扫 ~/.cursor/projects/*/agent-transcripts/ |
symlink → ~/.cursor/skills/<name>/ |
| Trae | 🟡 已对接,not well tested | IDE:读 %APPDATA%/Trae*/User/workspaceStorage/*/state.vscdb;CLI:扫 ~/trajectories/trajectory_*.json |
symlink → ~/.trae-cn/skills/ 与/或 ~/.trae/skills/ |
| 其他 agent | 手动 | SDK:xskill.adapters.submit_trajectory |
自己拷贝 / symlink SKILL.md 目录 |
| 术语 | 含义 |
|---|---|
| Trajectory(轨迹) | 一次 agent 执行——一段 session 的完整记录,存成 traj_*.md。 |
| Atom | 轨迹里单一意图的最小片段。路由判断发生在这一级。 |
| Skill | 一个 SKILL.md 加可选脚本,住在自己的 git 仓库里,带版本。 |
| Canary(灰度) | 现有 Skill 与候选版本在真实流量上做 A/B。 |
| UX score | 某个 Skill 在某个 Atom 上服务用户的好坏,从交互本身打 1–10 分。灰度按这个分数选赢家。 |
skill_dir)$ claude mcp add xskill \
-- python -m otcore.mcp_server <graph>