eo-skills

一套面向 Claude Code / Codex 的开发工作流 skill 集合。围绕"模块活文档 + change Delta"机制，把从模块设计、方案、实施、测试、审查到归档的全流程拆成可独立调用的 skill，并支持跨 agent（Claude ↔ Codex）协作。

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

---

依赖

依赖	用途	安装
Claude Code	skill 运行时	官方 CLI
Antigravity	skill 运行时（可选）	官方 CLI
tmux	跨 agent 协作底座（eo-flow 必需）	brew install tmux
smux	tmux pane 间通信桥（tmux-bridge）	见上游仓库 README

eo-flow 依赖 smux 提供的 tmux-bridge CLI 与另一 pane 里的 codex agent 通信。如果你只用单 agent 流（不跨 pane handoff），可以不装 tmux/smux。

---

安装

macOS / Linux:

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

# 方式二：clone 后安装
# 1. clone 本仓库到任意位置
git clone https://github.com/SimpleEve/eo-skills.git ~/code/eo-skills

# 2. 执行安装脚本（默认同时安装到 Claude Code + Codex + Antigravity）
cd ~/code/eo-skills
sh install.sh

脚本会把仓库中所有 eo-* 目录直接软链到各 agent 的 skills 目录，无中间层：

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

如果你只想装某一侧：

sh install.sh --claude-only
sh install.sh --codex-only
sh install.sh --antigravity-only

Windows:

REM 1. clone 本仓库到任意位置
git clone https://github.com/SimpleEve/eo-skills.git %USERPROFILE%\code\eo-skills

REM 2. 执行安装脚本（默认同时安装到 Claude Code + Codex + Antigravity）
cd /d %USERPROFILE%\code\eo-skills
install.bat

如果你只想装某一侧：

install.bat --claude-only
install.bat --codex-only
install.bat --antigravity-only

脚本会把当前仓库下所有 eo-* 目录逐个链接到对应的 skill 目录；如果目标里已经有同名 skill，会直接跳过，不会覆盖。链接而非复制：本仓库更新后所有 skill 立刻生效。

关于 eo-flow 的对端 agent：当前实现写死调用 codex（在另一个 tmux pane 里跑 codex CLI）。如果你想换成 Claude Code 作为对端，需要自行改 eo-flow/SKILL.md 里的派发指令。

---

第一次使用

进入任意项目目录，在 Claude Code 里跑：

/eo-project-init

它会生成 .eo-project.json（项目级配置）+ 双侧最小骨架（代码侧 eo-doc/ + 项目管理侧）。所有其它 eo- skill 都依赖它*，没跑过会直接报错。

---

流程一图流

flowchart TD
    Init["/eo-project-init<br/>(必跑一次)"]:::entry --> ModInit["/eo-module-init<br/>新模块 spec.md"]
    ModInit --> Change["/eo-change<br/>change.md (Delta + TODO)"]
    Change -.可选.-> CR["/eo-change-review<br/>方案审查"]
    CR -.P0/P1.-> Change
    Change --> Imp["/eo-implement<br/>写代码 + 勾 TODO"]
    Imp --> Test["/eo-test<br/>test.md"]
    Test -.失败.-> Imp
    Test --> Rev["/eo-review<br/>review.md"]
    Rev -.P0/P1.-> Imp
    Rev --> Arch["/eo-archive<br/>Delta 合并回 spec"]

    Imp -.甩给 codex pane.-> Flow["/eo-flow &lt;action&gt;<br/>(需 tmux + smux)"]
    Test -.同上.-> Flow
    Rev -.同上.-> Flow

    Init --> Doc["/eo-doc-manager<br/>维护 eo-doc/"]
    Init --> PU["/eo-project-update<br/>项目进度 / 决策"]
    Init --> PL["/eo-project-lesson<br/>项目经验"]
    Init --> Mini["/eo-miniapp-ideation<br/>(可选)"]

    Imp -.clear 前快照.-> Hand["/eo-handoff<br/>tmp/&lt;topic&gt;-handoff.md"]:::cross

    Brain["/eo-brainstorming 🚧"]:::wip
    Wf["/eo-workflow 🚧"]:::wip
    Init -.-> Brain
    Flow -.-> Wf

    classDef entry fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
    classDef wip stroke-dasharray: 5 5,opacity:0.55
    classDef cross fill:#dbeafe,stroke:#3b82f6,stroke-dasharray: 3 3

Loading

🚧 = 实验中，未稳定，暂不推荐使用。eo-brainstorming 与 eo-workflow 仍在调试，正式分发前请勿依赖。

/eo-handoff 横切整个流程：clear 前在任意节点都可触发，把当前状态写到 tmp/<topic>-handoff.md 供下个会话载入。图中仅以 implement 阶段示意。

---

我该用哪个？

场景	用	备注
第一次在项目里用 eo-skills	/eo-project-init	必跑
新建一个模块	/eo-module-init	自带一次性 spec-review
已有模块发起业务变更	/eo-change	产出 change.md
按 change 写代码	/eo-implement	含 bug 修复循环
发现 bug 但不确定是实现错还是方案错	/eo-fix	诊断路由：分叉到 implement / change
跑测试 / 写测试报告	/eo-test	—
实施后代码审查	/eo-review	强制，每个 change 都要
审查通过后归档	/eo-archive	Delta 自动合回 spec
把一步甩给另一个 pane 的 codex	/eo-flow <action>	需 tmux + smux
即将 /clear 但要保留进度	/eo-handoff	写到 tmp/<topic>-handoff.md，下个会话载入即续
维护 eo-doc/ 文档体系	/eo-doc-manager	sync / re-sync
项目进度 / 决策 / 经验	/eo-project-update /eo-project-lesson	项目管理侧
加一条 backlog 待办 / 灵感	/eo-backlog	仅追加到 backlog.md
微信小程序构思	/eo-miniapp-ideation	可选

不在表里的 skill（eo-spec / eo-spec-review / eo-change-review）是被上面这些 skill 内部触发或作为可选增强，详见 GUIDE。

---

三种 review 别混用

Skill	审什么	核心问题	强制？
/eo-spec-review	模块 spec.md	需求对吗？业务自洽？	module-init 时强制
/eo-change-review	某个 change 的方案	方案对吗？Delta 合理？	可选（高风险建议走）
/eo-review	change 实施后的代码	代码对吗？符合 AC？	每个 change 强制

详细边界见 GUIDE。

---

License

MIT