项目地址： https://github.com/magicdian/transpec
安装方式：
npm install -g @magicdian/transpec
我之前不少项目都是基于 OpenSpec 开发的，因为我一直觉得它那套 propose -> apply -> archive 的工作流很符合直觉，日常使用起来也很顺手。
不过用了一段时间之后，我也逐渐碰到一个问题：规范还是会慢慢漂移。 后来我在网上搜索相关方案时了解到 Trellis ，很想把以前的老项目迁移过去继续 用，但同时又不希望把原本积累下来的开发历史、任务痕迹和规范资产直接丢掉。
于是我就做了这个工具：transpec 。 它的目标很直接：帮助已有的 spec-driven 项目在不同框架之间迁移。 目前我重点完成并打磨的是 OpenSpec -> Trellis 这条转换链路。
大致的转换流程（ OpenSpec -> Trellis ）
-
在原始的 OpenSpec 项目里执行 transpec init 配置好要使用的 agent ，以及源/目标框架信息。 我个人建议把日志等级设成 trace ，这样如果中间有问题会更方便排查。
-
进入你实际使用的 agent ，比如我自己主要是用 Codex 。
-
在 agent 中执行：
$transpec-preprocess，这一步跑完之后，会生成中间产物，以及一份基于当前模型分析得到的增强信 息。 -
然后在 agent 中执行：
$transpec-apply， 这一步会完成最终转换。 -
转换完成后，再执行 trellis update ，把 .trellis 目录补全到更完整的状态。
-
删除原本的 .codex 目录，然后重新执行 trellis init 做一次配置
- 这个动作主要是因为：如果 agent 目录已经存在，trellis init 会自动跳过，就没法重新生成 Trellis 需要的 skills 和相关配置了。
转换效果参考
如果你想看一个实际效果，可以参考我另一个小工具项目的这次提交：
使用建议
-
可以先用便宜、量大的模型跑一遍试试。如果你觉得这套流程适合自己的项目，再换更强一点的模型去跑，通常效果会更稳一些。
-
如果你本身就有一些历史比较长的 OpenSpec 项目，又刚好想迁移到 Trellis ，欢迎试试，也欢迎反馈问题。
目前尚无回复
Select Language