用途:Trellis Meta 面向已在项目中执行过 trellis init 的本地 Trellis 用户。阅读后,AI 应理解该用户项目内的 Trellis 架构、运行模型与定制入口,再按用户请求修改生成的 .trellis/ 与平台目录文件。
主要能力:Trellis v0.6 在原有工作流/持久化/平台模型之上新增三个架构面。一是多智能体协作运行时:trellis channel 通过项目级 JSONL 事件日志 ~/.trellis/channels/<project>/<channel>/events.jsonl 协调多个 AI 工作进程,含 worker OOM 保护、forum/thread 频道、持久幂等键,以及内置 .trellis/agents/{check,implement}.md 运行时定义。二是跨会话记忆:trellis mem list | search | context | extract | projects 读取磁盘上已有的 Claude Code、Codex、Pi Agent JSONL,按 --phase brainstorm|implement|all 切片,且不上传任何内容。三是双包 npm 发布:@mindfoldhq/trellis(CLI)与 @mindfoldhq/trellis-core(SDK,含 /channel、/task、/mem、/testing 子路径)同版本同步发布。
使用方式:先读 references/local-architecture/overview.md 建立本地系统模型;涉及具体 AI 工具时读 references/platform-files/platform-map.md 及相关平台文件说明;涉及多智能体调度或 channel worker 时读 references/local-architecture/multi-agent-channel.md 与内置 .trellis/agents/ 文件;要改行为时读 references/customize-local/overview.md 再进入具体定制主题。编辑前先读用户项目中的实际文件,以本地内容为准。
适用场景:修改 .trellis/ 与平台钩子、设置、agents、skills、commands、workflow、spec 结构,或调整 channel 运行时与跨会话记忆相关配置。
限制:不要假设用户拥有 Trellis 源码仓库;不要默认修改全局 npm 安装目录或 node_modules。不要用默认模板覆盖用户已修改的本地文件,先查 .trellis/.template-hashes.json,优先用 .new 旁挂文件。团队私有规则不要放进公开内置技能,应放入 .trellis/spec/、项目本地技能、当前任务或 workspace 日志。不要手改 events.jsonl,序号在文件锁下分配,写入应经 trellis channel CLI 或 @mindfoldhq/trellis-core/channel SDK。要改 channel 运行时 worker 行为时,应编辑 .trellis/agents/<name>.md,而非各平台子智能体文件。不要将已移除或从未发布的机制描述为当前行为,应核对本地 .trellis/config.yaml 与已安装 CLI 的 trellis --help。