跳到主要内容
    ↑↓ 选择↵ 打开esc 关闭
    中文English
    devcxl

    Spec

    v0.2.0智能体编排
    @devcxl/opencode-spec

    OpenSpec workflow plugin for OpenCode

    未声明开源协议
    #opencode#openspec#opencode-plugin#spec-driven-development#ai-coding-agent
    GitHub 仓库npm 页面
    GitHub 星标

    6

    月装机量

    298

    近 7 天 52

    综合评分SCORE

    42.0

    生态多维模型

    最近提交

    9 天前

    2026-08-11

    快速安装与配置

    opencode.json

    写入当前项目的 opencode.json，只对这个仓库生效。

    opencode.json

    {
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@devcxl/opencode-spec@0.2.0"]
}

    opencode 启动时会通过内嵌运行时自动加载 npm 依赖并缓存至本地目录，无需手动在全局环境执行安装。

    README.md
    查看原始文件→

    opencode-spec

    CI Release Publish to npm npm version npm downloads

    中文 | English

    opencode-spec 是一个 OpenCode 插件，用于把 OpenSpec 风格的规格驱动开发流程接入 OpenCode。

    核心能力

    插件通过 OpenCode 的 config hook 在运行时注入以下能力（不向项目 .opencode/ 目录写入文件）：

    • commands（12 个）：/opsx-propose、/opsx-explore、/opsx-apply、/opsx-archive、/opsx-new-change、/opsx-continue-change、/opsx-ff-change、/opsx-update-change、/opsx-sync-specs、/opsx-verify-change、/opsx-bulk-archive、/opsx-onboard
    • skills（12 个）：openspec-propose、openspec-explore、openspec-apply、openspec-archive 及 8 个扩展技能（new-change / continue-change / ff-change / update-change / verify-change / sync-specs / bulk-archive-change / onboard）

    每个 skill 内置 JavaScript 参考脚本，替代外部 openspec CLI。

    安装

    在项目根目录的 opencode.json 中加入：

    {
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@devcxl/opencode-spec"]
}

    前置条件：OpenCode 所使用的 shell 必须能直接执行 node。

    配置

    OpenSpec 默认输出到项目根下的 openspec/ 目录。如需自定义，使用 plugin 元组格式传入 directory 选项：

    {
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    ["@devcxl/opencode-spec", { "directory": "docs" }]
  ]
}

    也可通过环境变量 OPENSPEC_DIR 指定，优先级高于配置。

    工作流

    propose → apply → archive
explore（可选，随时使用）

    核心命令

    命令 Skill 功能
    /opsx-propose openspec-propose 创建 change 并生成 proposal/specs/design/tasks
    /opsx-explore openspec-explore 探索问题、澄清需求
    /opsx-apply openspec-apply 按 tasks 执行实现
    /opsx-archive openspec-archive 归档完成的 change

    扩展命令

    命令 Skill 功能
    /opsx-new-change openspec-new-change 启动新变更，逐步创建 artifact
    /opsx-continue-change openspec-continue-change 继续创建下一个 artifact
    /opsx-ff-change openspec-ff-change 快速生成全部 planning artifacts
    /opsx-update-change openspec-update-change 更新 planning artifacts 并保持一致性
    /opsx-sync-specs openspec-sync-specs 同步 delta specs 到 main specs
    /opsx-verify-change openspec-verify-change 验证实现与 artifact 匹配
    /opsx-bulk-archive openspec-bulk-archive-change 批量归档多个变更
    /opsx-onboard openspec-onboard 引导式完整工作流教学

    注入方式

    插件启动时通过 config hook 在运行时注入 commands 和 skills：

    • commands：直接注册到 OpenCode 的 config.command，无需写入项目目录即可被 / 触发
    • skills：将 assets/skills/ 复制到系统临时目录，替换内部路径占位符后，通过 config.skills.paths 注册；进程退出时自动清理

    本地开发

    npm install
npm test
npm run build

    致谢

    本项目的工作流设计受到 OpenSpec 启发。

    文档索引