[开源分享] transpec，开发框架转换工具

项目地址： https://github.com/magicdian/transpec

安装方式：

npm install -g @magicdian/transpec 

我之前不少项目都是基于 OpenSpec 开发的，因为我一直觉得它那套 propose -> apply -> archive 的工作流很符合直觉，日常使用起来也很顺手。

不过用了一段时间之后，我也逐渐碰到一个问题：规范还是会慢慢漂移。 后来我在网上搜索相关方案时了解到 Trellis ，很想把以前的老项目迁移过去继续 用，但同时又不希望把原本积累下来的开发历史、任务痕迹和规范资产直接丢掉。

于是我就做了这个工具：transpec 。 它的目标很直接：帮助已有的 spec-driven 项目在不同框架之间迁移。 目前我重点完成并打磨的是 OpenSpec -> Trellis 这条转换链路。

大致的转换流程（ OpenSpec -> Trellis ）

1. 在原始的 OpenSpec 项目里执行 transpec init 配置好要使用的 agent ，以及源/目标框架信息。 我个人建议把日志等级设成 trace ，这样如果中间有问题会更方便排查。

2. 进入你实际使用的 agent ，比如我自己主要是用 Codex 。

3. 在 agent 中执行： $transpec-preprocess，这一步跑完之后，会生成中间产物，以及一份基于当前模型分析得到的增强信 息。

4. 然后在 agent 中执行：$transpec-apply ， 这一步会完成最终转换。

5. 转换完成后，再执行 trellis update ，把 .trellis 目录补全到更完整的状态。

6. 删除原本的 .codex 目录，然后重新执行 trellis init 做一次配置

- 这个动作主要是因为：如果 agent 目录已经存在，trellis init 会自动跳过，就没法重新生成 Trellis 需要的 skills 和相关配置了。 

转换效果参考

如果你想看一个实际效果，可以参考我另一个小工具项目的这次提交：

https://github.com/magicdian/xgit/commit/161928c442c271fd0d943ffe33b8da36892efdc0#diff-c81a0f51066def8b3b671e54d68bd15a5abe6bcd4d95584029744948242be74d

使用建议

• 可以先用便宜、量大的模型跑一遍试试。如果你觉得这套流程适合自己的项目，再换更强一点的模型去跑，通常效果会更稳一些。

• 如果你本身就有一些历史比较长的 OpenSpec 项目，又刚好想迁移到 Trellis ，欢迎试试，也欢迎反馈问题。