opencode

opencode

npm i -g opencode-ai

安装配置

  • Linux
git clone https://gitee.com/xwos/opencode ~/.config/opencode
cd ~/.config/opencode
npm i

opencode文档: https://opencode.ai/docs/zh-cn

codegraph

全局安装

npm i -g codegraph
codegraph install
  • 安装选择
    • opencode
    • Installed codegraph CLI on PATH
    • Apply agent configs to all your projects, or just this one?All projects

安装完成后, codegraph 会自动写入 ~/.config/opencode/AGENTS.md 以及 ~/.config/opencode/opencode.jsonc

项目级初始化

cd <项目的根目录>
codegraph init

初始化完成后会产生 .codegraph 数据

  • 重建数据
codegraph index
  • 刷新数据
codegraph sync

openspec

全局安装

npm i -g @studyzy/openspec-cn

项目级初始化

  • 安装
cd <项目的根目录>
openspec-cn init
  • 升级
cd <项目的根目录>
openspec-cn update

superpowers

全局安装

npm i -g superpowers-zh

项目级初始化

superpowers-zh --tool opencode

工作流

openspec工作流

    1. 启动opencode
    1. /opsx-explore <需求描述>
    • 如果需求描述过长,可以将需求写入一个markdown文件 req.md ,让AI去读这个文件, /opsx-explore 阅读req.md的内容
    1. 与Agent问答,将需求梳理清晰
    1. /opsx-propose 创建提案, openspec 会创建 design.mdproposal.mdtasks.md
    1. /opsx-apply 执行 tasks.md 中的任务
最后修改 July 18, 2026: feat: 增加AI笔记 (c398ab3)