opencode-spec
agent
Uyari
Health Uyari
- No license — Repository has no license file
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Uyari
- fs module — File system access in .github/workflows/create-draft-release.yml
- fs module — File system access in .github/workflows/create-release-tag.yml
- fs module — File system access in .github/workflows/npm-publish.yml
- process.env — Environment variable access in assets/skills/_shared/references/openspec.js
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
An OpenCode plugin that brings OpenSpec-style spec-driven development workflow into AI coding agents — propose, explore, apply, and archive changes with structured specs.
README.md
核心能力
插件通过 OpenCode 的 config hook 在运行时注入以下能力(不向项目 .opencode/ 目录写入文件):
- commands:
/opsx-propose、/opsx-explore、/opsx-apply、/opsx-archive - skills:
openspec-propose、openspec-explore、openspec-apply、openspec-archive
每个 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 |
注入方式
插件启动时通过 config hook 在运行时注入 commands 和 skills:
- commands:直接注册到 OpenCode 的
config.command,无需写入项目目录即可被/触发 - skills:将
assets/skills/复制到系统临时目录,替换内部路径占位符后,通过config.skills.paths注册;进程退出时自动清理
本地开发
npm install
npm test
npm run build
致谢
本项目的工作流设计受到 OpenSpec 启发。
文档索引
README.zh.md:中文 README 版本README.en.md:English READMEdocs/zh/usage.md:中文使用指南docs/zh/reference.md:中文参考文档docs/zh/architecture.md:中文实现原理docs/en/usage.md:English usage guidedocs/en/reference.md:English referencedocs/en/architecture.md:English architecture
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi