[开源]cursor-trellis：针对Cursor适配的Trellis

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是


• 我的开源项目完整开源，无未开源部分： 是


• 我的开源项目已链接认可 LINUX DO 社区： 是


• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是


• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

cursor-trellis

在Trellis的基础上对Cursor做了单平台适配，还是Trellis那一套流程。

把框架语义用Cursor原生通道实现：.cursor/rules(常驻策略)、commands(用户可调入口)、agents(subagent)、hooks.json(Python 脚本,会话/检索/派发上下文)。补充：Cursor的session注入有点问题，所以走 .cursor/rules。

改了什么

1. Cursor Native/Cursor++ 适配

两个不同环境对比：

在Cursor++环境下，要让 trellis-* 固定模型，尝试好多种只能patch resolver本身（可以等哈雷佬好消息）， patch_wpelc8.py + ~/.ccursor/trellis-task-models.json5，可逆，而且和Cursor++一样，每次更新完都要重新patch。Native用户不需要。

trellis init --cursor 默认是Native，Cursor++用户加 --cursor2plus。

2. commands-only

内部技能（ trellis-brainstorm 等）不写入 .cursor/skills/ ， / 仅暴露三个命令：/trellis-continue、trellis-finish-work、trellis-cursor2plus-setup。

技能语义通过 .cursor/rules + AGENTS.md + workflow.md 传递,由工作流匹配器自动加载。主要是因为，在Cursor装完Trellis， /敲下去一堆skills，看得头大。

3. subagent派发以及执行策略

三个subagent: trellis-research(内外部研究)、trellis-implement(只负责实现)、trellis-check(独立审查 pass)。主会话只在 execution_mode: worker 时才派实现/审查subgent:

执行策略：implement.md 里用 execution_mode / isolation / verification_profile这样的yaml块来决定谁实现、检查，以及在哪隔离。规划时跑 task.py suggest-execution-strategy <task> 拿数据驱动的建议，一般的文档操作、研究都会走 inline。

上下文加载是双路径:主路径是 CLI Layer 2(task.py generate-dispatch-prompt)——派发前把 prd/spec/research 预嵌进派发 prompt,并打 <!-- trellis-hook-injected --> 标记;preToolUse hook 作 best-effort 补充(标记已在就跳过)。subagent 见标记直接干活,不见就从 Selected task: <path> 手动读 jsonl + 工件。Native 与 BYOK 用同一套机制,与模型路由无关。

题外话：很奇怪，Cursor的hook好多问题。

4. 检索层设计

1. 外部事实优先走项目里的 smart-search CLI，Cursor自带的 WebSearch/WebFetch 只在 smart-search 不可用时fallback。


2. 本地/代码库问题按意图路由:精确串/路径走 Grep、调用链/影响面走 codegraph、跨包同名走 codegraph 消歧、概念级(如：这项目怎么工作)Native 用内置 @codebase / BYOK 用 fast-context-mcp。计划块由 beforeSubmitPrompt hook 注入 + .cursor/rules 兜底。

这一块内容太多了建议看文档，并且还有很多需要优化，佬们要删掉或者根据自己对检索工具的使用情况做修改都可以。

5. 联网搜索依赖 smart-search

外部事实检索依赖配套的 smart-search，装 cursor-trellis 时会作为依赖自动安装。根据站内的 smart-search 做了很小很小的修改，主要是双语 search，还有削减了一些搜索服务。

安装和使用

npm install -g @blxzer/cursor-trellis

trellis --version



cd /path/to/your-app    # 你的项目根

trellis init --cursor   # Native;BYOK 加 --cursor2plus

链接

致谢

感谢以下开发者！！