Eo Skills

eo-skills

一套开发工作流 skill 集合，可装进任何支持 Agent Skills 约定的 agent（Claude Code / Codex / Antigravity 等）。以 change 工件为核心，配套可选的 codegraph 代码召回与 agent-handbook 项目操作手册，把从构思、变更、实施、测试、审查到归档的全流程拆成可独立调用的 skill，并支持跨 agent 协作。

从 v1 升级？破坏性变更与迁移步骤见 [docs/migration-v1-to-v2.md](docs/migration-v1-to-v2.md)。

想直接看每个 skill 的详细用法、典型流程、设计权衡？请看 [docs/GUIDE.md](docs/GUIDE.md)。

担心流程的 token 开销？实测数据与 gstack / Anthropic 官方对标见 [docs/token-budget-benchmark.md](docs/token-budget-benchmark.md)。

---

依赖

• skill 本体：无硬性运行时依赖——只要 agent 支持 Agent Skills 约定（读 ~/.agents/skills/ 及自身 skills 目录）即可装载，Claude Code / Codex / Antigravity 均在此列，装了哪个就用哪个。
• 终端 CLI（eo-helper / eo-board / eo-sync）：Python 3 标准库，零第三方依赖（macOS / Linux 自带 python3 即可）；POSIX-only，Windows 走 WSL。
• 安装器：npx skills add 需要 Node ≥ 18；无 Node 环境用 install.sh（仅需 git + POSIX sh）。

---

安装

方式一（推荐）——skills CLI（[skills.sh](https://skills.sh) 生态标准安装器）：自动检测本机已装的 agent，把 skill 装入跨 agent 标准位 `~/.agents/skills/`，再在各 agent 的 skills 目录建软链：

npx skills add SimpleEve/eo-skills

方式二——install.sh（无需 Node；软链进本仓库的 clone，`git pull` 后所有 skill 立即生效）：

# 远程安装（自动 clone/update 到 ~/.eo-skills/repo）
curl -fsSL https://raw.githubusercontent.com/SimpleEve/eo-skills/main/install.sh | sh

# 或 clone 后安装
git clone https://github.com/SimpleEve/eo-skills.git ~/code/eo-skills
cd ~/code/eo-skills
sh install.sh

两种方式落到同一拓扑：skill 统一放在 `~/.agents/skills/`，检测到的 agent 目录各建软链——

Agent	skills 目录
Claude Code	~/.claude/skills/
Codex	~/.codex/skills/
Antigravity	~/.gemini/antigravity/skills/

**必须整套安装**——各 skill 以 `../eo-shared/` 相对路径引用共享规范库，单独装某个 skill 目录会断链（skills CLI 与 install.sh 都会连 `eo-shared` 一起装）。目标已有同名条目时跳过、不覆盖。install.sh 还会把终端 CLI 链接进 `~/.local/bin`（`EO_BIN_DIR` 可覆盖）。

Windows：`install.bat` 同拓扑（junction 链接）；终端 CLI 仍 POSIX-only，用 WSL 跑 install.sh 接线。

---

第一次使用

心智模型一句话：**对话里干活（skill），终端里看板（CLI）**。skill 在 agent 会话里喊；终端侧日常只需记一条命令——`eo-helper`（数字菜单直达看板与同步各入口），安装脚本已链接进 `~/.l