# 编码 agent

acdev 自带一个 **skill**: 一份说明加一组参考文件, 教编码 agent (Claude Code、Codex、Cursor、Gemini CLI, 以及其他读 [Agent Skills](https://agentskills.io) 格式的 agent) 怎么新建、运行、查看和测试 acde 工程. skill 在 acdev 的归档里, 所以它说的总是你装的那一版 acdev. 这份文档也是从同一批文件生成的.

## 一句话配好

把这句话贴给你的 agent:

```text
Read https://pkgs.dopame.ai/acdev/install.md and follow it to set up acdev on this machine.
```

它会安装 acdev, 给自己装上 skill, 再汇报哪些就绪、哪些还缺.

## 自己装 skill

```sh
acdev skills install
```

它把 skill 链接到:

- `~/.agents/skills/acdev`, 按通用约定读 skill 的 agent 共用的目录 (Codex、Cline、Zed、Warp、Pi 等);
- 本机上找到的其他每个 agent 的 skills 目录, 比如 Claude Code 的 `~/.claude/skills/acdev`, Cursor 的 `~/.cursor/skills/acdev`.

每一处都是指向 acdev 安装目录里那份 skill 的链接, 所以升级 acdev 也就升级了 skill.

| 命令 | 做什么 |
| --- | --- |
| `acdev skills` | 列出 skill 装在哪些地方, 每一处是不是最新的 |
| `acdev skills install` | 给找到的每个 agent 装上 |
| `acdev skills install --agent claude-code,cursor` | 给这几个 agent 装, 不管找没找到 |
| `acdev skills install --dir DIR` | 装进 `DIR/acde`; 用于 acdev 不认识的 agent, 或工程自己的 skills 目录 (比如 `.agents/skills`) |
| `acdev skills install --copy` | 拷贝而不是链接; 用于不能跟随链接的 agent. 升级 acdev 后要再跑一次 |
| `acdev skills remove` | 从装过的地方都删掉 (自己指定过的目录加 `--dir DIR`); `acdev skills install` 在那些地方建的 skills 目录空了以后也一起删掉 |
| `acdev skills path` | 打印 acdev 安装目录里 skill 的目录 |

`acdev skills install` 不会替换一个名叫 `acdev` 但不是这个 skill 的目录; 它会停下并指出是哪个.

## 不支持 skill 的 agent

让 agent 去读 skill 的入口文件. 比如在工程的 `AGENTS.md` 里写:

```text
This is an acde project. Before working on it, read the file SKILL.md in the directory `acdev skills path` prints.
```

## agent 能做什么

`acdev dev` 开发会话跑着的时候, agent 可以用[调试命令](https://docs.dopame.ai/zh/guide/tools.md)把屏幕读成文字、点击和输入、截图、读控制台和网络日志; [`acdev test`](https://docs.dopame.ai/zh/guide/testing.md) 跑端到端测试. 更习惯工具调用的 agent 可以通过 [MCP](https://docs.dopame.ai/zh/guide/mcp.md) 用同一套工具.
