跳转到内容
选择主题
选择语言简体中文

编码 agent

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

把这句话贴给你的 agent:

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

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

终端窗口
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 的目录; 它会停下并指出是哪个.

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

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

acdev dev 开发会话跑着的时候, agent 可以用调试命令把屏幕读成文字、点击和输入、截图、读控制台和网络日志; acdev test 跑端到端测试. 更习惯工具调用的 agent 可以通过 MCP 用同一套工具.